Unified Investment Decision Workflow & Due Diligence Automation Platform

End-to-end platform for investment committee workflow automation:

• deal intake
• due diligence execution
• IC approval and voting
• post-investment monitoring
• compliance-grade audit trail

For non-technical teams

Send this repo to IT; they can run docker compose up --build and give you a URL.

Recommended handoff steps:

1. IT copies .env.firm.example to .env and fills internal infrastructure values.
2. IT runs docker compose up --build.
3. IT shares frontend URL (default http://localhost:5173) with your deal team.

Demo-first quick start

cp .env.example .env
docker compose up --build
python scripts/seed_demo.py

Open:

• Frontend: http://localhost:5173
• API docs: http://localhost:8000/docs

Walkthrough script: docs/Demo script.md

Dashboard screenshots

• Pipeline view:
• Deal detail / diligence:
• IC decision view:
• Monitoring view:

System architecture

1. Document intelligence (OCR + parsing)
2. Extraction engine (heuristic / Ollama / Hugging Face)
3. Workflow orchestration (state transitions + task generation)
4. Collaboration UI (React command center)
5. Compliance data layer (audit_logs, monitoring_alerts)

Free AI Modes

Mode	Cost	Typical latency	Setup effort	Typical extraction accuracy
Heuristic	Free	Fastest	Minimal	Baseline, deterministic
Ollama	Free (local compute)	Medium	Medium (install model runtime)	Better on nuanced text
Hugging Face free tier	Free tier limits	Medium-high	Low-medium (token + model)	Good when model prompt follows schema

Default mode in .env.example is AI_PROVIDER=heuristic.

If your IT team is willing to run Ollama locally, here’s how

1. Install Ollama on internal host.
2. Pull a local model (example): ollama pull llama3.1:8b
3. Set:

AI_PROVIDER=ollama
AI_MODEL=llama3.1:8b
OLLAMA_BASE_URL=http://<internal-host>:11434

4. Restart API/Celery services.

Extraction mode examples and tests: docs/extraction-modes.md

Demo users and X-User headers

Built-in demo users endpoint: GET /api/v1/demo/users

Default demo users:

• Partner: partner.demo@firm.local
• Analyst: analyst.demo@firm.local
• Compliance: compliance.demo@firm.local

Example request:

curl -s http://localhost:8000/api/v1/deals \
  -H "X-User: analyst.demo@firm.local" \
  -H "X-User-Role: Analyst"

Firm-facing configuration points

• DD checklist without code changes: data/dd_checklist.yaml
• IC voting rules via env:
  • IC_QUORUM_REQUIRED
  • IC_QUORUM_PERCENTAGE
  • IC_REQUIRED_ROLES
  • IC_APPROVAL_THRESHOLD
• Branding:
  • FIRM_NAME
  • FIRM_LOGO_URL
  • Optional upload endpoint: POST /api/v1/branding/logo

Health, observability, and stability

• Dependency health: GET /health (DB, Redis, Celery broker/worker)
• Portfolio risk snapshot: GET /api/v1/monitoring/portfolio
• Alert records: GET /api/v1/monitoring/alerts
• Trigger alert scan: POST /api/v1/monitoring/alerts/run

Logging guide: docs/logging.md Deployment and hardening: docs/deployment.md Stress test script and latest report:

• scripts/stress_test.py
• docs/reports/stress-test-report-2026-02-26.md
• docs/reports/artifacts/stress-results-2026-02-26.json
• Visual presentation built from stress artifacts only:
  • docs/reports/stress-visual-demo-2026-02-26.md

Compliance and governance

• Audit model: docs/compliance-audit-model.md
• RegTech/supervisory view: docs/regtech-supervisory-view.md
• Audit export script:

python scripts/export_audit_log.py --output data/processed/audit_log_export.csv

Data residency and self-hosting

This platform is designed for private deployment inside your own environment (VPC/on-prem):

• Postgres + Redis + Chroma can run fully private.
• Document storage can stay internal.
• Heuristic and Ollama modes avoid external AI dependencies.

Environment templates

• Developer template: /.env.example
• Firm deployment template: /.env.firm.example

Repo layout

• src/ backend API, services, workflows, tasks
• frontend/ React dashboard
• scripts/ seed/export/init utilities
• data/ uploaded docs, checklist config, demo assets
• docs/ operating model, deployment, governance
• tests/ unit and integration coverage