# samuraigpt/seedance-2-generator architecture

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

- Interactive diagram: https://gitdiagram.com/samuraigpt/seedance-2-generator
- Repository: https://github.com/samuraigpt/seedance-2-generator

## Overview

Seedance 2 Generator is a web workspace for creating and archiving AI videos, with account authentication, API-key access, and credit-based purchases. The main workflow is to sign in, submit text or visual references (optionally uploading files), generate a video asynchronously, check its status, and view saved creations. Stripe checkout replenishes credits. The graph includes the documented studio, archive, and billing branches; some UI-to-route relationships are documented rather than visible in the sampled UI source, and the MuAPI webhook’s processing behavior is not inferred.

Main entry points: [`src/lib/auth.js`](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/auth.js) (Authentication), [`src/lib/services/ai.js`](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/services/ai.js) (AI Generation and Polling), [`src/lib/services/billing.js`](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/services/billing.js) (Billing Service), [`src/lib/prisma.js`](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/prisma.js) (Prisma Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Workspace"]
  node_studio["Video Studio<br/>[page.js]"]
  node_gallery["Creations Gallery<br/>[page.js]"]
  node_login["Sign-in Page<br/>[page.js]"]
  node_navbar["Navigation and API Keys<br/>[Navbar.js]"]
  node_pricing["Pricing Page<br/>[page.js]"]
end

subgraph group_api["Application API"]
  node_authroute["Auth Route<br/>[route.js]"]
  node_generateapi["Generation API<br/>[route.js]"]
  node_statusapi["Status API<br/>[route.js]"]
  node_uploadapi["Upload API<br/>[route.js]"]
  node_creationsapi["Creations API<br/>[route.js]"]
  node_apikeyapi["API Key Route<br/>[route.js]"]
  node_checkoutapi["Checkout Route<br/>[route.js]"]
  node_stripecheckoutapi["Stripe Checkout Route<br/>[route.js]"]
  node_stripewebhookapi["Stripe Webhook Route<br/>[route.js]"]
end

subgraph group_services["Domain Services"]
  node_ai["AI Generation and Polling<br/>[ai.js]"]
  node_billing["Billing Service<br/>[billing.js]"]
  node_userservice["Credit Management<br/>[user.js]"]
  node_config["Service Configuration<br/>[config.js]"]
end

subgraph group_state["Identity and Data"]
  node_auth["Authentication<br/>[auth.js]"]
  node_dbclient["Prisma Client<br/>[prisma.js]"]
  node_database[("PostgreSQL Data<br/>[schema.prisma]")]
end

node_visitor(("User"))
node_muapi["MuAPI"]
node_stripe["Stripe"]
node_google["Google OAuth"]

node_visitor -->|"uses"| node_studio
node_visitor -->|"views archive"| node_gallery
node_visitor -->|"signs in"| node_login
node_visitor -->|"chooses credits"| node_pricing
node_studio -->|"submits generation"| node_generateapi
node_studio -->|"uploads references"| node_uploadapi
node_studio -->|"checks progress"| node_statusapi
node_gallery -->|"loads creations"| node_creationsapi
node_navbar -->|"saves API key"| node_apikeyapi
node_login -.->|"authenticates"| node_authroute
node_generateapi -->|"checks session"| node_auth
node_generateapi -->|"dispatches generation"| node_ai
node_statusapi -->|"checks status"| node_ai
node_uploadapi -->|"checks session"| node_auth
node_uploadapi -->|"uploads file"| node_muapi
node_uploadapi -->|"reads API key"| node_config
node_creationsapi -->|"checks session"| node_auth
node_creationsapi -->|"reads creations"| node_dbclient
node_apikeyapi -->|"checks session"| node_auth
node_apikeyapi -->|"updates user"| node_dbclient
node_checkoutapi -->|"checks session"| node_auth
node_checkoutapi -->|"creates checkout"| node_billing
node_stripecheckoutapi -->|"creates checkout"| node_billing
node_stripewebhookapi -->|"handles event"| node_billing
node_authroute -->|"uses options"| node_auth
node_auth -->|"reads and writes users"| node_dbclient
node_auth -->|"offers sign-in"| node_google
node_ai -->|"submits and polls"| node_muapi
node_ai -->|"deducts or refunds"| node_userservice
node_ai -->|"stores generation state"| node_dbclient
node_ai -->|"reads endpoints"| node_config
node_billing -->|"creates sessions"| node_stripe
node_billing -->|"adds purchased credits"| node_userservice
node_billing -->|"reads plans and secrets"| node_config
node_userservice -->|"updates credits"| node_dbclient
node_dbclient -.->|"persists records"| node_database

click node_studio "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/page.js"
click node_gallery "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/gallery/page.js"
click node_login "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/login/page.js"
click node_navbar "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/components/Navbar.js"
click node_pricing "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/pricing/page.js"
click node_authroute "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/auth/%5B...nextauth%5D/route.js"
click node_generateapi "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/seedance/route.js"
click node_statusapi "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/seedance/check-status/route.js"
click node_uploadapi "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/upload/route.js"
click node_creationsapi "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/creations/route.js"
click node_apikeyapi "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/user/apikey/route.js"
click node_checkoutapi "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/checkout/route.js"
click node_stripecheckoutapi "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/stripe/checkout/route.js"
click node_stripewebhookapi "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/stripe/webhook/route.js"
click node_ai "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/services/ai.js"
click node_billing "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/services/billing.js"
click node_userservice "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/services/user.js"
click node_config "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/config.js"
click node_auth "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/auth.js"
click node_dbclient "https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/prisma.js"
click node_database "https://github.com/samuraigpt/seedance-2-generator/blob/main/prisma/schema.prisma"

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_studio,node_gallery,node_login,node_navbar,node_pricing,node_visitor toneBlue
class node_authroute,node_generateapi,node_statusapi,node_uploadapi,node_creationsapi,node_apikeyapi,node_checkoutapi,node_stripecheckoutapi,node_stripewebhookapi toneAmber
class node_ai,node_billing,node_userservice,node_config,node_muapi toneMint
class node_auth,node_dbclient,node_database toneRose
class node_stripe,node_google toneIndigo
```

## Components

### Workspace

- [Video Studio](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/page.js): `src/app/page.js`
- [Creations Gallery](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/gallery/page.js): `src/app/gallery/page.js`
- [Sign-in Page](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/login/page.js): `src/app/login/page.js`
- [Navigation and API Keys](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/components/Navbar.js): `src/components/Navbar.js`
- [Pricing Page](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/pricing/page.js): `src/app/pricing/page.js`

### Application API

- [Auth Route](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/auth/%5B...nextauth%5D/route.js): `src/app/api/auth/[...nextauth]/route.js`
- [Generation API](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/seedance/route.js): `src/app/api/seedance/route.js`
- [Status API](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/seedance/check-status/route.js): `src/app/api/seedance/check-status/route.js`
- [Upload API](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/upload/route.js): `src/app/api/upload/route.js`
- [Creations API](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/creations/route.js): `src/app/api/creations/route.js`
- [API Key Route](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/user/apikey/route.js): `src/app/api/user/apikey/route.js`
- [Checkout Route](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/checkout/route.js): `src/app/api/checkout/route.js`
- [Stripe Checkout Route](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/stripe/checkout/route.js): `src/app/api/stripe/checkout/route.js`
- [Stripe Webhook Route](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/app/api/stripe/webhook/route.js): `src/app/api/stripe/webhook/route.js`

### Domain Services

- [AI Generation and Polling](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/services/ai.js): `src/lib/services/ai.js`
- [Billing Service](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/services/billing.js): `src/lib/services/billing.js`
- [Credit Management](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/services/user.js): `src/lib/services/user.js`
- [Service Configuration](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/config.js): `src/lib/config.js`

### Identity and Data

- [Authentication](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/auth.js): `src/lib/auth.js`
- [Prisma Client](https://github.com/samuraigpt/seedance-2-generator/blob/main/src/lib/prisma.js): `src/lib/prisma.js`
- [PostgreSQL Data](https://github.com/samuraigpt/seedance-2-generator/blob/main/prisma/schema.prisma): `prisma/schema.prisma`

### Other components

- **User**
- **MuAPI**
- **Stripe**
- **Google OAuth**

## Connections

- User → Video Studio: uses (evidence: `README.md`)
- User → Creations Gallery: views archive (evidence: `README.md`)
- User → Sign-in Page: signs in (evidence: `README.md`)
- User → Pricing Page: chooses credits (evidence: `README.md`)
- Video Studio → Generation API: submits generation (evidence: `README.md`)
- Video Studio → Upload API: uploads references (evidence: `README.md`)
- Video Studio → Status API: checks progress (evidence: `README.md`)
- Creations Gallery → Creations API: loads creations (evidence: `README.md`)
- Navigation and API Keys → API Key Route: saves API key (evidence: `src/components/Navbar.js`)
- Sign-in Page → Auth Route: authenticates
- Generation API → Authentication: checks session (evidence: `src/app/api/seedance/route.js`)
- Generation API → AI Generation and Polling: dispatches generation (evidence: `src/app/api/seedance/route.js`)
- Status API → AI Generation and Polling: checks status (evidence: `src/app/api/seedance/check-status/route.js`)
- Upload API → Authentication: checks session (evidence: `src/app/api/upload/route.js`)
- Upload API → MuAPI: uploads file (evidence: `src/app/api/upload/route.js`)
- Upload API → Service Configuration: reads API key (evidence: `src/app/api/upload/route.js`)
- Creations API → Authentication: checks session (evidence: `src/app/api/creations/route.js`)
- Creations API → Prisma Client: reads creations (evidence: `src/app/api/creations/route.js`)
- API Key Route → Authentication: checks session (evidence: `src/app/api/user/apikey/route.js`)
- API Key Route → Prisma Client: updates user (evidence: `src/app/api/user/apikey/route.js`)
- Checkout Route → Authentication: checks session (evidence: `src/app/api/checkout/route.js`)
- Checkout Route → Billing Service: creates checkout (evidence: `src/app/api/checkout/route.js`)
- Stripe Checkout Route → Billing Service: creates checkout (evidence: `src/app/api/stripe/checkout/route.js`)
- Stripe Webhook Route → Billing Service: handles event (evidence: `src/app/api/stripe/webhook/route.js`)
- Auth Route → Authentication: uses options (evidence: `src/app/api/auth/[...nextauth]/route.js`)
- Authentication → Prisma Client: reads and writes users (evidence: `src/lib/auth.js`)
- Authentication → Google OAuth: offers sign-in (evidence: `src/lib/auth.js`)
- AI Generation and Polling → MuAPI: submits and polls (evidence: `src/lib/services/ai.js`)
- AI Generation and Polling → Credit Management: deducts or refunds (evidence: `src/lib/services/ai.js`)
- AI Generation and Polling → Prisma Client: stores generation state (evidence: `src/lib/services/ai.js`)
- AI Generation and Polling → Service Configuration: reads endpoints (evidence: `src/lib/services/ai.js`)
- Billing Service → Stripe: creates sessions (evidence: `src/lib/services/billing.js`)
- Billing Service → Credit Management: adds purchased credits (evidence: `src/lib/services/billing.js`)
- Billing Service → Service Configuration: reads plans and secrets (evidence: `src/lib/services/billing.js`)
- Credit Management → Prisma Client: updates credits (evidence: `src/lib/services/user.js`)
- Prisma Client → PostgreSQL Data: persists records
