How mwasobaddy/invoice_app works
Invoice Atlas is a workspace-based invoice and budget management application. A user signs in, manages clients and invoices, records expenses against budgets, and reviews dashboard analytics; the API routes persist those records and expose exports and document generation. Authentication, validation, audit logging, and Prisma form the internal service layer. The README documents major product capabilities and endpoints; source excerpts confirm selected route-to-service and service-to-store calls, while several listed subsystems were not sampled in source.
Main entry points: prisma.ts Prisma data access · expenses/route.ts Expense API · invoices/route.ts Invoice API · auth-utils.ts Auth helpers
Components 25
Identity and workspaces
- Sign-in and signup
src/app/auth/signin/page.tsx - Authentication API
src/app/api/auth/register/route.ts - Auth provider
src/lib/auth.ts - Workspace management
src/app/api/orgs/route.ts
Invoices and spending
- Client management
src/app/api/clients/route.ts - Invoice workspace
src/app/dashboard/invoices/page.tsx - Invoice API
src/app/api/invoices/route.ts - Invoice documents and export
src/app/api/invoices - Budget workspace
src/app/dashboard/budgets/page.tsx - Budget API
src/app/api/budgets/route.ts - Expense workspace
src/app/dashboard/expenses/page.tsx - Expense API
src/app/api/expenses/route.ts
Dashboard and analytics
- Dashboard pages
src/app/dashboard/page.tsx - Dashboard analytics
src/app/api/dashboard/chart-data/route.ts - Chart client
src/components/ChartClient.tsx
Application services
- Auth helpers
src/lib/auth-utils.ts - Request validation
src/lib/schemas.ts - Audit logging
src/lib/audit.ts - Prisma data access
src/lib/prisma.ts - PostgreSQL
Automation and integrations
- Receipt parsing
src/app/api/ai/parse-receipt/route.ts - Receipt upload
src/app/api/expenses/upload/route.ts - Scheduled tasks
src/app/api/crons - Webhook endpoint
src/app/api/webhooks/route.ts
Other components
- User
Connections 37
- User → Sign-in and signup: signs in
- Sign-in and signup → Authentication API: registers
- Authentication API → Auth helpers: uses auth helpers
src/app/api/auth/register/route.ts - Auth provider → Prisma data access: reads users
src/lib/auth.ts - Auth provider → Auth helpers: provides sessions
src/lib/auth-utils.ts - User → Workspace management: manages workspaces
- Workspace management → Prisma data access: reads and writes
src/app/api/orgs/route.ts - Workspace management → Audit logging: logs changes
src/app/api/orgs/route.ts - User → Client management: manages clients
- User → Invoice workspace: creates invoices
- Invoice workspace → Invoice API: uses endpoints
- Invoice API → Auth helpers: requires authentication
src/app/api/invoices/route.ts - Invoice API → Request validation: validates input
src/app/api/invoices/route.ts - Invoice API → Prisma data access: reads and writes
src/app/api/invoices/route.ts - Invoice API → Audit logging: logs changes
src/app/api/invoices/route.ts - Invoice workspace → Invoice documents and export: exports and renders
- User → Budget workspace: sets budgets
- Budget workspace → Budget API: uses endpoints
- Budget API → Request validation: validates input
src/app/api/budgets/route.ts - Budget API → Prisma data access: reads and writes
src/app/api/budgets/route.ts - User → Expense workspace: records expenses
- Expense workspace → Expense API: uses endpoints
- Expense API → Request validation: validates input
src/app/api/expenses/route.ts - Expense API → Prisma data access: records spending
src/app/api/expenses/route.ts - Expense API → Audit logging: logs changes
src/app/api/expenses/route.ts - Expense API → Budget API: updates budget totals
src/app/api/expenses/route.ts - User → Dashboard pages: reviews metrics
- Dashboard pages → Dashboard analytics: loads chart data
- Chart client → Dashboard analytics: requests chart data
- Dashboard analytics → Auth helpers: requires authentication
src/app/api/dashboard/chart-data/route.ts - Dashboard analytics → Prisma data access: queries analytics
src/app/api/dashboard/chart-data/route.ts - Receipt parsing → Auth helpers: checks access
src/app/api/ai/parse-receipt/route.ts - Receipt parsing → Prisma data access: uses stored settings
src/app/api/ai/parse-receipt/route.ts - Receipt upload → Expense API: attaches receipts
- Scheduled tasks → Prisma data access: updates records
src/app/api/crons/recurring/route.ts - Webhook endpoint → Prisma data access: records events
src/app/api/webhooks/route.ts - Prisma data access → PostgreSQL: queries
src/lib/prisma.ts