清远工贸自强成长系统
系统架构与
数据同步说明
学校管理端、师生钉钉小程序和钉钉组织数据均通过统一业务 API 接入。业务数据集中存储在指定运行环境中。
系统总体架构
系统架构图
管理端与钉钉小程序通过统一 API 访问服务端；数据库不直接向客户端开放。
使用端学校管理与师生使用
学校管理端Web 浏览器 · 组织、师生、成长、积分、任务与运营管理
师生使用端钉钉小程序 · 师生业务办理与成长服务
访问网关统一访问入口
Nginx / HTTPS域名访问、加密传输与 API 请求转发
受控访问业务服务统一规则与权限
统一业务 API · NestJS认证、权限、校验、业务规则与审计在服务端统一处理
组织与师生成长、积分与评价任务、活动与预警报表、治理与审计
数据层业务数据准源
MySQL 业务数据库组织、师生、成长、积分、任务、评价、同步任务和审计记录的唯一业务数据准源。
证据文件存储图片、PDF 等文件持久化保存；归属和业务关联信息同步入库。
外部数据集成
钉钉开放平台管理员按需发起组织、教师、学生和家长数据同步；系统保留同步任务、处理结果与异常记录。
部署位置：甲方指定云服务器、政务云或校内私有化服务器。数据库仅对应用服务开放，管理端和小程序端不直接连接数据库。
运行、存储与同步
系统运行方式
以下内容对应系统后续运行位置、数据存储和 API 数据同步方式。
运行位置
系统部署在甲方指定的云服务器、政务云或校内私有化服务器。Nginx 提供域名访问和 HTTPS，后端服务常驻运行。
数据存储
组织、师生、成长、积分、任务、评价、同步和审计数据存入 MySQL；图片、PDF 等证据文件存入服务器持久化目录。
API 与钉钉同步
各端只调用统一 API。管理员按需从钉钉同步组织、教师、学生和家长数据，系统保存同步结果与异常记录。
数据处理
数据如何流转
业务数据只在服务端处理和保存，其他端通过 API 获取当前数据。
管理端和小程序调用 API
登录认证、角色权限、参数校验和业务规则均由后端服务处理，不由客户端直接写数据库。
服务端写入 MySQL 和文件目录
成功操作写入 MySQL；证据文件保存到持久化目录，文件归属和业务关联信息写入数据库。
各端通过 API 获取最新数据
其他端再次请求相应 API 后读取最新结果。同步任务、异常信息和操作审计均保留查询记录。
上线前配置
完成生产域名、HTTPS、数据库账号、备份恢复和钉钉应用权限配置后，即可进入正式运行。
- 生产域名与 HTTPS 对外提供访问
- 数据库与证据文件定期备份并验证恢复
- 钉钉应用凭证、可见范围和通讯录权限配置完成