How ngtruongmetin/twd_hpd works
This is a competition-submission and judging platform with a React role-based portal and an Express/SQLite API. Users register or sign in, submit and manage entries, judges score them, administrators manage seasons and competition data, and public users can look up results; administrators also handle voting metrics and exports. The graph follows documented routing and sampled controller/service calls. Several feature paths are visible only in the tree or route index, so their internal links are omitted or marked unverified.
Main entry points: db.js SQLite database · server.js HTTP server · App.tsx Route shell · ExportController.js Exports and statistics
Components 25
Web portal
- Route shell
frontend/src/App.tsx - Auth state
frontend/src/context/AuthContext.tsx - Entry workspace
frontend/src/pages/contestant/Submissions.tsx - Judge workspace
frontend/src/pages/judge/Submissions.tsx - Admin workspaces
frontend/src/pages/tw_admin/Submissions.tsx - Public lookup
frontend/src/pages/LookupSubmissions.tsx
API and access
- HTTP server
backend/server.js - Session authorization
backend/middlewares/AuthMiddleware.js - Account access
backend/controllers/AuthController.js
Competition workflow
- Submission handling
backend/controllers/SubmissionController.js - Judge scoring
backend/controllers/JudgeScoreController.js - Result finalization
backend/controllers/SubmissionResultController.js - Score totals
backend/services/ScoreTotalService.js - Complaint messaging
backend/controllers/ComplaintController.js - Voting metrics
backend/services/VoteMetricsService.js
Administration and reporting
- Central administration
backend/controllers/TwAdminController.js - Technical administration
backend/controllers/TechAdminController.js - Resource management
backend/controllers/ResourceController.js - Exports and statistics
backend/controllers/ExportController.js - Public lookup API
backend/controllers/PublicLookupController.js
Storage and integrations
- SQLite database
backend/utils/db.js - Mail delivery
backend/utils/mailer.js - Google Drive
backend/utils/google.js - Export formatting
backend/models/DataModel.js
Other components
- Portal users
Connections 31
- Portal users → Route shell: uses portal
frontend/src/App.tsx - Route shell → Auth state: provides auth
frontend/src/App.tsx - Route shell → Entry workspace: routes contestants
frontend/src/App.tsx - Route shell → Judge workspace: routes judges
frontend/src/App.tsx - Route shell → Admin workspaces: routes admins
frontend/src/App.tsx - Route shell → Public lookup: routes lookup
frontend/src/App.tsx - Entry workspace → HTTP server: requests API
- Judge workspace → HTTP server: requests API
- Admin workspaces → HTTP server: requests API
- Public lookup → HTTP server: requests API
- HTTP server → Session authorization: protects routes
backend/server.js - HTTP server → Submission handling: routes submissions
- HTTP server → Judge scoring: routes scores
- HTTP server → Central administration: routes admin
- HTTP server → SQLite database: initializes schema
backend/server.js - Submission handling → SQLite database: reads and writes
backend/controllers/SubmissionController.js - Judge scoring → Score totals: calculates totals
backend/controllers/JudgeScoreController.js - Judge scoring → SQLite database: reads and writes
backend/controllers/JudgeScoreController.js - Result finalization → Score totals: calculates totals
backend/controllers/SubmissionResultController.js - Result finalization → SQLite database: reads and writes
backend/controllers/SubmissionResultController.js - Central administration → Voting metrics: uses metrics
backend/controllers/TwAdminController.js - Central administration → SQLite database: reads and writes
backend/controllers/TwAdminController.js - Exports and statistics → SQLite database: queries data
backend/controllers/ExportController.js - Exports and statistics → Export formatting: formats export
backend/controllers/ExportController.js - Exports and statistics → SQLite database: loads provinces
backend/controllers/ExportController.js - Resource management → SQLite database: manages records
backend/controllers/ResourceController.js - Public lookup API → SQLite database: queries entries
backend/controllers/PublicLookupController.js - Account access → SQLite database: reads and writes
backend/controllers/AuthController.js - Account access → Mail delivery: sends messages
backend/controllers/AuthController.js - Submission handling → Google Drive: checks Drive links
- Complaint messaging → SQLite database: stores messages