Files

T

Celes Renata 88ad1e8d99 feat: comprehensive docs, unit tests, docker-compose app services

- Add scheduler and ingestion unit tests (test_scheduler_unit.py, test_ingestion_unit.py)
- Add all 13 app services + dashboard to docker-compose.yml
- Add full documentation suite: API reference, Helm reference, Docker deployment guide,
  3 architecture diagrams (K8s, Docker Compose, data pipeline), AI agent guide,
  backup/restore guide, observability/metrics reference, per-service docs
- Add intelligence pipeline deep-dive docs with Mermaid diagrams
- Update README with documentation index and links
- Add specs for comprehensive-quality-docs, intelligence-pipeline-deep-dive,
  sanitized-pipeline-docs

2026-04-22 02:56:41 +00:00

3.8 KiB

Raw Permalink Blame History

Decision Execution Engine Loop

flowchart TD
    subgraph ENGINE["Decision Execution Engine\nservices/trading/engine.py"]
        direction TB
        TASKS["5 Concurrent Async Tasks"]
        T1["_decision_loop()\n60s polling interval"]
        T2["_risk_threshold_monitor()"]
        T3["_performance_loop()"]
        T4["_risk_tier_scheduler()"]
        T5["_rebalance_scheduler()"]
        TASKS --> T1 & T2 & T3 & T4 & T5
    end

    T1 --> POLL["Poll recommendations table\naction IN (act, defer)\nmode IN (simulation_eligible, production_eligible)\ngenerated_at > NOW() − 2h"]

    POLL --> EVAL["evaluate_recommendation()"]

    EVAL --> CHK_A

    subgraph PRETRADE["Pre-Execution Check Sequence\n(first failure short-circuits)"]
        direction TB
        CHK_A["a. Circuit Breaker active?\nservices/trading/circuit_breaker.py\nTriggers: daily_loss, single_commitment, volatility"]
        CHK_B["b. Execution Window?\nis_within_execution_window()"]
        CHK_C["c. Confidence Gate\nconfidence ≥ risk_tier.min_confidence"]
        CHK_D["d. Deduplication\nRec ID in processed set?\nRedis: app:dedupe:execution:*"]
        CHK_E["e. Declining Commitments\n> 50% commitments down > 2%"]
        CHK_F["f. Max Open Commitments\nopen_count ≥ max (default 10)"]

        CHK_A -->|"pass"| CHK_B
        CHK_B -->|"pass"| CHK_C
        CHK_C -->|"pass"| CHK_D
        CHK_D -->|"pass"| CHK_E
        CHK_E -->|"pass"| CHK_F
    end

    CHK_A & CHK_B & CHK_C & CHK_D & CHK_E & CHK_F -->|"fail"| SKIP["ExecutionDecision\ndecision = skip\n+ skip_reason"]

    CHK_F -->|"pass"| SIZER

    subgraph SIZER["Commitment Sizing\nservices/trading/position_sizer.py"]
        direction TB
        SZ1["Base sizing\nrisk_tier.max_commitment_pct × 0.5\n× (confidence / min_confidence)"]
        SZ2["Correlation reduction\nweighted avg corr > 0.8 → reject\n> 0.5 → proportional reduction"]
        SZ3["Sector exposure\ncap at risk_tier.max_sector_pct"]
        SZ4["Diversification bonus\n1.2× for new sector (< 3 sectors)"]
        SZ5["Event proximity\n≤ 1 day → reject\n≤ 3 days → 50% reduction"]
        SZ6["Absolute commitment cap"]
        SZ7["Pool exposure check\nmax_pool_exposure × active_pool"]
        SZ8["Share rounding\nfloor(dollar / price)"]

        SZ1 --> SZ2 --> SZ3 --> SZ4 --> SZ5 --> SZ6 --> SZ7 --> SZ8
    end

    SIZER -->|"rejected"| SKIP
    SIZER -->|"approved"| ACT["ExecutionDecision\ndecision = act\nshares, dollar amount"]

    ACT --> PERSIST_TD["Persist to\nexecution_decisions"]

    ACT --> ORDER["Build execution request\n{entity, action, side,\nquantity, request_type}"]

    ORDER -->|"rpush"| Q_BROKER["app:queue:execution_orders"]

    Q_BROKER --> BROKER["Execution Adapter\nexternal execution API (simulation)\nservices/adapters/broker_adapter.py"]

    BROKER --> AUDIT

    subgraph AUDIT["Audit Trail — PostgreSQL"]
        AU1["execution_requests"]
        AU2["commitments"]
        AU3["pool_snapshots"]
    end

    subgraph CB_DETAIL["Circuit Breaker Detail\nservices/trading/circuit_breaker.py"]
        CB1["daily_loss\npool loss > 5%\ncooldown: volatility_pause_hours"]
        CB2["single_commitment\ncommitment loss > 15%\ncooldown: entity_cooldown_hours (48h)"]
        CB3["volatility\n≥ 3 risk thresholds in 30min\ncooldown: volatility_pause_hours (2h)"]
        CB4["Redis state\napp:execution:circuit_breaker:*"]
    end

    subgraph RESERVE["Reserve Pool\nservices/trading/reserve_pool.py"]
        RP1["Profit siphoning: 20%"]
        RP2["High-water rebalance: 30%"]
        RP3["Emergency liquidation"]
        RP4["reserve_pool_ledger"]
    end

    subgraph RISK_TIER["Risk Tier Auto-Adjustment\nservices/trading/risk_tier_controller.py"]
        RT1["Evaluate: risk-adjusted return ratio,\npeak-to-trough decline, success rate"]
        RT2["conservative → moderate → aggressive"]
        RT3["risk_tier_history"]
    end

3.8 KiB Raw Permalink Blame History Unescape Escape

Decision Execution Engine Loop

3.8 KiB

Raw Permalink Blame History