# strakhovnicholas/allergint architecture

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

- Interactive diagram: https://gitdiagram.com/strakhovnicholas/allergint
- Repository: https://github.com/strakhovnicholas/allergint

## Overview

Allergy-Startup is an allergy-management app with a web frontend and backend services for user profiles, health diaries, pollen information, and AI assistance. The visible user journey spans survey/profile setup, diary tracking, map-based pollen exploration, and recommendations. The diary service coordinates diary records and nested symptom, medicine, and weather data, and can request AI notes through Kafka. Source excerpts establish several internal calls; most frontend-to-backend and service-to-service HTTP wiring is not shown, so those links are omitted.

Main entry points: [`allergint/core/diary-service/src/main/java/org/allergit/diarypage/service/DiaryPageService.java`](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/diarypage/service/DiaryPageService.java) (Diary coordination), [`frontend/src/App.tsx`](https://github.com/strakhovnicholas/allergint/blob/main/frontend/src/App.tsx) (Page router), [`allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/service/PollenMapService.java`](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/service/PollenMapService.java) (Map and recommendations), [`allergint/core/diary-service/src/main/java/org/allergit/kafka/service/DiaryNoteService.java`](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/kafka/service/DiaryNoteService.java) (Diary note producer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web app"]
  node_webapp["Page router<br/>[App.tsx]"]
  node_survey["Allergy survey<br/>[Survey.tsx]"]
  node_profile["User profile<br/>[Profile.tsx]"]
  node_notebook["Health notebook<br/>[NoteBook.tsx]"]
  node_pollenmapui["Pollen map<br/>[Map.tsx]"]
end

subgraph group_diary["Health diary"]
  node_diaryservice["Diary coordination"]
  node_diarystore[("Diary records")]
  node_medicine["Medicine tracking"]
  node_symptoms["Symptom tracking"]
  node_weatherdiary["Weather entries"]
  node_diarymodels["Diary data model<br/>[DiaryPage.java]"]
  node_diaryproducer["Diary note producer"]
end

subgraph group_users["User profiles"]
  node_userapi["User API"]
  node_userservice["User and allergens<br/>[UserService.java]"]
  node_userstore[("User repository")]
end

subgraph group_pollen["Pollen information"]
  node_pollenapi["Pollen map API"]
  node_pollenmap["Map and recommendations"]
  node_pollenstore[("Pollen data")]
  node_coordstore[("Coordinate data")]
end

subgraph group_ai["AI assistance"]
  node_gigaclient["GigaChat client"]
  node_gigaproxy["AI prompt service"]
  node_gigaproxyapi["AI chat API"]
  node_aiconsumer["AI diary consumer"]
end

node_person(("App user"))
node_externalai(("GigaChat service"))
node_kafkabroker["Kafka broker"]

node_person -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_survey
node_webapp -->|"routes to"| node_profile
node_webapp -->|"routes to"| node_notebook
node_webapp -->|"routes to"| node_pollenmapui
node_diaryservice -->|"saves records"| node_diarystore
node_diaryservice -->|"creates entries"| node_medicine
node_diaryservice -->|"creates entries"| node_symptoms
node_diaryservice -->|"creates entries"| node_weatherdiary
node_diaryservice -->|"checks user"| node_userapi
node_diaryservice -->|"requests AI notes"| node_diaryproducer
node_userservice -->|"reads and writes"| node_userstore
node_pollenmap -->|"reads pollen data"| node_pollenstore
node_pollenmap -->|"queries coordinates"| node_coordstore
node_pollenmap -->|"requests recommendations"| node_gigaclient
node_gigaproxy -.->|"sends prompts"| node_externalai
node_diaryproducer -.->|"publishes notes"| node_kafkabroker
node_kafkabroker -.->|"delivers notes"| node_aiconsumer
node_pollenapi -.->|"dispatches requests"| node_pollenmap
node_gigaproxyapi -.->|"dispatches requests"| node_gigaproxy

click node_webapp "https://github.com/strakhovnicholas/allergint/blob/main/frontend/src/App.tsx"
click node_survey "https://github.com/strakhovnicholas/allergint/blob/main/frontend/src/components/pages/survey/Survey.tsx"
click node_profile "https://github.com/strakhovnicholas/allergint/blob/main/frontend/src/components/pages/Profile/Profile.tsx"
click node_notebook "https://github.com/strakhovnicholas/allergint/blob/main/frontend/src/components/pages/NoteBook/NoteBook.tsx"
click node_pollenmapui "https://github.com/strakhovnicholas/allergint/blob/main/frontend/src/components/pages/Map/Map.tsx"
click node_diaryservice "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/diarypage/service/DiaryPageService.java"
click node_diarystore "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/diarypage/repository/DiaryPageRepository.java"
click node_medicine "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/medicine/service/MedicineService.java"
click node_symptoms "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/symptom/service/UserSymptomService.java"
click node_weatherdiary "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/weather/service/WeatherService.java"
click node_diarymodels "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/diarypage/entity/DiaryPage.java"
click node_userapi "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/user-service/src/main/java/org/allergit/controller/UserController.java"
click node_userservice "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/user-service/src/main/java/org/allergit/service/UserService.java"
click node_userstore "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/user-service/src/main/java/org/allergit/repository/UserRepository.java"
click node_pollenapi "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/controller/PollenMapController.java"
click node_pollenmap "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/service/PollenMapService.java"
click node_pollenstore "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/repository/PollenDataRepository.java"
click node_coordstore "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/repository/CoordinateRepository.java"
click node_gigaclient "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/client/GigaChatClient.java"
click node_gigaproxy "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/GigaChatInteraction-api/src/main/java/org/allergint/gigachatproxy/service/GigaChatService.java"
click node_gigaproxyapi "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/GigaChatInteraction-api/src/main/java/org/allergint/gigachatproxy/controller/ChatController.java"
click node_diaryproducer "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/kafka/service/DiaryNoteService.java"
click node_aiconsumer "https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/GigaChatInteraction-api/src/main/java/org/allergint/gigachatproxy/kafka/consumer/DiaryNoteConsumer.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_webapp,node_survey,node_profile,node_notebook,node_pollenmapui,node_person toneBlue
class node_diaryservice,node_diarystore,node_medicine,node_symptoms,node_weatherdiary,node_diarymodels,node_diaryproducer toneAmber
class node_userapi,node_userservice,node_userstore toneMint
class node_pollenapi,node_pollenmap,node_pollenstore,node_coordstore toneRose
class node_gigaclient,node_gigaproxy,node_gigaproxyapi,node_aiconsumer,node_externalai,node_kafkabroker toneIndigo
```

## Components

### Web app

- [Page router](https://github.com/strakhovnicholas/allergint/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Allergy survey](https://github.com/strakhovnicholas/allergint/blob/main/frontend/src/components/pages/survey/Survey.tsx): `frontend/src/components/pages/survey/Survey.tsx`
- [User profile](https://github.com/strakhovnicholas/allergint/blob/main/frontend/src/components/pages/Profile/Profile.tsx): `frontend/src/components/pages/Profile/Profile.tsx`
- [Health notebook](https://github.com/strakhovnicholas/allergint/blob/main/frontend/src/components/pages/NoteBook/NoteBook.tsx): `frontend/src/components/pages/NoteBook/NoteBook.tsx`
- [Pollen map](https://github.com/strakhovnicholas/allergint/blob/main/frontend/src/components/pages/Map/Map.tsx): `frontend/src/components/pages/Map/Map.tsx`

### Health diary

- [Diary coordination](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/diarypage/service/DiaryPageService.java): `allergint/core/diary-service/src/main/java/org/allergit/diarypage/service/DiaryPageService.java`
- [Diary records](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/diarypage/repository/DiaryPageRepository.java): `allergint/core/diary-service/src/main/java/org/allergit/diarypage/repository/DiaryPageRepository.java`
- [Medicine tracking](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/medicine/service/MedicineService.java): `allergint/core/diary-service/src/main/java/org/allergit/medicine/service/MedicineService.java`
- [Symptom tracking](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/symptom/service/UserSymptomService.java): `allergint/core/diary-service/src/main/java/org/allergit/symptom/service/UserSymptomService.java`
- [Weather entries](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/weather/service/WeatherService.java): `allergint/core/diary-service/src/main/java/org/allergit/weather/service/WeatherService.java`
- [Diary data model](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/diarypage/entity/DiaryPage.java): `allergint/core/diary-service/src/main/java/org/allergit/diarypage/entity/DiaryPage.java`
- [Diary note producer](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/diary-service/src/main/java/org/allergit/kafka/service/DiaryNoteService.java): `allergint/core/diary-service/src/main/java/org/allergit/kafka/service/DiaryNoteService.java`

### User profiles

- [User API](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/user-service/src/main/java/org/allergit/controller/UserController.java): `allergint/core/user-service/src/main/java/org/allergit/controller/UserController.java`
- [User and allergens](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/user-service/src/main/java/org/allergit/service/UserService.java): `allergint/core/user-service/src/main/java/org/allergit/service/UserService.java`
- [User repository](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/user-service/src/main/java/org/allergit/repository/UserRepository.java): `allergint/core/user-service/src/main/java/org/allergit/repository/UserRepository.java`

### Pollen information

- [Pollen map API](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/controller/PollenMapController.java): `allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/controller/PollenMapController.java`
- [Map and recommendations](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/service/PollenMapService.java): `allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/service/PollenMapService.java`
- [Pollen data](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/repository/PollenDataRepository.java): `allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/repository/PollenDataRepository.java`
- [Coordinate data](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/repository/CoordinateRepository.java): `allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/repository/CoordinateRepository.java`

### AI assistance

- [GigaChat client](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/client/GigaChatClient.java): `allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/client/GigaChatClient.java`
- [AI prompt service](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/GigaChatInteraction-api/src/main/java/org/allergint/gigachatproxy/service/GigaChatService.java): `allergint/core/GigaChatInteraction-api/src/main/java/org/allergint/gigachatproxy/service/GigaChatService.java`
- [AI chat API](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/GigaChatInteraction-api/src/main/java/org/allergint/gigachatproxy/controller/ChatController.java): `allergint/core/GigaChatInteraction-api/src/main/java/org/allergint/gigachatproxy/controller/ChatController.java`
- [AI diary consumer](https://github.com/strakhovnicholas/allergint/blob/main/allergint/core/GigaChatInteraction-api/src/main/java/org/allergint/gigachatproxy/kafka/consumer/DiaryNoteConsumer.java): `allergint/core/GigaChatInteraction-api/src/main/java/org/allergint/gigachatproxy/kafka/consumer/DiaryNoteConsumer.java`

### Other components

- **App user**
- **GigaChat service**
- **Kafka broker**

## Connections

- App user → Page router: uses (evidence: `frontend/src/App.tsx`)
- Page router → Allergy survey: routes to (evidence: `frontend/src/App.tsx`)
- Page router → User profile: routes to (evidence: `frontend/src/App.tsx`)
- Page router → Health notebook: routes to (evidence: `frontend/src/App.tsx`)
- Page router → Pollen map: routes to (evidence: `frontend/src/App.tsx`)
- Diary coordination → Diary records: saves records (evidence: `allergint/core/diary-service/src/main/java/org/allergit/diarypage/service/DiaryPageService.java`)
- Diary coordination → Medicine tracking: creates entries (evidence: `allergint/core/diary-service/src/main/java/org/allergit/diarypage/service/DiaryPageService.java`)
- Diary coordination → Symptom tracking: creates entries (evidence: `allergint/core/diary-service/src/main/java/org/allergit/diarypage/service/DiaryPageService.java`)
- Diary coordination → Weather entries: creates entries (evidence: `allergint/core/diary-service/src/main/java/org/allergit/diarypage/service/DiaryPageService.java`)
- Diary coordination → User API: checks user (evidence: `allergint/core/diary-service/src/main/java/org/allergit/diarypage/service/DiaryPageService.java`)
- Diary coordination → Diary note producer: requests AI notes (evidence: `allergint/core/diary-service/src/main/java/org/allergit/diarypage/service/DiaryPageService.java`)
- User and allergens → User repository: reads and writes (evidence: `allergint/core/user-service/src/main/java/org/allergit/service/UserService.java`)
- Map and recommendations → Pollen data: reads pollen data (evidence: `allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/service/PollenMapService.java`)
- Map and recommendations → Coordinate data: queries coordinates (evidence: `allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/service/PollenMapService.java`)
- Map and recommendations → GigaChat client: requests recommendations (evidence: `allergint/core/weather-service/src/main/java/ru/allergint/weatherservice/service/PollenMapService.java`)
- AI prompt service → GigaChat service: sends prompts
- Diary note producer → Kafka broker: publishes notes
- Kafka broker → AI diary consumer: delivers notes
- Pollen map API → Map and recommendations: dispatches requests
- AI chat API → AI prompt service: dispatches requests
