How vizbapu/spendsense-ai works
SpendSense is an early-stage bank-statement categorizer and anomaly detector, but the sampled runtime currently implements CSV upload and transaction persistence, health checks, and a synthetic-data generator. The frontend is still the default Vite/React starter screen; no browser-to-API integration or categorization/anomaly runtime is shown. The Ollama integration is currently a health check, not a categorization call. Edges below reflect the sampled calls and README; unsampled planned capabilities are not represented as working components.
Main entry points: uploads.py Upload endpoints · health.py Health endpoint · ingest.py Transaction ingest · session.py DB sessions
Components 15
Web client
- React entry
frontend/src/main.tsx - Starter screen
frontend/src/App.tsx
API
- FastAPI app
backend/app/main.py - Upload endpoints
backend/app/api/uploads.py - Health endpoint
backend/app/api/health.py
Statement ingestion
- CSV validation
backend/app/services/csv_formats.py - Transaction ingest
backend/app/services/ingest.py - Merchant normalizer
backend/app/services/normalizer.py - Synthetic data generator
backend/scripts/generate_data.py
Persistence
- DB sessions
backend/app/db/session.py - Upload and transaction models
backend/app/db/models.py - PostgreSQL
Operations
- Settings
backend/app/config.py - Ollama service
Other components
- User
Connections 16
- React entry → Starter screen: renders
frontend/src/main.tsx - User → Upload endpoints: uploads CSV
backend/app/api/uploads.py - FastAPI app → Health endpoint: registers
backend/app/main.py - FastAPI app → Upload endpoints: registers
backend/app/main.py - Upload endpoints → CSV validation: parses CSV
backend/app/api/uploads.py - Upload endpoints → Transaction ingest: saves rows
backend/app/api/uploads.py - Upload endpoints → DB sessions: requests session
backend/app/api/uploads.py - Upload endpoints → Upload and transaction models: loads upload
backend/app/api/uploads.py - Transaction ingest → Merchant normalizer: normalizes merchants
backend/app/services/ingest.py - Transaction ingest → Upload and transaction models: creates records
backend/app/services/ingest.py - DB sessions → Settings: reads database URL
backend/app/db/session.py - DB sessions → PostgreSQL: connects
- Transaction ingest → PostgreSQL: writes transactions
- Health endpoint → DB sessions: checks database
backend/app/api/health.py - Health endpoint → Settings: reads settings
backend/app/api/health.py - Health endpoint → Ollama service: checks availability
backend/app/api/health.py