QuantaTrade AI — Repository Bootstrap Plan¶

Source Code Mapping¶

Each QuantaTradeAI repo maps to an existing codebase that will be cloned and adapted.

%%{init: {'theme':'base','themeVariables':{'background':'#ffffff','primaryColor':'#ddf4ff','primaryBorderColor':'#0969da','primaryTextColor':'#0a0a0a','lineColor':'#1f2328','secondaryColor':'#fff8c5','tertiaryColor':'#dafbe1','clusterBkg':'#f6f8fa','clusterBorder':'#d0d7de'}}}%%
graph LR
 subgraph Sources["Source Repositories"]
 EC2[QuantaTradeAI/exchange-platform<br/>Java matching engine]
 FE[QuantaTradeAI/fix-engine<br/>Rust OMS/execution]
 WUI[QuantaTradeAI/quantatrade-ui<br/>Next.js trading dashboard]
 BP[QuantaTradeAI/exchange-platform<br/>NestJS microservices]
 BMM[QuantaTradeAI/quantatrade-mm<br/>Java market maker]
 BT[QuantaTradeAI/backtest-engine<br/>Python/Rust backtesting]
 end

 subgraph Target["QuantaTradeAI Organization"]
 QEC[exchange-core]
 QOM[order-management]
 QUI[trading-ui]
 QPL[platform]
 QCS[custody-service]
 QCC[compliance-service]
 QCT[contracts]
 QPA[presale-app]
 QID[investor-dashboard]
 QAP[admin-panel]
 QCI[chain-indexer]
 QSE[strategy-engine]
 QMD[market-data]
 QMM[market-maker]
 QIF[infrastructure]
 QDO[docs]
 end

 EC2 -->|"clone & adapt"| QEC
 FE -->|"clone & adapt"| QOM
 WUI -->|"clone & adapt"| QUI
 BP -->|"extract services"| QPL
 BP -->|"extract custody-service"| QCS
 BP -->|"extract kyc-service"| QCC
 BP -->|"extract admin-ui"| QAP
 BMM -->|"clone & adapt"| QMM
 BT -->|"clone & adapt"| QSE

 style Sources fill:#ddf4ff
 style Target fill:#ddf4ff

Detailed Mapping: Clone Source → Target¶

1. exchange-core ← QuantaTradeAI/exchange-platform (matching engine)¶

Aspect	Details
Source	`QuantaTradeAI/exchange-platform` → `services/matching-engine/`
Language	Java Spring Boot
What to copy	exchange-core2 library, matching engine gateway, order book logic
Adaptations	Rebrand packages, configure $QTRA trading pairs, adjust scale model for crypto-only, remove legacy fiat pairs
New pairs	QTRA-USDC, BTC-USDC, ETH-USDC, SOL-USDC, BTC-USDT, ETH-USDT

