# feiousama/aid-server architecture

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

- Interactive diagram: https://gitdiagram.com/feiousama/aid-server
- Repository: https://github.com/feiousama/aid-server

## Overview

AID is a platform for AI comic dramas, films, and comics. Its main workflow takes a user from project and script setup through episodes, reusable creative assets, storyboards, generated media, dubbing, and finished-episode management. The README also documents unified model providers, task orchestration, billing and payments, user identity, and operations management. The graph combines those documented capabilities with sampled controller, service, and frontend evidence; unsampled implementation links are omitted or marked unverified.

Main entry points: [`aid-business/aid-business-system/src/main/java/com/aid/aid/controller/AidAiModelController.java`](https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-system/src/main/java/com/aid/aid/controller/AidAiModelController.java) (Operations management), [`aid-business/aid-business-main/src/main/java/com/aid/compose/controller/ComposeController.java`](https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-main/src/main/java/com/aid/compose/controller/ComposeController.java) (Media generation), [`aid-interface/aid-interface-system/src/main/java/com/aid/aid/domain/AidAiProvider.java`](https://github.com/feiousama/aid-server/blob/main/aid-interface/aid-interface-system/src/main/java/com/aid/aid/domain/AidAiProvider.java) (AI providers), [`aid-interface/aid-interface-main/src/main/java/com/aid/rps/queue/TaskQueueService.java`](https://github.com/feiousama/aid-server/blob/main/aid-interface/aid-interface-main/src/main/java/com/aid/rps/queue/TaskQueueService.java) (Task orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creation["Creative workflow"]
  node_web["Creation frontend"]
  node_projects["Projects and scripts"]
  node_episodes["Episodes"]
  node_assets["Creative assets"]
  node_storyboards["Storyboards"]
end

subgraph group_generation["Generation platform"]
  node_media["Media generation"]
  node_providers["AI providers<br/>[AidAiProvider.java]"]
  node_tasks["Task orchestration"]
  node_composition["Timeline and export"]
end

subgraph group_platform["Account and commerce"]
  node_auth["Identity and login<br/>[AuthService.java]"]
  node_billing["Billing and payments"]
end

subgraph group_operations["Operations and runtime"]
  node_admin["Operations management"]
  node_storage["Storage configuration"]
  node_scheduler["Scheduled jobs<br/>[MediaTask.java]"]
  node_mysql[("MySQL")]
  node_redis[("Redis")]
end

node_creator(("Creator"))
node_model_services{{"External model services"}}

node_creator -->|"uses"| node_web
node_web -.->|"manages projects"| node_projects
node_projects -->|"organizes"| node_episodes
node_episodes -->|"uses assets"| node_assets
node_assets -->|"informs"| node_storyboards
node_storyboards -->|"requests generation"| node_media
node_media -->|"submits tasks"| node_tasks
node_media -->|"routes generation"| node_providers
node_providers -->|"calls models"| node_model_services
node_tasks -.->|"tracks results"| node_composition
node_composition -->|"delivers finished media"| node_creator
node_creator -.->|"authenticates"| node_auth
node_creator -->|"purchases credits"| node_billing
node_admin -.->|"configures models"| node_providers
node_admin -.->|"configures storage"| node_storage
node_scheduler -.->|"handles scheduled work"| node_tasks
node_auth -.->|"caches sessions"| node_redis
node_admin -->|"manages platform data"| node_mysql

click node_web "https://github.com/feiousama/aid-server/tree/main/frontend/web"
click node_projects "https://github.com/feiousama/aid-server/tree/main/aid-business/aid-business-main/src/main/java/com/aid/project/controller"
click node_episodes "https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-main/src/main/java/com/aid/episode/controller/UserEpisodeController.java"
click node_assets "https://github.com/feiousama/aid-server/tree/main/aid-business/aid-business-main/src/main/java/com/aid/asset/controller"
click node_storyboards "https://github.com/feiousama/aid-server/tree/main/aid-business/aid-business-main/src/main/java/com/aid/storyboard/controller"
click node_media "https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-main/src/main/java/com/aid/compose/controller/ComposeController.java"
click node_providers "https://github.com/feiousama/aid-server/blob/main/aid-interface/aid-interface-system/src/main/java/com/aid/aid/domain/AidAiProvider.java"
click node_tasks "https://github.com/feiousama/aid-server/blob/main/aid-interface/aid-interface-main/src/main/java/com/aid/rps/queue/TaskQueueService.java"
click node_composition "https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-main/src/main/java/com/aid/compose/controller/EpisodeExportController.java"
click node_auth "https://github.com/feiousama/aid-server/blob/main/aid-interface/aid-interface-main/src/main/java/com/aid/auth/service/AuthService.java"
click node_billing "https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-main/src/main/java/com/aid/billing/controller/BillingQuoteController.java"
click node_admin "https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-system/src/main/java/com/aid/aid/controller/AidAiModelController.java"
click node_storage "https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-system/src/main/java/com/aid/config/storage/controller/StorageConfigController.java"
click node_scheduler "https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-quartz/src/main/java/com/aid/quartz/task/MediaTask.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_web,node_projects,node_episodes,node_assets,node_storyboards toneBlue
class node_media,node_providers,node_tasks,node_composition toneAmber
class node_auth,node_billing toneMint
class node_admin,node_storage,node_scheduler,node_mysql,node_redis toneRose
class node_creator,node_model_services toneIndigo
```

## Components

### Creative workflow

- [Creation frontend](https://github.com/feiousama/aid-server/tree/main/frontend/web): `frontend/web`
- [Projects and scripts](https://github.com/feiousama/aid-server/tree/main/aid-business/aid-business-main/src/main/java/com/aid/project/controller): `aid-business/aid-business-main/src/main/java/com/aid/project/controller`
- [Episodes](https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-main/src/main/java/com/aid/episode/controller/UserEpisodeController.java): `aid-business/aid-business-main/src/main/java/com/aid/episode/controller/UserEpisodeController.java`
- [Creative assets](https://github.com/feiousama/aid-server/tree/main/aid-business/aid-business-main/src/main/java/com/aid/asset/controller): `aid-business/aid-business-main/src/main/java/com/aid/asset/controller`
- [Storyboards](https://github.com/feiousama/aid-server/tree/main/aid-business/aid-business-main/src/main/java/com/aid/storyboard/controller): `aid-business/aid-business-main/src/main/java/com/aid/storyboard/controller`

### Generation platform

- [Media generation](https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-main/src/main/java/com/aid/compose/controller/ComposeController.java): `aid-business/aid-business-main/src/main/java/com/aid/compose/controller/ComposeController.java`
- [AI providers](https://github.com/feiousama/aid-server/blob/main/aid-interface/aid-interface-system/src/main/java/com/aid/aid/domain/AidAiProvider.java): `aid-interface/aid-interface-system/src/main/java/com/aid/aid/domain/AidAiProvider.java`
- [Task orchestration](https://github.com/feiousama/aid-server/blob/main/aid-interface/aid-interface-main/src/main/java/com/aid/rps/queue/TaskQueueService.java): `aid-interface/aid-interface-main/src/main/java/com/aid/rps/queue/TaskQueueService.java`
- [Timeline and export](https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-main/src/main/java/com/aid/compose/controller/EpisodeExportController.java): `aid-business/aid-business-main/src/main/java/com/aid/compose/controller/EpisodeExportController.java`

### Account and commerce

- [Identity and login](https://github.com/feiousama/aid-server/blob/main/aid-interface/aid-interface-main/src/main/java/com/aid/auth/service/AuthService.java): `aid-interface/aid-interface-main/src/main/java/com/aid/auth/service/AuthService.java`
- [Billing and payments](https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-main/src/main/java/com/aid/billing/controller/BillingQuoteController.java): `aid-business/aid-business-main/src/main/java/com/aid/billing/controller/BillingQuoteController.java`

### Operations and runtime

- [Operations management](https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-system/src/main/java/com/aid/aid/controller/AidAiModelController.java): `aid-business/aid-business-system/src/main/java/com/aid/aid/controller/AidAiModelController.java`
- [Storage configuration](https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-system/src/main/java/com/aid/config/storage/controller/StorageConfigController.java): `aid-business/aid-business-system/src/main/java/com/aid/config/storage/controller/StorageConfigController.java`
- [Scheduled jobs](https://github.com/feiousama/aid-server/blob/main/aid-business/aid-business-quartz/src/main/java/com/aid/quartz/task/MediaTask.java): `aid-business/aid-business-quartz/src/main/java/com/aid/quartz/task/MediaTask.java`
- **MySQL**
- **Redis**

### Other components

- **Creator**
- **External model services**

## Connections

- Creator → Creation frontend: uses (evidence: `README.md`)
- Creation frontend → Projects and scripts: manages projects
- Projects and scripts → Episodes: organizes (evidence: `README.md`)
- Episodes → Creative assets: uses assets (evidence: `README.md`)
- Creative assets → Storyboards: informs (evidence: `README.md`)
- Storyboards → Media generation: requests generation (evidence: `README.md`)
- Media generation → Task orchestration: submits tasks (evidence: `README.md`)
- Media generation → AI providers: routes generation (evidence: `README.md`)
- AI providers → External model services: calls models (evidence: `README.md`)
- Task orchestration → Timeline and export: tracks results
- Timeline and export → Creator: delivers finished media (evidence: `README.md`)
- Creator → Identity and login: authenticates
- Creator → Billing and payments: purchases credits (evidence: `README.md`)
- Operations management → AI providers: configures models
- Operations management → Storage configuration: configures storage
- Scheduled jobs → Task orchestration: handles scheduled work
- Identity and login → Redis: caches sessions
- Operations management → MySQL: manages platform data (evidence: `README.md`)
