How w1ztechsolutions/walletwise works
WalletWise is a personal-finance application for managing transactions, accounts, budgets, categories, and analytics, with spreadsheet import and receipt storage. The main workflow is sign in, navigate a finance view, load or change data through query hooks and the API, then persist it in the edge-backed database. The graph also includes profile and account recovery, authentication, and import review. Several backend routes are represented from the file tree and SOURCE INDEX; their internal behavior is not claimed beyond the shown references.
Main entry points: hooks Finance data hooks · App.tsx Application shell · SpreadsheetImport.tsx Spreadsheet import · AuthGate.tsx Authentication gate
Components 30
Finance client
- Application shell
src/App.tsx - Authentication gate
src/components/auth/AuthGate.tsx - Sign-in view
src/components/auth/AuthView.tsx - Dashboard
src/components/dashboard/DashboardView.tsx - Transactions
src/components/transactions/TransactionsView.tsx - Accounts
src/components/accounts/AccountsView.tsx - Budgets
src/components/budgets/BudgetsView.tsx - Analytics
src/components/analytics/AnalyticsView.tsx - Settings and recovery
src/components/settings/SettingsView.tsx - Spreadsheet import
src/components/import/SpreadsheetImport.tsx - Import review
src/components/settings/ImportReviewModal.tsx
Client data layer
- Session state
src/hooks/useSession.ts - Finance data hooks
src/hooks - Bulk import hook
src/hooks/useBulkImport.ts - User profile hook
src/hooks/useUser.ts - API client
src/lib/api.ts - Auth client
src/lib/auth-client.ts - Spreadsheet parser
src/lib/importParser.ts
Edge services
- Finance API routes
functions/api - Import API
functions/api/import/index.ts - Analytics API
functions/api/analytics/index.ts - Authentication route
functions/api/auth/[[all]].ts - AI spreadsheet parsing
functions/api/ai/parse-spreadsheet.ts - Storage routes
functions/api/storage - Request middleware
functions/_middleware.ts - Account purge worker
workers/account-purge.ts
Persistence and storage
- Finance and auth schema
src/db/schema.ts - Upload policies
src/lib/storagePolicy.ts - Object storage
Other components
- Finance user
Connections 39
- Finance user → Authentication gate: opens app
- Application shell → Authentication gate: gates content
src/App.tsx - Application shell → Dashboard: routes to
src/App.tsx - Application shell → Transactions: routes to
src/App.tsx - Application shell → Accounts: routes to
src/App.tsx - Application shell → Budgets: routes to
src/App.tsx - Application shell → Analytics: routes to
src/App.tsx - Application shell → Settings and recovery: routes to
src/App.tsx - Authentication gate → Sign-in view: shows sign-in
src/components/auth/AuthGate.tsx - Authentication gate → Session state: checks session
src/components/auth/AuthGate.tsx - Session state → Auth client: gets session
src/hooks/useSession.ts - Sign-in view → Auth client: uses auth
src/components/auth/AuthView.tsx - Transactions → Finance data hooks: uses data hooks
src/components/transactions/TransactionsView.tsx - Accounts → Finance data hooks: uses account hooks
src/components/accounts/AccountsView.tsx - Analytics → Finance data hooks: loads analytics
src/components/analytics/AnalyticsView.tsx - Dashboard → Finance data hooks: loads summaries
src/components/dashboard/DashboardView.tsx - Budgets → Finance data hooks: uses budget hooks
src/components/budgets/BudgetsView.tsx - Settings and recovery → User profile hook: reads profile
- Finance data hooks → API client: requests data
src/hooks/useTransactions.ts - User profile hook → API client: requests profile
src/hooks/useUser.ts - API client → Finance API routes: sends API requests
src/lib/api.ts - Finance data hooks → Session state: keys by identity
src/hooks/useTransactions.ts - Finance data hooks → Transactions: invalidates related caches
src/hooks/useTransactions.ts - Spreadsheet import → Spreadsheet parser: parses file
src/components/import/SpreadsheetImport.tsx - Spreadsheet import → Import review: opens review
src/components/import/SpreadsheetImport.tsx - Spreadsheet import → Bulk import hook: previews and commits
src/components/import/SpreadsheetImport.tsx - Import review → Bulk import hook: submits decisions
src/components/settings/ImportReviewModal.tsx - Bulk import hook → API client: posts import
src/hooks/useBulkImport.ts - Bulk import hook → Import API: previews or commits
src/hooks/useBulkImport.ts - Import API → Finance and auth schema: references schema
functions/api/import/index.ts - Analytics API → Finance and auth schema: references schema
functions/api/analytics/index.ts - Finance API routes → Request middleware: requests pass through
- Request middleware → Auth client: uses auth
functions/_middleware.ts - Request middleware → Authentication route: protects data routes
- Upload policies → Spreadsheet import: validates uploads
src/components/import/SpreadsheetImport.tsx - Upload policies → Storage routes: server revalidates
src/lib/storagePolicy.ts - Storage routes → Object storage: stores objects
- AI spreadsheet parsing → Spreadsheet parser: may parse spreadsheets
- Account purge worker → Finance and auth schema: purges account data