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:
1 parent
e961904252
commit
c82a7d1f3d
16 files changed
+5117
-134
No files matched your search
@@ -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)
|
||||
|
||||
@@ -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())
|
||||
Reference in new issue
Block a user