docs: 添加日历功能警告注释(防止误删)

This commit is contained in:
maoshen
2026-04-15 02:16:19 +00:00
parent e91b58b079
commit c8178ce98f
2 changed files with 41 additions and 3 deletions

View File

@@ -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', '📦 部署'),