🚀 英雄成长管理系统

全能操作手册

完整的家庭任务管理、成长激励、数据隔离解决方案

💡 核心概念:家庭隔离

系统的本质是"一切数据都以家庭为边界"

  • 账户:每个家长拥有独立的 family_id
  • 孩子:一个家庭可以添加多个孩子,数据彼此隐离
  • 设备:设备与 family_id 绑定,防止数据泄露
  • 任务:所有任务、积分、计划只存在于对应的家庭内
🔐

账户、角色与登录

Auth & Roles

系统的核心是 家庭隔离 (Family Isolation)。一切数据都以"家庭"为边界。

1. 家长注册与初始化

注册

家长通过邮箱注册后,系统会自动分配一个唯一的 family_code(家庭邀请码)。

角色控制

家长账号(Admin)拥有最高权限,负责管理任务库、计划、审批以及授权设备。

2. 多孩子角色切换

多孩子支持

一个家庭可以添加多个孩子(如 Luffy, 妹妹等)。

快速切换

在已授权的设备上,系统会显示"角色选择"界面。点击对应头像即可切换到该英雄的专属看板。

3. 设备授权流 (Device Binding)

初次访问

新设备打开 /kid 页面会显示"等待授权"。

家长确认

家长在后台控制台看到新设备申请,点击 [授权]。

自动锁定

授权后,该设备将永久绑定至你的 family_id,刷新页面即可直接进入英雄选择界面。

📂

任务库与⚡挑战

Task Management

1. 任务分类

普通任务

日常习惯(刷牙、准时睡觉),由家长指派后每日自动出现。

⚡ 挑战任务

在任务管理中开启 "⚡ 挑战任务" 开关的任务。它们不会自动出现,而是存放在孩子的"挑战库"中。

2. 孩子自主发起挑战

点击发起

孩子在看板点击 ⚡ 发起挑战 按钮。

精准过滤

列表仅显示家长标记为挑战的任务(如:数学练习、练琴、洗碗)。

自主性

这赋予了孩子赚取额外积分的权利,鼓励自主学习。

📅

自动化运行机制

Automation

1. 每日任务同步 (Daily Sync)

被动触发

当孩子每天第一次打开页面时,系统会对比 task_plans(计划表)和当天的日期。

自动生成

如果今天该有的任务还没生成,系统会自动在 task_logs 中插入一条 status: open 的记录。

避免重复

智能去重机制确保即便刷新页面也不会产生重复任务。

2. 周循环逻辑

灵活配置

你可以为任务设置周一至周日的循环。例如:"练琴" 只在周一到周五出现,"大扫除" 只在周六出现。

智能匹配

系统会根据今天是星期几自动加载对应的任务。

💰

积分、审批与升级

Rewards & Levels

1. 审批闭环

打卡

孩子完成任务并点击"打卡"。

审核

家长在管理端看到申请,点击"通过"。

发放

积分即时入账,卡片变为"可领取"状态。

领取

孩子点击"领取奖励",积分正式加入总分,并伴随彩带特效。

2. 英雄升级 (Level Up)

等级配置

系统根据完成的任务总数判断等级(如:萌新英雄 → 资深英雄 → 传奇英雄)。

晋升奖励

升级时会触发全屏动画,并派发大额 ⭐ 奖金。

🧹

数据维护

Data Management

1. 重置今日进度

紧急修正

如果孩子在今天误操作或完成记录有误,家长可以在控制台点击 ↩️ 按钮,将该孩子今天的所有任务状态恢复到"未打卡"状态。

保留计划

这个操作只影响今天,不会删除任务计划或历史记录,明天的任务照常自动生成。

即时刷新

孩子的看板会自动刷新,待审批的任务会变回"未完成",准备重新完成。

2. 季节重置

全面重启

如果需要完全重新开始(如新年新气象或升年级),家长可以在管理端点击 🧹 按钮,将某个孩子的所有积分清零、等级重置为初始状态。

重置范围

这个操作会清空:所有分类积分(habit、physical、mindset、knowledge、custom)和任务完成数。

历史保留

过往的任务记录和审批日志不会删除,可用于查看成长轨迹。

3. 性能优化

实时同步

系统采用并行请求技术,确保即便任务再多,首次进入页面也能保持极速加载。

智能缓存

无需担心数据延迟,所有操作都有实时反馈。

💬 温馨提示

  • ☑️ 首次使用建议先注册账号,系统会自动生成 family_code
  • ☑️ 将 family_code 分享给孩子,便于设备绑定
  • ☑️ 任务库中的任务可以多次使用,建议创建常用任务库
  • ☑️ 定期检查"设备审批",及时授权新设备
  • ☑️ 所有数据实时同步,刷新页面不会丢失进度

🎮 Hero Base System v1.0