How h3d1/finlens works
FinLens is a locally runnable personal-finance dashboard, not a bank-connected product. Users sign in to obtain a JWT, then the dashboard fetches accounts, spending insights, and anomaly flags; the two analysis services retrieve account data from the aggregation API. The graph preserves the documented rule-based insight stages and PostgreSQL persistence. Several service details are documented but not sampled, so their edges rely on the README rather than implying source inspection.
Main entry points: AccountController.java Account API · client.ts API client · main.py Fraud endpoint · AuthController.java Authentication
Components 19
Dashboard
- Dashboard UI
frontend/src/pages/DashboardPage.tsx - Auth UI
frontend/src/auth/AuthContext.tsx - API client
frontend/src/api/client.ts - Auth routes
frontend/src/App.tsx
Aggregation API
- Authentication
aggregation-service/src/main/java/com/finlens/aggregation/api/AuthController.java - JWT tokens
aggregation-service/src/main/java/com/finlens/aggregation/security/JwtService.java - JWT filter
aggregation-service/src/main/java/com/finlens/aggregation/security/JwtAuthenticationFilter.java - Account API
aggregation-service/src/main/java/com/finlens/aggregation/api/AccountController.java
Financial Analysis
- Fraud endpoint
fraud-service/app/main.py - Velocity rule
fraud-service/app/fraud.py - Fraud schemas
fraud-service/app/models.py - Insights service
insights-service/app - Insight analysis
insights-service/app/insights.py - Insight schemas
insights-service/app/models.py
Persistence
- Account data
aggregation-service/src/main/java/com/finlens/aggregation/model/Account.java - Transaction data
aggregation-service/src/main/java/com/finlens/aggregation/model/Transaction.java - User data
aggregation-service/src/main/java/com/finlens/aggregation/model/User.java - PostgreSQL
Other components
- User
Connections 23
- User → Dashboard UI: uses
README.md - Dashboard UI → API client: requests data
frontend/src/pages/DashboardPage.tsx - Auth routes → Auth UI: routes to
frontend/src/App.tsx - Auth routes → Dashboard UI: protects route
frontend/src/App.tsx - Auth UI → Authentication: login request
README.md - Authentication → JWT tokens: issues token
aggregation-service/src/main/java/com/finlens/aggregation/api/AuthController.java - Authentication → User data: reads and saves
aggregation-service/src/main/java/com/finlens/aggregation/api/AuthController.java - JWT filter → JWT tokens: validates token
aggregation-service/src/main/java/com/finlens/aggregation/security/JwtAuthenticationFilter.java - API client → Account API: fetches accounts
README.md - API client → Insights service: requests insights
frontend/src/api/client.ts - API client → Fraud endpoint: requests flags
frontend/src/api/client.ts - Account API → Account data: reads accounts
aggregation-service/src/main/java/com/finlens/aggregation/api/AccountController.java - Account API → Transaction data: reads transactions
aggregation-service/src/main/java/com/finlens/aggregation/api/AccountController.java - Account data → PostgreSQL: persists
README.md - Transaction data → PostgreSQL: persists
README.md - User data → PostgreSQL: persists
README.md - Fraud endpoint → Account API: fetches data
fraud-service/app/main.py - Fraud endpoint → Fraud schemas: parses response
fraud-service/app/main.py - Fraud endpoint → Velocity rule: runs check
fraud-service/app/main.py - Velocity rule → Fraud schemas: evaluates records
fraud-service/app/fraud.py - Insights service → Account API: fetches data
README.md - Insights service → Insight analysis: analyzes records
README.md - Insight analysis → Insight schemas: returns observations
README.md