d-bis/proxmox
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
fa5de3ba0110f8f6c19d43df484a805dc1d857f0
proxmox/docs/00-meta/PARALLEL_TASK_STRUCTURE.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
Details
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates 
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

145 lines
7.3 KiB
Markdown
Raw Blame History

# Parallel Task Structure
**Purpose:** Enable maximum automation by removing artificial order-of-operations blockers.
**Principle:** Split large tasks into smaller atomic units; mark real vs fake dependencies; group by parallel cohort.
**Full remaining work (all TODOs):** For the **complete** list of remaining items ordered for **full maximum parallel mode** (Wave 0 → Wave 1 → Wave 2 → Wave 3), see **[FULL_PARALLEL_EXECUTION_ORDER.md](FULL_PARALLEL_EXECUTION_ORDER.md)**. Run all items in the same wave concurrently.
---
## Parallel Cohorts
Tasks in the same cohort have **no dependencies on each other** and can run in parallel.
### Cohort A — Immediate (no blockers)
| ID | Task | File/Scope | Automation |
|----|------|------------|------------|
| A1 | Add env check to e-signature.ts | the-order/services/legal-documents | Edit |
| A2 | Add env check to court-efiling.ts | the-order/services/legal-documents | Edit |
| A3 | Add ISSUER_DID env to identity | the-order/services/identity | Edit |
| A4 | Add env stub to OCR placeholder | the-order/packages/workflows | Edit |
| A5 | Add env stub to approval placeholder | the-order/packages/workflows | Edit |
| A6 | Add OIDC env vars to shared auth | the-order/packages/shared | Edit |
| A7 | Add DID env to auth/did.ts | the-order/packages/auth | Edit |
| A8 | Create ISO deploy script (forge) | smom-dbis-138/scripts | New file |
| A9 | Add Uniswap env stub | alltra-lifi-settlement | Edit |
| A10 | Add Curve env stub | alltra-lifi-settlement | Edit |
| A11 | Add payment-intent env stub | alltra-lifi-settlement | Edit |
| A12 | Create OMNIS EntityList.test.tsx | OMNIS | New file |
| A13 | Create OMNIS TreasuryCharts.test.tsx | OMNIS | New file |
| A14 | Add GlobalSearch mock for tests | OMNIS | Edit |
| A15 | Fix dbis JsonValue type (one module) | dbis_core | Edit |
| A16 | Create Prometheus scrape config | smom-dbis-138/monitoring | Edit |
| A17 | Create verify-websocket standalone script | scripts/verify | Edit |
| A18 | Add .env vars to IP_CENTRALIZATION | docs | Edit |
### Cohort B — After Cohort A (or parallel if A not needed)
| ID | Task | File/Scope | Depends On |
|----|------|------------|------------|
| B1 | Finance DB persistence (schema) | the-order/packages/database | None |
| B2 | Dataroom document metadata save | the-order/services/dataroom | None |
| B3 | Identity VC verification logic | the-order/services/identity | A3 |
| B4 | Vault test VLT-001 only | smom-dbis-138/test | None |
| B5 | ISO test ISO-001 only | smom-dbis-138/test | None |
| B6 | Bridge BRG-VLT deposit token | smom-dbis-138/contracts | None |
| B7 | Bridge BRG-ISO deposit token | smom-dbis-138/contracts | None |
| B8 | OMNIS cash flow chart stub | OMNIS | None |
| B9 | OMNIS Gantt stub | OMNIS | None |
| B10 | dbis IRU SES env stub | dbis_core | None |
| B11 | dbis IRU sanctions env stub | dbis_core | None |
| B12 | NPMplus backup cron script | scripts | None |
| B13 | Phase 3 CCIP Ops script skeleton | scripts/deployment | None |
| B14 | Phase 4 tenant script skeleton | scripts/deployment | None |
### Cohort C — Independent external integrations
Each can run in parallel; no cross-deps:
| ID | Task | Blocker |
|----|------|---------|
| C1 | Li.Fi SDK integration | API key |
| C2 | LayerZero integration | API/config |
| C3 | Uniswap routing (real) | RPC, pool addresses |
| C4 | DocuSign e-signature | API key |
| C5 | MoonPay fiat on-ramp | API key |
| C6 | Ramp Network fiat | API key |
### Cohort D — Infrastructure (SSH-able; can parallelize by host)
| ID | Task | Host | Depends On |
|----|------|------|------------|
| D1 | Verify ml110 containers | ml110 | SSH |
| D2 | Verify r630-01 containers | r630-01 | SSH |
| D3 | Verify r630-02 containers | r630-02 | SSH |
| D4 | Backup NPMplus (if NPM_PASSWORD) | r630-01 | SSH, creds |
| D5 | Export Prometheus targets | r630-01 | SSH |
---
## Dependency Rules
### Fake dependencies (ignore for parallelization)
- ~~Phase 2 before Phase 3~~ → Observability config can be done alongside CCIP scripts
- ~~Vault tests before deployment~~ → Deploy script can exist without tests passing
- ~~Auth before frontend charts~~ → Chart stubs need no auth
- ~~DB before Finance service~~ → Env stubs work without DB
- ~~BRG-VLT before BRG-ISO~~ → Independent contract changes
### Real dependencies (must respect)
- CCIP commit nodes → need CCIP Ops/Admin (true infra dep)
- NPMplus backup → needs NPM_PASSWORD (creds)
- Real API calls → need API keys (creds)
- Forge deploy → needs PRIVATE_KEY, RPC_URL (creds)
---
## Task Splitting Guide
| Monolithic Task | Split Into |
|-----------------|------------|
| "Vault tests VLT-001 to VLT-009" | VLT-001, VLT-002, … VLT-009 (9 parallel tasks) |
| "ISO tests ISO-001 to ISO-008" | ISO-001, … ISO-008 (8 parallel tasks) |
| "Bridge BRG-VLT, BRG-ISO, BRG-EM" | BRG-VLT, BRG-ISO, BRG-EM (3 parallel) |
| "CCIP Fleet" | Ops script, Commit script, Execute script, RMN script (4 parallel scripts) |
| "dbis TypeScript fixes" | By file: fix `file1.ts`, fix `file2.ts`, … |
| "OMNIS unit tests" | Header, EntityList, TreasuryCharts, … (one test file each) |
| "the-order Identity" | Env stub, VC issuance, verification, KMS (4 parallel) |
| "Documentation consolidation" | By doc folder: 01-, 02-, 03-, … (parallel by section) |
---
## Execution Model
1. **Cohort A** → Run all in parallel (no shared state).
2. **Cohort B** → Run in parallel; some reference A outputs but can use defaults.
3. **Cohort C** → Run when credentials available; independent of each other.
4. **Cohort D** → Run per-host in parallel; SSH to ml110, r630-01, r630-02 concurrently.
---
## Completed (2026-01-31)
**Cohort A:** A1-A2 (e-signature, court-efiling already had env checks), A3 (VC_ISSUER_DID exists), A4-A7 (workflows, auth env stubs), A8 (deploy-iso4217w-system.sh), A9-A11 (alltra env stubs), A12-A14 (EntityList, TreasuryCharts, GlobalSearch tests), A16 (scrape-proxmox.yml), A17 (verify-websocket exists), A18 (IP_CENTRALIZATION, .env.example).
**Cohort B:** B1-B2 (Finance/Dataroom DB wired), B12 (npmplus-backup-cron.sh), B13-B14 (phase3-ccip-ops.sh, phase4-sovereign-tenants.sh), B6-B7 (register-vault-deposit-tokens.sh, register-iso-deposit-tokens.sh), B8-B9 (TreasuryCharts, ProjectTimeline exist), B10-B11 (SES/sanctions env in dbis).
**Cohort D:** D4 (backup-npmplus ran successfully), D5 (export-prometheus-targets.sh, targets-proxmox.yml). PROXMOX_* added to .env.
**Completed (2026-02-01):** dbis_core deployment-orchestrator syntax fix; ari-reflex duplicate props; prisma generate. alltra-lifi-settlement: env.example, TypeScript fixes, workspace add, build passing. multi-chain-execution: Express router type annotations (build passing). OMNIS: vitest testTimeout 20s, hookTimeout 15s, MSW onUnhandledRequest bypass. smom: forge:test, forge:test:vault, forge:test:iso scripts.
**dbis_core TypeScript Phases 1-4 (2026-01-31):** Phase 1 (imports, route returns), Phase 2 (JsonValue, unknown, reduce types), Phase 3 (Prisma props, express.d.ts, null safety), Phase 4 (schema mismatches, gdsl-settlement, uhem-analytics). ~1186 TS errors remain. See REMAINING_TASKS_MASTER.
---
## Automation Script
A runner can:
- Parse this file for Cohort A/B task IDs
- For each task: `pnpm exec cursor-agent --task "A1"` (or similar)
- Collect results; proceed to next cohort
- Never block A2 on A1, B2 on B1, etc.
Reference in New Issue View Git Blame Copy Permalink