# iiia-ko/lanka architecture

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

- Interactive diagram: https://gitdiagram.com/iiia-ko/lanka
- Repository: https://github.com/iiia-ko/lanka

## Overview

Lanka is an influencer-marketing platform connecting bloggers and brands through campaign management, with user identity and Instagram linking, analytics, and search/discovery. The client routes users into those workflows; the backend is documented as a modular monolith with CQRS, module-owned persistence, and integration events. README capabilities are included even where implementation files were not sampled. The available excerpts show client routing and selected query handlers, but not API dispatch or most module wiring, so those links are omitted or marked unverified.

Main entry points: [`src/Api/Lanka.Api/Program.cs`](https://github.com/iiia-ko/lanka/blob/main/src/Api/Lanka.Api/Program.cs) (API host), [`src/Modules/Analytics`](https://github.com/iiia-ko/lanka/tree/main/src/Modules/Analytics) (Instagram analytics), [`client/lanka-client/src/app/app.routes.ts`](https://github.com/iiia-ko/lanka/blob/main/client/lanka-client/src/app/app.routes.ts) (Client routes), [`src/Modules/Users`](https://github.com/iiia-ko/lanka/tree/main/src/Modules/Users) (Users and linking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_routes["Client routes<br/>[app.routes.ts]"]
  node_campaign_ui["Campaign workflows"]
  node_profile_ui["Blogger profiles"]
end

subgraph group_business["Business modules"]
  node_users["Users and linking"]
  node_campaigns["Campaign lifecycle"]
  node_analytics["Instagram analytics"]
  node_matching["Search and discovery"]
end

subgraph group_shared["Shared backend"]
  node_cqrs["CQRS handlers<br/>[IQueryHandler.cs]"]
  node_domain["Domain results<br/>[Result.cs]"]
  node_infra["Shared infrastructure"]
end

subgraph group_platform["Platform services"]
  node_api["API host<br/>[Program.cs]"]
  node_gateway["API gateway<br/>[Program.cs]"]
end

node_actor(("Platform user"))
node_postgres[("PostgreSQL")]
node_mongodb[("MongoDB")]
node_redis[("Redis")]
node_messaging["RabbitMQ events"]
node_keycloak["Keycloak identity"]
node_elasticsearch[("Elasticsearch")]
node_instagram["Instagram APIs"]

node_actor -->|"uses"| node_routes
node_routes -->|"routes to"| node_campaign_ui
node_routes -->|"routes to"| node_profile_ui
node_routes -.->|"API calls"| node_api
node_gateway -->|"proxies requests"| node_api
node_api -.->|"hosts module"| node_users
node_api -.->|"hosts module"| node_campaigns
node_api -.->|"hosts module"| node_analytics
node_api -.->|"hosts module"| node_matching
node_campaigns -->|"persists data"| node_postgres
node_users -->|"persists data"| node_postgres
node_analytics -->|"stores insights"| node_mongodb
node_infra -->|"caches data"| node_redis
node_matching -->|"indexes and searches"| node_elasticsearch
node_users -->|"delegates identity"| node_keycloak
node_analytics -->|"fetches insights"| node_instagram
node_users -->|"links accounts"| node_instagram
node_campaigns -->|"publishes events"| node_messaging
node_analytics -->|"consumes events"| node_messaging
node_campaigns -->|"uses handlers"| node_cqrs
node_analytics -->|"uses handlers"| node_cqrs
node_cqrs -->|"returns results"| node_domain

click node_routes "https://github.com/iiia-ko/lanka/blob/main/client/lanka-client/src/app/app.routes.ts"
click node_campaign_ui "https://github.com/iiia-ko/lanka/blob/main/client/lanka-client/src/app/features/bloggers/campaigns/campaigns.component.ts"
click node_profile_ui "https://github.com/iiia-ko/lanka/blob/main/client/lanka-client/src/app/features/bloggers/public-profile/public-profile.component.ts"
click node_api "https://github.com/iiia-ko/lanka/blob/main/src/Api/Lanka.Api/Program.cs"
click node_gateway "https://github.com/iiia-ko/lanka/blob/main/src/Api/Lanka.Gateway/Program.cs"
click node_users "https://github.com/iiia-ko/lanka/tree/main/src/Modules/Users"
click node_campaigns "https://github.com/iiia-ko/lanka/tree/main/src/Modules/Campaigns"
click node_analytics "https://github.com/iiia-ko/lanka/tree/main/src/Modules/Analytics"
click node_matching "https://github.com/iiia-ko/lanka/tree/main/src/Modules/Matching"
click node_cqrs "https://github.com/iiia-ko/lanka/blob/main/src/Common/Lanka.Common.Application/Messaging/IQueryHandler.cs"
click node_domain "https://github.com/iiia-ko/lanka/blob/main/src/Common/Lanka.Common.Domain/Result.cs"
click node_infra "https://github.com/iiia-ko/lanka/tree/main/src/Common/Lanka.Common.Infrastructure"

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_routes,node_campaign_ui,node_profile_ui,node_actor toneBlue
class node_users,node_campaigns,node_analytics,node_matching,node_postgres,node_mongodb,node_redis,node_elasticsearch toneAmber
class node_cqrs,node_domain,node_infra,node_instagram toneMint
class node_api,node_gateway toneRose
class node_messaging,node_keycloak toneIndigo
```

## Components

### Web client

- [Client routes](https://github.com/iiia-ko/lanka/blob/main/client/lanka-client/src/app/app.routes.ts): `client/lanka-client/src/app/app.routes.ts`
- [Campaign workflows](https://github.com/iiia-ko/lanka/blob/main/client/lanka-client/src/app/features/bloggers/campaigns/campaigns.component.ts): `client/lanka-client/src/app/features/bloggers/campaigns/campaigns.component.ts`
- [Blogger profiles](https://github.com/iiia-ko/lanka/blob/main/client/lanka-client/src/app/features/bloggers/public-profile/public-profile.component.ts): `client/lanka-client/src/app/features/bloggers/public-profile/public-profile.component.ts`

### Business modules

- [Users and linking](https://github.com/iiia-ko/lanka/tree/main/src/Modules/Users): `src/Modules/Users`
- [Campaign lifecycle](https://github.com/iiia-ko/lanka/tree/main/src/Modules/Campaigns): `src/Modules/Campaigns`
- [Instagram analytics](https://github.com/iiia-ko/lanka/tree/main/src/Modules/Analytics): `src/Modules/Analytics`
- [Search and discovery](https://github.com/iiia-ko/lanka/tree/main/src/Modules/Matching): `src/Modules/Matching`

### Shared backend

- [CQRS handlers](https://github.com/iiia-ko/lanka/blob/main/src/Common/Lanka.Common.Application/Messaging/IQueryHandler.cs): `src/Common/Lanka.Common.Application/Messaging/IQueryHandler.cs`
- [Domain results](https://github.com/iiia-ko/lanka/blob/main/src/Common/Lanka.Common.Domain/Result.cs): `src/Common/Lanka.Common.Domain/Result.cs`
- [Shared infrastructure](https://github.com/iiia-ko/lanka/tree/main/src/Common/Lanka.Common.Infrastructure): `src/Common/Lanka.Common.Infrastructure`

### Platform services

- [API host](https://github.com/iiia-ko/lanka/blob/main/src/Api/Lanka.Api/Program.cs): `src/Api/Lanka.Api/Program.cs`
- [API gateway](https://github.com/iiia-ko/lanka/blob/main/src/Api/Lanka.Gateway/Program.cs): `src/Api/Lanka.Gateway/Program.cs`

### Other components

- **Platform user**
- **PostgreSQL**
- **MongoDB**
- **Redis**
- **RabbitMQ events**
- **Keycloak identity**
- **Elasticsearch**
- **Instagram APIs**

## Connections

- Platform user → Client routes: uses (evidence: `client/lanka-client/src/app/app.routes.ts`)
- Client routes → Campaign workflows: routes to (evidence: `client/lanka-client/src/app/app.routes.ts`)
- Client routes → Blogger profiles: routes to (evidence: `client/lanka-client/src/app/app.routes.ts`)
- Client routes → API host: API calls
- API gateway → API host: proxies requests
- API host → Users and linking: hosts module
- API host → Campaign lifecycle: hosts module
- API host → Instagram analytics: hosts module
- API host → Search and discovery: hosts module
- Campaign lifecycle → PostgreSQL: persists data
- Users and linking → PostgreSQL: persists data
- Instagram analytics → MongoDB: stores insights
- Shared infrastructure → Redis: caches data
- Search and discovery → Elasticsearch: indexes and searches
- Users and linking → Keycloak identity: delegates identity
- Instagram analytics → Instagram APIs: fetches insights
- Users and linking → Instagram APIs: links accounts
- Campaign lifecycle → RabbitMQ events: publishes events
- Instagram analytics → RabbitMQ events: consumes events
- Campaign lifecycle → CQRS handlers: uses handlers (evidence: `src/Modules/Campaigns/Lanka.Modules.Campaigns.Application/Chat/GetThreads/GetChatThreadsQueryHandler.cs`)
- Instagram analytics → CQRS handlers: uses handlers (evidence: `src/Modules/Analytics/Lanka.Modules.Analytics.Application/Instagram/ProfileSummary/GetProfileSummaryQueryHandler.cs`)
- CQRS handlers → Domain results: returns results (evidence: `src/Common/Lanka.Common.Application/Messaging/IQueryHandler.cs`)
