How tranvanduc21092k6-netizen/faceless works
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: (site) Site pages · create/route.js Create payment · [slug]/route.js Content API · AuthContext.jsx Auth context
Components 26
Media experience
- Site pages
faceless-app/app/(site) - Article view
faceless-app/src/views/ArticlePage.jsx - Reader route
faceless-app/app/read/[slug]/page.jsx - Reader view
faceless-app/src/views/ReadView.jsx - Audio player
faceless-app/src/components/ui/AudioPlayer.jsx - Playback bar
faceless-app/src/components/ui/AudioPlaybackBar.jsx - Navigation
faceless-app/src/components/layout/Navbar.jsx - Reader sidebar
faceless-app/src/components/layout/SideNavBar.jsx - Membership prompt
faceless-app/src/components/modals/MembershipModal.jsx
Identity and access
- Account pages
faceless-app/src/views - Auth context
faceless-app/src/context/AuthContext.jsx
Premium payments
- Checkout view
faceless-app/src/views/CheckoutPage.jsx - Create payment
faceless-app/app/api/payment/create/route.js - Payment status
faceless-app/app/api/payment/status/[paymentId]/route.js - Payment webhook
faceless-app/app/api/payment/webhook/route.js - Payment outcome views
faceless-app/src/views
Content operations
- Content API
faceless-app/app/api/content/[slug]/route.js - Admin console
faceless-app/src/views/AdminPage.jsx
Persistence and parsing
- Client PocketBase
faceless-app/src/lib/pocketbase.js - Server PocketBase
faceless-app/src/lib/pocketbase/server.js - Admin PocketBase
faceless-app/src/lib/pocketbase/admin.js - Markdown parser
faceless-app/src/lib/utils/markdown.js - PocketBase records
Other components
- Visitor
- Member
- Payment gateway
Connections 29
- Visitor → Site pages: browses
- Member → Account pages: uses
- Member → Reader route: opens
faceless-app/app/read/[slug]/page.jsx - Member → Checkout view: starts checkout
- Payment gateway → Payment webhook: sends notification
faceless-app/app/api/payment/webhook/route.js - Navigation → Auth context: reads auth state
faceless-app/src/components/layout/Navbar.jsx - Reader sidebar → Auth context: reads auth state
faceless-app/src/components/layout/SideNavBar.jsx - Auth context → Client PocketBase: authenticates users
faceless-app/src/context/AuthContext.jsx - Reader route → Reader view: renders with status
faceless-app/app/read/[slug]/page.jsx - Reader view → Reader sidebar: uses navigation
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
faceless-app/app/api/content/[slug]/route.js - Content API → Markdown parser: parses markdown
faceless-app/app/api/content/[slug]/route.js - Content API → PocketBase records: reads episode records
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
faceless-app/src/views/AdminPage.jsx - Admin console → Client PocketBase: manages records
faceless-app/src/views/AdminPage.jsx - Checkout view → Create payment: creates payment
- Create payment → Server PocketBase: checks session
faceless-app/app/api/payment/create/route.js - Create payment → Admin PocketBase: writes payment
faceless-app/app/api/payment/create/route.js - Create payment → PocketBase records: creates pending payment
faceless-app/app/api/payment/create/route.js - Payment status → Admin PocketBase: fetches payment
faceless-app/app/api/payment/status/[paymentId]/route.js - Payment status → PocketBase records: reads payment and user
faceless-app/app/api/payment/status/[paymentId]/route.js - Payment outcome views → Payment status: polls status
- Payment webhook → Admin PocketBase: records transaction
faceless-app/app/api/payment/webhook/route.js - Payment webhook → PocketBase records: updates payment and role
faceless-app/app/api/payment/webhook/route.js