How devesh-chandan/neural_nexus works
This is a suitability-aware structured-products decision-support application for clients and relationship managers. Clients register or provide a profile; RMs configure products, while both can review analysis. The backend obtains market history, evaluates payoff metrics and deterministic suitability, and can generate a plain-language explanation and audit record. Recommendations compare candidate products. The README documents ELN, CPN, and DCD support, authentication, offline market-data fallback, and simulation. Source excerpts confirm the analysis, market-data, suitability, and registration paths; some unsampled integrations are shown only where documented.
Main entry points: main.py FastAPI application · App.tsx Web application · service.py Market history · engine.py Candidate ranking
Components 23
User surfaces
- Web application
frontend/src/App.tsx - Client questionnaire
frontend/src/pages/ClientPage.tsx - RM configurator
frontend/src/pages/RMPage.tsx - Registration forms
frontend/src/pages/ClientRegisterPage.tsx - Session state
frontend/src/hooks/useAuth.tsx
Identity and onboarding
- FastAPI application
backend/app/main.py - Registration service
backend/app/registration/service.py - KYC providers
backend/app/kyc/providers.py - Supabase auth
backend/app/core/supabase.py
Product analysis
- Product payoff models
backend/app/payoff/registry.py - Market history
backend/app/market/service.py - Historical simulation
backend/app/simulation/service.py - Payoff analytics
backend/app/analytics/metrics.py
Decision support
- Candidate ranking
backend/app/recommend/engine.py - Suitability rules
backend/app/suitability/engine.py - Result explanation
backend/app/explain/service.py
Records and data
- Client cases
backend/app/store/cases.py - Analysis runs
backend/app/store/runs.py - Audit trail
backend/app/store/audit.py
Other components
- Client / RM
- Supabase service
- LLM provider
- Market data provider
Connections 29
- Client / RM → Web application: use
README.md - Web application → Client questionnaire: routes to
frontend/src/App.tsx - Web application → RM configurator: routes to
frontend/src/App.tsx - Web application → Registration forms: routes to
frontend/src/App.tsx - Web application → Session state: provides session
frontend/src/App.tsx - Client questionnaire → FastAPI application: submits profile
- RM configurator → FastAPI application: submits configuration
- Registration forms → FastAPI application: submits registration
- Session state → Supabase service: manages session
frontend/src/hooks/useAuth.tsx - FastAPI application → Registration service: routes registration
- FastAPI application → Supabase auth: validates tokens
backend/app/main.py - Registration service → KYC providers: uses providers
backend/app/api/routes_registration.py - Registration service → Client cases: stores client cases
backend/app/api/routes_registration.py - FastAPI application → Market history: routes market access
backend/app/main.py - Market history → Market data provider: fetches history
backend/app/market/service.py - FastAPI application → Payoff analytics: requests analysis
- Payoff analytics → Market history: loads history
backend/app/analytics/metrics.py - Payoff analytics → Product payoff models: uses payoff models
backend/app/analytics/metrics.py - FastAPI application → Suitability rules: evaluates profile
- FastAPI application → Result explanation: requests narration
- FastAPI application → Analysis runs: records analysis
- FastAPI application → Audit trail: appends audit
- FastAPI application → Candidate ranking: routes recommendations
backend/app/main.py - Candidate ranking → Payoff analytics: scores candidates
backend/app/recommend/engine.py - Candidate ranking → Market history: loads history
backend/app/recommend/engine.py - Candidate ranking → Suitability rules: checks suitability
backend/app/recommend/engine.py - FastAPI application → Historical simulation: routes simulation
backend/app/main.py - Historical simulation → Market history: uses market history
- Result explanation → LLM provider: optionally narrates
README.md