# tejeshwini1441/distributed-app-gen-platform architecture

> Architecture diagram of the GitHub repository tejeshwini1441/distributed-app-gen-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tejeshwini1441/distributed-app-gen-platform
- Repository: https://github.com/tejeshwini1441/distributed-app-gen-platform

## Overview

The product is a browser-based AI app generator: users create projects, prompt an LLM, inspect generated files and chat output, then run the result in an isolated live preview. The README documents the main service calls, asynchronous file-save saga, billing, and preview-routing design. Source excerpts confirm streaming chat dispatch and the workspace file consumer’s idempotent save/ack behavior; other links below rely on README statements, since most service implementations were not sampled.

Main entry points: [`distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/service/impl/AiGenerationServiceImpl.java`](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/service/impl/AiGenerationServiceImpl.java) (AI generation), [`distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/controller/ProjectController.java`](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/controller/ProjectController.java) (Workspace API), [`distributed-app-gen-platform-main/frontend/src/App.tsx`](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/frontend/src/App.tsx) (React frontend), [`distributed-app-gen-platform-main/api-gateway/src/main/java/com/tejeshwini/distributed_lovable/api_gateway/filter/GatewayJwtAuthFilter.java`](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/api-gateway/src/main/java/com/tejeshwini/distributed_lovable/api_gateway/filter/GatewayJwtAuthFilter.java) (API gateway)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["User experience"]
  node_frontend["React frontend<br/>[App.tsx]"]
  node_project_view["Project editor<br/>[ProjectView.tsx]"]
  node_dashboard["Projects dashboard"]
end

subgraph group_generation["AI generation"]
  node_intelligence["Intelligence API"]
  node_generation_service["AI generation"]
  node_chat_state[("Chat history<br/>[ChatSession.java]")]
end

subgraph group_workspace["Workspace and runtime"]
  node_workspace["Workspace API"]
  node_project_service["Project management"]
  node_file_consumer["File save consumer"]
  node_file_storage["Project file storage"]
  node_project_data[("Project records<br/>[Project.java]")]
  node_preview["Preview deployment"]
  node_proxy["Preview proxy<br/>[index.js]"]
end

subgraph group_account["Identity and billing"]
  node_account["Account service"]
  node_billing["Billing endpoints"]
  node_account_data[("Account data<br/>[User.java]")]
end

subgraph group_platform["Shared platform"]
  node_gateway["API gateway"]
  node_common["Shared contracts"]
  node_config["Config service"]
  node_discovery["Discovery service"]
end

node_user(("Browser user"))
node_llm["LLM provider"]
node_stripe["Stripe"]
node_minio[("MinIO")]
node_kafka["Kafka"]
node_redis[("Preview routes")]
node_runner["Isolated runner pod"]

node_user -->|"uses"| node_frontend
node_frontend -->|"routes to"| node_project_view
node_frontend -->|"routes to"| node_dashboard
node_frontend -->|"sends API requests"| node_gateway
node_gateway -->|"routes requests"| node_account
node_gateway -->|"routes requests"| node_workspace
node_gateway -->|"routes requests"| node_intelligence
node_intelligence -->|"invokes"| node_generation_service
node_generation_service -->|"generates with"| node_llm
node_generation_service -->|"reads project files"| node_workspace
node_generation_service -->|"checks token limits"| node_account
node_intelligence -.->|"stores chat"| node_chat_state
node_account -.->|"persists account state"| node_account_data
node_billing -->|"handles webhooks"| node_stripe
node_workspace -->|"checks project limits"| node_account
node_workspace -.->|"manages projects"| node_project_service
node_project_service -.->|"persists projects"| node_project_data
node_generation_service -->|"publishes file events"| node_kafka
node_kafka -->|"delivers requests"| node_file_consumer
node_file_consumer -->|"saves file"| node_file_storage
node_file_storage -->|"stores files"| node_minio
node_file_consumer -->|"publishes acknowledgement"| node_kafka
node_kafka -->|"delivers response"| node_intelligence
node_workspace -->|"deploys preview"| node_preview
node_preview -->|"starts workload"| node_runner
node_preview -->|"writes route"| node_redis
node_proxy -->|"reads route"| node_redis
node_proxy -->|"forwards preview traffic"| node_runner

