# elvich/chianparser architecture

> Architecture diagram of the GitHub repository elvich/chianparser, 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/elvich/chianparser
- Repository: https://github.com/elvich/chianparser

## Overview

ChianParser is a SwiftUI property-research app backed by a FastAPI service. The main user flow is browsing collected Cian listings, inspecting parsed apartment details, and using analysis, filtering, and export tools. The app also supports local LLM analysis and remote service capabilities; the backend exposes apartment, scoring, analytics, recommendation, update, and WebSocket routes, with scheduled parsing and persistent apartment data. Several app view-model and backend route implementations were not excerpted, so uncertain connections are omitted or shown as unverified.

Main entry points: [`App/ChianParser/App/AppContainer.swift`](https://github.com/elvich/chianparser/blob/main/App/ChianParser/App/AppContainer.swift) (Dependency container), [`App/ChianParser/ViewModels/ContentViewModel.swift`](https://github.com/elvich/chianparser/blob/main/App/ChianParser/ViewModels/ContentViewModel.swift) (Listing workflow), [`Backend/main.py`](https://github.com/elvich/chianparser/blob/main/Backend/main.py) (FastAPI application), [`Backend/api/routes`](https://github.com/elvich/chianparser/tree/main/Backend/api/routes) (API route handlers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app_ui["App experience"]
  node_app["SwiftUI app"]
  node_content["Listings and filters<br/>[ContentView.swift]"]
  node_content_vm["Listing workflow"]
  node_detail_view["Apartment details"]
  node_detail_loader["Detail loading"]
  node_filter["Filter coordination"]
  node_flip_view["Flip scoring UI"]
  node_chat_view["LLM chat UI<br/>[LLMChatView.swift]"]
  node_settings["Settings UI<br/>[SettingsView.swift]"]
end

subgraph group_app_services["App services"]
  node_container["Dependency container<br/>[AppContainer.swift]"]
  node_apartment_model["Apartment records<br/>[Apartment.swift]"]
  node_detail_parser["Cian detail parser"]
  node_selectors["Selector configuration"]
  node_flip_analyzer["Flip analyzer<br/>[FlipAnalyzer.swift]"]
  node_export["CSV and JSON export"]
  node_llm["Local LLM service<br/>[LLMManager.swift]"]
end

subgraph group_api["Backend API"]
  node_backend_app["FastAPI application<br/>[main.py]"]
  node_routes["API route handlers"]
end

subgraph group_backend_logic["Backend processing"]
  node_scheduler["Parsing scheduler<br/>[scheduler.py]"]
  node_parser["Cian parser<br/>[parser.py]"]
  node_scoring["Scoring engine<br/>[scoring.py]"]
  node_recommendations["Recommendations<br/>[recommendations.py]"]
end

subgraph group_data["Models and storage"]
  node_db["Database sessions<br/>[db.py]"]
  node_records[("Apartment database<br/>[database.py]")]
  node_config["Scoring configuration"]
end

node_user(("Property researcher"))

node_user -.->|"browses listings"| node_content
node_content -.->|"uses workflow"| node_content_vm
node_content_vm -.->|"loads details"| node_detail_loader
node_detail_loader -.->|"parses listing"| node_detail_parser
node_detail_parser -->|"uses selectors"| node_selectors
node_detail_parser -->|"produces records"| node_apartment_model
node_content_vm -.->|"coordinates filters"| node_filter
node_content_vm -.->|"requests analysis"| node_flip_analyzer
node_flip_view -.->|"shows score"| node_content_vm
node_content_vm -.->|"exports records"| node_export
node_chat_view -->|"sends prompts"| node_llm
node_container -->|"configures"| node_selectors
node_container -->|"configures"| node_detail_parser
node_container -->|"configures"| node_flip_analyzer
node_container -->|"configures"| node_export
node_container -->|"configures"| node_llm
node_app -->|"creates"| node_container
node_user -.->|"requests service"| node_backend_app
node_backend_app -->|"registers routes"| node_routes
node_backend_app -->|"initializes database"| node_db
node_backend_app -->|"starts scheduler"| node_scheduler
node_scheduler -->|"schedules parsing"| node_parser
node_routes -->|"opens sessions"| node_db
node_routes -->|"invokes scoring"| node_scoring
node_routes -->|"requests recommendations"| node_recommendations
node_parser -->|"uses sessions"| node_db
node_parser -->|"uses scoring"| node_scoring
node_db -->|"persists models"| node_records
node_scoring -->|"reads apartment data"| node_records
node_recommendations -->|"reads apartment data"| node_records

click node_app "https://github.com/elvich/chianparser/blob/main/App/ChianParser/App/ChianParserApp.swift"
click node_content "https://github.com/elvich/chianparser/blob/main/App/ChianParser/Views/ContentView.swift"
click node_content_vm "https://github.com/elvich/chianparser/blob/main/App/ChianParser/ViewModels/ContentViewModel.swift"
click node_detail_view "https://github.com/elvich/chianparser/blob/main/App/ChianParser/Views/ApartmentDetailView.swift"
click node_detail_loader "https://github.com/elvich/chianparser/blob/main/App/ChianParser/ViewModels/DetailPageLoader.swift"
click node_filter "https://github.com/elvich/chianparser/blob/main/App/ChianParser/ViewModels/FilterCoordinator.swift"
click node_flip_view "https://github.com/elvich/chianparser/blob/main/App/ChianParser/Views/FlipScoreView.swift"
click node_chat_view "https://github.com/elvich/chianparser/blob/main/App/ChianParser/Views/LLMChatView.swift"
click node_settings "https://github.com/elvich/chianparser/blob/main/App/ChianParser/Views/SettingsView.swift"
click node_container "https://github.com/elvich/chianparser/blob/main/App/ChianParser/App/AppContainer.swift"
click node_apartment_model "https://github.com/elvich/chianparser/blob/main/App/ChianParser/Models/Apartment.swift"
click node_detail_parser "https://github.com/elvich/chianparser/blob/main/App/ChianParser/Services/CianDetailParser.swift"
click node_selectors "https://github.com/elvich/chianparser/blob/main/App/ChianParser/Services/SelectorsManager.swift"
click node_flip_analyzer "https://github.com/elvich/chianparser/blob/main/App/ChianParser/Services/FlipAnalyzer.swift"
click node_export "https://github.com/elvich/chianparser/blob/main/App/ChianParser/Services/ExportManager.swift"
click node_llm "https://github.com/elvich/chianparser/blob/main/App/ChianParser/Services/LLMManager.swift"
click node_backend_app "https://github.com/elvich/chianparser/blob/main/Backend/main.py"
click node_routes "https://github.com/elvich/chianparser/tree/main/Backend/api/routes"
click node_scheduler "https://github.com/elvich/chianparser/blob/main/Backend/core/scheduler.py"
click node_parser "https://github.com/elvich/chianparser/blob/main/Backend/services/parser.py"
click node_scoring "https://github.com/elvich/chianparser/blob/main/Backend/core/scoring.py"
click node_recommendations "https://github.com/elvich/chianparser/blob/main/Backend/core/recommendations.py"
click node_db "https://github.com/elvich/chianparser/blob/main/Backend/core/db.py"
click node_records "https://github.com/elvich/chianparser/blob/main/Backend/models/database.py"

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_app,node_content,node_content_vm,node_detail_view,node_detail_loader,node_filter,node_flip_view,node_chat_view,node_settings toneBlue
class node_container,node_apartment_model,node_detail_parser,node_selectors,node_flip_analyzer,node_export,node_llm toneAmber
class node_backend_app,node_routes toneMint
class node_scheduler,node_parser,node_scoring,node_recommendations toneRose
class node_db,node_records,node_config,node_user toneIndigo
```

## Components

### App experience

- [SwiftUI app](https://github.com/elvich/chianparser/blob/main/App/ChianParser/App/ChianParserApp.swift): `App/ChianParser/App/ChianParserApp.swift`
- [Listings and filters](https://github.com/elvich/chianparser/blob/main/App/ChianParser/Views/ContentView.swift): `App/ChianParser/Views/ContentView.swift`
- [Listing workflow](https://github.com/elvich/chianparser/blob/main/App/ChianParser/ViewModels/ContentViewModel.swift): `App/ChianParser/ViewModels/ContentViewModel.swift`
- [Apartment details](https://github.com/elvich/chianparser/blob/main/App/ChianParser/Views/ApartmentDetailView.swift): `App/ChianParser/Views/ApartmentDetailView.swift`
- [Detail loading](https://github.com/elvich/chianparser/blob/main/App/ChianParser/ViewModels/DetailPageLoader.swift): `App/ChianParser/ViewModels/DetailPageLoader.swift`
- [Filter coordination](https://github.com/elvich/chianparser/blob/main/App/ChianParser/ViewModels/FilterCoordinator.swift): `App/ChianParser/ViewModels/FilterCoordinator.swift`
- [Flip scoring UI](https://github.com/elvich/chianparser/blob/main/App/ChianParser/Views/FlipScoreView.swift): `App/ChianParser/Views/FlipScoreView.swift`
- [LLM chat UI](https://github.com/elvich/chianparser/blob/main/App/ChianParser/Views/LLMChatView.swift): `App/ChianParser/Views/LLMChatView.swift`
- [Settings UI](https://github.com/elvich/chianparser/blob/main/App/ChianParser/Views/SettingsView.swift): `App/ChianParser/Views/SettingsView.swift`

### App services

- [Dependency container](https://github.com/elvich/chianparser/blob/main/App/ChianParser/App/AppContainer.swift): `App/ChianParser/App/AppContainer.swift`
- [Apartment records](https://github.com/elvich/chianparser/blob/main/App/ChianParser/Models/Apartment.swift): `App/ChianParser/Models/Apartment.swift`
- [Cian detail parser](https://github.com/elvich/chianparser/blob/main/App/ChianParser/Services/CianDetailParser.swift): `App/ChianParser/Services/CianDetailParser.swift`
- [Selector configuration](https://github.com/elvich/chianparser/blob/main/App/ChianParser/Services/SelectorsManager.swift): `App/ChianParser/Services/SelectorsManager.swift`
- [Flip analyzer](https://github.com/elvich/chianparser/blob/main/App/ChianParser/Services/FlipAnalyzer.swift): `App/ChianParser/Services/FlipAnalyzer.swift`
- [CSV and JSON export](https://github.com/elvich/chianparser/blob/main/App/ChianParser/Services/ExportManager.swift): `App/ChianParser/Services/ExportManager.swift`
- [Local LLM service](https://github.com/elvich/chianparser/blob/main/App/ChianParser/Services/LLMManager.swift): `App/ChianParser/Services/LLMManager.swift`

### Backend API

- [FastAPI application](https://github.com/elvich/chianparser/blob/main/Backend/main.py): `Backend/main.py`
- [API route handlers](https://github.com/elvich/chianparser/tree/main/Backend/api/routes): `Backend/api/routes`

### Backend processing

- [Parsing scheduler](https://github.com/elvich/chianparser/blob/main/Backend/core/scheduler.py): `Backend/core/scheduler.py`
- [Cian parser](https://github.com/elvich/chianparser/blob/main/Backend/services/parser.py): `Backend/services/parser.py`
- [Scoring engine](https://github.com/elvich/chianparser/blob/main/Backend/core/scoring.py): `Backend/core/scoring.py`
- [Recommendations](https://github.com/elvich/chianparser/blob/main/Backend/core/recommendations.py): `Backend/core/recommendations.py`

### Models and storage

- [Database sessions](https://github.com/elvich/chianparser/blob/main/Backend/core/db.py): `Backend/core/db.py`
- [Apartment database](https://github.com/elvich/chianparser/blob/main/Backend/models/database.py): `Backend/models/database.py`
- **Scoring configuration**

### Other components

- **Property researcher**

## Connections

- Property researcher → Listings and filters: browses listings
- Listings and filters → Listing workflow: uses workflow
- Listing workflow → Detail loading: loads details
- Detail loading → Cian detail parser: parses listing
- Cian detail parser → Selector configuration: uses selectors (evidence: `App/ChianParser/Services/CianDetailParser.swift`)
- Cian detail parser → Apartment records: produces records (evidence: `App/ChianParser/Services/CianDetailParser.swift`)
- Listing workflow → Filter coordination: coordinates filters
- Listing workflow → Flip analyzer: requests analysis
- Flip scoring UI → Listing workflow: shows score
- Listing workflow → CSV and JSON export: exports records
- LLM chat UI → Local LLM service: sends prompts (evidence: `App/ChianParser/Views/LLMChatView.swift`)
- Dependency container → Selector configuration: configures (evidence: `App/ChianParser/App/AppContainer.swift`)
- Dependency container → Cian detail parser: configures (evidence: `App/ChianParser/App/AppContainer.swift`)
- Dependency container → Flip analyzer: configures (evidence: `App/ChianParser/App/AppContainer.swift`)
- Dependency container → CSV and JSON export: configures (evidence: `App/ChianParser/App/AppContainer.swift`)
- Dependency container → Local LLM service: configures (evidence: `App/ChianParser/App/AppContainer.swift`)
- SwiftUI app → Dependency container: creates (evidence: `App/ChianParser/App/ChianParserApp.swift`)
- Property researcher → FastAPI application: requests service
- FastAPI application → API route handlers: registers routes (evidence: `Backend/main.py`)
- FastAPI application → Database sessions: initializes database (evidence: `Backend/main.py`)
- FastAPI application → Parsing scheduler: starts scheduler (evidence: `Backend/main.py`)
- Parsing scheduler → Cian parser: schedules parsing (evidence: `Backend/core/scheduler.py`)
- API route handlers → Database sessions: opens sessions (evidence: `Backend/api/routes/apartments.py`)
- API route handlers → Scoring engine: invokes scoring (evidence: `Backend/api/routes/scoring.py`)
- API route handlers → Recommendations: requests recommendations (evidence: `Backend/api/routes/recommendations.py`)
- Cian parser → Database sessions: uses sessions (evidence: `Backend/services/parser.py`)
- Cian parser → Scoring engine: uses scoring (evidence: `Backend/services/parser.py`)
- Database sessions → Apartment database: persists models (evidence: `Backend/core/db.py`)
- Scoring engine → Apartment database: reads apartment data (evidence: `Backend/core/scoring.py`)
- Recommendations → Apartment database: reads apartment data (evidence: `Backend/core/recommendations.py`)
