How kekborkek/max_buisnes_bot works
This MAX bot and mini-app help individual entrepreneurs understand and track tax, contribution, and reporting deadlines, alongside personal tasks. The main journey is profile questions → a tailored calendar → reminders and guidance → completion tracking; the mini-app provides list, month, detail, settings, task, sharing, and iCalendar views. The README documents the broad workflow and runtime layout; source excerpts and the index support selected internal links. Some endpoint and handler details are unsampled, so those links are omitted or grounded in README statements.
Main entry points: handlers Bot handlers · build.py Calendar assembly · screens Mini-app screens · routes.py HTTP API
Components 22
MAX bot
- Bot routing
backend/app/bot/router.py - Bot handlers
backend/app/bot/handlers - Dialog context
backend/app/bot/context.py - Task parsing
backend/app/bot/dateparse.py
Calendar services
- Calendar assembly
backend/app/calendar/build.py - Deadline catalog
backend/app/calendar/loader.py - Date rules
backend/app/calendar/dates.py - Reminder scheduling
backend/app/calendar/reminders.py - Weekly digest
backend/app/calendar/digest.py
API and state
- HTTP API
backend/app/api/routes.py - Calendar API service
backend/app/api/service.py - iCalendar feeds
backend/app/api/ics.py - Task endpoints
backend/app/api/tasks.py - Application database
backend/app/core/db.py - MAX client
backend/app/core/max_client.py
Mini-app
- Mini-app screens
miniapp/src/screens - Data source
miniapp/src/data/source.ts - API client
miniapp/src/data/http.ts - MAX bridge
miniapp/src/bridge.ts - Screen navigation
miniapp/src/router.tsx
Other components
- Entrepreneur
- MAX Bot API
Connections 24
- Entrepreneur → MAX Bot API: sends messages
README.md - MAX Bot API → Bot routing: webhook updates
README.md - Bot routing → Bot handlers: dispatches to
backend/app/bot/router.py - Bot handlers → Dialog context: uses dialog
backend/app/bot/handlers/service.py - Bot handlers → Task parsing: parses task text
- Bot handlers → Calendar assembly: requests calendar
README.md - Calendar assembly → Deadline catalog: loads obligations
backend/app/calendar/loader.py - Calendar assembly → Date rules: applies date rules
- Calendar assembly → Application database: stores calendar
README.md - Reminder scheduling → Application database: reads and records
backend/app/calendar/reminders.py - Reminder scheduling → MAX client: sends reminders
backend/app/calendar/reminders.py - Weekly digest → MAX client: sends digest
backend/app/calendar/digest.py - HTTP API → Calendar API service: uses calendar service
backend/app/api/routes.py - HTTP API → Task endpoints: routes task requests
backend/app/api/routes.py - HTTP API → iCalendar feeds: routes feed requests
backend/app/api/routes.py - Calendar API service → Application database: reads event state
backend/app/api/service.py - Task endpoints → Application database: reads and writes tasks
backend/app/api/tasks.py - Entrepreneur → Mini-app screens: opens mini-app
README.md - Mini-app screens → Screen navigation: navigates screens
miniapp/src/App.tsx - Mini-app screens → Data source: requests data
miniapp/src/App.tsx - Data source → API client: selects API source
miniapp/src/data/source.ts - API client → HTTP API: calls API
miniapp/src/data/http.ts - API client → MAX bridge: gets MAX launch data
miniapp/src/data/http.ts - Mini-app screens → iCalendar feeds: requests calendar feed