How rommerrro-gh/vega2124 works
Pulse Doma is a housing-service mini app and dispatcher workspace for reporting, grouping, tracking, and confirming repairs, with separate house administration and access-management capabilities. The principal workflow runs from a resident’s report through duplicate review and dispatcher handling to resident confirmation. The README also documents house passports, polls, contacts, invitations, attachments, and MAX integration. Some subsystem links rely on README statements or SOURCE INDEX references; unsampled implementation details are not inferred.
Main entry points: main.jsx Mini app · MiniAppService.java Issue workflow · SqliteDataSourceConfig.java SQLite data · HousesController.java House API
Components 24
User interfaces and API
- Mini app
frontend/src/main.jsx - Report API
api/src/main/java/ru/pulsedoma/api/ReportsController.java - Issue API
api/src/main/java/ru/pulsedoma/api/IssuesController.java - House API
api/src/main/java/ru/pulsedoma/api/HousesController.java - House admin API
api/src/main/java/ru/pulsedoma/api/HouseAdminController.java - Access API
api/src/main/java/ru/pulsedoma/api/AccessActivationController.java
Reports and issue handling
- Report intake
domain-issues/src/main/java/ru/pulsedoma/issues/ReportService.java - Duplicate search
domain-duplicates/src/main/java/ru/pulsedoma/duplicates/CandidateRetriever.java - Issue workflow
domain-issues/src/main/java/ru/pulsedoma/issues/MiniAppService.java - Attachments
domain-issues/src/main/java/ru/pulsedoma/issues/AttachmentService.java - Issue notifications
domain-issues/src/main/java/ru/pulsedoma/issues/IssueNotificationService.java
House services and access
- House administration
domain-house/src/main/java/ru/pulsedoma/house/HouseAdminService.java - House passport
domain-house/src/main/java/ru/pulsedoma/house/HousePassportService.java - House polls
domain-house/src/main/java/ru/pulsedoma/house/HousePollService.java - Access activation
domain-house/src/main/java/ru/pulsedoma/house/AccessActivationService.java - Guided demo
domain-house/src/main/java/ru/pulsedoma/house/GuidedDemoService.java
Runtime and integrations
- SQLite data
app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/SqliteDataSourceConfig.java - Attachment storage
app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/MinioAttachmentStore.java - MAX webhook worker
app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/MaxWebhookWorker.java - MAX API client
integration-max/src/main/java/ru/pulsedoma/max/MaxApiClient.java - Contract ticket adapter
integration-external/src/main/java/ru/pulsedoma/external/ContractTicketAdapter.java
Other components
- Resident
- Dispatcher
- MAX platform
Connections 30
- Resident → Mini app: uses
README.md - Dispatcher → Mini app: uses
README.md - Mini app → Report API: submits reports
README.md - Mini app → Issue API: tracks issues
README.md - Mini app → House API: views house data
README.md - Mini app → House admin API: manages house
README.md - Mini app → Access API: manages access
README.md - Report API → Report intake: creates reports
api/src/main/java/ru/pulsedoma/api/ReportsController.java - Report intake → Duplicate search: retrieves candidates
domain-issues/src/main/java/ru/pulsedoma/issues/ReportService.java - Duplicate search → SQLite data: searches issues
domain-duplicates/src/main/java/ru/pulsedoma/duplicates/CandidateRetriever.java - Report intake → SQLite data: stores reports
domain-issues/src/main/java/ru/pulsedoma/issues/ReportService.java - Issue API → Issue workflow: routes issue actions
api/src/main/java/ru/pulsedoma/api/IssuesController.java - Issue workflow → SQLite data: reads and updates
domain-issues/src/main/java/ru/pulsedoma/issues/MiniAppService.java - Issue workflow → Attachments: uses attachments
domain-issues/src/main/java/ru/pulsedoma/issues/MiniAppService.java - Issue workflow → Issue notifications: uses notifications
domain-issues/src/main/java/ru/pulsedoma/issues/MiniAppService.java - Attachments → Attachment storage: stores files
- Attachment storage → SQLite data: stores metadata
- House API → House passport: serves passport
api/src/main/java/ru/pulsedoma/api/HousesController.java - House API → House polls: serves polls
api/src/main/java/ru/pulsedoma/api/HousesController.java - House admin API → House administration: manages contacts
api/src/main/java/ru/pulsedoma/api/HouseAdminController.java - Access API → Access activation: manages invitations
api/src/main/java/ru/pulsedoma/api/AccessActivationController.java - Access activation → SQLite data: stores access state
domain-house/src/main/java/ru/pulsedoma/house/AccessActivationService.java - House administration → SQLite data: stores house data
- House polls → SQLite data: stores votes
domain-house/src/main/java/ru/pulsedoma/house/HousePollService.java - Dispatcher → Issue workflow: handles queue
README.md - Resident → Issue workflow: confirms work
README.md - Resident → Guided demo: starts demo
README.md - MAX platform → MAX webhook worker: sends updates
README.md - MAX webhook worker → MAX API client: uses client
app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/MaxWebhookWorker.java - Contract ticket adapter → Issue workflow: ticket integration