01项目概览
“恰同学少年”是一套闭源交付的家庭成长陪伴系统，由家长端 APP、Web 管理后台、服务端和 MySQL 数据库组成。APP 面向日常使用，后台面向数据维护与统计查看，两端共用同一套账号和数据。
家长端 APPAndroid家庭使用
积分操作、奖励兑换、学习/游玩记录、成长档案、每日打卡与计时任务。
Web 管理后台浏览器访问数据管理
首页统计、用户与孩子、积分规则、奖励、成长数据和系统配置。
一体化服务镜像DockerMySQL 5.7
管理后台和业务接口通过同一个镜像交付，业务数据写入用户自行准备的 MySQL，附件持久化到宿主机。
02功能说明
积分成长加分、扣分、手动评分、照片佐证、月度趋势与分类对比。
奖励激励积分兑换、奖励清单、幸运抽奖及兑换记录。
专注任务阅读、作业、吃饭等计时任务，按时完成或超时关联积分规则。
每日打卡自定义任务、连续打卡、阶段奖励和完成明细。
成长档案学习记录、试卷、游玩记录、成长影像与文件预览。
家庭管理用户、孩子、家长绑定、密码修改和基础字典维护。
03产品展示
APP 与 PC 管理后台部分功能界面展示，点击图片可查看大图。
04部署前准备
| 项目 | 要求 | 说明 |
|---|---|---|
| Docker | Docker 或 Docker Compose | |
| MySQL | 推荐 MySQL 5.7 | 需由用户提前自行安装 |
| 附件存储 | 宿主机任意可写目录 | 映射到容器固定目录 /app/uploads |
| 网络端口 | 外部端口可自定义 | 映射到容器固定端口 54321 |
数据库兼容性：当前仅支持 MySQL，推荐使用 5.7。MySQL 8.0 尚未经过完整测试，不保证兼容；不支持 PostgreSQL、SQL
Server、SQLite 等其他数据库。
请提前创建数据库和专用账号，并确保该账号可以连接目标数据库。本文档不包含 MySQL 安装教程。
05Docker Compose 部署
创建部署目录和附件持久化目录，然后新建 docker-compose.yml。下面的数据库信息、外部端口和宿主机目录请按实际环境修改。
services:
qiatongxue:
image: ccr.ccs.tencentyun.com/jianzhichu/qiatongxue:beta_0.0.1
container_name: qitongxue
# network_mode: host
ports:
# 左侧为外部端口，可自行修改；右侧容器端口保持 54321
- "54321:54321"
environment:
- DB_TYPE=MySql
- DB_HOST=你的MySQL地址
- DB_PORT=3306
- DB_USER=mykid
- DB_PWD=你的数据库密码
- DB_NAME=mykid
volumes:
# 左侧宿主机路径和目录名可自定义；右侧保持 /app/uploads
- /你的宿主机附件目录:/app/uploads
restart: on-failure:5
tty: true
stdin_open: true
注意：
DB_HOST 不能填写容器自身的 127.0.0.1，除非启用了 host
网络并确认网络环境允许。例如需要使用外部端口 8080 时，将端口映射改为 8080:54321。启动服务
docker compose pull docker compose up -d docker compose ps docker logs -f qitongxue
06访问与使用
管理后台浏览器访问
http://服务器IP:外部端口。例如端口映射为 8080:54321，则访问
http://服务器IP:8080。
默认管理员
| 账号 | qtx |
|---|---|
| 初始密码 | qtx@2026 |
| 角色 | 管理员 |
首次登录后请立即在右上角“修改密码”中更换初始密码。不要把真实数据库密码写入公开网页、截图或对外文档。
07基础数据维护
系统提供基本示例结构，实际家庭规则和内容需要管理员登录 PC 后台后自行维护。建议正式使用前依次完成以下配置：
赏罚分明维护加分、扣分和手动评分规则，设置分值、规则说明、是否拍照、首页展示及计时任务关联。
兑换与抽奖维护可兑换奖品、所需积分，以及幸运抽奖的奖项、概率和未中奖项。
每日打卡维护家庭每天需要完成的任务、排序、任务说明和完成奖励积分。
专注任务维护作业、阅读、吃饭等任务类型、默认时长，以及按时完成和超时对应的积分规则。
字典管理根据孩子实际情况维护年级、科目、作业与试卷类型，供成长档案和学习记录选择。
孩子与家庭补充孩子资料并确认家长绑定关系，再开始记录积分、学习和成长数据。
这些内容具有明显的家庭差异，不建议直接照搬示例数据。配置完成后，可先用少量测试记录确认分值、兑换成本和任务时长是否合理。
08镜像升级与数据持久化
发布新版本时，只需要修改 Compose 中的镜像标签并重新拉取。升级前应备份 MySQL 数据库以及映射到 /app/uploads 的宿主机附件目录。
# 先在 docker-compose.yml 中修改 image 标签 docker compose pull docker compose up -d docker compose ps docker logs --tail 200 qitongxue
/app/uploads：容器内固定附件目录，宿主机映射路径可自定义。- MySQL：所有业务记录，需使用用户自己的数据库备份方案。
不要在升级时删除宿主机附件目录。镜像回退时，将标签改回上一版本并重新执行 docker compose up -d。