How micode-ai/accounting-ai-agent works
Accounting AI Agent is a web-based bookkeeping and financial-reporting product. Users enter through the Next.js application, authenticate against the REST API, and use AI chat or accounting features such as dashboards, HR records, and KSeF invoice operations. The backend separates HTTP handling from domain services and connects to PostgreSQL, Redis, wFirma, and AI services. The graph emphasizes documented capabilities and relationships visible in the supplied excerpts or SOURCE INDEX; unsampled subsystem internals are represented at their listed paths, without inferring unshown calls.
Main entry points: ai-chat.service.ts AI chat service · prisma.ts PostgreSQL · auth.service.ts Authentication · auth.middleware.ts Auth middleware
Components 21
Web application
- Next.js application
packages/web/src/app - Chat interface
packages/web/src/components/chat/ChatContainer.tsx - KSeF interface
packages/web/src/components/ksef/KSeFContractorManager.tsx
API and identity
- REST API
packages/api/src/index.ts - Authentication
packages/api/src/services/auth.service.ts - Auth middleware
packages/api/src/middleware/auth.middleware.ts - Chat endpoints
packages/api/src/controllers/ai-chat.controller.ts
Accounting domains
- KSeF operations
packages/api/src/services/ksef/ksef.service.ts - HR management
packages/api/src/services/hr/hr.service.ts - Business dashboard
packages/api/src/services/dashboard/dashboard.service.ts - wFirma accounting
packages/api/src/services/wfirma/invoice.service.ts
AI and messaging
- AI chat service
packages/api/src/services/ai-chat/ai-chat.service.ts - Agent runner
packages/api/src/services/ai-chat/langgraph-agent-runner.ts - AI memory
packages/api/src/services/ai-memory/ai-memory.service.ts - Telegram bot
packages/api/src/services/telegram-bot/telegram-bot.service.ts
Data and integrations
- PostgreSQL
packages/api/src/lib/prisma.ts - Redis
packages/api/src/lib/redis.ts
Other components
- End user
- External AI provider
- National KSeF service
- wFirma service
Connections 19
- End user → Next.js application: uses
README.md - Next.js application → REST API: calls REST API
README.md - Chat interface → Chat endpoints: sends chat requests
- KSeF interface → REST API: uses KSeF API
- REST API → Auth middleware: protects routes
- Auth middleware → Authentication: verifies tokens
packages/api/src/middleware/auth.middleware.ts - Auth middleware → PostgreSQL: loads user
packages/api/src/middleware/auth.middleware.ts - Authentication → PostgreSQL: persists accounts
packages/api/src/services/auth.service.ts - Authentication → Redis: checks tokens
packages/api/src/services/auth.service.ts - Chat endpoints → AI chat service: handles messages
packages/api/src/controllers/ai-chat.controller.ts - AI chat service → Agent runner: runs agent
packages/api/src/services/ai-chat/ai-chat.service.ts - AI chat service → AI memory: extracts memory
packages/api/src/services/ai-chat/ai-chat.service.ts - AI chat service → External AI provider: uses AI models
README.md - Telegram bot → AI chat service: routes chat
packages/api/src/services/telegram-bot/telegram-bot.service.ts - KSeF operations → National KSeF service: exchanges invoices
- HR management → PostgreSQL: stores HR records
- Business dashboard → PostgreSQL: reads business data
- wFirma accounting → wFirma service: manages invoices
- KSeF interface → KSeF operations: manages contractors