click node_frontend "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/frontend/src/App.tsx"
click node_project_view "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/frontend/src/pages/ProjectView.tsx"
click node_dashboard "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/frontend/src/pages/ProjectsDashboard.tsx"
click node_gateway "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/api-gateway/src/main/java/com/tejeshwini/distributed_lovable/api_gateway/filter/GatewayJwtAuthFilter.java"
click node_intelligence "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/controller/ChatController.java"
click node_generation_service "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/service/impl/AiGenerationServiceImpl.java"
click node_chat_state "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/entity/ChatSession.java"
click node_account "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/account-service/src/main/java/com/tejeshwini/distributed_lovable/account_service/controller/AuthController.java"
click node_billing "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/account-service/src/main/java/com/tejeshwini/distributed_lovable/account_service/controller/BillingController.java"
click node_account_data "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/account-service/src/main/java/com/tejeshwini/distributed_lovable/account_service/entity/User.java"
click node_workspace "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/controller/ProjectController.java"
click node_project_service "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/service/impl/ProjectServiceImpl.java"
click node_file_consumer "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/consumer/FileStorageConsumer.java"
click node_file_storage "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/service/ProjectFileService.java"
click node_project_data "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/entity/Project.java"
click node_preview "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/service/DeploymentService.java"
click node_proxy "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/k8s/proxy/index.js"
click node_common "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/common-lib/src/main/java/com/tejeshwini/distributed_lovable/common_lib/event/FileStoreRequestEvent.java"
click node_config "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/config-service/src/main/java/com/tejeshwini/distributed_lovable/config_service/ConfigServiceApplication.java"
click node_discovery "https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/discovery-service/src/main/java/com/tejeshwini/distributed_lovable/discovery_service/DiscoveryServiceApplication.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_frontend,node_project_view,node_dashboard,node_user toneBlue
class node_intelligence,node_generation_service,node_chat_state,node_minio,node_redis toneAmber
class node_workspace,node_project_service,node_file_consumer,node_file_storage,node_project_data,node_preview,node_proxy toneMint
class node_account,node_billing,node_account_data toneRose
class node_gateway,node_common,node_config,node_discovery,node_llm,node_stripe,node_kafka,node_runner toneIndigo
```

## Components

### User experience

- [React frontend](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/frontend/src/App.tsx): `distributed-app-gen-platform-main/frontend/src/App.tsx`
- [Project editor](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/frontend/src/pages/ProjectView.tsx): `distributed-app-gen-platform-main/frontend/src/pages/ProjectView.tsx`
- [Projects dashboard](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/frontend/src/pages/ProjectsDashboard.tsx): `distributed-app-gen-platform-main/frontend/src/pages/ProjectsDashboard.tsx`

### AI generation

- [Intelligence API](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/controller/ChatController.java): `distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/controller/ChatController.java`
- [AI generation](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/service/impl/AiGenerationServiceImpl.java): `distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/service/impl/AiGenerationServiceImpl.java`
- [Chat history](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/entity/ChatSession.java): `distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/entity/ChatSession.java`

### Workspace and runtime

- [Workspace API](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/controller/ProjectController.java): `distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/controller/ProjectController.java`
- [Project management](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/service/impl/ProjectServiceImpl.java): `distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/service/impl/ProjectServiceImpl.java`
- [File save consumer](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/consumer/FileStorageConsumer.java): `distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/consumer/FileStorageConsumer.java`
- [Project file storage](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/service/ProjectFileService.java): `distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/service/ProjectFileService.java`
- [Project records](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/entity/Project.java): `distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/entity/Project.java`
- [Preview deployment](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/service/DeploymentService.java): `distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/service/DeploymentService.java`
- [Preview proxy](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/k8s/proxy/index.js): `distributed-app-gen-platform-main/k8s/proxy/index.js`

### Identity and billing

- [Account service](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/account-service/src/main/java/com/tejeshwini/distributed_lovable/account_service/controller/AuthController.java): `distributed-app-gen-platform-main/account-service/src/main/java/com/tejeshwini/distributed_lovable/account_service/controller/AuthController.java`
- [Billing endpoints](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/account-service/src/main/java/com/tejeshwini/distributed_lovable/account_service/controller/BillingController.java): `distributed-app-gen-platform-main/account-service/src/main/java/com/tejeshwini/distributed_lovable/account_service/controller/BillingController.java`
- [Account data](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/account-service/src/main/java/com/tejeshwini/distributed_lovable/account_service/entity/User.java): `distributed-app-gen-platform-main/account-service/src/main/java/com/tejeshwini/distributed_lovable/account_service/entity/User.java`

### Shared platform

- [API gateway](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/api-gateway/src/main/java/com/tejeshwini/distributed_lovable/api_gateway/filter/GatewayJwtAuthFilter.java): `distributed-app-gen-platform-main/api-gateway/src/main/java/com/tejeshwini/distributed_lovable/api_gateway/filter/GatewayJwtAuthFilter.java`
- [Shared contracts](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/common-lib/src/main/java/com/tejeshwini/distributed_lovable/common_lib/event/FileStoreRequestEvent.java): `distributed-app-gen-platform-main/common-lib/src/main/java/com/tejeshwini/distributed_lovable/common_lib/event/FileStoreRequestEvent.java`
- [Config service](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/config-service/src/main/java/com/tejeshwini/distributed_lovable/config_service/ConfigServiceApplication.java): `distributed-app-gen-platform-main/config-service/src/main/java/com/tejeshwini/distributed_lovable/config_service/ConfigServiceApplication.java`
- [Discovery service](https://github.com/tejeshwini1441/distributed-app-gen-platform/blob/main/distributed-app-gen-platform-main/discovery-service/src/main/java/com/tejeshwini/distributed_lovable/discovery_service/DiscoveryServiceApplication.java): `distributed-app-gen-platform-main/discovery-service/src/main/java/com/tejeshwini/distributed_lovable/discovery_service/DiscoveryServiceApplication.java`

### Other components

- **Browser user**
- **LLM provider**
- **Stripe**
- **MinIO**
- **Kafka**
- **Preview routes**
- **Isolated runner pod**

## Connections

- Browser user → React frontend: uses
- React frontend → Project editor: routes to (evidence: `distributed-app-gen-platform-main/frontend/src/App.tsx`)
- React frontend → Projects dashboard: routes to (evidence: `distributed-app-gen-platform-main/frontend/src/App.tsx`)
- React frontend → API gateway: sends API requests
- API gateway → Account service: routes requests
- API gateway → Workspace API: routes requests
- API gateway → Intelligence API: routes requests
- Intelligence API → AI generation: invokes (evidence: `distributed-app-gen-platform-main/intelligence-service/src/main/java/com/tejeshwini/distributed_lovable/intelligence_service/controller/ChatController.java`)
- AI generation → LLM provider: generates with
- AI generation → Workspace API: reads project files
- AI generation → Account service: checks token limits
- Intelligence API → Chat history: stores chat
- Account service → Account data: persists account state
- Billing endpoints → Stripe: handles webhooks (evidence: `distributed-app-gen-platform-main/account-service/src/main/java/com/tejeshwini/distributed_lovable/account_service/controller/BillingController.java`)
- Workspace API → Account service: checks project limits
- Workspace API → Project management: manages projects
- Project management → Project records: persists projects
- AI generation → Kafka: publishes file events
- Kafka → File save consumer: delivers requests (evidence: `distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/consumer/FileStorageConsumer.java`)
- File save consumer → Project file storage: saves file (evidence: `distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/consumer/FileStorageConsumer.java`)
- Project file storage → MinIO: stores files
- File save consumer → Kafka: publishes acknowledgement (evidence: `distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/consumer/FileStorageConsumer.java`)
- Kafka → Intelligence API: delivers response
- Workspace API → Preview deployment: deploys preview (evidence: `distributed-app-gen-platform-main/workspace-service/src/main/java/com/tejeshwini/distributed_lovable/workspace_service/controller/ProjectController.java`)
- Preview deployment → Isolated runner pod: starts workload
- Preview deployment → Preview routes: writes route
- Preview proxy → Preview routes: reads route
- Preview proxy → Isolated runner pod: forwards preview traffic
