diary-system/docs/EXPERIENCE.md

经验总结模块需求说明

位置：backend/diary/models.py, frontend/index.html

---

📋 后端模型

Experience 模型

class Experience(models.Model):
    title = CharField(max_length=200)         # 标题
    category = CharField(choices=CATEGORY_CHOICES)  # 类别
    problem = TextField()                     # 问题描述
    solution = TextField()                    # 解决方案
    lesson_learned = TextField()              # 经验教训
    date = DateField()                        # 日期
    created_at = DateTimeField()              # 创建时间

类别选项

• deployment - 📦 部署
• development - 💻 开发
• database - 🗄️ 数据库
• permission - 🔐 权限
• network - 🌐 网络
• other - 其他

---

📋 API 接口

接口	方法	描述
/api/experiences/	GET	获取所有经验
/api/experiences/{id}/	GET	获取单条经验
/api/experiences/	POST	创建经验
/api/experiences/{id}/	PUT	更新经验
/api/experiences/recent/	GET	最近 10 条
/api/experiences/by_category/	GET	按类别分组

---

🎨 前端展示

UI 结构

<div class="experience-item">
    <div class="experience-header">
        <span class="experience-title">标题</span>
        <span class="experience-category">类别</span>
    </div>
    <div class="experience-problem">
        <div class="experience-problem-title">🐛 问题</div>
        <div>问题描述</div>
    </div>
    <div class="experience-solution">
        <div class="experience-solution-title">✅ 解决方案</div>
        <div>解决方案</div>
    </div>
    <div class="experience-lesson">
        <div class="experience-lesson-title">📌 经验教训</div>
        <div>经验教训</div>
    </div>
</div>

---

🔧 修改指南

可以修改的

• ✅ 添加新的类别选项
• ✅ 修改样式
• ✅ 添加新字段
• ✅ 修改展示格式

不能删除的

• ❌ Experience 模型
• ❌ /api/experiences/ 相关 API
• ❌ 经验总结 Tab
• ❌ .experience-item 样式

添加新功能时

1. 修改 models.py 添加字段
2. 运行 makemigrations 和 migrate
3. 更新 serializers.py
4. 更新前端展示
5. 运行 test_frontend.py experience

---

🧪 测试清单

修改后必须验证：

• 经验列表正常显示
• 分类标签正确
• 问题/解决方案格式正确
• 经验教训高亮显示

python3 test_frontend.py experience

---

此文档必须与代码一起维护