How omaridop/tamweel_ai_expo works
Tamweel is a full-stack credit-decision platform: applicants use the web portal to request assessments, the backend produces a model score and applies business rules, and an LLM provides a text-only explanation. Separate product branches support financial dashboards, authenticated access, and a bilingual policy-grounded chat assistant with sponsor policy uploads. The README documents portfolio analytics, simulation, disputes, and audit governance; tree paths identify these capabilities, but their detailed wiring is not shown in the sampled source.
Main entry points: main.py FastAPI App · chat.py Chat Routes · AppRoutes.jsx Portal Routes · hybrid_engine.py Hybrid Score Engine
Components 25
User and Sponsor Portal
- Web App
frontend/src/App.jsx - Portal Routes
frontend/src/routes/AppRoutes.jsx - User Dashboard
frontend/src/features/dashboard/UserDashboard.jsx - Score Simulator
frontend/src/features/dashboard/ScoreSimulator.jsx - Sponsor Dashboard
frontend/src/features/dashboard/SponsorDashboard.jsx - Dispute Resolution
frontend/src/features/disputes/DisputeResolutionPage.jsx
Identity and API
- FastAPI App
backend/app/main.py - Authentication Routes
backend/app/routes/auth.py
Credit Decisioning
- Scoring Routes
backend/app/routes/score.py - Hybrid Score Engine
backend/app/ml/hybrid_engine.py - Score Explanation
ml_pipeline/rag_engine.py - Decision and Audit Records
Financial Intelligence
- Financial Intelligence
backend/app/services/financial_intelligence.py - User Routes
backend/app/routes/users.py
Policy Assistant
- RAG Chat Widget
frontend/src/components/chat/RAGChatWidget.tsx - Chat Routes
backend/app/routes/chat.py - Query Rewriter
backend/app/pipeline/query_rewriter.py - Chat Context Services
backend/app/services/context_assembler.py - Policy Chunk Store
- Policy Ingestion
backend/app/knowledge_ingester.py - Admin Upload Routes
backend/app/routes/admin.py
Other components
- Applicant
- Sponsor / Admin
- LLM Provider
- Supabase
Connections 28
- Applicant → Web App: uses portal
- Sponsor / Admin → Web App: uses portal
- Web App → Portal Routes: renders routes
- Portal Routes → User Dashboard: routes to
- Portal Routes → Score Simulator: routes to
- Portal Routes → Dispute Resolution: routes to
- Portal Routes → Sponsor Dashboard: routes to
- Web App → FastAPI App: API requests
- FastAPI App → Authentication Routes: registers router
- FastAPI App → Scoring Routes: registers router
- FastAPI App → User Routes: registers router
- FastAPI App → Chat Routes: registers router
- FastAPI App → Admin Upload Routes: registers router
- Scoring Routes → Hybrid Score Engine: assessment call
- Hybrid Score Engine → Score Explanation: requests narrative
- Score Explanation → LLM Provider: generates explanation
- Hybrid Score Engine → Decision and Audit Records: writes decisions
- Hybrid Score Engine → Supabase: persists records
- User Dashboard → User Routes: requests profile
- User Routes → Financial Intelligence: gets insights
- RAG Chat Widget → Chat Routes: sends turns
- Chat Routes → Query Rewriter: rewrites follow-ups
- Chat Routes → Chat Context Services: assembles context
- Chat Routes → Policy Chunk Store: hybrid search
- Chat Routes → LLM Provider: generates answer
- Admin Upload Routes → Policy Ingestion: starts ingestion
- Policy Ingestion → Policy Chunk Store: embeds and stores
- Policy Ingestion → LLM Provider: generates retrieval text