Operational procedures for deployment, monitoring, data management, and incident response for the Tickonomics platform.
| Endpoint | URL | Purpose |
|---|---|---|
| Backend health | http://localhost:8080/actuator/health |
Spring Boot health check |
| Analytics worker health | http://localhost:8001/health |
FastAPI health with dependency versions |
| Dashboard | http://localhost:3001 |
Analytics dashboard UI |
| Landing page | http://localhost:3000 |
Marketing page |
| Jaeger UI | http://localhost:16686 |
Distributed tracing |
| TimescaleDB | localhost:5432 |
PostgreSQL (dev only) |
- Deployment Procedures — Starting, stopping, updating services across environments
- Analytics Worker Deployment — Build, start, and verify the Python FastAPI worker
- Data Management — Retention, compression, backup, recovery
- Monitoring & Troubleshooting — Health checks, tracing, common issues
- Finnhub WebSocket + Yahoo Finance Setup — Configure and verify free data source clients
- Finnhub WebSocket Outage Response — Circuit breaker, REST fallback, recovery
- Options Data Pipeline Verification — Options ingestion and GEX calculation
- Proxy Divergence Event Review — SOFR / T-Bill dislocation handling (Finding 3)
- De-Rounding & Periodicity Filter Verification — Data quality filter checks
- Disaster Alert Verification — Exogenous-shock regime trigger checks
- Big Red Button — Kill-Switch — Manual emergency halt (
/api/v1/demo/kill-switch/*) - Systemic Resilience Monitor — Global Safe Mode — Automatic correlated-degradation protection (
/api/v1/demo/safe-mode/*) - Chronicle / Overflow Buffer Recovery — Ingestion overflow volume replay
- Bulkhead Pool Monitoring — Per-pool executor utilization tuning
- Distributed Tracing with Jaeger — End-to-end Java→Python→Java latency
- Calibration Task Monitoring —
ScheduledCalibrationTasklifecycle - ILI Weight Recalibration — Bayesian weight optimization review
- TimescaleDB Continuous Aggregate Refresh — CAGG staleness and refresh
- TA-Lib Adapter Integration — Pure-Java TA-Lib usage
- Regulatory Compliance Report Generation — MiFID II-style self-certification reports
- Plan:
docs/plan_v6/11-deployment-operations.md - Architecture decisions:
docs/adr/— notably ADR-017 (kill-switch) and ADR-018 (Systemic Resilience Monitor)