How elvich/chianparser works
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: AppContainer.swift Dependency container · ContentViewModel.swift Listing workflow · main.py FastAPI application · routes API route handlers
Components 26
App experience
- SwiftUI app
App/ChianParser/App/ChianParserApp.swift - Listings and filters
App/ChianParser/Views/ContentView.swift - Listing workflow
App/ChianParser/ViewModels/ContentViewModel.swift - Apartment details
App/ChianParser/Views/ApartmentDetailView.swift - Detail loading
App/ChianParser/ViewModels/DetailPageLoader.swift - Filter coordination
App/ChianParser/ViewModels/FilterCoordinator.swift - Flip scoring UI
App/ChianParser/Views/FlipScoreView.swift - LLM chat UI
App/ChianParser/Views/LLMChatView.swift - Settings UI
App/ChianParser/Views/SettingsView.swift
App services
- Dependency container
App/ChianParser/App/AppContainer.swift - Apartment records
App/ChianParser/Models/Apartment.swift - Cian detail parser
App/ChianParser/Services/CianDetailParser.swift - Selector configuration
App/ChianParser/Services/SelectorsManager.swift - Flip analyzer
App/ChianParser/Services/FlipAnalyzer.swift - CSV and JSON export
App/ChianParser/Services/ExportManager.swift - Local LLM service
App/ChianParser/Services/LLMManager.swift
Backend API
- FastAPI application
Backend/main.py - API route handlers
Backend/api/routes
Backend processing
- Parsing scheduler
Backend/core/scheduler.py - Cian parser
Backend/services/parser.py - Scoring engine
Backend/core/scoring.py - Recommendations
Backend/core/recommendations.py
Models and storage
- Database sessions
Backend/core/db.py - Apartment database
Backend/models/database.py - Scoring configuration
Other components
- Property researcher
Connections 30
- 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
App/ChianParser/Services/CianDetailParser.swift - Cian detail parser → Apartment records: produces records
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
App/ChianParser/Views/LLMChatView.swift - Dependency container → Selector configuration: configures
App/ChianParser/App/AppContainer.swift - Dependency container → Cian detail parser: configures
App/ChianParser/App/AppContainer.swift - Dependency container → Flip analyzer: configures
App/ChianParser/App/AppContainer.swift - Dependency container → CSV and JSON export: configures
App/ChianParser/App/AppContainer.swift - Dependency container → Local LLM service: configures
App/ChianParser/App/AppContainer.swift - SwiftUI app → Dependency container: creates
App/ChianParser/App/ChianParserApp.swift - Property researcher → FastAPI application: requests service
- FastAPI application → API route handlers: registers routes
Backend/main.py - FastAPI application → Database sessions: initializes database
Backend/main.py - FastAPI application → Parsing scheduler: starts scheduler
Backend/main.py - Parsing scheduler → Cian parser: schedules parsing
Backend/core/scheduler.py - API route handlers → Database sessions: opens sessions
Backend/api/routes/apartments.py - API route handlers → Scoring engine: invokes scoring
Backend/api/routes/scoring.py - API route handlers → Recommendations: requests recommendations
Backend/api/routes/recommendations.py - Cian parser → Database sessions: uses sessions
Backend/services/parser.py - Cian parser → Scoring engine: uses scoring
Backend/services/parser.py - Database sessions → Apartment database: persists models
Backend/core/db.py - Scoring engine → Apartment database: reads apartment data
Backend/core/scoring.py - Recommendations → Apartment database: reads apartment data
Backend/core/recommendations.py