feat(core): 补齐 core 族 22 条端点并同步契约三处

按官方三源(LoginController / UtilsController / LocationController +
官方前端 api/core/*.ts)逐条核对,实现 22 条 core 端点:
- 真实现 6 条:锁屏解锁、免密登录票据、扫码凭证状态流转
- 诚实失败 16 条:文件族 4 + 导入族 4 + 地图族 3 + 改密通知 1
  + SaaS 族 3 + socials 1(无文件存储 / 无导入引擎 / 无地图服务 /
  无邮件短信通道 / 无多租户切库 / 无第三方账号 ⇒ code=400 + 人话,
  不返假 URL、不返假坐标)

新增 TicketStore(进程内内存票据表,官方用 Redis 而本仓无 Redis):
两种票据带前缀隔离(tkt- / scc-),不互相串用。

同批修掉一个真偏差:Login/saas 原先写成 let _ = require_login_face_b(..)
丢弃了 Err ⇒ 实际不拦,但静态闸门推成「登录」⇒ 契约标签与运行时行为
不符;已改成真拦(官方 TenantSaasGranter.checkTenantUser 要求已有登录态)。

契约三处同步:[ENDPOINT] +22 / [OFFICIAL] +22 / [FACE] 面 B 558→580,
并顺手修正契约 §6 头两个无人校验的散文数字(132→610 条、53→607 行)。
This commit is contained in:
admin committed 2026-11-02 17:34:03 +08:00
1 parent cf154d50ff
commit 1c224b7b79
30 files changed
+1560 -46

No files matched your search

+138 -2
View File
@@ -53,6 +53,65 @@ S = _load("ccs", os.path.join(HERE, "check-contract-scan.py"))
# 的 `api/onlineDev/report.ts`(本仓按官方前端的消费点定契约)。
REPORT_SRC = "api/onlineDev/report.ts"
# 🔴 core 族(批次 18):官方 `jnpf-oauth` 的 `LoginController` +
# `jnpf-file` 的 `UtilsController` + `jnpf-system` 的 `LocationController`。
#
# 🔴 **core 族在官方前端全是「只有声明、没有消费点」**
# (`api/core/{auth,common,user}.ts` 里声明了,但两个前端版本里都搜不到
# 调用点)⇒ **形状以官方 Java 为准**,不能照前端消费点猜。
_CORE_CONTROLLERS = {
# 官方 `jnpf-oauth` 的 `LoginController`(`@RequestMapping("/api/oauth")`)
"LoginController.java": {
"POST /api/oauth/LockScreen": 130,
"POST /api/oauth/updatePasswordMessage": 269,
"GET /api/oauth/getConfig/{account}": 318,
"GET /api/oauth/getLoginConfig": 349,
"GET /api/oauth/getTicket": 383,
"GET /api/oauth/getTicketStatus/{ticket}": 398,
"GET /api/oauth/codeCertificate": 454,
"GET /api/oauth/codeCertificateStatus/{ticket}": 468,
"GET /api/oauth/setCodeCertificateStatus/{ticket}/{status}": 507,
"POST /api/oauth/Login/saas": 554,
"POST /api/oauth/apply/saas": 562,
"GET /api/oauth/mobilecode/saas": 571,
},
# 官方 `jnpf-file` 的 `UtilsController`(`@RequestMapping("/api/file")`)
"UtilsController.java": {
"GET /api/file/Download/{fileType}/{fileName}": 200,
"POST /api/file/PackDownload/{fileType}": 100,
"GET /api/file/Uploader/Preview": 277,
"POST /api/file/merge": 295,
},
# 官方 `jnpf-system` 的 `LocationController`(`@RequestMapping("/api/system/Location")`)
"LocationController.java": {
"GET /api/system/Location/around": 32,
"GET /api/system/Location/text": 47,
"GET /api/system/Location/inputtips": 62,
},
}
# 🔴 core 族里**官方 Java 没有独立 `@XxxMapping`** 的一条:
# `/api/oauth/Login/socials` —— 官方**没有**独立的 `socials` 映射,
# 它走 `LoginController.java:117` 的 `@RequestMapping("/Login/**")` 通配,
# 由 `SocialsTokenGranter`(`grant_type=socials`)分流。
# (官方前端 `api/core/user.ts:43` 只是**声明**了它。)
CORE_FRONTEND_OR_INDIRECT = {
"POST /api/oauth/Login/socials": "LoginController.java:117",
}
# 🔴 **导入族**:官方前端用 `/api/${url}/Xxx` 拼(`url` 是**模块名**)
# ⇒ 官方**每个模块的 Controller 各有一份**同路径的映射
# (`BaseLangController.java:142` / `VisualdevModelDataController.java:944` /
# `EmployeeController.java:208` / `VisualdevModelDataController.java:1000` /
# `VisualdevModelDataController.java:733` / `BaseLangController.java:182` /
# `VisualdevModelDataController.java:1073`)⇒ 出处指**其中一份**即可。
_CORE_IMPORT_SOURCES = {
"GET /api/{prefix}/TemplateDownload": "VisualdevModelDataController.java:944",
"GET /api/{prefix}/ImportPreview": "VisualdevModelDataController.java:1000",
"POST /api/{prefix}/ImportData": "VisualdevModelDataController.java:733",
"POST /api/{prefix}/ImportExceptionData": "VisualdevModelDataController.java:1073",
}
# onlineDev:官方 Controller(`jnpf-visualdev` 模块)⇒ 文件名 + 映射行号
_VISUALDEV_CONTROLLERS = {
"VisualdevController.java": {
@@ -263,14 +322,71 @@ PARTIAL_NOTES = {
"partial", "本仓无 DataV 组件库 ⇒ 恒空列表"),
("POST", "/api/visualdev/Portal/{id}/Actions/Export"): (
"partial", "本仓无文件服务 ⇒ **明确业务失败**"),
# ---- core(批次 18):框架自带能力 —— 本仓按「有落库/内存表可做」与
# 「能力缺失」分两类,逐条诚实落地。
("POST", "/api/oauth/LockScreen"): (
"implemented", "面 B 已落地:按**本仓口令口径**(`md5(明文)`,非官方 "
"`md5(明文+secretkey)`)校验 `base_user.f_password`;"
"账号不存在与口令错统一返「账号或密码错误」(防账号枚举)"),
("GET", "/api/oauth/getTicket"): (
"implemented", "面 B 已落地:照抄官方 `ActionResult.success(msg, data)` 的"
"**错位** —— 有效期(毫秒时间戳)进 `msg`、票据进 `data`;"
"官方票据存 Redis ⇒ 本仓用进程内内存表(进程重启即失效)"),
("GET", "/api/oauth/getTicketStatus/{ticket}"): (
"implemented", "面 B 已落地:返官方 `LoginTicketModel`(恰好 4 字段 "
"`status`/`value`/`theme`/`ticketTimeout`);"
"票据查不到返 `status=1`(**不报错**,照官方)"),
("GET", "/api/oauth/codeCertificate"): (
"implemented", "面 B 已落地:与 `getTicket` 同构(`msg`=超时、`data`=凭证);"
"扫码凭证与登录票据是**两张表**(`scc-` / `tkt-` 前缀),不串用"),
("GET", "/api/oauth/codeCertificateStatus/{ticket}"): (
"implemented", "面 B 已落地:返官方 `LoginTicketModel` 形状;查不到返 `status=1`"),
("GET", "/api/oauth/setCodeCertificateStatus/{ticket}/{status}"): (
"implemented", "面 B 已落地:改状态并**续期**(官方 `updateTicket` 同款);"
"凭证不存在返 `status=1` 的空模型(不报错)"),
("POST", "/api/oauth/updatePasswordMessage"): (
"partial", "本仓无邮件 / 短信通道 ⇒ **明确业务失败**(不假装发成功)"),
("POST", "/api/oauth/Login/saas"): (
"partial", "本仓无多租户数据源切换 ⇒ **明确业务失败**"),
("GET", "/api/oauth/mobilecode/saas"): (
"partial", "本仓无短信通道 ⇒ **明确业务失败**"),
("POST", "/api/oauth/apply/saas"): (
"partial", "本仓未接入官方 SaaS 平台 ⇒ **明确业务失败**"),
("POST", "/api/oauth/Login/socials"): (
"partial", "本仓无第三方账号配置 ⇒ **明确业务失败**"),
("GET", "/api/file/Download/{fileType}/{fileName}"): (
"partial", "本仓无文件存储 ⇒ **明确业务失败**(**不返假 URL**)"),
("POST", "/api/file/PackDownload/{fileType}"): (
"partial", "本仓无文件存储 ⇒ **明确业务失败**(**不返假 URL**)"),
("GET", "/api/file/Uploader/Preview"): (
"partial", "本仓无文件存储 ⇒ **明确业务失败**(官方返预览流)"),
("POST", "/api/file/merge"): (
"partial", "本仓无文件存储 ⇒ **明确业务失败**(分片无处可合)"),
("GET", "/api/{prefix}/TemplateDownload"): (
"partial", "本仓无导入模板文件 ⇒ **明确业务失败**"),
("GET", "/api/{prefix}/ImportPreview"): (
"partial", "本仓无导入引擎 ⇒ **明确业务失败**"),
("POST", "/api/{prefix}/ImportData"): (
"partial", "本仓无导入引擎 ⇒ **明确业务失败**"),
("POST", "/api/{prefix}/ImportExceptionData"): (
"partial", "本仓无导入引擎 ⇒ **明确业务失败**"),
("GET", "/api/system/Location/around"): (
"partial", "本仓无地图服务(无高德 key + `Cargo.toml` 里**无 HTTP 客户端**)"
"⇒ **明确业务失败**(**不返假坐标**)"),
("GET", "/api/system/Location/text"): (
"partial", "本仓无地图服务 ⇒ **明确业务失败**(**不返假坐标**)"),
("GET", "/api/system/Location/inputtips"): (
"partial", "本仓无地图服务 ⇒ **明确业务失败**(**不返假坐标**)"),
}
# 🔴 **端点顺序**:按官方模块分组,组内按路径排 —— 与 `routes.rs` 的注册顺序对齐
# (⇒ 契约读起来与代码读起来同序 ⇒ 人工 review 不用来回跳)。
MODULE_ORDER = ["online_dev", "report"]
MODULE_ORDER = ["core", "online_dev", "report"]
# 🔴 **默认 note**(未在 `PARTIAL_NOTES` 里显式标注的端点)。
DEFAULT_NOTES = {
"core": "面 B 已落地:按官方 `jnpf-oauth` / `jnpf-file` / `jnpf-system` "
"的 Controller 形状实现",
"online_dev": "面 B 已落地:按官方 `jnpf-visualdev` 的 Controller 形状实现",
"report": "面 B 已落地:官方 `/api/Report/*` 在官方是**独立部署的第三方服务**"
"(`jnpf-java-datareport-univer`,端口 32000)⇒ 本仓把报表元数据**就地落库**"
@@ -333,8 +449,28 @@ def official_entry(mod, key, path):
src = "%s:%d" % (REPORT_SRC, line) if line else REPORT_SRC
status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["report"]))
return src, status, note
# onlineDev
k = "%s %s" % (method, path)
if mod == "core":
# 🔴 core 族的官方出处**分三层**(批次 18 逐条核对):
# ① 官方 Java Controller 有独立 `@XxxMapping` ⇒ 出处指 Java 行号;
# ② 官方 Java **没有**独立映射(走 `/Login/**` 通配)⇒ 出处指通配行号;
# ③ 导入族(官方前端用 `/api/${url}/Xxx` 拼,官方各模块 Controller
# 各有一份)⇒ 出处指**其中一份**即可。
for ctrl, table in _CORE_CONTROLLERS.items():
if k in table:
src = "%s:%d" % (ctrl, table[k])
status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["core"]))
return src, status, note
src = CORE_FRONTEND_OR_INDIRECT.get(k)
if src:
status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["core"]))
return src, status, note
src = _CORE_IMPORT_SOURCES.get(k)
if src:
status, note = PARTIAL_NOTES.get(key, ("implemented", DEFAULT_NOTES["core"]))
return src, status, note
raise SystemExit("core 族没有官方出处可登记:%s %s" % (method, path))
# onlineDev
for ctrl, table in _VISUALDEV_CONTROLLERS.items():
if k in table:
src = "%s:%d" % (ctrl, table[k])