How sure-block/sure works
Sure の小站 is a personal blog and interactive site with a Vue-based administration console. Visitors browse posts, photos, projects, bookmarks, and moments; they can comment or leave messages, while administrators manage content and site settings. Next.js pages and API routes handle these workflows, with Prisma-backed persistence and shared authentication and object-storage helpers. Music, a novel reader, and the Garden of interactive tools are additional visitor-facing capabilities. The README documents several features whose detailed implementation was not sampled, so those branches are shown at subsystem level; edges are limited to sampled references and documented relationships.
Main entry points: posts/route.ts Post endpoints · api Next.js API routes · prisma.ts Prisma data access · music/route.ts Music endpoints
Components 22
Visitor experience
- Home dashboard
app/HomeClient.tsx - Posts and comments
app/posts/page.tsx - Moments feed
app/moments/page.tsx - Music experience
app/music/page.tsx - Novel reader
app/novel/[bookUrl]/page.tsx - Interactive Garden
app/garden - Music playback state
components/providers/MusicProvider.tsx
Administration
- Admin console
admin/src - Content management
admin/src/views/post - Site configuration
admin/src/views/site-config/index.vue
API and services
- Next.js API routes
app/api - Post endpoints
app/api/posts/route.ts - Music endpoints
app/api/music/route.ts - Authentication routes
app/api/auth - Token authentication
app/lib/auth.ts - Message client
app/api/messages.ts
Persistence and integrations
- Prisma data access
app/lib/prisma.ts - SQLite database
- R2 object storage
app/lib/r2.ts - Site config data
app/lib/site-config-db.ts - Default site settings
siteConfig.ts
Other components
- Site visitor
Connections 24
- Site visitor → Home dashboard: opens
- Home dashboard → Posts and comments: browses
- Site visitor → Posts and comments: reads and comments
- Site visitor → Moments feed: reads and reacts
- Moments feed → Next.js API routes: requests moments
app/moments/page.tsx - Posts and comments → Next.js API routes: loads posts
app/posts/page.tsx - Site visitor → Music experience: plays music
- Music experience → Music playback state: uses playback state
app/music/page.tsx - Site visitor → Novel reader: reads novels
- Site visitor → Interactive Garden: uses tools
- Admin console → Content management: manages posts
- Admin console → Site configuration: manages settings
- Content management → Post endpoints: submits content
- Next.js API routes → Post endpoints: routes requests
- Post endpoints → Token authentication: checks identity
app/api/posts/route.ts - Post endpoints → Prisma data access: reads and writes
app/api/posts/route.ts - Music endpoints → Prisma data access: reads music
app/api/music/route.ts - Authentication routes → Token authentication: uses tokens
- Prisma data access → SQLite database: persists records
app/lib/prisma.ts - Site config data → Prisma data access: reads settings
app/lib/site-config-db.ts - Site config data → Default site settings: falls back to
- Message client → Next.js API routes: calls endpoints
app/api/messages.ts - Music endpoints → R2 object storage: uploads audio
- Music endpoints → Token authentication: checks administrator