项目定位： 家庭内部试用验证阶段 最后更新： 2025-01-26 当前版本： v1.2

---

《家庭任务大作战》是一款通过游戏化机制促进家庭成员高效完成任务、增强家庭凝聚力、培养良好习惯的互动型家庭任务管理应用。

核心价值：

• 任务管理：将家务、学习等任务可视化、系统化
• 游戏化激励：通过积分、勋章、竞赛提升参与积极性
• 家庭互动：创造家庭共同话题和合作机会
• 成长记录：可视化个人和家庭的进步历程

---

文档	版本	说明	链接
需求文档	v1.2	产品需求、功能规格、版本规划	家庭任务大作战-需求文档.md
技术方案	v1.2	技术架构、数据库、部署方案	家庭任务大作战-技术方案.md
设计系统	v1.2	UI/UX 设计规范、系统设计	家庭任务大作战-设计系统.md
周日会议	v1.2	特色功能专题设计	家庭任务大作战-周日会议设计.md

---

• 任务库管理（家务/学习/成长）
• 任务分配与认领
• 难度分级（1-5星）
• 智能提醒功能
• 任务状态管理

• 积分系统（难度系数、提前奖励、连胜加成）
• 成就勋章（能力型、趣味型、情感型）
• 实体化展示（可选）

• 周日家庭之夜（核心仪式）
• 排行榜系统（周榜/月榜/总榜/进步榜/专项榜）
• 竞赛模式（主题周、团队对抗、Boss战）

• 协作任务系统
• 智能求助系统
• 互助银行系统
• 角色扮演协作

• 体验型奖励（电影之夜、游戏特权）
• 实体奖励（零食、礼物、道具）
• 趣味惩罚（才艺表演、补偿任务）
• 救赎机制

• 个人成长曲线
• 能力雷达图
• 家庭贡献统计
• 趣味化洞察报告

• 成长轨迹时间轴
• 勋章陈列馆
• 3D展示模式
• 虚拟形象定制
• 技能树系统
• 成就故事集

• 娱乐体验区
• 美食享受区
• 实物奖励区
• 虚拟特权区
• 家庭活动区
• 限时抢购

• 智能任务推荐
• 智能时间规划
• 成长路径规划
• 家庭协同推荐
• 智能挑战生成

---

前端层
├── Next.js 14 (App Router)
├── shadcnadcn/ui + TailwindCSS
├── Framer Motion (动画)
├── React Hook Form + Zod (表单)
└── Recharts (图表)

状态层
├── Zustand (轻量状态管理)
└── React Query (数据获取)

后端层
├── Next.js Server Actions
└── API Routes (可选)

数据层
├── 本地开发 (Prisma + SQLite)
└── 生产环境 (Supabase PostgreSQL)

部署层
└── Vercel (全球CDN + 自动HTTPS)

---

• 基础任务管理
• 积分系统
• 简单排行榜
• 3-5个基础勋章
• 完成庆祝动画

• 点赞互动系统
• 任务历史查看
• 周日家庭之夜功能
• 提醒通知

• 完整勋章系统
• 任务拍卖会
• 团队协作任务
• 主题周挑战

• 段位系统
• 竞赛模式
• 跨家庭互动
• 个人成就空间

• AI智能推荐
• 高级社交功能
• 季节性活动

---

# 1. 创建项目
npx create-next-app@latest family-task-app

#   2. 安装依赖
npm install prisma @prisma/client zustand framer-motion react-hook-form zod
npm install @supabase/supabase-js @supabase/ssr
npm install -D tailwindcss postcss autoprefixer

# 3. 初始化数据库
npx prisma init --datasource-provider sqlite

# 4. 启动开发
npm run dev

# 1. 配置环境变量
DATABASE_URL="postgresql://user:password@host:5432/dbname"
NEXT_PUBLIC_SUPABASE_URL="your_supabase_url"
NEXT_PUBLIC_SUPABASE_ANON_KEY="your_anon_key"

# 2. 部署到 Vercel
vercel

---

本项目采用模块化文档结构，便于团队协作和版本管理。

1. 版本统一 - 所有文档版本号保持一致
2. 交叉引用 - 文档间添加相互链接
3. 及时更新 - 修改功能后同步更新相关文档
4. 变更记录 - 在变更日志中记录每次修改

1. 修改功能 → 更新需求文档
2. 影响设计 → 更新设计系统文档
3. 涉及技术 → 更新技术方案文档
4. 统一版本 → 所有文档版本升级

---

指标	状态	说明
需求分析	✅ 完成	产品需求已明确
技术方案	✅ 完成	技术栈已确定
设计系统	✅ 完成	设计规范已定义
文档整合	✅ 完成	所有文档已整合

---

项目文档版本：v1.2 最后更新：2025-01-26