# Bootstrap
gh repo clone QuantaTradeAI/exchange-platform /tmp/emt-exchange
cp -r /tmp/emt-exchange/services/matching-engine/* exchange-core/
# Extract exchange-core2 Java library
cp -r /tmp/emt-exchange/libs/exchange-core2/* exchange-core/libs/
# Clean up, rebrand, push

2. order-management ← QuantaTradeAI/fix-engine¶

Aspect	Details
Source	`QuantaTradeAI/fix-engine`
Language	Rust
What to copy	Multi-exchange connector architecture, order execution, venue routing
Adaptations	Replace FIX protocol with crypto exchange APIs (Binance, Bybit, OKX REST+WebSocket), add OMS state machine, add PMS position tracking, add smart order routing logic

# Bootstrap
gh repo clone QuantaTradeAI/fix-engine /tmp/fix-engine
cp -r /tmp/fix-engine/* order-management/
# Refactor: remove venue-specific, add crypto venue connectors

3. trading-ui ← QuantaTradeAI/quantatrade-ui¶

Aspect	Details
Source	`QuantaTradeAI/quantatrade-ui`
Language	Next.js 14 + TypeScript
What to copy	Trading dashboard layout, real-time WebSocket charts, order entry, portfolio view, auth flow
Adaptations	Rebrand to QuantaTrade, add spot trading interface, add strategy monitoring dashboard, replace FX-specific components with crypto, add TradingView charts, add subscription management UI

# Bootstrap
gh repo clone QuantaTradeAI/quantatrade-ui /tmp/quantatrade-ui
cp -r /tmp/quantatrade-ui/* trading-ui/
# Rebrand, adapt for crypto trading

4. platform ← QuantaTradeAI/exchange-platform (services)¶

Aspect	Details
Source	`QuantaTradeAI/exchange-platform`
Language	Node.js + NestJS + TypeScript
What to extract	API gateway, order-router, ledger-service, risk-service, ws-gateway, shared packages (db, types, nats, common)
Adaptations	Rebrand, remove QuantaTrade-specific business logic, add QuantaTrade API routes, adapt Prisma schema for $QTRA pairs, replace NATS with Kafka/Redpanda if needed

# Bootstrap - extract specific services into monorepo
gh repo clone QuantaTradeAI/exchange-platform /tmp/quantatrade
mkdir -p platform/{services,packages}
cp -r /tmp/quantatrade/services/api-gateway platform/services/
cp -r /tmp/quantatrade/services/order-router platform/services/
cp -r /tmp/quantatrade/services/ledger-service platform/services/
cp -r /tmp/quantatrade/services/risk-service platform/services/
cp -r /tmp/quantatrade/services/ws-gateway platform/services/
cp -r /tmp/quantatrade/packages/{common,db,types,nats} platform/packages/
# Adapt package.json, rebrand, push

5. custody-service ← QuantaTradeAI/exchange-platform¶

Aspect	Details
Source	`QuantaTradeAI/exchange-platform` → `services/custody-service/`
Language	Node.js + TypeScript + Temporal workflows
What to copy	BitGo API integration, wallet provisioning, deposit/withdrawal flows, address pooling
Adaptations	Add multi-sig approval flows, add stablecoin rails (USDC/USDT on ETH/BSC/SOL/Tron), add fiat rails (SEPA/SWIFT/ACH), add treasury allocation framework (50/50 split)

# Bootstrap
cp -r /tmp/quantatrade/services/custody-service/* custody-service/
cp -r /tmp/quantatrade/services/treasury-service/* custody-service/treasury/

6. compliance-service ← QuantaTradeAI/exchange-platform¶

Aspect	Details
Source	`QuantaTradeAI/exchange-platform` → `services/kyc-service/`
Language	Node.js + TypeScript
What to copy	Sumsub KYC integration, webhook handlers, verification status management
Adaptations	Add tiered KYC (Retail/HNWI/Institutional), add jurisdiction-based access controls, add AML transaction monitoring, add sanctions screening, add immutable audit logging

# Bootstrap
cp -r /tmp/quantatrade/services/kyc-service/* compliance-service/

7. contracts — NEW (Solidity)¶

Aspect	Details
Source	New development
Language	Solidity 0.8.x + Hardhat
Deliverables	$QTRA ERC20 token, SaleManager (6 rounds), Allocation & Vesting (Merkle), Staking + Rewards

# Bootstrap with Hardhat
cd contracts && npx hardhat init
npm install @openzeppelin/contracts

8. presale-app — NEW (Next.js)¶

Aspect	Details
Source	New development (reference trading-ui for patterns)
Deliverables	Wallet connect, round pages (Private A/B/C, Public), buy flow, claim portal, tx receipts

9. investor-dashboard — NEW (Next.js)¶

Aspect	Details
Source	New development (reference trading-ui for patterns)
Deliverables	Auth (wallet/OAuth), holdings by round, vesting schedule, claimable amounts, tx history

10. admin-panel ← QuantaTradeAI/exchange-platform¶

Aspect	Details
Source	`QuantaTradeAI/exchange-platform` → `services/admin-ui/`
Language	React / Next.js
Adaptations	Add presale management (configure rounds, CSV uploads, Merkle root), add allocation freeze, add TGE config, add CSV exports, add audit log viewer

# Bootstrap
cp -r /tmp/quantatrade/services/admin-ui/* admin-panel/

11. chain-indexer — NEW (TypeScript)¶

Aspect	Details
Source	New development
Deliverables	Index on-chain events (purchases, allocations, claims, vesting), reconciliation against on-chain totals
Stack	Node.js + ethers.js + PostgreSQL

12. strategy-engine ← QuantaTradeAI/backtest-engine¶

Aspect	Details
Source	`QuantaTradeAI/backtest-engine` + `QuantaTradeAI/strategies`
Language	Python + Rust (PyO3)
Adaptations	Replace strategies with crypto strategies (mean reversion, funding spread arbitrage), add signal engine, add AI prediction scanners, add backtesting environment, add custom signal builder

# Bootstrap
gh repo clone QuantaTradeAI/backtest-engine /tmp/backtester
cp -r /tmp/backtester/* strategy-engine/
gh repo clone QuantaTradeAI/strategies /tmp/strategies
cp -r /tmp/strategies/* strategy-engine/strategies/

13. market-data — MIXED (Rust + Node.js)¶

Aspect	Details
Source	Reference `QuantaTradeAI/market-data-relay` for data streaming patterns
Deliverables	DOM, L2/L3 visualization, liquidity analytics, news aggregation, sentiment engine, microstructure analytics

14. market-maker ← QuantaTradeAI/quantatrade-mm¶

Aspect	Details
Source	`QuantaTradeAI/quantatrade-mm`
Language	Java Spring Boot
Adaptations	Configure for $QTRA pairs, add liquidity provisioning logic, add external incentives, add spread management

# Bootstrap
gh repo clone QuantaTradeAI/quantatrade-mm /tmp/quantatrade-mm
cp -r /tmp/quantatrade-mm/* market-maker/

15. infrastructure — NEW¶

Aspect	Details
Source	Reference QuantaTrade and QuantaTrade infra patterns
Deliverables	Terraform (GCP/AWS), K8s manifests, Helm charts, CI/CD (GitHub Actions + ArgoCD), monitoring stack

16. docs — DONE (already pushed)¶

Bootstrap Execution Order¶

%%{init: {'theme':'base','themeVariables':{'background':'#ffffff','primaryColor':'#ddf4ff','primaryBorderColor':'#0969da','primaryTextColor':'#0a0a0a','lineColor':'#1f2328','secondaryColor':'#fff8c5','tertiaryColor':'#dafbe1','clusterBkg':'#f6f8fa','clusterBorder':'#d0d7de'}}}%%
gantt
 title Repository Bootstrap Order
 dateFormat YYYY-MM-DD
 axisFormat %b %d

 section Week 0 — Bootstrap
 Clone sources & strip history :w0a, 2026-03-31, 2d
 exchange-core (from QuantaTradeAI) :w0b, after w0a, 1d
 order-management (from fix-engine) :w0c, after w0a, 1d
 trading-ui (from quantatrade-ui) :w0d, after w0a, 1d
 platform (from quantatrade services) :w0e, after w0a, 2d
 custody-service (from quantatrade) :w0f, after w0a, 1d
 compliance-service (from quantatrade) :w0g, after w0a, 1d
 admin-panel (from quantatrade) :w0h, after w0a, 1d
 market-maker (from quantatrade-mm) :w0i, after w0a, 1d
 strategy-engine (from quantatrade) :w0j, after w0a, 1d
 contracts (Hardhat scaffold) :w0k, after w0a, 1d
 infrastructure (Terraform scaffold) :w0l, after w0a, 1d
 presale-app (Next.js scaffold) :w0m, after w0a, 1d
 investor-dashboard (Next.js scaffold) :w0n, after w0a, 1d
 chain-indexer (Node.js scaffold) :w0o, after w0a, 1d

Important: Clean Git History¶

When cloning from source repos, strip the git history to avoid leaking proprietary code lineage:

# For each cloned repo:
rm -rf .git
git init
git add -A
git commit -m "Initial commit - bootstrapped from internal codebase"
git remote add origin https://github.com/QuantaTradeAI/<repo>.git
git branch -M main
git push -u origin main

Source Access Requirements¶

Source Repo	Org	Access
QuantaTradeAI/exchange-platform	QuantaTradeAI	You (owner)
QuantaTradeAI/fix-engine	QuantaTradeAI	You (owner)
QuantaTradeAI/quantatrade-ui	QuantaTradeAI	You (owner)
QuantaTradeAI/backtest-engine	QuantaTradeAI	You (owner)
QuantaTradeAI/strategies	QuantaTradeAI	You (owner)
QuantaTradeAI/exchange-platform	QuantaTradeAI	You (owner)
QuantaTradeAI/quantatrade-mm	QuantaTradeAI	You (owner)

All source repos are owned by you — no access issues.