How gillandghaz/gramofon-web works
Gramofon is a browser-based personal audio/video library and player, with private playlists and an admin-managed shared Explore catalog. The main user journey is sign-in, upload media directly to Cloudinary through a server-authorized signed-upload flow, register metadata in Firestore, then manage and play the collection; admins also curate shared media and manage users and settings. The graph combines documented capabilities with sampled route and library evidence; the large app page and several feature modules were not inspected, so their internal call paths are not inferred.
Main entry points: server-auth.js Server authorization · firebase-admin.js Firebase Admin access · cloudinary-admin.js Cloudinary administration · page.js Player and library UI
Components 21
Web experience
- Landing and auth pages
src/app/page.js - Login and registration
src/app/login/page.js - Player and library UI
src/app/app/page.js - Account dashboard
src/app/dashboard/page.js - Admin controls
src/components/tabs/AdminTab.js
Identity and accounts
- Client auth state
src/lib/auth-context.js - User profiles
src/lib/profile.js - Session and auth routes
src/app/api/auth - User administration
src/app/api/admin/delete-user/route.js - Profile photo routes
src/app/api/profile/photo
Media and catalogs
- Private media routes
src/app/api/media - Explore catalog routes
src/app/api/explore
Backend and services
- Server authorization
src/lib/server-auth.js - Firebase Admin access
src/lib/firebase-admin.js - Firebase client SDK
src/lib/firebase.js - Cloudinary administration
src/lib/cloudinary-admin.js - Client media upload
src/lib/cloudinary-upload.js - Firestore metadata
- Firebase Authentication
- Cloudinary media store
Other components
- Browser user
Connections 32
- Browser user → Landing and auth pages: opens
README.md - Browser user → Login and registration: signs in
README.md - Browser user → Player and library UI: uses player
README.md - Browser user → Account dashboard: manages account
README.md - Browser user → Admin controls: administers
src/components/tabs/AdminTab.js - Login and registration → Firebase Authentication: authenticates with
README.md - Client auth state → Firebase client SDK: uses SDK
src/lib/auth-context.js - Client auth state → User profiles: ensures profile
src/lib/auth-context.js - Client auth state → Firestore metadata: listens to profile
src/lib/auth-context.js - Player and library UI → Firebase client SDK: uses SDK
README.md - Player and library UI → Private media routes: requests upload authorization
README.md - Private media routes → Server authorization: checks user
src/app/api/media/sign-upload/route.js - Private media routes → Firebase Admin access: reads and writes metadata
src/app/api/media/confirm-upload/route.js - Private media routes → Cloudinary administration: signs and verifies assets
src/app/api/media/confirm-upload/route.js - Firebase Admin access → Firestore metadata: accesses
src/lib/firebase-admin.js - Firebase client SDK → Firestore metadata: reads and writes
README.md - Firebase client SDK → Firebase Authentication: uses
src/lib/firebase.js - Browser user → Cloudinary media store: uploads signed media
README.md - Cloudinary administration → Cloudinary media store: signs and manages assets
src/lib/cloudinary-admin.js - Browser user → Cloudinary media store: streams media
README.md - Player and library UI → Explore catalog routes: loads shared catalog
README.md - Explore catalog routes → Server authorization: checks admin
src/app/api/explore/confirm-upload/route.js - Explore catalog routes → Firebase Admin access: stores catalog metadata
src/app/api/explore/confirm-upload/route.js - Explore catalog routes → Cloudinary administration: verifies and manages assets
src/app/api/explore/confirm-upload/route.js - Admin controls → User administration: removes users
src/app/api/admin/delete-user/route.js - User administration → Firebase Admin access: deletes account data
src/app/api/admin/delete-user/route.js - User administration → Cloudinary administration: cleans profile image
src/app/api/admin/delete-user/route.js - Session and auth routes → Server authorization: verifies sessions
src/app/api/auth/gate/route.js - Server authorization → Firebase Admin access: verifies tokens and profiles
src/lib/server-auth.js - Account dashboard → Profile photo routes: updates profile photo
README.md - Profile photo routes → Server authorization: checks user
src/app/api/profile/photo/confirm/route.js - Profile photo routes → Cloudinary administration: verifies image
src/app/api/profile/photo/confirm/route.js