sycamore: Instructions file for Claude Code

CLAUDE.md

本文件为 Claude Code (claude.ai/code) 在此仓库中工作时提供指导。

Project Overview

Sycamore —— 个人人生管理系统，为单人使用设计。聚合每日记录、目标、项目、健康、财务、人际关系、旅行日志和数字资产于统一仪表盘。

• 后端: Django 6.0.4 + DRF + django-cors-headers
• 前端: Vue 3 + TypeScript + Vite 7 + Pinia + Vue Router + Element Plus + ECharts
• 数据库: MySQL | Python 3.14 | Node ^20.19.0 || >=22.12.0
• 虚拟环境: .venv/（项目根目录）

Architecture

Backend (backend/)

• App 按生命维度划分，每个 App 自包含（models/services/views/urls）
• 瘦 view，胖 service：业务逻辑放 services.py，views 只做路由和参数校验
• ModelViewSet 模式，除非有特殊需求（wealth 既有「按 managed 表走 ModelViewSet」的 CRUD 端点，也有「一次算全」的 APIView 汇总端点，两种并存）
• 序列化器显式声明字段，不用 __all__
• 环境配置分离：settings 分 base / development / production

backend/
├── sycamore/         # 项目配置（settings/urls/asgi/wsgi）
├── apps/             # 20 个 app（INSTALLED_APPS 为准）
│   ├── core/         # 基础设施（分页 / 用户画像 / 通知）
│   ├── temporal/     # 时间感知（日记 + 时间统计 + 活动追踪）
│   ├── health/       # 健康管理
│   ├── wealth/       # 财务管理
│   ├── relation/     # 关系管理
│   ├── book/         # 书籍阅读
│   ├── sugar/        # 小确幸
│   ├── dance/        # 舞蹈记录
│   ├── travel/       # 旅行记录
│   ├── reward/       # 奖励池
│   ├── goals/        # 目标管理
│   ├── redemption/   # 三年赎回期
│   ├── selfrun/      # 自我运转（KPI 制定→执行→复盘→事后分析）
│   ├── lifesample/   # 人生样本
│   ├── treasure/     # 好东西
│   ├── food/         # 美食记录
│   ├── inbox/        # 收件箱
│   ├── dams/         # 数字资产
│   ├── toolkit/      # 工具箱
│   └── summary/      # 跨模块聚合
├── manage.py
└── requirements.txt

Frontend (frontend/)

• 模块自包含：modules/<模块>/ 含 views / stores / api / types / components
• 路径别名 @/ 指向 src/
• 模块间不互相引用 store；跨模块数据在 core/dashboard 聚合
• core/：admin / analysis / auth / dashboard / notifications / privacy
• shared/：跨模块组件 / composables / utils / styles

frontend/src/
├── modules/      # 业务模块（每个模块含 views/stores/api/types/components）
├── core/         # 基础设施（admin/analysis/auth/dashboard/notifications/privacy）
├── shared/       # 共享（components/composables/config/api/styles/utils）
├── router/
├── App.vue
└── main.ts