How lilwndrr/personal-ai-accountant works
This appears to be a Telegram-based personal-finance application: users submit transaction documents, review parsed transactions, categorize them, and request reports. The tree identifies parsing, deduplication, categorization, bot state handling, and persistence components, but no README or runtime source excerpts establish how they connect. Dashed, uncited edges below represent the workflow implied by component names; the exact runtime wiring remains unverified.
Main entry points: UploadWorkFlowService.java Upload workflow · CategorizationService.java Categorization · EventsListener.java Message events · TransactionRepository.java Transactions
Components 20
Telegram bot
- Bot runtime
src/main/java/com/example/springaitest/bot/MainBot.java - Message events
src/main/java/com/example/springaitest/bot/events/EventsListener.java - Conversation states
src/main/java/com/example/springaitest/bot/state - Upload workflow
src/main/java/com/example/springaitest/bot/service/UploadWorkFlowService.java - Telegram files
src/main/java/com/example/springaitest/bot/service/TelegramFileService.java - Review callbacks
src/main/java/com/example/springaitest/bot/service/CallbackHandlerService.java - User sessions
src/main/java/com/example/springaitest/bot/model/UserSessionService.java - Reports
src/main/java/com/example/springaitest/bot/service/ReportService.java - Bot commands
src/main/java/com/example/springaitest/bot/commands
Transaction processing
- Document parser
src/main/java/com/example/springaitest/api/config/service/DocumentParserService.java - Transaction deduplication
src/main/java/com/example/springaitest/api/config/service/TransactionDeduplicationService.java - Categorization
src/main/java/com/example/springaitest/api/config/service/CategorizationService.java
Finance data
- Transactions
src/main/java/com/example/springaitest/api/config/Repository/TransactionRepository.java - Categories
src/main/java/com/example/springaitest/api/config/Repository/CategoryRepository.java - Merchant mappings
src/main/java/com/example/springaitest/api/config/Repository/MerchantMappingRepository.java
Application support
- Data seeder
src/main/java/com/example/springaitest/api/config/DataSeeder.java - Spring application
src/main/java/com/example/springaitest/SpringAiTestApplication.java
Other components
- Telegram user
- Telegram
- Ollama model
Connections 18
- Telegram user → Telegram: sends documents
- Telegram → Message events: delivers messages
- Message events → Conversation states: dispatches input
- Conversation states → Upload workflow: starts upload
- Upload workflow → Telegram files: fetches files
- Upload workflow → Document parser: parses documents
- Upload workflow → Transaction deduplication: checks duplicates
- Upload workflow → Categorization: categorizes transactions
- Categorization → Ollama model: requests categorization
- Categorization → Categories: uses categories
- Categorization → Merchant mappings: uses mappings
- Upload workflow → Transactions: stores transactions
- Review callbacks → Transactions: updates transactions
- Message events → User sessions: tracks sessions
- Bot commands → Reports: requests reports
- Reports → Transactions: reads transactions
- Data seeder → Categories: seeds data
- Spring application → Bot runtime: initializes