feat(brief): store week-level brief and return it when no SourceText exists

models/WeekBrief.js

@@ -0,0 +1,22 @@
+const mongoose = require('mongoose');
+
+const weekBriefSchema = new mongoose.Schema({
+  category: {
+    type: String,
+    enum: ['tutorial', 'weekly-practice'],
+    required: true,
+    index: true
+  },
+  weekNumber: {
+    type: Number,
+    required: true,
+    index: true
+  },
+  translationBrief: {
+    type: String,
+  }
+}, { timestamps: true, indexes: [{ fields: { category: 1, weekNumber: 1 }, unique: true }] });
+
+module.exports = mongoose.model('WeekBrief', weekBriefSchema);
+
+

routes/auth.js

@@ -447,10 +447,13 @@ router.put('/admin/tutorial-brief/:weekNumber', authenticateToken, requireAdmin,
 router.put('/admin/weekly-brief/:weekNumber', authenticateToken, requireAdmin, async (req, res) => {
   try {
     const SourceText = require('../models/SourceText');
+    const WeekBrief = require('../models/WeekBrief');
     const { translationBrief } = req.body;
     const weekNumber = parseInt(req.params.weekNumber);
     if (translationBrief === undefined || translationBrief === null) return res.status(400).json({ error: 'Translation brief is required' });
     const result = await SourceText.updateMany({ category: 'weekly-practice', weekNumber }, { translationBrief });
+    // Also persist a week-level brief so it shows even when no SourceText items exist (e.g., file-based week)
+    await WeekBrief.findOneAndUpdate({ category: 'weekly-practice', weekNumber }, { translationBrief }, { upsert: true, new: true });
     res.json({ success: true, message: `Translation brief updated successfully for ${result.modifiedCount} weekly practice tasks`, modifiedCount: result.modifiedCount });
   } catch (error) {
     console.error('Update weekly practice brief error:', error);

routes/search.js

@@ -43,13 +43,22 @@ router.get('/tutorial-tasks/:week', authenticateToken, async (req, res) => {
 router.get('/weekly-practice/:week', authenticateToken, async (req, res) => {
   try {
     const SourceText = require('../models/SourceText');
+    const WeekBrief = require('../models/WeekBrief');
     const weekNumber = parseInt(req.params.week);
     
     const practice = await SourceText.find({ 
       category: 'weekly-practice',
       weekNumber: weekNumber 
     }).sort({ position: 1, createdAt: 1 });
-    
+
+    // If no SourceText items exist for this week, attempt to fetch week-level brief
+    if (practice.length === 0) {
+      const wb = await WeekBrief.findOne({ category: 'weekly-practice', weekNumber });
+      if (wb && wb.translationBrief) {
+        return res.json([{ _id: `wb-${weekNumber}`, title: `Week ${weekNumber} Brief`, content: '', category: 'weekly-practice', weekNumber, translationBrief: wb.translationBrief }]);
+      }
+    }
+
     res.json(practice);
   } catch (error) {
     // Reduced logging to prevent excessive console output