# brilliant666/frame-zero-portfolio-studio architecture

> Architecture diagram of the GitHub repository brilliant666/frame-zero-portfolio-studio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/brilliant666/frame-zero-portfolio-studio
- Repository: https://github.com/brilliant666/frame-zero-portfolio-studio

## Overview

The repository is a multi-tenant photography portfolio platform: photographers authenticate, choose an authorized Site editor, manage content and private photo assets, save versioned drafts, preview them, and (for the premium Polaroid space) publish immutable versions for public viewing. Basic and premium content remain separate while sharing Site assets. The graph emphasizes those product stages, template composition/rendering, and account/storage boundaries. Several route and database implementations were not excerpted; their links rely on README statements rather than claims of inspected source.

Main entry points: [`app/admin/admin-provider.tsx`](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/admin/admin-provider.tsx) (Basic editor), [`app/preview-workspace/admin.tsx`](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/preview-workspace/admin.tsx) (Premium editor), [`app/[siteSlug]/admin/route.node.ts`](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/%5BsiteSlug%5D/admin/route.node.ts) (Site workspace routes), [`app/preview-workspace/server.ts`](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/preview-workspace/server.ts) (Saved draft preview)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Platform and access"]
  node_platform["Platform pages<br/>[page.tsx]"]
  node_login["Login<br/>[login.tsx]"]
  node_account_auth["Account and Site access"]
  node_site_workspace["Site workspace routes<br/>[route.node.ts]"]
end

subgraph group_editing["Editing and assets"]
  node_basic_editor["Basic editor<br/>[admin-provider.tsx]"]
  node_premium_editor["Premium editor<br/>[admin.tsx]"]
  node_site_assets["Site photo assets<br/>[assets-client.ts]"]
  node_photo_library["Photo manifest and assignment<br/>[photo-library.ts]"]
end

subgraph group_content["Draft and publication"]
  node_content_schema["Space content validation<br/>[content-schema.ts]"]
  node_draft_api["Site draft operations<br/>[server.ts]"]
  node_account_services["Account data services"]
  node_publication["Premium publication history<br/>[publications.mjs]"]
  node_preview_workspace["Saved draft preview<br/>[server.ts]"]
  node_preview_document["Premium portfolio document<br/>[document.ts]"]
end

subgraph group_experience["Templates and public site"]
  node_template_composition["Template composition"]
  node_composition_planner["Composition assignment<br/>[assignment.ts]"]
  node_template_catalog["Template catalog<br/>[catalog.ts]"]
  node_polaroid_experience["Polaroid experience<br/>[composer-scene.tsx]"]
  node_public_site["Published portfolio<br/>[page.node.tsx]"]
end

node_photographer(("Photographer"))
node_public_visitor(("Public visitor"))
node_database[("PostgreSQL account store")]
node_asset_storage[("Private asset storage")]

node_photographer -->|"opens platform"| node_platform
node_photographer -->|"signs in"| node_login
node_login -.->|"authenticates"| node_account_auth
node_account_auth -.->|"reads account"| node_database
node_photographer -->|"opens own Site"| node_site_workspace
node_site_workspace -->|"checks ownership"| node_account_auth
node_site_workspace -->|"routes authorized"| node_basic_editor
node_site_workspace -->|"routes authorized"| node_premium_editor
node_basic_editor -->|"loads assets"| node_site_assets
node_premium_editor -.->|"uses Site assets"| node_site_assets
node_site_assets -->|"validates manifest"| node_photo_library
node_site_assets -.->|"uploads and reads"| node_asset_storage
node_basic_editor -->|"saves draft"| node_draft_api
node_premium_editor -->|"saves draft"| node_draft_api
node_draft_api -->|"validates content"| node_content_schema
node_draft_api -->|"authorizes and persists"| node_account_services
node_account_services -.->|"reads and writes"| node_database
node_premium_editor -->|"requests saved preview"| node_preview_workspace
node_preview_workspace -->|"parses document"| node_preview_document
node_preview_workspace -->|"reads legacy preview data"| node_database
node_premium_editor -->|"publishes saved version"| node_publication
node_publication -.->|"stores publication state"| node_account_services
node_publication -.->|"updates Published pointer"| node_database
node_basic_editor -->|"previews layout"| node_template_composition
node_template_composition -->|"assigns photos"| node_composition_planner
node_template_composition -->|"maps assets to works"| node_photo_library
node_basic_editor -->|"selects template"| node_template_catalog
node_template_catalog -.->|"defines available templates"| node_public_site
node_public_visitor -->|"visits published Site"| node_public_site
node_public_site -.->|"resolves Published only"| node_publication
node_public_site -.->|"renders portfolio"| node_polaroid_experience
node_preview_workspace -->|"previews collections"| node_polaroid_experience

