From c8178ce98fa1c8d1a3154854b9f7e3a25c06e8d3 Mon Sep 17 00:00:00 2001
From: maoshen <maoshen@chengshishouce.com>
Date: Wed, 15 Apr 2026 02:16:19 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E6=97=A5=E5=8E=86?=
 =?UTF-8?q?=E5=8A=9F=E8=83=BD=E8=AD=A6=E5=91=8A=E6=B3=A8=E9=87=8A=EF=BC=88?=
 =?UTF-8?q?=E9=98=B2=E6=AD=A2=E8=AF=AF=E5=88=A0=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 backend/diary/models.py | 26 ++++++++++++++++++++++++--
 frontend/index.html     | 18 +++++++++++++++++-
 2 files changed, 41 insertions(+), 3 deletions(-)

diff --git a/backend/diary/models.py b/backend/diary/models.py
index f9199e4..c79a09b 100755
--- a/backend/diary/models.py
+++ b/backend/diary/models.py
@@ -2,7 +2,20 @@ from django.db import models
 from django.utils import timezone
 
 class DiaryEntry(models.Model):
-    """日记条目 - 作为所有记录的主入口"""
+    """
+    ⚠️ 核心模型：日记条目
+    与日历组件关联 - 修改此模型会影响日历功能
+    
+    日历功能依赖：
+    - date 字段（唯一）- 用于日历标记
+    - linked_tasks - 关联任务
+    - extract_experience() - 提炼经验
+    
+    修改前必须：
+    1. 阅读 docs/CALENDAR.md
+    2. 确认不影响日历显示
+    3. 运行 test_frontend.py diary 验证
+    """
     date = models.DateField('日期', unique=True)
     title = models.CharField('标题', max_length=200, default='每日日记')
     content = models.TextField('日记内容', blank=True, default='')
@@ -47,7 +60,16 @@ class DiaryEntry(models.Model):
 
 
 class Experience(models.Model):
-    """经验总结 - 记录遇到的问题和解决方法"""
+    """
+    ⚠️ 核心模型：经验总结
+    从日记提炼的经验教训
+    
+    关联：
+    - extracted_from - 可选，关联到日记
+    - category - 分类显示
+    
+    修改前阅读 docs/EXPERIENCE.md
+    """
     title = models.CharField('标题', max_length=200)
     category = models.CharField('类别', max_length=50, choices=[
         ('deployment', '📦 部署'),
diff --git a/frontend/index.html b/frontend/index.html
index b844264..29f51ef 100644
--- a/frontend/index.html
+++ b/frontend/index.html
@@ -4,6 +4,19 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>码神的日记系统</title>
+    <!-- 
+    ⚠️⚠️⚠️ 核心功能：日历组件 ⚠️⚠️⚠️
+    修改此文件前必须：
+    1. 阅读 docs/CALENDAR.md 了解日历功能
+    2. 确认不会删除日历相关代码
+    3. 修改后运行 test_frontend.py diary 验证
+    
+    日历功能包括：
+    - 月历视图显示
+    - 点击日期显示日记
+    - 上月/下月切换
+    - 有日记的日期标记 📝
+    -->
     <style>
         * {
             margin: 0;
@@ -102,7 +115,7 @@
             border-bottom: 2px solid #667eea;
         }
         
-        /* 日历组件 */
+        /* ⚠️ 日历组件样式 - 核心功能，不可删除 */
         .calendar-wrapper {
             display: flex;
             gap: 20px;
@@ -596,6 +609,7 @@
             return state.allEntries.find(entry => entry.date === date);
         }
 
+        // ⚠️ 核心功能：渲染日历 - 不可删除
         function renderCalendar(year, month, selectedDate, hasDataDates) {
             const firstDay = new Date(year, month, 1);
             const lastDay = new Date(year, month + 1, 0);
@@ -896,6 +910,7 @@
             render();
         }
 
+        // ⚠️ 核心功能：选择日期显示日记 - 不可删除
         function selectDate(date) {
             state.selectedDate = date;
             render();
@@ -906,6 +921,7 @@
             render();
         }
 
+        // ⚠️ 核心功能：切换月份 - 不可删除
         function changeMonth(delta) {
             if (!state.currentCalendar) {
                 state.currentCalendar = new Date();