# rommerrro-gh/vega2124 architecture

> Architecture diagram of the GitHub repository rommerrro-gh/vega2124, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rommerrro-gh/vega2124
- Repository: https://github.com/rommerrro-gh/vega2124

## Overview

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: [`frontend/src/main.jsx`](https://github.com/rommerrro-gh/vega2124/blob/main/frontend/src/main.jsx) (Mini app), [`domain-issues/src/main/java/ru/pulsedoma/issues/MiniAppService.java`](https://github.com/rommerrro-gh/vega2124/blob/main/domain-issues/src/main/java/ru/pulsedoma/issues/MiniAppService.java) (Issue workflow), [`app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/SqliteDataSourceConfig.java`](https://github.com/rommerrro-gh/vega2124/blob/main/app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/SqliteDataSourceConfig.java) (SQLite data), [`api/src/main/java/ru/pulsedoma/api/HousesController.java`](https://github.com/rommerrro-gh/vega2124/blob/main/api/src/main/java/ru/pulsedoma/api/HousesController.java) (House API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User interfaces and API"]
  node_miniapp["Mini app<br/>[main.jsx]"]
  node_reports_api["Report API"]
  node_issues_api["Issue API"]
  node_house_api["House API"]
  node_admin_api["House admin API"]
  node_access_api["Access API"]
end

subgraph group_reports["Reports and issue handling"]
  node_report_service["Report intake<br/>[ReportService.java]"]
  node_duplicate_search["Duplicate search"]
  node_issue_service["Issue workflow"]
  node_attachments["Attachments"]
  node_notification["Issue notifications"]
end

subgraph group_houses["House services and access"]
  node_house_admin["House administration"]
  node_passport["House passport"]
  node_polls["House polls"]
  node_activation["Access activation"]
  node_guided_demo["Guided demo"]
end

subgraph group_runtime["Runtime and integrations"]
  node_database[("SQLite data")]
  node_attachment_store["Attachment storage"]
  node_max_webhook["MAX webhook worker"]
  node_max_api["MAX API client<br/>[MaxApiClient.java]"]
  node_ticket_adapter["Contract ticket adapter"]
end

node_resident(("Resident"))
node_dispatcher(("Dispatcher"))
node_max_service{{"MAX platform"}}

node_resident -->|"uses"| node_miniapp
node_dispatcher -->|"uses"| node_miniapp
node_miniapp -->|"submits reports"| node_reports_api
node_miniapp -->|"tracks issues"| node_issues_api
node_miniapp -->|"views house data"| node_house_api
node_miniapp -->|"manages house"| node_admin_api
node_miniapp -->|"manages access"| node_access_api
node_reports_api -->|"creates reports"| node_report_service
node_report_service -->|"retrieves candidates"| node_duplicate_search
node_duplicate_search -->|"searches issues"| node_database
node_report_service -->|"stores reports"| node_database
node_issues_api -->|"routes issue actions"| node_issue_service
node_issue_service -->|"reads and updates"| node_database
node_issue_service -->|"uses attachments"| node_attachments
node_issue_service -->|"uses notifications"| node_notification
node_attachments -.->|"stores files"| node_attachment_store
node_attachment_store -.->|"stores metadata"| node_database
node_house_api -->|"serves passport"| node_passport
node_house_api -->|"serves polls"| node_polls
node_admin_api -->|"manages contacts"| node_house_admin
node_access_api -->|"manages invitations"| node_activation
node_activation -->|"stores access state"| node_database
node_house_admin -.->|"stores house data"| node_database
node_polls -->|"stores votes"| node_database
node_dispatcher -->|"handles queue"| node_issue_service
node_resident -->|"confirms work"| node_issue_service
node_resident -->|"starts demo"| node_guided_demo
node_max_service -->|"sends updates"| node_max_webhook
node_max_webhook -->|"uses client"| node_max_api
node_ticket_adapter -.->|"ticket integration"| node_issue_service

click node_miniapp "https://github.com/rommerrro-gh/vega2124/blob/main/frontend/src/main.jsx"
click node_reports_api "https://github.com/rommerrro-gh/vega2124/blob/main/api/src/main/java/ru/pulsedoma/api/ReportsController.java"
click node_issues_api "https://github.com/rommerrro-gh/vega2124/blob/main/api/src/main/java/ru/pulsedoma/api/IssuesController.java"
click node_house_api "https://github.com/rommerrro-gh/vega2124/blob/main/api/src/main/java/ru/pulsedoma/api/HousesController.java"
click node_admin_api "https://github.com/rommerrro-gh/vega2124/blob/main/api/src/main/java/ru/pulsedoma/api/HouseAdminController.java"
click node_access_api "https://github.com/rommerrro-gh/vega2124/blob/main/api/src/main/java/ru/pulsedoma/api/AccessActivationController.java"
click node_report_service "https://github.com/rommerrro-gh/vega2124/blob/main/domain-issues/src/main/java/ru/pulsedoma/issues/ReportService.java"
click node_duplicate_search "https://github.com/rommerrro-gh/vega2124/blob/main/domain-duplicates/src/main/java/ru/pulsedoma/duplicates/CandidateRetriever.java"
click node_issue_service "https://github.com/rommerrro-gh/vega2124/blob/main/domain-issues/src/main/java/ru/pulsedoma/issues/MiniAppService.java"
click node_attachments "https://github.com/rommerrro-gh/vega2124/blob/main/domain-issues/src/main/java/ru/pulsedoma/issues/AttachmentService.java"
click node_notification "https://github.com/rommerrro-gh/vega2124/blob/main/domain-issues/src/main/java/ru/pulsedoma/issues/IssueNotificationService.java"
click node_house_admin "https://github.com/rommerrro-gh/vega2124/blob/main/domain-house/src/main/java/ru/pulsedoma/house/HouseAdminService.java"
click node_passport "https://github.com/rommerrro-gh/vega2124/blob/main/domain-house/src/main/java/ru/pulsedoma/house/HousePassportService.java"
click node_polls "https://github.com/rommerrro-gh/vega2124/blob/main/domain-house/src/main/java/ru/pulsedoma/house/HousePollService.java"
click node_activation "https://github.com/rommerrro-gh/vega2124/blob/main/domain-house/src/main/java/ru/pulsedoma/house/AccessActivationService.java"
click node_guided_demo "https://github.com/rommerrro-gh/vega2124/blob/main/domain-house/src/main/java/ru/pulsedoma/house/GuidedDemoService.java"
click node_database "https://github.com/rommerrro-gh/vega2124/blob/main/app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/SqliteDataSourceConfig.java"
click node_attachment_store "https://github.com/rommerrro-gh/vega2124/blob/main/app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/MinioAttachmentStore.java"
click node_max_webhook "https://github.com/rommerrro-gh/vega2124/blob/main/app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/MaxWebhookWorker.java"
click node_max_api "https://github.com/rommerrro-gh/vega2124/blob/main/integration-max/src/main/java/ru/pulsedoma/max/MaxApiClient.java"
click node_ticket_adapter "https://github.com/rommerrro-gh/vega2124/blob/main/integration-external/src/main/java/ru/pulsedoma/external/ContractTicketAdapter.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_miniapp,node_reports_api,node_issues_api,node_house_api,node_admin_api,node_access_api toneBlue
class node_report_service,node_duplicate_search,node_issue_service,node_attachments,node_notification toneAmber
class node_house_admin,node_passport,node_polls,node_activation,node_guided_demo toneMint
class node_database,node_attachment_store,node_max_webhook,node_max_api,node_ticket_adapter toneRose
class node_resident,node_dispatcher,node_max_service toneIndigo
```

## Components

### User interfaces and API

- [Mini app](https://github.com/rommerrro-gh/vega2124/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Report API](https://github.com/rommerrro-gh/vega2124/blob/main/api/src/main/java/ru/pulsedoma/api/ReportsController.java): `api/src/main/java/ru/pulsedoma/api/ReportsController.java`
- [Issue API](https://github.com/rommerrro-gh/vega2124/blob/main/api/src/main/java/ru/pulsedoma/api/IssuesController.java): `api/src/main/java/ru/pulsedoma/api/IssuesController.java`
- [House API](https://github.com/rommerrro-gh/vega2124/blob/main/api/src/main/java/ru/pulsedoma/api/HousesController.java): `api/src/main/java/ru/pulsedoma/api/HousesController.java`
- [House admin API](https://github.com/rommerrro-gh/vega2124/blob/main/api/src/main/java/ru/pulsedoma/api/HouseAdminController.java): `api/src/main/java/ru/pulsedoma/api/HouseAdminController.java`
- [Access API](https://github.com/rommerrro-gh/vega2124/blob/main/api/src/main/java/ru/pulsedoma/api/AccessActivationController.java): `api/src/main/java/ru/pulsedoma/api/AccessActivationController.java`

### Reports and issue handling

- [Report intake](https://github.com/rommerrro-gh/vega2124/blob/main/domain-issues/src/main/java/ru/pulsedoma/issues/ReportService.java): `domain-issues/src/main/java/ru/pulsedoma/issues/ReportService.java`
- [Duplicate search](https://github.com/rommerrro-gh/vega2124/blob/main/domain-duplicates/src/main/java/ru/pulsedoma/duplicates/CandidateRetriever.java): `domain-duplicates/src/main/java/ru/pulsedoma/duplicates/CandidateRetriever.java`
- [Issue workflow](https://github.com/rommerrro-gh/vega2124/blob/main/domain-issues/src/main/java/ru/pulsedoma/issues/MiniAppService.java): `domain-issues/src/main/java/ru/pulsedoma/issues/MiniAppService.java`
- [Attachments](https://github.com/rommerrro-gh/vega2124/blob/main/domain-issues/src/main/java/ru/pulsedoma/issues/AttachmentService.java): `domain-issues/src/main/java/ru/pulsedoma/issues/AttachmentService.java`
- [Issue notifications](https://github.com/rommerrro-gh/vega2124/blob/main/domain-issues/src/main/java/ru/pulsedoma/issues/IssueNotificationService.java): `domain-issues/src/main/java/ru/pulsedoma/issues/IssueNotificationService.java`

### House services and access

- [House administration](https://github.com/rommerrro-gh/vega2124/blob/main/domain-house/src/main/java/ru/pulsedoma/house/HouseAdminService.java): `domain-house/src/main/java/ru/pulsedoma/house/HouseAdminService.java`
- [House passport](https://github.com/rommerrro-gh/vega2124/blob/main/domain-house/src/main/java/ru/pulsedoma/house/HousePassportService.java): `domain-house/src/main/java/ru/pulsedoma/house/HousePassportService.java`
- [House polls](https://github.com/rommerrro-gh/vega2124/blob/main/domain-house/src/main/java/ru/pulsedoma/house/HousePollService.java): `domain-house/src/main/java/ru/pulsedoma/house/HousePollService.java`
- [Access activation](https://github.com/rommerrro-gh/vega2124/blob/main/domain-house/src/main/java/ru/pulsedoma/house/AccessActivationService.java): `domain-house/src/main/java/ru/pulsedoma/house/AccessActivationService.java`
- [Guided demo](https://github.com/rommerrro-gh/vega2124/blob/main/domain-house/src/main/java/ru/pulsedoma/house/GuidedDemoService.java): `domain-house/src/main/java/ru/pulsedoma/house/GuidedDemoService.java`

### Runtime and integrations

- [SQLite data](https://github.com/rommerrro-gh/vega2124/blob/main/app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/SqliteDataSourceConfig.java): `app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/SqliteDataSourceConfig.java`
- [Attachment storage](https://github.com/rommerrro-gh/vega2124/blob/main/app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/MinioAttachmentStore.java): `app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/MinioAttachmentStore.java`
- [MAX webhook worker](https://github.com/rommerrro-gh/vega2124/blob/main/app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/MaxWebhookWorker.java): `app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/MaxWebhookWorker.java`
- [MAX API client](https://github.com/rommerrro-gh/vega2124/blob/main/integration-max/src/main/java/ru/pulsedoma/max/MaxApiClient.java): `integration-max/src/main/java/ru/pulsedoma/max/MaxApiClient.java`
- [Contract ticket adapter](https://github.com/rommerrro-gh/vega2124/blob/main/integration-external/src/main/java/ru/pulsedoma/external/ContractTicketAdapter.java): `integration-external/src/main/java/ru/pulsedoma/external/ContractTicketAdapter.java`

### Other components

- **Resident**
- **Dispatcher**
- **MAX platform**

## Connections

- Resident → Mini app: uses (evidence: `README.md`)
- Dispatcher → Mini app: uses (evidence: `README.md`)
- Mini app → Report API: submits reports (evidence: `README.md`)
- Mini app → Issue API: tracks issues (evidence: `README.md`)
- Mini app → House API: views house data (evidence: `README.md`)
- Mini app → House admin API: manages house (evidence: `README.md`)
- Mini app → Access API: manages access (evidence: `README.md`)
- Report API → Report intake: creates reports (evidence: `api/src/main/java/ru/pulsedoma/api/ReportsController.java`)
- Report intake → Duplicate search: retrieves candidates (evidence: `domain-issues/src/main/java/ru/pulsedoma/issues/ReportService.java`)
- Duplicate search → SQLite data: searches issues (evidence: `domain-duplicates/src/main/java/ru/pulsedoma/duplicates/CandidateRetriever.java`)
- Report intake → SQLite data: stores reports (evidence: `domain-issues/src/main/java/ru/pulsedoma/issues/ReportService.java`)
- Issue API → Issue workflow: routes issue actions (evidence: `api/src/main/java/ru/pulsedoma/api/IssuesController.java`)
- Issue workflow → SQLite data: reads and updates (evidence: `domain-issues/src/main/java/ru/pulsedoma/issues/MiniAppService.java`)
- Issue workflow → Attachments: uses attachments (evidence: `domain-issues/src/main/java/ru/pulsedoma/issues/MiniAppService.java`)
- Issue workflow → Issue notifications: uses notifications (evidence: `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 (evidence: `api/src/main/java/ru/pulsedoma/api/HousesController.java`)
- House API → House polls: serves polls (evidence: `api/src/main/java/ru/pulsedoma/api/HousesController.java`)
- House admin API → House administration: manages contacts (evidence: `api/src/main/java/ru/pulsedoma/api/HouseAdminController.java`)
- Access API → Access activation: manages invitations (evidence: `api/src/main/java/ru/pulsedoma/api/AccessActivationController.java`)
- Access activation → SQLite data: stores access state (evidence: `domain-house/src/main/java/ru/pulsedoma/house/AccessActivationService.java`)
- House administration → SQLite data: stores house data
- House polls → SQLite data: stores votes (evidence: `domain-house/src/main/java/ru/pulsedoma/house/HousePollService.java`)
- Dispatcher → Issue workflow: handles queue (evidence: `README.md`)
- Resident → Issue workflow: confirms work (evidence: `README.md`)
- Resident → Guided demo: starts demo (evidence: `README.md`)
- MAX platform → MAX webhook worker: sends updates (evidence: `README.md`)
- MAX webhook worker → MAX API client: uses client (evidence: `app-bootstrap/src/main/java/ru/pulsedoma/bootstrap/MaxWebhookWorker.java`)
- Contract ticket adapter → Issue workflow: ticket integration
