# tranvanduc21092k6-netizen/faceless architecture

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

- Interactive diagram: https://gitdiagram.com/tranvanduc21092k6-netizen/faceless
- Repository: https://github.com/tranvanduc21092k6-netizen/faceless

## Overview

Faceless Dialectics is a Next.js media and membership platform for editorial reading and audio, with tiered content access, account management, and premium payments. The main journey runs from public discovery to account sign-in, content access, and (optionally) premium checkout; administrators manage content and users. The README describes an older Vite/React structure, so this map follows the supplied Next.js tree and source excerpts. Unsampled page-to-API calls are shown only as unverified where useful.

Main entry points: [`faceless-app/app/(site)`](https://github.com/tranvanduc21092k6-netizen/faceless/tree/main/faceless-app/app/(site)) (Site pages), [`faceless-app/app/api/payment/create/route.js`](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/api/payment/create/route.js) (Create payment), [`faceless-app/app/api/content/[slug]/route.js`](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/api/content/%5Bslug%5D/route.js) (Content API), [`faceless-app/src/context/AuthContext.jsx`](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/context/AuthContext.jsx) (Auth context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Media experience"]
  node_site_pages["Site pages"]
  node_article_view["Article view<br/>[ArticlePage.jsx]"]
  node_read_route["Reader route<br/>[page.jsx]"]
  node_read_view["Reader view<br/>[ReadView.jsx]"]
  node_audio_player["Audio player<br/>[AudioPlayer.jsx]"]
  node_audio_bar["Playback bar"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_sidebar["Reader sidebar<br/>[SideNavBar.jsx]"]
  node_membership_modal["Membership prompt"]
end

subgraph group_identity["Identity and access"]
  node_auth_pages["Account pages"]
  node_auth_context["Auth context<br/>[AuthContext.jsx]"]
end

subgraph group_payments["Premium payments"]
  node_checkout["Checkout view<br/>[CheckoutPage.jsx]"]
  node_payment_api["Create payment<br/>[route.js]"]
  node_payment_status["Payment status<br/>[route.js]"]
  node_webhook["Payment webhook<br/>[route.js]"]
  node_payment_views["Payment outcome views"]
end

subgraph group_operations["Content operations"]
  node_content_api["Content API<br/>[route.js]"]
  node_admin_page["Admin console<br/>[AdminPage.jsx]"]
end

subgraph group_platform["Persistence and parsing"]
  node_client_pb["Client PocketBase<br/>[pocketbase.js]"]
  node_server_pb["Server PocketBase<br/>[server.js]"]
  node_admin_pb["Admin PocketBase<br/>[admin.js]"]
  node_markdown["Markdown parser<br/>[markdown.js]"]
  node_pb_store[("PocketBase records")]
end

node_visitor(("Visitor"))
node_member(("Member"))
node_gateway(("Payment gateway"))

node_visitor -->|"browses"| node_site_pages
node_member -->|"uses"| node_auth_pages
node_member -->|"opens"| node_read_route
node_member -.->|"starts checkout"| node_checkout
node_gateway -->|"sends notification"| node_webhook
node_navbar -->|"reads auth state"| node_auth_context
node_sidebar -->|"reads auth state"| node_auth_context
node_auth_context -->|"authenticates users"| node_client_pb
node_read_route -->|"renders with status"| node_read_view
node_read_view -->|"uses navigation"| node_sidebar
node_site_pages -.->|"routes to"| node_article_view
node_article_view -.->|"requests content"| node_content_api
node_content_api -->|"creates session client"| node_server_pb
node_content_api -->|"parses markdown"| node_markdown
node_content_api -->|"reads episode records"| node_pb_store
node_site_pages -->|"uses audio"| node_audio_player
node_site_pages -->|"uses playback bar"| node_audio_bar
node_site_pages -->|"uses membership prompt"| node_membership_modal
node_admin_page -->|"checks session"| node_auth_context
node_admin_page -->|"manages records"| node_client_pb
node_checkout -.->|"creates payment"| node_payment_api
node_payment_api -->|"checks session"| node_server_pb
node_payment_api -->|"writes payment"| node_admin_pb
node_payment_api -->|"creates pending payment"| node_pb_store
node_payment_status -->|"fetches payment"| node_admin_pb
node_payment_status -->|"reads payment and user"| node_pb_store
node_payment_views -.->|"polls status"| node_payment_status
node_webhook -->|"records transaction"| node_admin_pb
node_webhook -->|"updates payment and role"| node_pb_store

click node_site_pages "https://github.com/tranvanduc21092k6-netizen/faceless/tree/main/faceless-app/app/(site)"
click node_article_view "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/views/ArticlePage.jsx"
click node_read_route "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/read/%5Bslug%5D/page.jsx"
click node_read_view "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/views/ReadView.jsx"
click node_audio_player "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/components/ui/AudioPlayer.jsx"
click node_audio_bar "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/components/ui/AudioPlaybackBar.jsx"
click node_navbar "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/components/layout/Navbar.jsx"
click node_sidebar "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/components/layout/SideNavBar.jsx"
click node_membership_modal "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/components/modals/MembershipModal.jsx"
click node_auth_pages "https://github.com/tranvanduc21092k6-netizen/faceless/tree/main/faceless-app/src/views"
click node_auth_context "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/context/AuthContext.jsx"
click node_client_pb "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/lib/pocketbase.js"
click node_server_pb "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/lib/pocketbase/server.js"
click node_admin_pb "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/lib/pocketbase/admin.js"
click node_content_api "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/api/content/%5Bslug%5D/route.js"
click node_markdown "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/lib/utils/markdown.js"
click node_admin_page "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/views/AdminPage.jsx"
click node_checkout "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/views/CheckoutPage.jsx"
click node_payment_api "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/api/payment/create/route.js"
click node_payment_status "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/api/payment/status/%5BpaymentId%5D/route.js"
click node_webhook "https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/api/payment/webhook/route.js"
click node_payment_views "https://github.com/tranvanduc21092k6-netizen/faceless/tree/main/faceless-app/src/views"

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_article_view,node_read_route,node_read_view,node_audio_player,node_audio_bar,node_navbar,node_sidebar,node_membership_modal toneBlue
class node_auth_pages,node_auth_context toneAmber
class node_checkout,node_payment_api,node_payment_status,node_webhook,node_payment_views toneMint
class node_content_api,node_admin_page toneRose
class node_client_pb,node_server_pb,node_admin_pb,node_markdown,node_pb_store,node_visitor,node_member,node_gateway toneIndigo
```

## Components

### Media experience

- [Site pages](https://github.com/tranvanduc21092k6-netizen/faceless/tree/main/faceless-app/app/(site)): `faceless-app/app/(site)`
- [Article view](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/views/ArticlePage.jsx): `faceless-app/src/views/ArticlePage.jsx`
- [Reader route](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/read/%5Bslug%5D/page.jsx): `faceless-app/app/read/[slug]/page.jsx`
- [Reader view](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/views/ReadView.jsx): `faceless-app/src/views/ReadView.jsx`
- [Audio player](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/components/ui/AudioPlayer.jsx): `faceless-app/src/components/ui/AudioPlayer.jsx`
- [Playback bar](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/components/ui/AudioPlaybackBar.jsx): `faceless-app/src/components/ui/AudioPlaybackBar.jsx`
- [Navigation](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/components/layout/Navbar.jsx): `faceless-app/src/components/layout/Navbar.jsx`
- [Reader sidebar](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/components/layout/SideNavBar.jsx): `faceless-app/src/components/layout/SideNavBar.jsx`
- [Membership prompt](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/components/modals/MembershipModal.jsx): `faceless-app/src/components/modals/MembershipModal.jsx`

### Identity and access

- [Account pages](https://github.com/tranvanduc21092k6-netizen/faceless/tree/main/faceless-app/src/views): `faceless-app/src/views`
- [Auth context](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/context/AuthContext.jsx): `faceless-app/src/context/AuthContext.jsx`

### Premium payments

- [Checkout view](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/views/CheckoutPage.jsx): `faceless-app/src/views/CheckoutPage.jsx`
- [Create payment](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/api/payment/create/route.js): `faceless-app/app/api/payment/create/route.js`
- [Payment status](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/api/payment/status/%5BpaymentId%5D/route.js): `faceless-app/app/api/payment/status/[paymentId]/route.js`
- [Payment webhook](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/api/payment/webhook/route.js): `faceless-app/app/api/payment/webhook/route.js`
- [Payment outcome views](https://github.com/tranvanduc21092k6-netizen/faceless/tree/main/faceless-app/src/views): `faceless-app/src/views`

### Content operations

- [Content API](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/app/api/content/%5Bslug%5D/route.js): `faceless-app/app/api/content/[slug]/route.js`
- [Admin console](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/views/AdminPage.jsx): `faceless-app/src/views/AdminPage.jsx`

### Persistence and parsing

- [Client PocketBase](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/lib/pocketbase.js): `faceless-app/src/lib/pocketbase.js`
- [Server PocketBase](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/lib/pocketbase/server.js): `faceless-app/src/lib/pocketbase/server.js`
- [Admin PocketBase](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/lib/pocketbase/admin.js): `faceless-app/src/lib/pocketbase/admin.js`
- [Markdown parser](https://github.com/tranvanduc21092k6-netizen/faceless/blob/main/faceless-app/src/lib/utils/markdown.js): `faceless-app/src/lib/utils/markdown.js`
- **PocketBase records**

### Other components

- **Visitor**
- **Member**
- **Payment gateway**

## Connections

- Visitor → Site pages: browses
- Member → Account pages: uses
- Member → Reader route: opens (evidence: `faceless-app/app/read/[slug]/page.jsx`)
- Member → Checkout view: starts checkout
- Payment gateway → Payment webhook: sends notification (evidence: `faceless-app/app/api/payment/webhook/route.js`)
- Navigation → Auth context: reads auth state (evidence: `faceless-app/src/components/layout/Navbar.jsx`)
- Reader sidebar → Auth context: reads auth state (evidence: `faceless-app/src/components/layout/SideNavBar.jsx`)
- Auth context → Client PocketBase: authenticates users (evidence: `faceless-app/src/context/AuthContext.jsx`)
- Reader route → Reader view: renders with status (evidence: `faceless-app/app/read/[slug]/page.jsx`)
- Reader view → Reader sidebar: uses navigation (evidence: `faceless-app/src/views/ReadView.jsx`)
- Site pages → Article view: routes to
- Article view → Content API: requests content
- Content API → Server PocketBase: creates session client (evidence: `faceless-app/app/api/content/[slug]/route.js`)
- Content API → Markdown parser: parses markdown (evidence: `faceless-app/app/api/content/[slug]/route.js`)
- Content API → PocketBase records: reads episode records (evidence: `faceless-app/app/api/content/[slug]/route.js`)
- Site pages → Audio player: uses audio
- Site pages → Playback bar: uses playback bar
- Site pages → Membership prompt: uses membership prompt
- Admin console → Auth context: checks session (evidence: `faceless-app/src/views/AdminPage.jsx`)
- Admin console → Client PocketBase: manages records (evidence: `faceless-app/src/views/AdminPage.jsx`)
- Checkout view → Create payment: creates payment
- Create payment → Server PocketBase: checks session (evidence: `faceless-app/app/api/payment/create/route.js`)
- Create payment → Admin PocketBase: writes payment (evidence: `faceless-app/app/api/payment/create/route.js`)
- Create payment → PocketBase records: creates pending payment (evidence: `faceless-app/app/api/payment/create/route.js`)
- Payment status → Admin PocketBase: fetches payment (evidence: `faceless-app/app/api/payment/status/[paymentId]/route.js`)
- Payment status → PocketBase records: reads payment and user (evidence: `faceless-app/app/api/payment/status/[paymentId]/route.js`)
- Payment outcome views → Payment status: polls status
- Payment webhook → Admin PocketBase: records transaction (evidence: `faceless-app/app/api/payment/webhook/route.js`)
- Payment webhook → PocketBase records: updates payment and role (evidence: `faceless-app/app/api/payment/webhook/route.js`)
