How qianqiuzy/harei-frontend works
Harei Frontend is a Next.js site for public Harei pages and interactive features, with separate general-admin and music-admin areas. The main visitor flow spans home/status, message box, music catalog, downloads, and captain-gift content; admin workflows manage messages, images, captain-gift assets, and music metadata. The graph captures documented capabilities and source-index-supported relationships. Several route implementations are unsampled, so their internal calls are omitted rather than inferred.
Main entry points: page.tsx Message box page · client.ts Music admin client · session.ts Session and auth · api.ts Browser API client
Components 28
Visitor experience
- Home and status
app/page.tsx - About page
app/about/page.tsx - Downloads
app/download/page.tsx - Download proxy
app/api/download-file/route.ts - Captain gifts
app/captaingift/page.tsx - Gift image route
app/api/captaingift-image/[filename]/route.ts
Message box
- Message box page
app/box/page.tsx - Emoji editor and picker
components/box/BoxEmojiEditor.tsx - Message rendering
components/box/BoxMessage.tsx - Emoji API routes
app/api/emoji/route.ts - Emoji catalog helpers
lib/box/emojis.ts
Administration
- Admin dashboard
app/admin/page.tsx - Message moderation
app/admin/message/page.tsx - Admin audit
app/admin/audit/page.tsx - Gift administration
app/admin/captaingift/page.tsx - Gift upload workflow
app/admin/captaingift/use-captaingift-upload.ts
Music catalog
- Music catalog UI
app/music/_components/MusicCatalog.tsx - Music API client
lib/music/client.ts - Music data schemas
lib/music/schemas.ts - Music management UI
app/music-admin/songs/page.tsx - Performance manager
app/music-admin/_components/PerformanceManager.tsx - Music admin client
lib/music-admin/client.ts - Admin data schemas
lib/music-admin/schemas.ts
Shared services
- Session and auth
lib/auth/session.ts - Browser API client
lib/api.ts - Server API base
lib/server-api.ts
Other components
- Visitor
- Harei backend
Connections 34
- Visitor → Home and status: opens
README.md - Visitor → Message box page: uses
README.md - Visitor → Music catalog UI: browses
README.md - Visitor → Downloads: opens
README.md - Visitor → Captain gifts: views
README.md - Downloads → Download proxy: requests file
- Download proxy → Server API base: uses base
app/api/download-file/route.ts - Download proxy → Harei backend: proxies download
app/api/download-file/route.ts - Captain gifts → Gift image route: loads images
- Gift image route → Server API base: uses base
app/api/captaingift-image/[filename]/route.ts - Gift image route → Harei backend: proxies image
app/api/captaingift-image/[filename]/route.ts - Message box page → Emoji editor and picker: renders
app/box/page.tsx - Message box page → Message rendering: renders
- Emoji editor and picker → Emoji catalog helpers: uses helpers
components/box/BoxEmojiEditor.tsx - Message box page → Emoji catalog helpers: loads groups
app/box/page.tsx - Emoji API routes → Server API base: uses base
app/api/emoji/route.ts - Emoji API routes → Harei backend: proxies emoji
app/api/emoji/route.ts - Admin dashboard → Session and auth: authenticates
- Message moderation → Message rendering: renders messages
app/admin/message/page.tsx - Message moderation → Session and auth: requires session
- Admin audit → Message rendering: renders messages
app/admin/audit/page.tsx - Gift administration → Gift upload workflow: uses workflow
- Music catalog UI → Music API client: loads catalog
- Music API client → Browser API client: uses client
lib/music/client.ts - Music API client → Music data schemas: validates data
lib/music/client.ts - Music management UI → Music admin client: calls management API
app/music-admin/songs/page.tsx - Music management UI → Session and auth: uses session
app/music-admin/songs/page.tsx - Performance manager → Music admin client: mutates records
app/music-admin/_components/PerformanceManager.tsx - Music admin client → Browser API client: uses client
lib/music-admin/client.ts - Music admin client → Admin data schemas: validates responses
lib/music-admin/client.ts - Admin data schemas → Music data schemas: reuses schemas
lib/music-admin/schemas.ts - Session and auth → Browser API client: calls auth API
lib/auth/session.ts - Browser API client → Harei backend: sends browser requests
README.md - Server API base → Harei backend: configures server proxy
README.md