# offclosemanage/offclose architecture

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

- Interactive diagram: https://gitdiagram.com/offclosemanage/offclose
- Repository: https://github.com/offclosemanage/offclose

## Overview

OFFCLOSE is an independent music-label site with a public catalog and a demo-to-artist-onboarding workflow. A prospective artist submits a demo; admins review submissions, can reject them or invite accepted artists, and invitees submit full-track details through a personal link. Public pages also present label information, releases, and roster. The admin surface manages submissions, team access, and releases. Edges reflect the supplied excerpts and SOURCE INDEX references; some route/component wiring and unsampled admin behavior are documented but not verified in source excerpts.

Main entry points: [`src/app/api/submit/route.ts`](https://github.com/offclosemanage/offclose/blob/main/src/app/api/submit/route.ts) (Submission API), [`src/lib/firebase.ts`](https://github.com/offclosemanage/offclose/blob/main/src/lib/firebase.ts) (Firebase client), [`src/components/admin/admin-app.tsx`](https://github.com/offclosemanage/offclose/blob/main/src/components/admin/admin-app.tsx) (Admin application), [`src/lib/invites.ts`](https://github.com/offclosemanage/offclose/blob/main/src/lib/invites.ts) (Invite management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public label site"]
  node_site_pages["Public pages"]
  node_about["About page<br/>[page.tsx]"]
  node_roster["Artist roster<br/>[page.tsx]"]
  node_releases_ui["Release catalog"]
  node_release_card["Release card<br/>[release-card.tsx]"]
  node_artist_data["Artist profiles<br/>[artists.ts]"]
  node_release_data["Release data"]
end

subgraph group_submission["Submissions and invites"]
  node_submit_page["Demo page<br/>[page.tsx]"]
  node_demo_form["Demo submission form<br/>[demo-form.tsx]"]
  node_submit_api["Submission API<br/>[route.ts]"]
  node_invite_page["Invite page<br/>[page.tsx]"]
  node_invite_form["Full-track form<br/>[invite-form.tsx]"]
  node_invite_logic["Invite management<br/>[invites.ts]"]
end

subgraph group_admin["Admin operations"]
  node_admin_page["Admin route<br/>[page.tsx]"]
  node_admin_app["Admin application<br/>[admin-app.tsx]"]
  node_submissions_ui["Submission review"]
  node_invite_ui["Invite dialog<br/>[invite-dialog.tsx]"]
  node_release_admin["Release management<br/>[releases-admin.ts]"]
end

subgraph group_services["Data and services"]
  node_auth["Admin authorization<br/>[admin-auth.ts]"]
  node_firebase["Firebase client<br/>[firebase.ts]"]
  node_submissions["Submission records<br/>[submissions.ts]"]
  node_settings["Site settings<br/>[settings.ts]"]
  node_validation["Submission validation"]
  node_email["Email service<br/>[mail.ts]"]
  node_captcha["reCAPTCHA check<br/>[recaptcha.ts]"]
end

node_visitor(("Site visitor"))
node_firestore[("Cloud Firestore")]
node_resend["Resend email"]

node_visitor -->|"visits"| node_site_pages
node_visitor -->|"opens demo"| node_submit_page
node_site_pages -->|"routes to"| node_about
node_site_pages -->|"routes to"| node_roster
node_site_pages -->|"renders"| node_releases_ui
node_about -->|"reads"| node_artist_data
node_about -->|"reads"| node_release_data
node_roster -->|"reads"| node_artist_data
node_releases_ui -->|"renders"| node_release_card
node_release_card -->|"reads"| node_release_data
node_release_data -->|"fallbacks through"| node_firebase
node_submit_page -.->|"presents"| node_demo_form
node_demo_form -.->|"posts demo"| node_submit_api
node_submit_api -->|"checks status"| node_settings
node_submit_api -->|"validates"| node_validation
node_submit_api -->|"verifies human"| node_captcha
node_submit_api -->|"stores via"| node_firebase
node_firebase -->|"connects"| node_firestore
node_submit_api -->|"sends thanks"| node_email
node_email -->|"sends through"| node_resend
node_invite_page -.->|"presents"| node_invite_form
node_invite_form -->|"submits details"| node_invite_logic
node_invite_logic -->|"reads and writes"| node_firebase
node_admin_page -->|"renders"| node_admin_app
node_admin_app -->|"uses"| node_firebase
node_admin_app -.->|"administers"| node_submissions_ui
node_submissions_ui -->|"manages records"| node_submissions
node_submissions_ui -->|"opens"| node_invite_ui
node_invite_ui -->|"creates or emails"| node_invite_logic
node_invite_logic -->|"uses submission data"| node_submissions
node_submissions -->|"uses"| node_firebase
node_admin_app -.->|"manages releases"| node_release_admin
node_submit_api -->|"sends receipt"| node_email
node_admin_app -.->|"checks access"| node_auth
node_auth -->|"checks team"| node_firestore
node_invite_logic -->|"requests token"| node_auth
node_visitor -.->|"opens invite link"| node_invite_page
node_admin_page -.->|"supports release operations"| node_release_admin

click node_site_pages "https://github.com/offclosemanage/offclose/tree/main/src/app/(site)"
click node_about "https://github.com/offclosemanage/offclose/blob/main/src/app/(site)/about/page.tsx"
click node_roster "https://github.com/offclosemanage/offclose/blob/main/src/app/(site)/roster/page.tsx"
click node_releases_ui "https://github.com/offclosemanage/offclose/blob/main/src/components/site/releases-section.tsx"
click node_release_card "https://github.com/offclosemanage/offclose/blob/main/src/components/site/release-card.tsx"
click node_artist_data "https://github.com/offclosemanage/offclose/blob/main/src/data/artists.ts"
click node_release_data "https://github.com/offclosemanage/offclose/blob/main/src/data/initial-releases.ts"
click node_submit_page "https://github.com/offclosemanage/offclose/blob/main/src/app/(site)/submit/page.tsx"
click node_demo_form "https://github.com/offclosemanage/offclose/blob/main/src/components/site/demo-form.tsx"
click node_submit_api "https://github.com/offclosemanage/offclose/blob/main/src/app/api/submit/route.ts"
click node_invite_page "https://github.com/offclosemanage/offclose/blob/main/src/app/(invite)/invite/%5Btoken%5D/page.tsx"
click node_invite_form "https://github.com/offclosemanage/offclose/blob/main/src/components/invite/invite-form.tsx"
click node_invite_logic "https://github.com/offclosemanage/offclose/blob/main/src/lib/invites.ts"
click node_admin_page "https://github.com/offclosemanage/offclose/blob/main/src/app/(admin)/operate/page.tsx"
click node_admin_app "https://github.com/offclosemanage/offclose/blob/main/src/components/admin/admin-app.tsx"
click node_submissions_ui "https://github.com/offclosemanage/offclose/blob/main/src/components/admin/submissions-panel.tsx"
click node_invite_ui "https://github.com/offclosemanage/offclose/blob/main/src/components/admin/invite-dialog.tsx"
click node_release_admin "https://github.com/offclosemanage/offclose/blob/main/src/lib/releases-admin.ts"
click node_auth "https://github.com/offclosemanage/offclose/blob/main/src/lib/admin-auth.ts"
click node_firebase "https://github.com/offclosemanage/offclose/blob/main/src/lib/firebase.ts"
click node_submissions "https://github.com/offclosemanage/offclose/blob/main/src/lib/submissions.ts"
click node_settings "https://github.com/offclosemanage/offclose/blob/main/src/lib/settings.ts"
click node_validation "https://github.com/offclosemanage/offclose/blob/main/src/lib/submission-schema.ts"
click node_email "https://github.com/offclosemanage/offclose/blob/main/src/lib/mail.ts"
click node_captcha "https://github.com/offclosemanage/offclose/blob/main/src/lib/recaptcha.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_site_pages,node_about,node_roster,node_releases_ui,node_release_card,node_artist_data,node_release_data toneBlue
class node_submit_page,node_demo_form,node_submit_api,node_invite_page,node_invite_form,node_invite_logic,node_firestore toneAmber
class node_admin_page,node_admin_app,node_submissions_ui,node_invite_ui,node_release_admin toneMint
class node_auth,node_firebase,node_submissions,node_settings,node_validation,node_email,node_captcha toneRose
class node_visitor,node_resend toneIndigo
```

## Components

### Public label site

- [Public pages](https://github.com/offclosemanage/offclose/tree/main/src/app/(site)): `src/app/(site)`
- [About page](https://github.com/offclosemanage/offclose/blob/main/src/app/(site)/about/page.tsx): `src/app/(site)/about/page.tsx`
- [Artist roster](https://github.com/offclosemanage/offclose/blob/main/src/app/(site)/roster/page.tsx): `src/app/(site)/roster/page.tsx`
- [Release catalog](https://github.com/offclosemanage/offclose/blob/main/src/components/site/releases-section.tsx): `src/components/site/releases-section.tsx`
- [Release card](https://github.com/offclosemanage/offclose/blob/main/src/components/site/release-card.tsx): `src/components/site/release-card.tsx`
- [Artist profiles](https://github.com/offclosemanage/offclose/blob/main/src/data/artists.ts): `src/data/artists.ts`
- [Release data](https://github.com/offclosemanage/offclose/blob/main/src/data/initial-releases.ts): `src/data/initial-releases.ts`

### Submissions and invites

- [Demo page](https://github.com/offclosemanage/offclose/blob/main/src/app/(site)/submit/page.tsx): `src/app/(site)/submit/page.tsx`
- [Demo submission form](https://github.com/offclosemanage/offclose/blob/main/src/components/site/demo-form.tsx): `src/components/site/demo-form.tsx`
- [Submission API](https://github.com/offclosemanage/offclose/blob/main/src/app/api/submit/route.ts): `src/app/api/submit/route.ts`
- [Invite page](https://github.com/offclosemanage/offclose/blob/main/src/app/(invite)/invite/%5Btoken%5D/page.tsx): `src/app/(invite)/invite/[token]/page.tsx`
- [Full-track form](https://github.com/offclosemanage/offclose/blob/main/src/components/invite/invite-form.tsx): `src/components/invite/invite-form.tsx`
- [Invite management](https://github.com/offclosemanage/offclose/blob/main/src/lib/invites.ts): `src/lib/invites.ts`

### Admin operations

- [Admin route](https://github.com/offclosemanage/offclose/blob/main/src/app/(admin)/operate/page.tsx): `src/app/(admin)/operate/page.tsx`
- [Admin application](https://github.com/offclosemanage/offclose/blob/main/src/components/admin/admin-app.tsx): `src/components/admin/admin-app.tsx`
- [Submission review](https://github.com/offclosemanage/offclose/blob/main/src/components/admin/submissions-panel.tsx): `src/components/admin/submissions-panel.tsx`
- [Invite dialog](https://github.com/offclosemanage/offclose/blob/main/src/components/admin/invite-dialog.tsx): `src/components/admin/invite-dialog.tsx`
- [Release management](https://github.com/offclosemanage/offclose/blob/main/src/lib/releases-admin.ts): `src/lib/releases-admin.ts`

### Data and services

- [Admin authorization](https://github.com/offclosemanage/offclose/blob/main/src/lib/admin-auth.ts): `src/lib/admin-auth.ts`
- [Firebase client](https://github.com/offclosemanage/offclose/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`
- [Submission records](https://github.com/offclosemanage/offclose/blob/main/src/lib/submissions.ts): `src/lib/submissions.ts`
- [Site settings](https://github.com/offclosemanage/offclose/blob/main/src/lib/settings.ts): `src/lib/settings.ts`
- [Submission validation](https://github.com/offclosemanage/offclose/blob/main/src/lib/submission-schema.ts): `src/lib/submission-schema.ts`
- [Email service](https://github.com/offclosemanage/offclose/blob/main/src/lib/mail.ts): `src/lib/mail.ts`
- [reCAPTCHA check](https://github.com/offclosemanage/offclose/blob/main/src/lib/recaptcha.ts): `src/lib/recaptcha.ts`

### Other components

- **Site visitor**
- **Cloud Firestore**
- **Resend email**

## Connections

- Site visitor → Public pages: visits
- Site visitor → Demo page: opens demo
- Public pages → About page: routes to
- Public pages → Artist roster: routes to
- Public pages → Release catalog: renders (evidence: `src/app/(site)/page.tsx`)
- About page → Artist profiles: reads (evidence: `src/app/(site)/about/page.tsx`)
- About page → Release data: reads (evidence: `src/app/(site)/about/page.tsx`)
- Artist roster → Artist profiles: reads (evidence: `src/app/(site)/roster/page.tsx`)
- Release catalog → Release card: renders
- Release card → Release data: reads (evidence: `src/components/site/release-card.tsx`)
- Release data → Firebase client: fallbacks through (evidence: `src/data/initial-releases.ts`)
- Demo page → Demo submission form: presents
- Demo submission form → Submission API: posts demo
- Submission API → Site settings: checks status (evidence: `src/app/api/submit/route.ts`)
- Submission API → Submission validation: validates (evidence: `src/app/api/submit/route.ts`)
- Submission API → reCAPTCHA check: verifies human (evidence: `src/app/api/submit/route.ts`)
- Submission API → Firebase client: stores via (evidence: `src/app/api/submit/route.ts`)
- Firebase client → Cloud Firestore: connects (evidence: `src/lib/firebase.ts`)
- Submission API → Email service: sends thanks (evidence: `src/app/api/submit/route.ts`)
- Email service → Resend email: sends through (evidence: `src/lib/mail.ts`)
- Invite page → Full-track form: presents
- Full-track form → Invite management: submits details (evidence: `src/components/invite/invite-form.tsx`)
- Invite management → Firebase client: reads and writes (evidence: `src/lib/invites.ts`)
- Admin route → Admin application: renders (evidence: `src/app/(admin)/operate/page.tsx`)
- Admin application → Firebase client: uses (evidence: `src/components/admin/admin-app.tsx`)
- Admin application → Submission review: administers
- Submission review → Submission records: manages records (evidence: `src/components/admin/submissions-panel.tsx`)
- Submission review → Invite dialog: opens (evidence: `src/components/admin/submissions-panel.tsx`)
- Invite dialog → Invite management: creates or emails (evidence: `src/components/admin/invite-dialog.tsx`)
- Invite management → Submission records: uses submission data (evidence: `src/lib/invites.ts`)
- Submission records → Firebase client: uses (evidence: `src/lib/submissions.ts`)
- Admin application → Release management: manages releases
- Submission API → Email service: sends receipt (evidence: `src/app/api/submit/route.ts`)
- Admin application → Admin authorization: checks access
- Admin authorization → Cloud Firestore: checks team (evidence: `src/lib/admin-auth.ts`)
- Invite management → Admin authorization: requests token (evidence: `src/lib/invites.ts`)
- Site visitor → Invite page: opens invite link
- Admin route → Release management: supports release operations
