R1 先行批：question-center 后端（SB 2.7.18，23 单测全绿）+ 建表脚本 + 仓库说明

2026-10-22 10:13:00 +08:00
parent 380df08271
commit 907063a0b6
30 changed files with 2693 additions and 2 deletions
@@ -1,3 +1,48 @@
-# ysch-question-service
+# question-center 问卷后端（ysch-question-service）

-managed by projman
+问卷应用 R1「先行跑通」后端：Spring Boot 2.7.18，包名 `com.yunhai.question`，端口 8090，库 `ysch_question`。链路：**新建问卷（自动挂接 FC 表单）→ iframe 内用 FC 设计器编辑 → 发布投放（链接+二维码）→ FC 填写页提交 → 投影拉取 → 回收明细与基础统计**。表单定义/版本/校验/答卷权威全在 form-center（FC），本服务零改动 FC；提交入口永远在 FC 填写页 `#/f/{code}`（不建第二提交入口）。
+
+配套前端：`ysch-question-front`（Vue3+TS+Vite5，端口 8091）。
+
+```
+├── sql/question_r1.sql   建表脚本（questionnaire / pull_cursor / answer_projection）
+└── src/                  主代码 + 无外部依赖单测（H2+mock，23 例：投影幂等/游标推进/人数口径/绑定 uk）
+```
+
+## 前置依赖（联调）
+
+| 依赖 | 地址 | 说明 |
+|---|---|---|
+| form-center 后端/前端 | localhost:8086 / 8089 | /oapi 三端点 + 设计器 iframe / 填写页 `#/f/{code}` |
+| MySQL | localhost:3306 | 建库 `ysch_question`（执行 `sql/question_r1.sql`；开发期 ddl-auto=update 可自动建表） |
+| Redis | localhost:6379 | 平台 starter 密钥链（trust-registry） |
+| CAS/UserBase | localhost:8443 / 8060 | 登录与模块下发（local-debug 形态，同 flow-center） |
+| appKey | UserBase | **question-center appKey=100020 已注册（2026-10-22）**；FC 验签走 trust-registry 密钥链，FC 本地 trusted-apps 仅停摆兜底、可不配 |
+| AppRegistry | FC 管理页 | 校管理员在 FC 管理面登记 `question` 应用（appCode 恒 `question`，不写代码注册） |
+
+## 启动（本地 dev）
+
+```bash
+# 1) MySQL 建库
+mysql -uroot -p123456 < sql/question_r1.sql
+
+# 2) 启动（:8090）
+mvn -o spring-boot:run
+# 健康探针：登录态 curl http://localhost:8090/api/question/ping → 200 {pong,user,shcId}；未登录 → 302 CAS
+```
+
+## 关键配置（src/main/resources/application.yml）
+
+- `yh.app-auth.app-key: 100020`（UserBase 已注册；FC 侧经 trust-registry 密钥链验签，secret 两端须一致）
+- `yh.open.services.form-center: http://localhost:8086`（FormCenterClient 唯一出站点）
+- `question.projection.fixed-delay-ms: 30000`
+
+## 测试
+
+```bash
+mvn -o test   # 23 例单测（H2/mock，无外部依赖）
+```
+
+## 红线（沿任务书 §7）
+
+不迁旧数据；不做家长问卷；不跨校；不建第二答卷提交入口；不改 form-center/flow-center/svc-hall/Notice/UserBase/BasePlatform；不 import FC 在途未提交类（FormConsumerAccessService/AnswerDelivery*/SubmissionContext* 等）；OAPI 只用已提交的 schema/answer/answers 三端点；`appCode` 恒为 `question`（2026-10-22 改定；FC AppRegistry 按此登记）。