# next_ed **Repository Path**: cfuns/next_ed ## Basic Information - **Project Name**: next_ed - **Description**: 面向小学与初中的 AI 教育协同平台，覆盖教师、学生、家长、学校、关怀与平台管理六类 PC 入口。 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2026-09-11 - **Last Updated**: 2026-09-27 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 知序 · AI 教育协同平台

面向小学与初中的 AI 教育协同平台
让学生学得主动，让教师工作更轻，让学校治理有据可依。

License: Apache 2.0 Version 1.0.0 Node.js >= 22.13 Next.js 16 PC Web

知序（NextED）围绕“目标—任务—尝试—证据—人工决定—跟进”构建学习与教学闭环。平台为学生、教师、家长、学校管理者、学生关怀人员和平台管理员提供六类 PC 入口，以国产大模型辅助个性化学习、备课批阅、教学治理和家校协同。高影响决定保留人工确认、用途声明、版本检查和完整审计。 > 当前版本用于产品评审和本地验证。演示数据与生产数据严格分离；生产模式不会在缺少数据库或可信身份配置时自动回退到 Demo。 ## 首页 教师“今日工作”将高优先级事项、班级动态和教学任务汇聚到一个工作台，减少在多个系统之间切换。 ![知序教师首页](./docs/audit-assets/2026-09-16/01-teacher-home.png) ## 核心功能 | 角色 | 当前已实现能力 | | --- | --- | | 学生 | 今日学习、个性化任务、成长证据、问题本、引导式学习反馈 | | 教师 | 今日工作、AI 辅助备课、作业与批阅、学生成长、班级事务、教研成长 | | 家长 | 本周成长、家庭安排、家校沟通、授权与隐私 | | 学校 | 学校概览、年度目标、教学质量、教师支持、制度与安全 | | 学生关怀 | 待响应队列、用途声明、个案跟进、资源与值守 | | 平台管理 | 组织与账号、内容资源、国产模型、审计与运行 | ### 学生：个性化学习与成长证据 ![学生学习页](./docs/audit-assets/2026-09-16/04-student-learning.png) 系统结合当前学段、学习任务和尝试记录给出引导，保留学生自己的判断过程，并把完成结果沉淀为成长证据。 ### 教师：AI 辅助备课与教学工作台 ![教师备课中心](./docs/audit-assets/2026-09-16/03-teacher-lesson-center.png) 教师可从目标和班情出发组织教学设计。AI 负责生成建议与草稿，发布和高影响操作由教师确认并记录原因。 ### 家长：成长信息与隐私授权 ![家长成长页](./docs/audit-assets/2026-09-16/06-parent-growth.png) 家长看到的是可行动的成长信息、家庭安排和沟通入口。敏感数据读取与授权范围在独立页面管理。 ### 学校：目标、质量与教师支持 ![学校概览](./docs/audit-assets/2026-09-16/08-school-overview.png) 学校管理者可从年度目标下钻到年级、班级和教师支持事项，通过统一指标和责任人持续跟进。 ### 学生关怀：受控访问与人工干预 ![学生关怀工作台](./docs/audit-assets/2026-09-16/10-care-overview.png) 关怀信息遵循最小必要原则。工作人员需先声明用途才能读取正文，系统保留访问、处理和跟进记录。 ### 平台管理：国产模型治理 ![平台管理概览](./docs/audit-assets/2026-09-16/12-admin-overview.png) 平台统一管理组织、账号、内容、模型和审计。模型仅允许接入经过学校评测与审批的千问、DeepSeek 或豆包配置。 更多产品截图见 [`docs/audit-assets`](./docs/audit-assets/)。 ## 三套重设计原型 新版交互试验场位于 [`/prototypes`](http://localhost:5173/prototypes)，可即时切换三套方案与六类角色，并演示任务选择、处理中、人工确认和完成状态。 | 方案 | 核心交互 | 优先适用角色 | | --- | --- | --- | | A · 行动台 | 今日优先队列 → 证据 → AI 建议 → 人工确认 | 教师、高频事务角色 | | B · 成长岛 | 成长路径 → 当前节点 → 短任务 → 成长证据 | 学生、家长 | | C · 证据流 | 对象队列 → 可核验事实 → 决定 → 审计时间线 | 学校、关怀、平台管理 |
行动台教师原型 成长岛学生原型 证据流学校原型
A · 行动台 B · 成长岛 C · 证据流
设计依据、适用判断和评审维度见 [三套 UI 与交互产品原型设计方案](./docs/15_三套UI交互原型设计方案.md)。 ## 产品闭环 ~~~mermaid flowchart LR A[目标与学情] --> B[任务与教学设计] B --> C[学生尝试] C --> D[证据与反馈] D --> E{人工决定} E -->|继续学习| B E -->|教师调整| F[分层教学与支持] E -->|需要关怀| G[受控关怀流程] F --> A G --> A ~~~ AI 用于降低信息整理和重复劳动成本；教师、学校和授权专业人员对教学、评价及关怀结论负责。 ## 技术架构 ~~~mermaid flowchart TB UI[六类 PC 角色入口] --> API[Next.js /api/v1] API --> AUTH[可信身份、角色权限与职责范围] API --> DOMAIN[教学、成长、治理与关怀领域服务] DOMAIN --> DB[(PostgreSQL)] DOMAIN --> AUDIT[版本检查与审计日志] DOMAIN --> AI[国产模型网关] AI --> QWEN[千问] AI --> DEEPSEEK[DeepSeek] AI --> DOUBAO[豆包] ~~~ 主要技术： - Next.js 16、React 19、TypeScript 5、Tailwind CSS 4。 - Vinext、Vite 与 Cloudflare 本地运行链路。 - PostgreSQL、Drizzle ORM 和顺序数据库迁移。 - Zod 输入校验、角色策略、可信代理身份和高影响操作审计。 - Docker 多阶段构建、非 root 只读运行和健康检查。 ## 目录结构 ~~~text next_ed/ ├─ docs/ 产品、架构、交互、安全与验收文档 │ └─ audit-assets/ 真实浏览器审计截图 ├─ zhixu-platform/ │ ├─ app/ 页面、布局与 /api/v1 路由 │ ├─ components/ UI 与业务组件 │ ├─ server/ 领域服务、策略、认证与模型网关 │ ├─ db/ Schema、迁移执行器与数据访问 │ ├─ drizzle/ 顺序数据库迁移 │ ├─ scripts/ 构建、API 验收与浏览器烟雾测试 │ ├─ Dockerfile │ └─ compose.yaml ├─ LICENSE └─ README.md ~~~ 完整应用说明见 [`zhixu-platform/README.md`](./zhixu-platform/README.md)，设计与实现的对应关系见 [`docs/10_设计实现追踪矩阵.md`](./docs/10_设计实现追踪矩阵.md)。 ## 快速开始 ### 环境要求 - Node.js 22.13 或更高版本。 - npm 10 或兼容版本。 - Chrome，仅在运行真实浏览器烟雾测试时需要。 - PostgreSQL，仅在正式数据模式下需要；本地产品体验可使用 Demo 模式。 ### 安装与完整验证 ~~~bash git clone https://gitee.com/cfuns/next_ed.git cd next_ed/zhixu-platform npm ci npm run verify ~~~ `npm run verify` 会执行 7 项教育规则、认证和模型边界测试、ESLint、TypeScript、Next standalone 构建，并启动临时服务完成 21 项六角色 API 验收。 如本机已安装 Chrome，可继续运行： ~~~bash npm run test:browser npm run test:prototypes ~~~ 主产品浏览器测试覆盖角色切换、深链 hydration 和关怀正文用途声明等关键路径；原型测试覆盖 3 套方案、6 类角色、33 项 DOM/交互检查、3 张截图和 1024px PC 视口。 ### 启动开发环境 PowerShell： ~~~powershell cd zhixu-platform $env:DEMO_MODE = "true" npm run dev ~~~ Bash： ~~~bash cd zhixu-platform DEMO_MODE=true npm run dev ~~~ 打开 [http://localhost:5173](http://localhost:5173)。 ### 本地生产构建体验 PowerShell： ~~~powershell cd zhixu-platform $env:DEMO_MODE = "true" npm run build:container npm run start:container ~~~ 打开 [http://localhost:3000](http://localhost:3000)。 ## 容器化部署 仓库已提供容器化部署文件，本地无需安装 Docker 也可审查： - `Dockerfile`：dependencies、builder、migration、runtime 多阶段目标。 - `compose.yaml`：PostgreSQL、一次性迁移和只读非 root Web 服务。 - `.env.example`：数据库、可信身份网关与国产模型变量模板。 - `.dockerignore`：排除依赖、缓存、构建产物和本地密钥。 在安装 Docker 的验收环境中执行： ~~~bash cd zhixu-platform cp .env.example .env # 修改 .env 中的密码、密钥、DATABASE_URL 和所选国内模型配置 docker compose config docker compose build docker compose up -d docker compose ps ~~~ 生产环境必须由可信反向代理清除外部传入的 `x-zhixu-*` 请求头，再注入代理密钥、用户、租户、角色和职责范围。不要提交 `.env`、模型密钥、真实学生数据或可识别个人身份的信息。 ## 参与开发 欢迎通过 Issue 和 Pull Request 参与。为保证设计、实现和验收保持一致，请遵循以下流程。 1. 从 `main` 创建短生命周期分支，例如 `feature/adaptive-practice`、`fix/care-access-scope` 或 `docs/deployment-guide`。 2. 开始编码前，在 `docs/` 新增或更新设计方案，写清目标、流程、数据/API 变化、安全边界与验收标准。 3. 按设计实现前端、后端、数据库迁移和审计链路，不让页面状态与服务端规则分叉。 4. 为权限、教育规则、模型边界和数据变更补充有意义的测试。 5. 提交前至少运行 `npm run verify`；涉及关键交互时再运行 `npm run test:browser`。 6. 在 Pull Request 中说明问题、最终行为、设计文档、验证结果及截图。 从 v1.0.0 起，**所有提交标题和正文必须使用中文说明实际变化**。类型前缀可以保留，具体规范见 [参与开发](./CONTRIBUTING.md)： ~~~text feat: 新增可交付功能 fix: 修复缺陷 docs: 更新文档 test: 增补验证 refactor: 不改变行为的重构 chore: 工程维护 release: 发布知序 v1.0.0 ~~~ 首次克隆后执行 `git config core.hooksPath .githooks`，启用仓库内的中文提交标题检查。 贡献应遵守以下教育产品边界： - AI 输出必须可追溯、可复核，不替代教师和专业人员的高影响决定。 - 新接口必须校验身份、租户、角色、职责范围、输入与资源版本。 - 涉及心理、情绪和健康的信息坚持最小必要、用途限定和人工干预。 - 仅接入国内主流模型，并在启用前完成效果、安全、成本和稳定性评测。 - Demo 数据不得进入生产库，测试、截图和日志不得包含真实未成年人信息。 ## 后续迭代任务 | 优先级 | 阶段 | 任务 | 可验收交付 | | --- | --- | --- | --- | | P0 | 试点就绪 | 对接学校 SSO/统一身份、完善组织导入和最小权限管理 | 可在试点校完成账号开通、停用、调班和权限审计 | | P0 | 生产保障 | 数据备份恢复、迁移回滚、日志指标链路和告警看板 | 完成恢复演练，并能定位关键 API、模型与任务失败 | | P0 | 模型治理 | 建立学科/学段评测集、质量门禁、降级与成本配额 | 模型版本可评测、审批、灰度、回退并生成审计报告 | | P1 | 学习闭环 | 细化知识点掌握模型、错因分类和自适应任务编排 | 学生任务能根据证据调整，教师可查看并修正依据 | | P1 | 教师效率 | 扩展多学科备课、作业解析、批阅复核和班务模板 | 从草稿到发布、反馈和复盘形成完整可测工作流 | | P1 | 家校协同 | 增强周报解释、家庭任务边界和双向沟通跟进 | 家长得到少而明确的行动建议，教师可追踪反馈 | | P1 | 身心成长 | 引入分级预警、专业转介和危机处置演练 | 风险信号不由模型单独定性，所有处置有授权和记录 | | P2 | 规模化 | 多学校租户、区域指标、标准数据交换与开放集成 | 支持区域级部署、隔离验证和受控第三方系统接入 | | P2 | 教育创新 | 多模态作品、探究项目、协作评价与创新能力证据 | 可记录过程性证据，并由学生、教师共同解释与评价 | 详细需求与阶段拆分见 [`docs/13_产品迭代开发计划.md`](./docs/13_产品迭代开发计划.md) 和 [`docs/14_全功能闭环实施设计.md`](./docs/14_全功能闭环实施设计.md)。 ## 文档索引 - [产品需求文档](./docs/01_AI教育平台_产品需求文档.md) - [完整实现方案](./docs/02_AI教育平台_完整实现方案.md) - [品牌与 PC 端交互规范](./docs/03_知序品牌与PC端交互规范.md) - [后端领域、数据与 API 设计](./docs/06_后端领域数据与API设计.md) - [PC 全入口与交互设计](./docs/07_PC全入口与交互设计.md) - [国产模型网关与安全设计](./docs/08_国产模型网关与安全设计.md) - [部署、测试与验收设计](./docs/09_部署测试与验收设计.md) - [设计—实现追踪矩阵](./docs/10_设计实现追踪矩阵.md) - [产品功能与体验审计](./docs/12_产品功能与体验审计设计.md) - [产品迭代开发计划](./docs/13_产品迭代开发计划.md) - [全功能闭环实施设计](./docs/14_全功能闭环实施设计.md) - [README 改版设计方案](./docs/README_REDESIGN_PLAN.md) - [更新日志](./CHANGELOG.md) - [参与开发](./CONTRIBUTING.md) - [v1.0.0 文档—实现一致性同步方案](./docs/17_v1.0.0文档实现一致性同步方案.md) ## 许可证 本项目采用 [Apache License 2.0](./LICENSE) 开源。你可以在遵守许可证条款、保留版权及许可证声明的前提下使用、复制、修改和分发本项目；该许可证同时包含明确的专利授权条款。