feat(face-b): 系统服务族落地(面 B 批次 15,+39 端点)

多语言/表单套件/缓存管理/任务调度/IM 会话/收藏菜单/公式目录/系统监控 + 三处
Actions/Export;新表 8 张(官方 DDL 逐字)⇒ tables 65,BASE_TABLES 62。

影响:
- 多语言是「一行一语种 + f_group_id 聚组」,列表 id = groupId;tableHead 的列来自
  字典 Language(seed 按官方初始库种子化);PUT 时 map 里没有的语种要删掉。
- CacheManage 落到本仓真实的内存会话表:DELETE 真的把人踢下线、ClearAll 保留操作者
  自己、overdueTime 恒 null(会话不过期,不编时间)、绝不把 token 放进响应。
- scheduletask 只登记不执行(本仓无 XXL-JOB):runCount 恒 0、lastRunTime/nextRunTime
  恒 null、TaskMethods 返空 list(返错会让新建表单整条红)。
- 三处 Export 与 BaseLang 模板/导入 = 明确业务失败(无文件服务),不返假 url;
  Kit 那条尤其不能用 data:null(官方前端 res.data.url 会抛 JS 异常)。
- Monitor 真读宿主机指标;macOS 的 CPU 占空比用负载均值近似(契约标 partial)。

顺手修掉 fe-api-inventory.py 的嵌套模板串截断(真因):内层反引号会截断 URL、内层 }
会截断变量替换 ⇒ 产出畸形路径,让 system 永远差 2 条。改成深度配对 + 丢掉「拼查询串
的三元片段」后,system 缺口 41 → 0(196/196)。另把 3 条「官方前端声明但官方后端
从无映射、也无人调用」的死接口记进 [OFFICIAL] 的 oos(带判据,不进分母)。

回归测试 tests/batch15_it.rs 12 条;全量 610 passed / 0 failed;verify.sh 全绿。
This commit is contained in:
admin committed 2026-11-02 10:04:42 +08:00
1 parent e961904252
commit c82a7d1f3d
16 files changed
+5117 -134

No files matched your search

