How davguzm20/axionlabs works
KhipuBot is a personal-finance web app and AI-assisted messaging bot for recording finances through text, voice and images. In the web workflow, a user signs in, enters the chat, and sends transaction input; backend transaction logic extracts and validates it, assigns a category and persists the transaction while updating the wallet balance. The app also exposes classification, history, wallets, budgets, settings and notifications. Edges below are limited to relationships shown in excerpts, the source index or README; unsampled feature wiring is not assumed.
Main entry points: router.tsx Route map · api.ts API client · service.py Transaction workflow · ChatPage.tsx Finance chat
Components 25
Web app
- App provider
Desarrollo/KPB/Implementacion/Frontend/src/App.tsx - Route map
Desarrollo/KPB/Implementacion/Frontend/src/app/router.tsx - Wallet management
Desarrollo/KPB/Implementacion/Frontend/src/features/wallets - Budgets
Desarrollo/KPB/Implementacion/Frontend/src/features/budgets - Notifications
Desarrollo/KPB/Implementacion/Frontend/src/features/notifications - Settings
Desarrollo/KPB/Implementacion/Frontend/src/features/settings/pages/SettingsPage.tsx
Transactions
- Finance chat
Desarrollo/KPB/Implementacion/Frontend/src/features/chat/ChatPage.tsx - Voice and receipts
Desarrollo/KPB/Implementacion/Frontend/src/features/chat - Classification
Desarrollo/KPB/Implementacion/Frontend/src/features/classification/pages/ClassificationPage.tsx - Transaction history
Desarrollo/KPB/Implementacion/Frontend/src/features/history/pages/HistoryPage.tsx - Transaction routes
Desarrollo/KPB/Implementacion/Backend/app/modules/transactions/router.py - Transaction workflow
Desarrollo/KPB/Implementacion/Backend/app/modules/transactions/service.py - AI extractor
Desarrollo/KPB/Implementacion/Backend/app/integrations/ai/extractor.py - Transaction repository
Desarrollo/KPB/Implementacion/Backend/app/modules/transactions/repository.py
Identity
- Sign-in
Desarrollo/KPB/Implementacion/Frontend/src/features/auth/LoginPage.tsx - Auth routes
Desarrollo/KPB/Implementacion/Backend/app/modules/auth/router.py - Auth service
Desarrollo/KPB/Implementacion/Backend/app/modules/auth/service.py - Token security
Desarrollo/KPB/Implementacion/Backend/app/core/security.py - Sessions and lockout
Desarrollo/KPB/Implementacion/Backend/app/integrations/redis/sessions.py
Data and integrations
- API client
Desarrollo/KPB/Implementacion/Frontend/src/lib/api.ts - API application
Desarrollo/KPB/Implementacion/Backend/app/main.py - Finance entities
Desarrollo/KPB/Implementacion/Backend/app/entities.py - PostgreSQL access
Desarrollo/KPB/Implementacion/Backend/app/database.py - Redis
Other components
- User
Connections 30
- User → Route map: opens
Desarrollo/KPB/Implementacion/Frontend/src/app/router.tsx - App provider → Route map: renders
Desarrollo/KPB/Implementacion/Frontend/src/App.tsx - Route map → Sign-in: routes to
Desarrollo/KPB/Implementacion/Frontend/src/app/router.tsx - Route map → Finance chat: routes to
Desarrollo/KPB/Implementacion/Frontend/src/app/router.tsx - Route map → Classification: routes to
Desarrollo/KPB/Implementacion/Frontend/src/app/router.tsx - Route map → Transaction history: routes to
Desarrollo/KPB/Implementacion/Frontend/src/app/router.tsx - Route map → Wallet management: routes to
Desarrollo/KPB/Implementacion/Frontend/src/app/router.tsx - Route map → Budgets: routes to
Desarrollo/KPB/Implementacion/Frontend/src/app/router.tsx - Route map → Notifications: routes to
Desarrollo/KPB/Implementacion/Frontend/src/app/router.tsx - Route map → Settings: routes to
Desarrollo/KPB/Implementacion/Frontend/src/app/router.tsx - Finance chat → Voice and receipts: uses
- Finance chat → API client: submits
- Classification → API client: requests
- Transaction history → API client: requests
- Wallet management → API client: requests
Desarrollo/KPB/Implementacion/Frontend/src/features/wallets/services/walletService.ts - Budgets → API client: requests
Desarrollo/KPB/Implementacion/Frontend/src/features/budgets/services/budgetService.ts - Notifications → API client: requests
Desarrollo/KPB/Implementacion/Frontend/src/features/notifications/services/notificationService.ts - API client → API application: HTTP requests
- API application → Auth routes: registers
Desarrollo/KPB/Implementacion/Backend/app/main.py - API application → Transaction routes: registers
Desarrollo/KPB/Implementacion/Backend/app/main.py - Auth routes → Auth service: delegates to
Desarrollo/KPB/Implementacion/Backend/app/modules/auth/router.py - Auth service → Token security: uses
Desarrollo/KPB/Implementacion/Backend/app/modules/auth/service.py - Auth service → Sessions and lockout: manages sessions
Desarrollo/KPB/Implementacion/Backend/app/modules/auth/service.py - Sessions and lockout → Redis: reads and writes
Desarrollo/KPB/Implementacion/Backend/app/integrations/redis/sessions.py - Transaction routes → Transaction workflow: delegates to
Desarrollo/KPB/Implementacion/Backend/app/modules/transactions/router.py - Transaction workflow → AI extractor: extracts input
Desarrollo/KPB/Implementacion/Backend/app/modules/transactions/service.py - Transaction workflow → Transaction repository: reads and persists
Desarrollo/KPB/Implementacion/Backend/app/modules/transactions/service.py - Transaction workflow → Finance entities: creates transaction
Desarrollo/KPB/Implementacion/Backend/app/modules/transactions/service.py - Transaction repository → Finance entities: uses entities
Desarrollo/KPB/Implementacion/Backend/app/modules/transactions/repository.py - Transaction routes → PostgreSQL access: gets database session
Desarrollo/KPB/Implementacion/Backend/app/modules/transactions/router.py