How tech-armstrong/fp-agentic-prod works
This is an AI-powered financial-planning dashboard: users browse Airtable client records, inspect portfolio and liability summaries, and ask questions through a Copilot sidebar. They can also run financial plans, review RSU market data, export plans as PowerPoint, and upload policy PDFs for OCR-based summaries. The graph separates the dashboard, API services, planning engine, and assistant/policy workflow. Some service-to-service links are documented; unsampled implementation details are not inferred.
Main entry points: ClientsDashboard.tsx Client dashboard · fastapi-proxy.ts FastAPI proxy · backend-airtable/main.py Airtable API · agent/main.py LangGraph agent
Components 28
Dashboard UI
- Dashboard shell
app/page.tsx - Client dashboard
components/ClientsDashboard.tsx - Plan panel
components/FinancialPlanPanel.tsx - Spouse details
components/SpouseDetailsPanel.tsx - Education planning
components/EducationPlanningSection.tsx
Application APIs
- Client routes
app/api/airtable/clients/route.ts - Airtable API
backend-airtable/main.py - Airtable
- Plan run route
app/api/financial-plan/run/route.ts - Plan export route
app/api/financial-plan/ppt/route.ts - FastAPI proxy
lib/fastapi-proxy.ts - RSU routes
app/api/rsu/market-data/route.ts
Financial Planning
- Plan runner
backend/financial_plan_runner.py - Planning workflow
Financial_Planning/Workflow/workflow.py - Planning calculations
Financial_Planning/Nodes - Plan state
Financial_Planning/Models/client_data_state.py
Assistant and Policy
- Copilot route
app/api/copilotkit/route.ts - LangGraph agent
agent/main.py - Policy upload route
app/api/parse-policy-document/route.ts - OCR service client
lib/ocrService.ts - Policy OCR service
ocr-service/main.py - PDF processor
ocr-service/processor.py
RSU and Reporting
- RSU market API
backend/rsu_market.py - PPT migration endpoint
Financial_Planning/PPTX_Migration/endpoint.py - PowerPoint deck
Financial_Planning/PPTX_Migration/deck.py
Other components
- User
- Azure OpenAI
- Tavily search
Connections 31
- User → Dashboard shell: uses
README.md - Dashboard shell → Client dashboard: renders
app/page.tsx - User → Client dashboard: browses clients
README.md - Client dashboard → Client routes: loads records
- Client routes → Airtable API: forwards requests
- Airtable API → Airtable: reads and writes
backend-airtable/main.py - Client dashboard → Plan panel: shows plan
components/ClientsDashboard.tsx - User → Plan panel: requests plan
README.md - Plan panel → Plan run route: submits plan
- Plan run route → FastAPI proxy: forwards request
app/api/financial-plan/run/route.ts - FastAPI proxy → Plan runner: calls API
backend/financial_plan_runner.py - Plan runner → Planning workflow: invokes workflow
backend/financial_plan_runner.py - Planning workflow → Planning calculations: dispatches stages
- Planning calculations → Plan state: updates state
Financial_Planning/Nodes/allocations_nodes.py - Client dashboard → Spouse details: renders
components/ClientsDashboard.tsx - Client dashboard → Education planning: renders
components/ClientsDashboard.tsx - User → Copilot route: asks questions
README.md - Copilot route → LangGraph agent: routes chat
app/api/copilotkit/route.ts - LangGraph agent → Azure OpenAI: generates responses
README.md - LangGraph agent → Tavily search: searches web
README.md - User → Policy upload route: uploads policy PDF
app/api/parse-policy-document/route.ts - Policy upload route → OCR service client: summarizes document
app/api/parse-policy-document/route.ts - OCR service client → Policy OCR service: posts PDF
lib/ocrService.ts - Policy OCR service → PDF processor: processes PDF
ocr-service/main.py - User → RSU routes: views market data
README.md - RSU routes → FastAPI proxy: forwards request
app/api/rsu/market-data/route.ts - FastAPI proxy → RSU market API: calls API
backend/rsu_market.py - User → Plan export route: exports plan
- Plan export route → FastAPI proxy: forwards export
app/api/financial-plan/ppt/route.ts - Airtable API → PPT migration endpoint: serves migration endpoint
backend-airtable/main.py - PPT migration endpoint → PowerPoint deck: builds deck
Financial_Planning/PPTX_Migration/endpoint.py