How winlu2303/hackathon-max-2026 works
Дом в Порядке is a MAX chat bot for finding a building’s management company and managing emergency and repair requests. Residents register a role and address, select a matching company (or private-sector status), then submit requests, review their status, and close them. MAX webhooks pass through the Go gateway and NATS to Java’s dialog handler; Java also exposes REST endpoints and stores records in PostgreSQL, with Redis for dialog state. The README documents monthly reminders and contact lookup. Several links reflect documented architecture or SOURCE INDEX references; unsampled details are not inferred.
Main entry points: MessageHandler.java Dialog handler · main.go Go gateway · NatsListener.java NATS listener · MAXApiClient.java MAX API client
Components 19
Webhook ingress
- Go gateway
go-gateway/main.go - NATS events
- NATS listener
java-core/src/main/java/ru/domvporyadke/max/NatsListener.java
Bot dialogue
- Dialog handler
java-core/src/main/java/ru/domvporyadke/max/MessageHandler.java - Dialog state
java-core/src/main/java/ru/domvporyadke/max/FSMService.java - MAX API client
java-core/src/main/java/ru/domvporyadke/max/MAXApiClient.java - Company lookup
java-core/src/main/java/ru/domvporyadke/repository/ManagementCompanyRepository.java - MAX user profiles
java-core/src/main/java/ru/domvporyadke/service/MaxUserService.java - Monthly reminders
java-core/src/main/java/ru/domvporyadke/service/MonthlyPingService.java
Request management
- Emergency requests
java-core/src/main/java/ru/domvporyadke/service/EmergencyService.java - Repair requests
java-core/src/main/java/ru/domvporyadke/service/ServiceRequestService.java - Request REST API
java-core/src/main/java/ru/domvporyadke/web/ServiceRequestController.java - Emergency REST API
java-core/src/main/java/ru/domvporyadke/web/EmergencyController.java - Buildings REST API
java-core/src/main/java/ru/domvporyadke/web/BuildingsController.java
State and storage
- PostgreSQL
- Redis
Other components
- Resident
- MAX platform
- Cloudpub proxy
Connections 24
- Resident → MAX platform: sends chat
README.md - MAX platform → Cloudpub proxy: webhook
README.md - Cloudpub proxy → Go gateway: proxies webhook
README.md - Go gateway → NATS events: publishes events
README.md - Go gateway → NATS listener: HTTP requests
- NATS events → NATS listener: delivers events
README.md - NATS listener → Dialog handler: dispatches updates
java-core/src/main/java/ru/domvporyadke/max/NatsListener.java - Dialog handler → Dialog state: uses state
java-core/src/main/java/ru/domvporyadke/max/MessageHandler.java - Dialog handler → MAX API client: sends replies
java-core/src/main/java/ru/domvporyadke/max/MessageHandler.java - MAX API client → MAX platform: calls bot API
README.md - Dialog handler → Company lookup: searches companies
java-core/src/main/java/ru/domvporyadke/max/MessageHandler.java - Dialog handler → MAX user profiles: manages profiles
java-core/src/main/java/ru/domvporyadke/max/MessageHandler.java - Dialog handler → Emergency requests: creates and closes
java-core/src/main/java/ru/domvporyadke/max/MessageHandler.java - Dialog handler → Repair requests: creates and closes
java-core/src/main/java/ru/domvporyadke/max/MessageHandler.java - Emergency REST API → Emergency requests: routes requests
java-core/src/main/java/ru/domvporyadke/web/EmergencyController.java - Request REST API → Repair requests: routes requests
java-core/src/main/java/ru/domvporyadke/web/ServiceRequestController.java - Buildings REST API → Company lookup: looks up buildings
- Emergency requests → PostgreSQL: persists records
README.md - Repair requests → PostgreSQL: persists records
README.md - MAX user profiles → PostgreSQL: stores profiles
README.md - Company lookup → PostgreSQL: queries companies
README.md - Dialog state → Redis: stores dialogue state
README.md - Monthly reminders → PostgreSQL: reads and updates users
java-core/src/main/java/ru/domvporyadke/service/MonthlyPingService.java - Monthly reminders → MAX API client: sends reminders
java-core/src/main/java/ru/domvporyadke/service/MonthlyPingService.java