# alexsur1989/qalago architecture

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

## Overview

QalaGo is a Kazakhstan-focused city-discovery super-app: consumers discover businesses, categories and promotions; business teams manage listings and purchases; staff administer the catalog, safety and platform. The README identifies the catalog API as the production-ready backend and says the AI orchestrator is proxied through it. The web trees show distinct reporting, moderation, onboarding and monetization surfaces. Mobile is documented as the native consumer and membership-aware owner client, but its Dart feature sources are absent from this tree. Several service relationships below are documented only at product level.

Main entry points: [`apps/admin-web/app`](https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app) (Admin web), [`services/catalog-api`](https://github.com/alexsur1989/qalago/tree/master/services/catalog-api) (Catalog API), [`apps/business-web/app`](https://github.com/alexsur1989/qalago/tree/master/apps/business-web/app) (Business web), [`apps/consumer-web/app`](https://github.com/alexsur1989/qalago/tree/master/apps/consumer-web/app) (Consumer web)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public discovery"]
  node_consumer["Consumer web"]
  node_mobile["Mobile app"]
  node_discovery["City discovery"]
  node_business_detail["Business profiles<br/>[page.tsx]"]
  node_consumer_ads["Promotions and ads"]
end

subgraph group_owner["Business operations"]
  node_business_portal["Business web"]
  node_onboarding["Owner onboarding"]
  node_owner_catalog["Business management"]
  node_owner_monetization["Owner monetization"]
end

subgraph group_staff["Platform operations"]
  node_admin_portal["Admin web"]
  node_admin_catalog["Catalog administration"]
  node_requests["Applications and claims"]
  node_moderation["Content moderation"]
  node_staff_monetization["Ad operations"]
  node_staff_reporting["Reports and audit"]
  node_legal_ops["Legal operations"]
end

subgraph group_core["Core services"]
  node_catalog_api["Catalog API"]
  node_reviews["Reviews service<br/>[reviews.service.ts]"]
  node_review_stats["Review aggregation"]
  node_report_queries["Reporting queries"]
  node_database[("PostgreSQL")]
  node_ai["AI orchestrator<br/>[main.ts]"]
end

node_consumer_actor(("Consumer"))
node_owner_actor(("Business team"))
node_staff_actor(("Platform staff"))

node_consumer_actor -->|"uses"| node_consumer
node_consumer -->|"discovers"| node_discovery
node_discovery -.->|"opens profiles"| node_business_detail
node_consumer -->|"views promotions"| node_consumer_ads
node_mobile -->|"uses backend"| node_catalog_api
node_consumer -->|"uses backend"| node_catalog_api
node_owner_actor -->|"uses"| node_business_portal
node_business_portal -.->|"applies or claims"| node_onboarding
node_business_portal -->|"manages business"| node_owner_catalog
node_business_portal -->|"manages purchases"| node_owner_monetization
node_business_portal -->|"uses backend"| node_catalog_api
node_staff_actor -->|"uses"| node_admin_portal
node_admin_portal -->|"administers catalog"| node_admin_catalog
node_admin_portal -.->|"reviews requests"| node_requests
node_admin_portal -->|"handles moderation"| node_moderation
node_admin_portal -.->|"manages monetization"| node_staff_monetization
node_admin_portal -.->|"views reports"| node_staff_reporting
node_admin_portal -.->|"handles legal work"| node_legal_ops
node_admin_portal -->|"uses backend"| node_catalog_api
node_catalog_api -.->|"reads and writes"| node_database
node_catalog_api -->|"proxies requests"| node_ai
node_reviews -->|"reads and writes"| node_database
node_review_stats -->|"aggregates reviews"| node_database
node_report_queries -->|"queries metrics"| node_database
node_catalog_api -->|"routes reviews"| node_reviews
node_report_queries -.->|"supplies report data"| node_staff_reporting

click node_consumer "https://github.com/alexsur1989/qalago/tree/master/apps/consumer-web/app"
click node_mobile "https://github.com/alexsur1989/qalago/tree/master/apps/mobile"
click node_discovery "https://github.com/alexsur1989/qalago/tree/master/apps/consumer-web/app/%5Blocale%5D/%5BcitySlug%5D"
click node_business_detail "https://github.com/alexsur1989/qalago/blob/master/apps/consumer-web/app/%5Blocale%5D/%5BcitySlug%5D/business/%5BbusinessSlug%5D/page.tsx"
click node_consumer_ads "https://github.com/alexsur1989/qalago/tree/master/apps/consumer-web/components/ads"
click node_business_portal "https://github.com/alexsur1989/qalago/tree/master/apps/business-web/app"
click node_onboarding "https://github.com/alexsur1989/qalago/tree/master/apps/business-web/app/onboarding"
click node_owner_catalog "https://github.com/alexsur1989/qalago/tree/master/apps/business-web/app/business/%5Bid%5D"
click node_owner_monetization "https://github.com/alexsur1989/qalago/tree/master/apps/business-web/app/monetization"
click node_admin_portal "https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app"
click node_admin_catalog "https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/catalog/businesses"
click node_requests "https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/business-requests"
click node_moderation "https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/moderation"
click node_staff_monetization "https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/monetization"
click node_staff_reporting "https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/reports"
click node_legal_ops "https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/legal"
click node_catalog_api "https://github.com/alexsur1989/qalago/tree/master/services/catalog-api"
click node_reviews "https://github.com/alexsur1989/qalago/blob/master/services/catalog-api/src/modules/reviews/reviews.service.ts"
click node_review_stats "https://github.com/alexsur1989/qalago/blob/master/services/catalog-api/src/common/services/review-aggregation.service.ts"
click node_report_queries "https://github.com/alexsur1989/qalago/blob/master/services/catalog-api/src/modules/admin-reporting/reporting-query.service.ts"
click node_ai "https://github.com/alexsur1989/qalago/blob/master/services/ai-orchestrator/src/main.ts"

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_consumer,node_mobile,node_discovery,node_business_detail,node_consumer_ads toneBlue
class node_business_portal,node_onboarding,node_owner_catalog,node_owner_monetization toneAmber
class node_admin_portal,node_admin_catalog,node_requests,node_moderation,node_staff_monetization,node_staff_reporting,node_legal_ops toneMint
class node_catalog_api,node_reviews,node_review_stats,node_report_queries,node_database,node_ai toneRose
class node_consumer_actor,node_owner_actor,node_staff_actor toneIndigo
```

## Components

### Public discovery

- [Consumer web](https://github.com/alexsur1989/qalago/tree/master/apps/consumer-web/app): `apps/consumer-web/app`
- [Mobile app](https://github.com/alexsur1989/qalago/tree/master/apps/mobile): `apps/mobile`
- [City discovery](https://github.com/alexsur1989/qalago/tree/master/apps/consumer-web/app/%5Blocale%5D/%5BcitySlug%5D): `apps/consumer-web/app/[locale]/[citySlug]`
- [Business profiles](https://github.com/alexsur1989/qalago/blob/master/apps/consumer-web/app/%5Blocale%5D/%5BcitySlug%5D/business/%5BbusinessSlug%5D/page.tsx): `apps/consumer-web/app/[locale]/[citySlug]/business/[businessSlug]/page.tsx`
- [Promotions and ads](https://github.com/alexsur1989/qalago/tree/master/apps/consumer-web/components/ads): `apps/consumer-web/components/ads`

### Business operations

- [Business web](https://github.com/alexsur1989/qalago/tree/master/apps/business-web/app): `apps/business-web/app`
- [Owner onboarding](https://github.com/alexsur1989/qalago/tree/master/apps/business-web/app/onboarding): `apps/business-web/app/onboarding`
- [Business management](https://github.com/alexsur1989/qalago/tree/master/apps/business-web/app/business/%5Bid%5D): `apps/business-web/app/business/[id]`
- [Owner monetization](https://github.com/alexsur1989/qalago/tree/master/apps/business-web/app/monetization): `apps/business-web/app/monetization`

### Platform operations

- [Admin web](https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app): `apps/admin-web/app`
- [Catalog administration](https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/catalog/businesses): `apps/admin-web/app/catalog/businesses`
- [Applications and claims](https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/business-requests): `apps/admin-web/app/business-requests`
- [Content moderation](https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/moderation): `apps/admin-web/app/moderation`
- [Ad operations](https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/monetization): `apps/admin-web/app/monetization`
- [Reports and audit](https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/reports): `apps/admin-web/app/reports`
- [Legal operations](https://github.com/alexsur1989/qalago/tree/master/apps/admin-web/app/legal): `apps/admin-web/app/legal`

### Core services

- [Catalog API](https://github.com/alexsur1989/qalago/tree/master/services/catalog-api): `services/catalog-api`
- [Reviews service](https://github.com/alexsur1989/qalago/blob/master/services/catalog-api/src/modules/reviews/reviews.service.ts): `services/catalog-api/src/modules/reviews/reviews.service.ts`
- [Review aggregation](https://github.com/alexsur1989/qalago/blob/master/services/catalog-api/src/common/services/review-aggregation.service.ts): `services/catalog-api/src/common/services/review-aggregation.service.ts`
- [Reporting queries](https://github.com/alexsur1989/qalago/blob/master/services/catalog-api/src/modules/admin-reporting/reporting-query.service.ts): `services/catalog-api/src/modules/admin-reporting/reporting-query.service.ts`
- **PostgreSQL**
- [AI orchestrator](https://github.com/alexsur1989/qalago/blob/master/services/ai-orchestrator/src/main.ts): `services/ai-orchestrator/src/main.ts`

### Other components

- **Consumer**
- **Business team**
- **Platform staff**

## Connections

- Consumer → Consumer web: uses (evidence: `README.md`)
- Consumer web → City discovery: discovers (evidence: `README.md`)
- City discovery → Business profiles: opens profiles
- Consumer web → Promotions and ads: views promotions (evidence: `README.md`)
- Mobile app → Catalog API: uses backend (evidence: `README.md`)
- Consumer web → Catalog API: uses backend (evidence: `README.md`)
- Business team → Business web: uses (evidence: `README.md`)
- Business web → Owner onboarding: applies or claims
- Business web → Business management: manages business (evidence: `README.md`)
- Business web → Owner monetization: manages purchases (evidence: `README.md`)
- Business web → Catalog API: uses backend (evidence: `README.md`)
- Platform staff → Admin web: uses (evidence: `README.md`)
- Admin web → Catalog administration: administers catalog (evidence: `README.md`)
- Admin web → Applications and claims: reviews requests
- Admin web → Content moderation: handles moderation (evidence: `README.md`)
- Admin web → Ad operations: manages monetization
- Admin web → Reports and audit: views reports
- Admin web → Legal operations: handles legal work
- Admin web → Catalog API: uses backend (evidence: `README.md`)
- Catalog API → PostgreSQL: reads and writes
- Catalog API → AI orchestrator: proxies requests (evidence: `README.md`)
- Reviews service → PostgreSQL: reads and writes (evidence: `services/catalog-api/src/modules/reviews/reviews.service.ts`)
- Review aggregation → PostgreSQL: aggregates reviews (evidence: `services/catalog-api/src/common/services/review-aggregation.service.ts`)
- Reporting queries → PostgreSQL: queries metrics (evidence: `services/catalog-api/src/modules/admin-reporting/reporting-query.service.ts`)
- Catalog API → Reviews service: routes reviews (evidence: `services/catalog-api/src/modules/reviews/reviews.controller.ts`)
- Reporting queries → Reports and audit: supplies report data
