chore: relocate backend into apps/api ahead of monorepo merge

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-27 00:12:54 +08:00 · 2026-08-24 12:20:40 +08:00
parent af44598df6
commit eaa6d2276a
388 changed files with 0 additions and 13998 deletions
@@ -0,0 +1,102 @@
+/***********************************************************************************************************************************************************************
+ * File Name: groups.routes.js  (client)
+ * Type of Program: Router
+ * Description: Client-facing task routes — groups, task lists, tasks, completions,
+ *              file uploads, and progress tracking.
+ *
+ * Route Map:
+ *   GET  /client/groups                                                                                          → my groups
+ *   GET  /client/groups/:groupId                                                                                 → single group
+ *   GET  /client/groups/:groupId/task-lists                                                                      → task lists (?status=ongoing|completed|overdue)
+ *   GET  /client/groups/:groupId/task-lists/:taskListId                                                          → single task list
+ *   GET  /client/groups/:groupId/task-lists/:taskListId/tasks/:taskId                                            → task + requirements + latest completion
+ *   GET  /client/groups/:groupId/task-lists/:taskListId/tasks/:taskId/progress                                   → full progress snapshot
+ *   GET  /client/groups/:groupId/task-lists/:taskListId/tasks/:taskId/completions/latest                         → latest completion only
+ *   GET  /client/groups/:groupId/task-lists/:taskListId/tasks/:taskId/completions                                → full completion history
+ *   POST /client/groups/:groupId/task-lists/:taskListId/tasks/:taskId/completions                                → submit completion
+ *   POST /client/groups/:groupId/task-lists/:taskListId/tasks/:taskId/upload                                     → upload file to S3 (returns file metadata)
+ *   POST /client/groups/:groupId/task-lists/:taskListId/tasks/:taskId/requirements/:requirementId/visit          → UPSERT link visit
+ *   POST /client/groups/:groupId/task-lists/:taskListId/tasks/:taskId/requirements/:requirementId/progress       → UPSERT lesson progress
+ *
+ * Guards: authenticate + requireClient() applied in client.routes.js
+ *
+ * Author: rgrgogu
+ * Date Created: Jun. 13, 2026
+ ***********************************************************************************************************************************************************************/
+const router = require('express').Router();
+const taskController     = require('../../controllers/client/task.controller');
+const uploadController   = require('../../controllers/client/task_upload.controller');
+const progressController = require('../../controllers/client/task_progress.controller');
+const downloadController = require('../../controllers/client/task_download.controller');
+const { handleUpload }   = require('../../middleware/task_upload.middleware');
+const { sensitiveOpsLimiter } = require('../../middleware/rateLimiter.middleware');
+
+// ─── Groups ───────────────────────────────────────────────────────────────────
+router.get('/', taskController.getMyGroups);
+router.get('/:groupId', taskController.getMyGroup);
+
+// ─── Task Lists ───────────────────────────────────────────────────────────────
+router.get('/:groupId/task-lists', taskController.getGroupTaskLists);
+router.get('/:groupId/task-lists/:taskListId', taskController.getGroupTaskList);
+
+// ─── Tasks ────────────────────────────────────────────────────────────────────
+router.get('/:groupId/task-lists/:taskListId/tasks/:taskId', taskController.getTask);
+
+// ─── Progress snapshot ────────────────────────────────────────────────────────
+router.get(
+    '/:groupId/task-lists/:taskListId/tasks/:taskId/progress',
+    progressController.getTaskProgress
+);
+
+// ─── Completions ──────────────────────────────────────────────────────────────
+// NOTE: /latest must be before / to avoid Express treating "latest" as an ID
+router.get(
+    '/:groupId/task-lists/:taskListId/tasks/:taskId/completions/latest',
+    taskController.getLatestCompletion
+);
+router.get(
+    '/:groupId/task-lists/:taskListId/tasks/:taskId/completions',
+    taskController.getMySubmissions
+);
+router.post(
+    '/:groupId/task-lists/:taskListId/tasks/:taskId/completions',
+    sensitiveOpsLimiter,
+    taskController.submitTask
+);
+router.get(
+    '/:groupId/task-lists/:taskListId/tasks/:taskId/completions/:completionId/files/:fileId/stream',
+    downloadController.streamCompletionFile
+);
+router.get(
+    '/:groupId/task-lists/:taskListId/tasks/:taskId/completions/:completionId/files/:fileId/download',
+    downloadController.downloadCompletionFile
+);
+
+// ─── File upload → S3 ────────────────────────────────────────────────────────
+// Client uploads one file at a time, gets back file metadata,
+// then includes all file references in the completion submit payload.
+router.post(
+    '/:groupId/task-lists/:taskListId/tasks/:taskId/upload',
+    sensitiveOpsLimiter,
+    handleUpload,
+    uploadController.uploadTaskFile
+);
+
+// ─── Requirement-level progress (UPSERT) ─────────────────────────────────────
+router.post(
+    '/:groupId/task-lists/:taskListId/tasks/:taskId/requirements/:requirementId/visit',
+    sensitiveOpsLimiter,
+    progressController.visitLink
+);
+router.delete(
+    '/:groupId/task-lists/:taskListId/tasks/:taskId/requirements/:requirementId/visit',
+    sensitiveOpsLimiter,
+    progressController.unvisitLink
+);
+router.post(
+    '/:groupId/task-lists/:taskListId/tasks/:taskId/requirements/:requirementId/progress',
+    sensitiveOpsLimiter,
+    progressController.updateProgress
+);
+
+module.exports = router;