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:
1 parent
cf154d50ff
commit
1c224b7b79
30 files changed
+1560
-46
No files matched your search
@@ -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])
|
||||
|
||||
Reference in new issue
Block a user