How dragonminez/dragonminez-web works
DragonMineZ Web is a community platform for browsing, previewing, creating, and sharing Minecraft character hair designs, with favorites, voting, a multilingual interface, and a forum. The central workflow is browsing or previewing designs, then creating or managing one through authenticated API and persistence layers. The editor and forum are distinct product branches. Edges are limited to relationships shown in excerpts, the source index, or the README; several feature implementations were not sampled, so their internal wiring is left unspecified.
Main entry points: auth.ts Forum Identity · hairThumbnails.ts Thumbnail Renderer · index.ts Hair API · hair.repository.ts Hair Repository
Components 23
Hair Salon
- Hair Catalog
src/components/features/hairs/HairList.tsx - 3D Preview
src/components/features/hairs/HairPreview.tsx - Hair Form
src/hooks/useHairForm.ts
Design Editor
- Hair Editor
src/components/features/editor/HairEditorPage.tsx - Thumbnail Renderer
src/components/features/editor/hairThumbnails.ts - Hair Scene
src/components/features/editor/hairScene.ts - Hair Codec
src/lib/hair/codec.ts
API and Data
- Hair API
src/pages/api/hairs/index.ts - Hair Service
src/services/hair.service.ts - Hair Repository
src/repositories/hair.repository.ts - PostgreSQL
- Prisma Client
src/lib/prisma.ts
Community Features
- Favorites
src/hooks/useLike.ts - Voting
src/components/features/vote/VotingSystem.tsx - Forum Actions
src/pages/forum/act/[action].ts - Forum Identity
src/lib/forum/auth.ts
Shared Platform
- Language Store
src/i18n/store.ts - Language Provider
src/providers/LanguageProvider.tsx - Language Hook
src/i18n/useLanguage.ts - Request Middleware
src/middleware.ts - API Responses
src/lib/api/response.ts
Other components
- Site Visitor
- Discord
Connections 23
- Site Visitor → Hair Catalog: browses
- Hair Catalog → 3D Preview: shows previews
- Site Visitor → Hair Editor: creates designs
- 3D Preview → Thumbnail Renderer: requests thumbnails
src/components/features/hairs/HairPreview.tsx - Thumbnail Renderer → Hair Scene: uses scene
src/components/features/editor/hairThumbnails.ts - Thumbnail Renderer → Hair Codec: decodes hair
src/components/features/editor/hairThumbnails.ts - Hair Form → Hair Codec: validates codes
src/hooks/useHairForm.ts - Hair Form → Hair API: submits designs
src/hooks/useHairForm.ts - Hair API → Hair Service: calls service
src/pages/api/hairs/index.ts - Hair API → Hair Repository: calls repository
src/pages/api/hairs/index.ts - Hair Service → Hair Repository: delegates queries
src/services/hair.service.ts - Hair Repository → Prisma Client: queries through
src/repositories/hair.repository.ts - Prisma Client → PostgreSQL: connects to
src/lib/prisma.ts - Site Visitor → Favorites: saves favorites
- Site Visitor → Voting: votes
- Site Visitor → Forum Actions: uses forum
- Forum Actions → Forum Identity: checks identity
- Forum Identity → Discord: checks staff roles
src/lib/forum/auth.ts - Forum Identity → Prisma Client: loads forum user
src/lib/forum/auth.ts - Language Provider → Language Hook: provides context
src/i18n/useLanguage.ts - Language Hook → Language Store: reads and updates
src/i18n/useLanguage.ts - Request Middleware → API Responses: uses responses
src/middleware.ts - Request Middleware → Forum Identity: loads identity
src/middleware.ts