How loluwafemi/fintrack works
FinanceTracker is a personal and organization finance-tracking product, with a separate Admin mobile app. The main user workflow covers account access, recording or uploading spending, reviewing transactions and budgets, and generating reports; the Admin app supports oversight and account management. The README documents receipt scanning, exports, and weekly tracking, while the tree shows dedicated backend service routes and a FastAPI receipt-processing service. Client request excerpts establish calls to the SvelteKit API; unsampled screen-to-request wiring and any connection to FastAPI are not inferred.
Main entry points: server.tsx Figtrack API client · index.server.ts Request authenticator · server.ts Admin API client · +server.ts Report endpoint
Components 23
Mobile clients
- Figtrack screens
app/figtrack/app - Figtrack API client
app/figtrack/lib/server/server.tsx - Admin screens
app/Admin/app - Admin API client
app/Admin/lib/server/server.ts
Application API
- Authentication API
app/backends/sveltekit/src/routes/api/auth - Admin signup API
app/backends/sveltekit/src/routes/api/secure/signup/+server.ts - Organization API
app/backends/sveltekit/src/routes/api/secure/+server.ts - Service API
app/backends/sveltekit/src/routes/api/service - Budget operations
app/backends/sveltekit/src/routes/api/secure/actions/managebudget/+server.ts - Transaction routes
app/backends/sveltekit/src/routes/api/secure/transactions/+server.ts - Receipt upload
app/backends/sveltekit/src/routes/api/service/upload/+server.ts - Receipt scanner
app/backends/sveltekit/src/routes/api/service/scanner/+server.ts - Report endpoint
app/backends/sveltekit/src/routes/api/service/report_generator/+server.ts
Finance services
- Request authenticator
app/backends/sveltekit/src/lib/index.server.ts - User operations
app/backends/sveltekit/src/lib/server/models/user.ts - Admin operations
app/backends/sveltekit/src/lib/server/models/admin.ts - Budget operations
app/backends/sveltekit/src/lib/server/models/budget.ts - Transaction operations
app/backends/sveltekit/src/lib/server/models/transaction.ts
Persistence and processing
- Report generation
app/backends/sveltekit/src/lib/gen/processor.ts - Application database
app/backends/sveltekit/src/lib/server/db/index.ts - Receipt processing
app/backends/fastapi/app/main.py
Other components
- Finance user
- Admin user
Connections 32
- Finance user → Figtrack screens: uses
- Figtrack screens → Figtrack API client: requests
- Figtrack API client → Authentication API: authenticates
- Figtrack API client → Budget operations: manages budgets
- Figtrack API client → Transaction routes: requests records
- Figtrack API client → Receipt upload: uploads receipts
- Figtrack API client → Receipt scanner: requests scanning
- Figtrack API client → Report endpoint: requests reports
- Admin user → Admin screens: uses
- Admin screens → Admin API client: requests
- Admin API client → Authentication API: authenticates
- Admin API client → Organization API: requests organization data
- Admin API client → Admin signup API: registers admins
- Authentication API → Request authenticator: checks sessions
- Authentication API → User operations: manages accounts
- Admin signup API → Request authenticator: checks requests
- Admin signup API → User operations: creates admin
- Organization API → Request authenticator: checks requests
- Organization API → Admin operations: loads organization accounts
- Budget operations → Request authenticator: checks requests
- Budget operations → Budget operations: updates budgets
- Transaction routes → Request authenticator: checks requests
- Transaction routes → Transaction operations: handles transactions
- Receipt upload → Request authenticator: checks requests
- Receipt scanner → Request authenticator: checks requests
- Report endpoint → Request authenticator: checks requests
- Report endpoint → User operations: loads budget data
- Report endpoint → Report generation: generates report
- User operations → Application database: reads and writes
- Admin operations → Application database: reads and writes
- Budget operations → Application database: reads and writes
- Transaction operations → Application database: reads and writes