+66 -1
View File
@@ -99,6 +99,16 @@ def extract_url_expr(obj):
if obj[j] == "\\":
j += 2
continue
# 🔴 模板串里的 `${...}` 可以再套一层模板
# (官方 `` `${Prefix}/getConfig/${id}${encryption ? `?e=${encryption}` : ''}` ``)
# ⇒ 那里面出现的反引号**不是**结束符,必须整段跳过;
# 否则 URL 会在内层反引号处被截断成 `…/${encryption`,变成永远修不完的假缺口。
if quote == "`" and obj.startswith("${", j):
end = find_template_end(obj, j)
if end < 0:
return obj[i:]
j = end
continue
if obj[j] == quote:
return obj[i : j + 1]
j += 1
@@ -120,6 +130,61 @@ def extract_url_expr(obj):
return obj[i:j].strip()
RE_TMPL_LITERAL = re.compile(r"'[^']*'|\"[^\"]*\"|`[^`]*`")
def find_template_end(s, i):
"""`s[i:]` 以 `${` 开头 ⇒ 返**配对**的 `}` 之后的下标;未闭合返 -1。
🔴 必须按**嵌套深度**配对,不能用 `\\$\\{[^}]*\\}`:官方前端真的有
`` `${Api.Prefix}/Selector/${`${id || '0'}`}` `` 这种套两层模板的写法,
`[^}]*` 会停在内层的 `}` 上 ⇒ 截出 `/api/system/Menu/Selector/${` 这种畸形路径,
然后在缺口报表里变成一个**永远修不完的假缺口**。
"""
depth = 0
j = i
while j < len(s):
if s.startswith("${", j):
depth += 1
j += 2
continue
if s[j] == "}":
depth -= 1
if depth == 0:
return j + 1
j += 1
return -1
def subst_template_vars(body):
"""把剩下的 `${...}` 归一成 `{param}`(深度感知,见 `find_template_end`)。
🔴 **拼查询串的片段要整段丢掉**,不能变成 `{param}`:官方
`` `${Api.Prefix}/${type}${interfaceId ? `?dataInterFaceId=${interfaceId}` : ''}` ``
的后半段是往 URL 尾巴上追加 `?dataInterFaceId=…`,它**不是**一个路径段。
判据:这一段里的字符串字面量有以 `?` 开头的 ⇒ 查询串追加 ⇒ 丢掉。
"""
out = []
i = 0
while i < len(body):
if body.startswith("${", i):
end = find_template_end(body, i)
if end < 0:
# 未闭合:原样留着 ⇒ 下游照旧报缺口(宁可多报,不要静默吞掉)
out.append(body[i:])
break
expr = body[i + 2 : end - 1]
query_append = any(
lit[1:].startswith("?") for lit in RE_TMPL_LITERAL.findall(expr)
)
out.append("" if query_append else "{param}")
i = end
continue
out.append(body[i])
i += 1
return "".join(out)
def resolve_path(expr, enums):
"""把 url 表达式解析成真实路径模板。"""
if not expr:
@@ -141,7 +206,7 @@ def resolve_path(expr, enums):
body = re.sub(r"\bApi\.%s\b" % re.escape(key), val, body)
# 3) 剩下的 ${...} 是运行时变量 ⇒ 归一成 {param}
body = re.sub(r"\$\{[^}]*\}", "{param}", body)
body = subst_template_vars(body)
# 4) 去掉查询串残留与重复斜杠
body = body.split("?")[0]
body = re.sub(r"/{2,}", "/", body)
+290
View File
@@ -0,0 +1,290 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""gen-function-catalog.py —— 从官方 Java 枚举**生成**本仓的函数/变量目录。
为什么要生成而不是手抄
--------------------
`FunctionTypeEnum`(100+ 条)与 `SystemVariateEnum`(18 条)是**纯数据**:
公式编辑器(`variate.ts` 的三个元数据端点)靠它们出下拉与帮助文本。手抄两条风险:
① 漏条 —— 前端某个函数在帮助里点不开,但没人发现;
② 抄错 HTML 描述 —— 帮助面板显示成乱码/错行,且没有闸门能发现。
所以:**官方枚举是唯一真源**,本脚本把它转成 `src/backend/src/platform/variate_catalog.rs`。
改了官方枚举就重跑;`--check` 用于闸门(生成物与真源不一致 ⇒ 非零退出)。
用法
----
python3 scripts/gen-function-catalog.py # 写入(生成物)
python3 scripts/gen-function-catalog.py --check # 只校验,不写
退出码:0 一致 / 1 有差异 / 2 前置缺失
"""
from __future__ import annotations
import pathlib
import re
import sys
ROOT = pathlib.Path(__file__).resolve().parent.parent
JAVA_DIR = pathlib.Path(
"/Users/xs/Desktop/workspace/jnpf/jnpf-java-boot/jnpf-system/"
"jnpf-system-entity/src/main/java/jnpf/base/model/variate"
)
OUT = ROOT / "src" / "backend" / "src" / "platform" / "variate_catalog.rs"
def read(path: pathlib.Path) -> str:
if not path.exists():
sys.exit(f"缺少官方真源:{path}")
return path.read_text(encoding="utf-8", errors="replace")
def split_top_level(body: str) -> list[str]:
"""按**顶层**逗号切分(跳过字符串字面量与括号)。"""
parts: list[str] = []
buf: list[str] = []
depth = 0
i = 0
in_str = False
while i < len(body):
c = body[i]
if in_str:
buf.append(c)
if c == "\\":
buf.append(body[i + 1])
i += 2
continue
if c == '"':
in_str = False
i += 1
continue
if c == '"':
in_str = True
buf.append(c)
elif c == "(":
depth += 1
buf.append(c)
elif c == ")":
depth -= 1
buf.append(c)
elif c == "," and depth == 0:
parts.append("".join(buf).strip())
buf = []
else:
buf.append(c)
i += 1
tail = "".join(buf).strip()
if tail:
parts.append(tail)
return parts
def parse_java_string(expr: str) -> str:
"""把 Java 的字符串表达式(含 `+` 拼接)求值成纯文本。"""
expr = expr.strip()
chunks = re.findall(r'"((?:[^"\\]|\\.)*)"', expr)
out = []
for chunk in chunks:
out.append(
chunk.replace("\\n", "\n")
.replace("\\t", "\t")
.replace('\\"', '"')
.replace("\\\\", "\\")
)
return "".join(out)
def rust_str(s: str) -> str:
"""Rust 字符串字面量(用 r#"…"# 避免 HTML 里的引号转义地狱)。"""
if '"#' not in s:
return 'r#"' + s + '"#'
return '"' + s.replace("\\", "\\\\").replace('"', '\\"').replace("\n", "\\n") + '"'
def parse_enum_entries(text: str, enum_name: str) -> list[tuple[str, list[str]]]:
"""解析 `enum X { A(...), B(...); ... }` ⇒ [(枚举名, [参数原文…]), …]。"""
start = text.index(f"enum {enum_name}")
brace = text.index("{", start)
depth = 0
end = brace
for i in range(brace, len(text)):
if text[i] == "{":
depth += 1
elif text[i] == "}":
depth -= 1
if depth == 0:
end = i
break
body = text[brace + 1 : end]
# 枚举体在第一个**顶层** `;` 处结束(之后是字段与方法)
depth = 0
in_str = False
cut = len(body)
i = 0
while i < len(body):
c = body[i]
if in_str:
if c == "\\":
i += 2
continue
if c == '"':
in_str = False
elif c == '"':
in_str = True
elif c in "([{":
depth += 1
elif c in ")]}":
depth -= 1
elif c == ";" and depth == 0:
cut = i
break
i += 1
entries_text = body[:cut]
entries: list[list[str]] = []
depth = 0
in_str = False
buf: list[str] = []
i = 0
while i < len(entries_text):
c = entries_text[i]
if in_str:
buf.append(c)
if c == "\\":
buf.append(entries_text[i + 1])
i += 2
continue
if c == '"':
in_str = False
i += 1
continue
if c == '"':
in_str = True
buf.append(c)
elif c == "(":
depth += 1
buf.append(c)
elif c == ")":
depth -= 1
buf.append(c)
if depth == 0:
raw = "".join(buf)
head = raw[: raw.index("(")].strip()
args = raw[raw.index("(") + 1 : raw.rindex(")")]
entries.append((head, split_top_level(args)))
buf = []
elif depth == 0:
# 条目名与空白:丢掉(名字只是 Java 侧标识)
if c not in ",\n\r\t ":
buf.append(c)
else:
buf.append(c)
i += 1
return entries
def gen() -> str:
funcs_text = read(JAVA_DIR / "FunctionTypeEnum.java")
variates_text = read(JAVA_DIR / "SystemVariateEnum.java")
categories_text = read(JAVA_DIR / "FunctionCategory.java")
cats = parse_enum_entries(categories_text, "FunctionCategory")
cat_map = {name: parse_java_string(args[0]) for name, args in cats}
funcs = parse_enum_entries(funcs_text, "FunctionTypeEnum")
variates = parse_enum_entries(variates_text, "SystemVariateEnum")
lines: list[str] = []
lines.append("//! 公式编辑器的**函数目录**与**系统变量目录**。")
lines.append("//!")
lines.append("//! 🔴 **本文件是生成物,不许手改** —— 由 `scripts/gen-function-catalog.py`")
lines.append("//! 从官方 Java 枚举逐条转出:")
lines.append("//! `jnpf-system-entity/.../model/variate/{FunctionTypeEnum,SystemVariateEnum}.java`")
lines.append("//! 改了官方枚举就重跑脚本;`gen-function-catalog.py --check` 是闸门。")
lines.append("//!")
lines.append("//! 为什么值得生成:这 100+ 条是**前端公式编辑器的下拉与帮助文本**(含 HTML),")
lines.append("//! 手抄漏一条不会有任何编译/测试报错,只会让某个函数在帮助里点不开。")
lines.append("")
lines.append("/// 一条公式函数。")
lines.append("pub struct FuncEntry {")
lines.append(" /// 函数名(`SUM` / `ROUND` …),也是表达式里的写法。")
lines.append(" pub name: &'static str,")
lines.append(" /// 帮助文本(**HTML 片段**,前端直接 v-html 渲染)。")
lines.append(" pub description: &'static str,")
lines.append(" /// 分类枚举名(`MATH` / `TIME` …)。")
lines.append(" pub category: &'static str,")
lines.append(" /// 分类中文名(`数学函数` …)—— 与 `category` 一一对应,冗余存一份。")
lines.append(" pub sub_category: &'static str,")
lines.append("}")
lines.append("")
lines.append("/// 一条系统变量(`@userId` 之类,公式里可直接引用)。")
lines.append("pub struct VariateEntry {")
lines.append(" /// 变量名(含 `@` 前缀)。")
lines.append(" pub field: &'static str,")
lines.append(" /// 中文说明。")
lines.append(" pub description: &'static str,")
lines.append("}")
lines.append("")
# 分类(含「全部函数」——官方 `FunctionCategory.ALL` 在树里被排除)
lines.append("/// 函数分类(官方 `FunctionCategory` 全量,**含** `ALL`)。")
lines.append("pub const FUNCTION_CATEGORIES: &[(&str, &str)] = &[")
for name, label in cat_map.items():
lines.append(f" ({rust_str(name)}, {rust_str(label)}),")
lines.append("];")
lines.append("")
lines.append(f"/// 公式函数目录({len(funcs)} 条,官方 `FunctionTypeEnum` 逐条)。")
lines.append("pub const FUNCTIONS: &[FuncEntry] = &[")
for _name, args in funcs:
if len(args) < 4:
continue
fname = parse_java_string(args[0])
desc = parse_java_string(args[1])
cat = args[2].strip().split(".")[-1]
sub = parse_java_string(args[3])
lines.append(" FuncEntry {")
lines.append(f" name: {rust_str(fname)},")
lines.append(f" description: {rust_str(desc)},")
lines.append(f" category: {rust_str(cat)},")
lines.append(f" sub_category: {rust_str(sub)},")
lines.append(" },")
lines.append("];")
lines.append("")
lines.append(f"/// 系统变量目录({len(variates)} 条,官方 `SystemVariateEnum` 逐条)。")
lines.append("pub const SYSTEM_VARIATES: &[VariateEntry] = &[")
for _name, args in variates:
if len(args) < 2:
continue
field = parse_java_string(args[0])
desc = parse_java_string(args[1])
lines.append(" VariateEntry {")
lines.append(f" field: {rust_str(field)},")
lines.append(f" description: {rust_str(desc)},")
lines.append(" },")
lines.append("];")
lines.append("")
return "\n".join(lines)
def main() -> int:
text = gen()
if "--check" in sys.argv:
if not OUT.exists():
print(f"❌ 生成物不存在:{OUT}")
return 1
current = OUT.read_text(encoding="utf-8")
if current != text:
print("❌ 生成物与官方枚举不一致,请重跑 scripts/gen-function-catalog.py")
return 1
print("✅ 函数/变量目录与官方枚举一致")
return 0
OUT.write_text(text, encoding="utf-8")
print(f"已写入 {OUT}({len(text.splitlines())} 行)")
return 0
if __name__ == "__main__":
raise SystemExit(main())