┌─────────────────────────────────────────────────────────────┐
│                       Frontend (UI)                         │
└──────────┬──────────────────────────────────┬───────────────┘
           │ deposit / withdraw / create      │ read state
           ▼                                  ▼
┌─────────────────────┐          ┌──────────────────────────┐
│   VaultFactory(s)   │          │     VaultRegistry        │
│  Politician / User  │          │   on-chain discovery     │
└────────┬────────────┘          └──────────────────────────┘
         │ deploys (BeaconProxy)
         ▼
┌─────────────────────────────────────────────────────────────┐
│                     BaseVault (ERC-4626)                     │
│  ┌─────────────────┐  ┌──────────────────┐                  │
│  │ PoliticianVault │  │    UserVault      │                  │
│  │ (oracle-driven) │  │ (curator-managed) │                  │
│  └────────┬────────┘  └────────┬─────────┘                  │
│           │ getTargetWeights() │                             │
│           ▼                    ▼                             │
│  ┌─────────────────┐  ┌──────────────────┐                  │
│  │ PortfolioOracle │  │ Internal weights │                  │
│  └─────────────────┘  └──────────────────┘                  │
└───────────────────────────┬─────────────────────────────────┘
                            │ rebalance / allocate
                            ▼
                 ┌─────────────────────┐
                 │   RebalanceEngine   │
                 │  trade calculation  │
                 └──────────┬──────────┘
                            │ swap
                            ▼
                 ┌─────────────────────┐
                 │    TokenRouter      │
                 │  price oracle +     │
                 │  swap execution     │
                 └─────────────────────┘

        ┌──────────────┐    ┌───────────────────┐
        │  FeeManager  │    │   PriceOracle     │
        │  fee splits  │    │ ticker → price    │
        └──────────────┘    └───────────────────┘

src/
├── core/
│   ├── BaseVault.sol              # Abstract ERC-4626 vault base
│   ├── PoliticianVault.sol        # Oracle-driven vault
│   ├── UserVault.sol              # Curator-managed vault
│   ├── PoliticianVaultFactory.sol # BeaconProxy factory (permissioned)
│   ├── UserVaultFactory.sol       # BeaconProxy factory (permissionless)
│   ├── VaultRegistry.sol          # On-chain vault discovery
│   └── FeeManager.sol             # Protocol + curator fee splits
├── interfaces/
│   ├── IBaseVault.sol
│   ├── IPortfolioOracle.sol
│   ├── IRebalanceEngine.sol
│   └── ITokenRouter.sol
├── oracle/
│   ├── PortfolioOracle.sol        # Politician portfolio weights
│   ├── ChainlinkAdapter.sol       # Chainlink Functions + Automation
│   └── PriceOracle.sol            # Ticker-based price queries
├── rebalance/
│   ├── RebalanceEngine.sol        # Trade calculation and execution
│   └── TokenRouter.sol            # Mock DEX router (testnet)
└── tokens/
    └── MockStockToken.sol         # Mock ERC-20 stock tokens (testnet)

UpgradeableBeacon (UserVault)
  └─ implementation: UserVault logic contract
  └─ BeaconProxy #1 (Fund A) ──→ delegates to beacon
  └─ BeaconProxy #2 (Fund B) ──→ delegates to beacon
  └─ BeaconProxy #3 (Fund C) ──→ delegates to beacon