| 1 | # AI Investment Intelligence Platform |
| 2 | |
| 3 | Production-grade monorepo foundation for an AI-powered investment intelligence platform. |
| 4 | |
| 5 | This repository is independent and does not use or modify any existing user-management project. |
| 6 | |
| 7 | ## Stack |
| 8 | |
| 9 | - Backend: Java 17, Spring Boot, Maven |
| 10 | - AI services: Python 3.12+, FastAPI |
| 11 | - Frontend: React / Next.js |
| 12 | - Data platform: PostgreSQL, Redis, Kafka |
| 13 | - Infrastructure: Docker, k3d, Kubernetes, Helm, Terraform |
| 14 | - PRD target: Microsoft Azure AKS in `westeurope` |
| 15 | - Observability target: OpenTelemetry, Prometheus, Grafana |
| 16 | |
| 17 | ## Repository Layout |
| 18 | |
| 19 | ```text |
| 20 | frontend/ |
| 21 | services/ |
| 22 | ai/ |
| 23 | shared/ |
| 24 | infrastructure/ |
| 25 | config/ |
| 26 | scripts/ |
| 27 | docs/ |
| 28 | platform.ps1 |
| 29 | ``` |
| 30 | |
| 31 | ## Platform Commands |
| 32 | |
| 33 | ```powershell |
| 34 | .\platform.ps1 up DEV |
| 35 | .\platform.ps1 status DEV |
| 36 | .\platform.ps1 down DEV |
| 37 | |
| 38 | .\platform.ps1 up PRD |
| 39 | .\platform.ps1 status PRD |
| 40 | .\platform.ps1 down PRD |
| 41 | ``` |
| 42 | |
| 43 | The first foundation iteration does not apply Azure infrastructure. `up PRD` validates the Azure subscription and creates a Terraform plan only. `down PRD` requires an explicit typed confirmation before running `terraform destroy` against this project's PRD Terraform state. |
| 44 | |
| 45 | ## Safe Local Validation |
| 46 | |
| 47 | ```powershell |
| 48 | mvn clean verify |
| 49 | python -m compileall ai/research-engine/app |
| 50 | helm lint infrastructure/helm/ai-investment-platform |
| 51 | terraform -chdir=infrastructure/terraform/environments/prd fmt -check |
| 52 | ``` |
| 53 | |
| 54 | Foundation validation creates no Azure resources. Use Terraform plan/apply only after an explicit deployment review. |
| 55 | |
| 56 | ## Phase 3 Research Intelligence |
| 57 | |
| 58 | The research foundation lives in `ai/research-engine` and exposes `/api/v1/research/*` APIs for company profiles, documents, extracted events, source providers, schedule rules, refresh, and deterministic catalyst summaries. It uses demo fixtures by default and does not perform Google result scraping, CAPTCHA bypass, paywall bypass, paid API calls, or BUY/SELL recommendations. |
| 59 | |
| 60 | ## Security Baseline |
| 61 | |
| 62 | No broker credentials, Azure credentials, API keys, or LLM provider secrets belong in source control. Use Azure CLI context for development authentication and Key Vault / Kubernetes secrets for production runtime secrets. |