click node_platform "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/page.tsx"
click node_login "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/login/login.tsx"
click node_account_auth "https://github.com/brilliant666/frame-zero-portfolio-studio/tree/main/db/accounts"
click node_site_workspace "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/%5BsiteSlug%5D/admin/route.node.ts"
click node_basic_editor "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/admin/admin-provider.tsx"
click node_premium_editor "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/preview-workspace/admin.tsx"
click node_site_assets "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/site-editor/assets-client.ts"
click node_photo_library "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/photo-library.ts"
click node_content_schema "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/site-editor/content-schema.ts"
click node_draft_api "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/site-editor/server.ts"
click node_account_services "https://github.com/brilliant666/frame-zero-portfolio-studio/tree/main/db/accounts"
click node_publication "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/db/accounts/publications.mjs"
click node_preview_workspace "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/preview-workspace/server.ts"
click node_preview_document "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/preview-workspace/document.ts"
click node_template_composition "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/templates/template-preview-composition.ts"
click node_composition_planner "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/template-composition/assignment.ts"
click node_template_catalog "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/templates/catalog.ts"
click node_polaroid_experience "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/templates/polaroid-field/composer-scene.tsx"
click node_public_site "https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/%5BsiteSlug%5D/page.node.tsx"

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_platform,node_login,node_account_auth,node_site_workspace toneBlue
class node_basic_editor,node_premium_editor,node_site_assets,node_photo_library,node_database,node_asset_storage toneAmber
class node_content_schema,node_draft_api,node_account_services,node_publication,node_preview_workspace,node_preview_document toneMint
class node_template_composition,node_composition_planner,node_template_catalog,node_polaroid_experience,node_public_site toneRose
class node_photographer,node_public_visitor toneIndigo
```

## Components

### Platform and access

- [Platform pages](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/page.tsx): `app/page.tsx`
- [Login](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/login/login.tsx): `app/login/login.tsx`
- [Account and Site access](https://github.com/brilliant666/frame-zero-portfolio-studio/tree/main/db/accounts): `db/accounts`
- [Site workspace routes](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/%5BsiteSlug%5D/admin/route.node.ts): `app/[siteSlug]/admin/route.node.ts`

### Editing and assets

- [Basic editor](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/admin/admin-provider.tsx): `app/admin/admin-provider.tsx`
- [Premium editor](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/preview-workspace/admin.tsx): `app/preview-workspace/admin.tsx`
- [Site photo assets](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/site-editor/assets-client.ts): `app/site-editor/assets-client.ts`
- [Photo manifest and assignment](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/photo-library.ts): `app/photo-library.ts`

### Draft and publication

- [Space content validation](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/site-editor/content-schema.ts): `app/site-editor/content-schema.ts`
- [Site draft operations](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/site-editor/server.ts): `app/site-editor/server.ts`
- [Account data services](https://github.com/brilliant666/frame-zero-portfolio-studio/tree/main/db/accounts): `db/accounts`
- [Premium publication history](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/db/accounts/publications.mjs): `db/accounts/publications.mjs`
- [Saved draft preview](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/preview-workspace/server.ts): `app/preview-workspace/server.ts`
- [Premium portfolio document](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/preview-workspace/document.ts): `app/preview-workspace/document.ts`

### Templates and public site

- [Template composition](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/templates/template-preview-composition.ts): `app/templates/template-preview-composition.ts`
- [Composition assignment](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/template-composition/assignment.ts): `app/template-composition/assignment.ts`
- [Template catalog](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/templates/catalog.ts): `app/templates/catalog.ts`
- [Polaroid experience](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/templates/polaroid-field/composer-scene.tsx): `app/templates/polaroid-field/composer-scene.tsx`
- [Published portfolio](https://github.com/brilliant666/frame-zero-portfolio-studio/blob/main/app/%5BsiteSlug%5D/page.node.tsx): `app/[siteSlug]/page.node.tsx`

### Other components

- **Photographer**
- **Public visitor**
- **PostgreSQL account store**
- **Private asset storage**

## Connections

- Photographer → Platform pages: opens platform (evidence: `README.md`)
- Photographer → Login: signs in (evidence: `README.md`)
- Login → Account and Site access: authenticates (evidence: `README.md`)
- Account and Site access → PostgreSQL account store: reads account (evidence: `README.md`)
- Photographer → Site workspace routes: opens own Site (evidence: `README.md`)
- Site workspace routes → Account and Site access: checks ownership (evidence: `README.md`)
- Site workspace routes → Basic editor: routes authorized (evidence: `README.md`)
- Site workspace routes → Premium editor: routes authorized (evidence: `README.md`)
- Basic editor → Site photo assets: loads assets (evidence: `app/admin/admin-provider.tsx`)
- Premium editor → Site photo assets: uses Site assets (evidence: `README.md`)
- Site photo assets → Photo manifest and assignment: validates manifest (evidence: `app/site-editor/assets-client.ts`)
- Site photo assets → Private asset storage: uploads and reads (evidence: `README.md`)
- Basic editor → Site draft operations: saves draft (evidence: `README.md`)
- Premium editor → Site draft operations: saves draft (evidence: `README.md`)
- Site draft operations → Space content validation: validates content (evidence: `app/site-editor/server.ts`)
- Site draft operations → Account data services: authorizes and persists (evidence: `app/site-editor/server.ts`)
- Account data services → PostgreSQL account store: reads and writes (evidence: `README.md`)
- Premium editor → Saved draft preview: requests saved preview (evidence: `README.md`)
- Saved draft preview → Premium portfolio document: parses document (evidence: `app/preview-workspace/server.ts`)
- Saved draft preview → PostgreSQL account store: reads legacy preview data (evidence: `app/preview-workspace/server.ts`)
- Premium editor → Premium publication history: publishes saved version (evidence: `README.md`)
- Premium publication history → Account data services: stores publication state (evidence: `README.md`)
- Premium publication history → PostgreSQL account store: updates Published pointer (evidence: `README.md`)
- Basic editor → Template composition: previews layout (evidence: `app/admin/template/template-composition-preview.tsx`)
- Template composition → Composition assignment: assigns photos (evidence: `app/templates/template-preview-composition.ts`)
- Template composition → Photo manifest and assignment: maps assets to works (evidence: `app/templates/template-preview-composition.ts`)
- Basic editor → Template catalog: selects template
- Template catalog → Published portfolio: defines available templates (evidence: `README.md`)
- Public visitor → Published portfolio: visits published Site (evidence: `README.md`)
- Published portfolio → Premium publication history: resolves Published only (evidence: `README.md`)
- Published portfolio → Polaroid experience: renders portfolio (evidence: `README.md`)
- Saved draft preview → Polaroid experience: previews collections
