Commit Graph
61 Commits
Author SHA1 Message Date
admin 8a72cb2e4e docs(changelog): 发布 v1.5.1 整合 GB/T 48000.3 建模能力 + MCP 写闸门修复
首个整合此前 1.6.0/1.5.0 规划能力的正式发布版本;
修复 MCP 写类工具硬编码 manager/ingest 主体、不查 grants 表导致的
已授 manage 主体(如 rong)经 MCP 仍被拒写的问题,改走 authz.CanWrite 与 REST 对齐。
2026-09-21 17:13:23 +08:00
admin 4f28dc53a2 fix(mcp): 写闸门改走 grant 授权,与 REST 路径对齐
原 MCP 写类工具在 handlers_mcp.go 用主体名硬判
(principal=="manager"||"ingest"),不查 grants 表,
导致被授 manage 权限的主体(如 rong)仍无法经 MCP 写入。

改为调用 authz.CanWrite("write","*","*"),与 REST 一致;
manager 仍由 CanWrite 内部特殊放行,任何持 write/manage
授权的主体均可写入。denyWrite 提示文案同步更新。
2026-09-21 15:47:13 +08:00
adminandClaude Opus 4.8 6fea152696 fix(ontology): 设置父类型时以库内既有公理做父子互斥守卫(PUT 省略 axioms 场景)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 22:23:39 +08:00
adminandClaude Opus 4.8 cbb3a76760 fix(ontology): 终审修复——axioms PUT 三态保持 + 缓存锁统一(classMu)+失效防污染+dateOrder 闭包声明+merge 缓存失效+父子互斥补齐+文档措辞
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 22:10:02 +08:00
adminandClaude Opus 4.8 e16bca882c docs(gb48000): M4/M5 落地状态回写(GAP/README/PLAN/CLAUDE/INSTANCE_GOVERNANCE)+ CHANGELOG 1.6.0
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 21:25:10 +08:00
adminandClaude Opus 4.8 5dd86bfa95 feat(schema): data_type 增 uri(绝对 URI 写入校验+xsd:anyURI 导出+AI/MCP 词表)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 20:59:55 +08:00
adminandClaude Opus 4.8 c5826df832 feat(ontology): display_name_lang 多语标签(三表+管理 API+Turtle 语言标签字面量,旧列回退)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 20:44:29 +08:00
adminandClaude Opus 4.8 376147fdf5 fix(ontology): createObjectType/deleteObjectType 补 invalidateClassCache(子类型 enum 闭包即时生效)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 20:27:44 +08:00
adminandClaude Opus 4.8 abbed9a60d feat(ontology): 属性继承(子类型读路径合并祖先属性+enum 校验闭包生效)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 20:01:08 +08:00
adminandClaude Opus 4.8 bb26040ed0 fix(ontology): parent_id 更新路径三态契约 + DDL 顺序对齐 brief
- updateObjectType 把 parent_id = $17 改为 CASE WHEN $17::boolean THEN $18 ELSE parent_id END,
  修复'PUT 不带 parent 字段即清空既有 parent'的回归(reviewer round 1)。
- db.go::migrate() 把 parent_id DDL 块挪到 axioms 块之后,与 brief 顺序对齐
  (语义无差,ADD COLUMN IF NOT EXISTS 幂等)。
- 追加 TestIntegration_ParentTriState_PreserveOnMissing:覆盖三态
  nil(保持)/""(清空)/值(设父),并断言不传 parent 时 parent_api_name 不变。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:26:42 +08:00
adminandClaude Opus 4.8 caacb5a3bf feat(ontology): parent_id SubclassOf 声明(环/父子互斥守卫+类型闭包+rdfs:subClassOf 导出)
DDL: object_types.parent_id BIGINT REFERENCES object_types(id) ON DELETE SET NULL(GB/T 48000.3-2026 §7.1.1 / 附录 A.1.6-7)。
模型: ObjectType.ParentID *int64(不序列化)+ ParentAPIName string(回显专用)。
入口: objectTypeInput.Parent *string 三态(nil=保持/空=无父/值=设父)。
守卫:
  createObjectType  自指 + 父子互斥(checkParentDisjoint)。
  updateObjectType  自指 + 环(checkParentCycle,parent 链 ≤32 步)+ 父子互斥(总是检查,即使 in.Parent 未传,沿用现有 parent)。
类型闭包: typeClosure 替换 Task 4 stub,实为 parent_id 链上行至根,深度 32 + visited 防环兜底。
读路径: loadObjectType / listObjectTypes LEFT JOIN object_types par 取 parent_api_name 回显。
导出: schemaTypeExport.ParentAPIName + buildTurtle 类型块追加 rdfs:subClassOf <parentIRI>(taskIRI 已由任务 6 顶部建立)。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:24:01 +08:00
adminandClaude Opus 4.8 f1ef22734e feat(export): 公理随 Turtle 导出为 OWL 公理(disjointWith/equivalentClass/inverseOf/FunctionalProperty)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:18:34 +08:00
adminandClaude Opus 4.8 309c1321b0 feat(ontology): functionalLinks 功能属性边写入校验(create_link/批量)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:13:26 +08:00
adminandClaude Opus 4.8 807427629e feat(ontology): dateOrder 公理实例写入校验(applyObjectUpsert 统一入口,validate_axioms 可豁免)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:08:22 +08:00
adminandClaude Opus 4.8 d6dc45e85f feat(ontology): 公理 schema 级良构校验(引用存在性+inverseOf 互换+date/datetime)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 19:03:25 +08:00
adminandClaude Opus 4.8 6e08f15581 feat(ontology): object_types.axioms 公理声明列(形状校验+创建/更新/回显+写入路径串入 schema 版本流)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 18:57:55 +08:00
adminandClaude Opus 4.8 c6cd9981f3 fix(export): 撤销 addProperty 多余的 DataType 守卫(任务1 brief 外)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 18:53:29 +08:00
adminandClaude Opus 4.8 b6ab1ffde6 fix(export): IRI 本地名守卫 + Turtle 字面量显式转义(导出防毒化)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 18:51:20 +08:00
adminandClaude Opus 4.8 5a8c8ca946 docs(gb48000): 终评收窄版本流水覆盖口径 + 旧快照 iri 注记 + PLAN 补钩后续项
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 17:36:27 +08:00
adminandClaude Opus 4.8 e5c18cbd55 docs(gb48000): 差距分析三项 P1 落地状态回写 + CHANGELOG + env 示例
存量集成测试 8 项失败与 Task 1-7 无关(对照实验:pre-GB48000 代码 + 全新库以完全相同文案复现):RestoreEdges/BackupLifecycle 新库通过=共享库 shangshu 状态残留;其余 6 项为测试环境前置缺失(共享库主体已有 api_key 触发 connectorAuth 401 / 全新库未跑 seedAccessControlDefaults 缺 access-control 五表),非本次交付回归;server/ai::TestHeuristicA5 为机器局部 fixture 文件缺失。冒烟:meta/export(turtle,400 分支)/versions(list+/:version+404/400)/iri 回显全部实测通过。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 16:59:04 +08:00
adminandClaude Opus 4.8 c3b4848dd6 fix(schema): getSchemaVersion 区分 ErrNoRows 与真实 DB 错误 + 404/400 断言
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 16:34:07 +08:00
adminandClaude Opus 4.8 fe2ef537aa feat(schema): /ontology/versions 版本流水查询 + 按版本读回旧定义
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 16:27:33 +08:00
adminandClaude Opus 4.8 3c2ae8b885 feat(schema): schemaAudit 挂钩 append-only 全局版本流水 schema_versions
TestIntegration_SchemaVersions 走 /versions 端点,Task 7 前预期红(404);
本任务以 TestIntegration_SchemaVersionsWritten 验证写入转绿。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 16:17:38 +08:00
adminandClaude Opus 4.8 a380664a1c feat(export): GET /ontology/export 导出 W3C Turtle,Protégé 等标准工具可加载
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 16:05:56 +08:00
adminandClaude Opus 4.8 4de8a8dce6 feat(export): 纯函数 Turtle 序列化(schema→owl:Class/DatatypeProperty/ObjectProperty)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 15:56:37 +08:00
adminandClaude Opus 4.8 ba699ded3b feat(ontology): 管理/审计/连接器读取路径统一回显 iri
含旁路创建位点回填治愈(seed/merge/AI 摄取):migrate 的三条 UPDATE 抽成
backfillMissingIRI,seedIfEmpty 灌入后、mergeExecute 提交后、ai.ApplySuggestion
落库后(runIngest 单点,覆盖 AI 摄取/km 抽取/连接批量抽取)各调一次治愈空值。

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 15:48:51 +08:00
adminandClaude Opus 4.8 3c3c385955 feat(schema): object/property/link 三类元数据物化全局 IRI(创建即固化+存量回填)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 15:25:18 +08:00
adminandClaude Opus 4.8 96a27c389f feat(ontology): 全局 IRI 命名空间配置 + /ontology/meta 自描述
Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-09-20 15:02:02 +08:00
admin 43007cd2d2 docs(changelog): v1.4.1 发布说明(导入核对 tab 风格统一) 2026-09-14 10:28:22 +08:00
admin 5e2ddf7241 docs(changelog): v1.4.0 发布说明(使用分析 + schema 层审计) 2026-09-11 18:32:43 +08:00
admin 8ed658382f feat(analytics): 使用分析面板 + schema 层审计 + access_log target/保留策略
- access_log 中间件按路由模板映射 target(修复 :name/:id 参数名导致
  /object-types/:name 等路由 target 长期为空);401/4xx 兜底记 deny;
  action 简化为 read/write/delete/manage;新增 90 天保留策略
  (ACCESS_LOG_RETENTION_DAYS 覆盖,0 关闭)
- schema 审计:对象类型/属性/链接类型/链接属性/动作类型/分级配置的
  增删改写入 ontology_audit_log(target_pk 落库,update/delete 带 before 快照);
  存量库补 target_pk 列(幂等 ALTER)
- 新增 /api/v1/analytics/{overview,types,users,sharing}(仅 manager):
  总体读写比/活跃主体/来源分布/按天趋势、分项热度、用户活跃、共享授权使用量
- 前端新增「使用分析」tab(AnalyticsView)
2026-09-11 18:23:47 +08:00
admin 15d0893522 docs(changelog): v1.3.6 发布说明([Unreleased] 定版 issue #8 MCP 读路径真实身份) 2026-09-07 18:41:14 +08:00
admin 6841712289 fix(mcp): 读路径透传调用方真实身份(issue #8 v2)
按用户反馈「每个主体都有 mcp 访问 key,就应该是各自主体身份」——
v1 方案「注入 connector key + 手动 X-Principal」本质是「模拟身份」,
绕开了主体解析链。v2 改为透传调用方真实鉴权。

### 改动
- callConn 接受源 *gin.Context,透传 X-API-Key / session cookie 给内层请求,
  让 principalFromRequest 自然解析到 manager / connector / analyst / 等。
- connectorAuth 放宽到「任一主体 api_key 即放行」:
  - 移除 WHERE name='connector' 的硬约束
  - 助手 anyPrincipalKeySet() 判断全库是否已有密钥(有则要求带 key,无则放行兼容无密钥只读)
- 6 个调用点去掉 principal 参数,改传 c。

### 影响
- 之前:MCP 读工具一律以 connector 执行,manager 走 MCP 只能看 L0-L2。
- 现在:各主体按自己 clearance 视图读,manager 走 MCP 见全部分级(含 L3)。
- callConn 路径与 connectorAuth 路径身份解析统一(都走 principalFromRequest 自然解析)。

### 验证
- 3 个新集成测试全绿(issue8_mcp_read_principal_test.go):
  按 connector / manager / analyst 三种 api_key 调 MCP get_objects_by_type,
  分别见 2 / 3 / 1 条(符合各自 clearance)。
- 既有 issue #6/#7 的 6 个测试 + SetObjectTypeClassification 全绿。

### CHANGELOG 风格
按用户反馈「只有改了什么 / 有什么影响,不要流水账」,
重写 [Unreleased] / [1.3.3] / [1.3.2] 三段:每段只留「影响 + 改动 [+ 设计]」,
去掉过程叙述、commit hash、调试日志、issue 评论引用等。
2026-09-07 18:36:21 +08:00
admin 2a58d5adab docs(changelog): v1.3.3 发布说明([Unreleased] 定版 issue #7 clearance 配置) 2026-09-07 17:43:46 +08:00
admin 8388e14772 feat(access): 补 principal clearance 配置入口(采纳 issue #7)
用户报告「principal_clearances 不可配置,导致 L3 实例对所有非 manager 主体不可见」
—— 实测是 UX 缺口:

### 修复
- PUT /access/principals/:name 的 principalUpdateInput 新增 clearances 字段(nil=不动;
  非空数组(含 [])= 全量替换),与 PUT /principals/:name/clearances 同义。
- GET /access/principals/:name 响应新增 clearances 数组(保证非 nil,空集序列化为 [])。
- GET /access/principals 列表也回显 clearances,避免管理员看不到当前状态。

### 新增 MCP 工具(之前 36 个没有这一片)
- list_principals:列出全部主体及其 clearance。
- get_principal:按名取单个主体(含 description / has_api_key / clearances)。
- set_principal_clearance:全量替换主体 clearance(alias 接受 markings / clearances)。

### 不动的部分
- seedAccessControlDefaults 中 manager 默认 [L0,L1,L2,L3,L4] 已正确(CHANGELOG v1.2.0
  「manager 不受影响」依然成立)。
- classificationCond / classAllowed 对 manager 显式放行已正确;用户报告的「admin
  看不到 L3」实际是误读——真正不可见的是非 manager 主体(默认 connector L0-L2、public L0)。

### 验证
- 新增 3 个集成测试(issue7_clearance_config_test.go):
  updatePrincipal clearances / MCP 端到端 / 旧专用端点回归,全绿。
- 既有测试除 TestIntegration_ClassificationFilter 外全绿(后者预存在失败)。
2026-09-07 17:38:54 +08:00
admin 938a5fc960 docs(changelog): v1.3.2 发布说明([Unreleased] 定版 issue #6 本体属性注册修复) 2026-09-07 16:53:14 +08:00
admin c16957b97d feat(ontology): 补 update_object_type / add_object_type_property(采纳 issue #6 方案 A+B)
用户提交 issue #6 反映「587 个 data_level 实例是孤儿,原生分级引擎无法接管」
(分类引擎要求 classification_property 必须在 schema 中注册,但无任何端点
能把属性注册到已存在类型上)。

### 修复
- PUT /api/v1/ontology/object-types/:name 此前静默忽略 properties 字段
  (用户实测加 zz_probe 属性再 GET 没注册上)。现 objectTypeInput 新增
  properties 数组字段,非空时由 upsertObjectTypeProperties 一并 upsert
  (同名更新元数据,新名新增)。createObjectType 也同步支持内联 properties,
  两条路径共用同一辅助函数,语义一致。

### 新增 MCP 工具
- update_object_type(包装 PUT /object-types/:name):更新 display/icon/group/
  分级三件套同时可批量 upsert properties。
- add_object_type_property(包装 POST /object-types/:name/properties):
  细粒度「加一个属性」入口,适合只补一个属性的场景(如分级属性 data_level)。

### 不采纳
- 方案 C(让 set_object_type_classification 在 property 不存在时自动注入):
  把属性注册藏在分类配置里语义混淆,属性注册应是显式动作 + 可独立审计。

### 验证
- 新增 3 个集成测试(issue6_object_type_property_test.go):
  update_object_type merge / add_object_type_property MCP 端到端 /
  update_object_type MCP 端到端,全绿。
- 全部既有测试除 TestIntegration_ClassificationFilter 外全绿;后者为预存在
  失败(stash 本次改动后仍 fail,根因不在本 PR 范围内)。
2026-09-07 16:41:52 +08:00
admin 4fc20ad0a5 fix(docker): HEALTHCHECK 改用免鉴权 /api/v1/version (v1.3.1 密钥收紧后 object-types 无头 401) 2026-09-07 15:38:13 +08:00
admin 2cacb40153 refactor(access): 完全移除 .env 显式密钥,密钥统一由 principals 表管理
理由:管理界面已就位,DB 中由 UI 设置或 seed 随机生成的 key 才是唯一权威来源,
不再需要在部署时手动配置 MANAGER_API_KEY/CONNECTOR_API_KEY/INGEST_API_KEY,
避免环境变量泄漏/不同环境不一致/容器重启覆盖等运维隐患。

### 设计
- 移除 Config 中的 ManagerAPIKey/ConnectorAPIKey/IngestAPIKey 字段及对应环境变量读取。
- principalFromRequest 仅查 principals 表 api_key;不再有 env 优先回退。
- loginRequired/connectorAuth 改为查询 'DB 是否已有密钥' 判定是否进入真实鉴权模式;
  manager 未配置 key 的全新库仍保留开放体验,便于首次引导(密码登录)。
- 首次启动时 seedAccessControlDefaults 为 4 个内置主体(manager/connector/public/ingest)
  随机生成 API Key 并打印到 stdout(幂等,已有 key 不覆盖)。
- handlers_mcp.callConn 内部派发改用 a.builtinKey('connector') 注入 X-API-Key,
  走 DB 查到的密钥而非 env。

### 加固
- 移除固定/空 key 漏洞:seed 写入前先 UPDATE...WHERE api_key IS NULL OR api_key='',
  重复启动幂等;首次启动日志里打印 4 个随机值,运维保存后可在 Access Control 页重置。

### 验证(localhost:8081 真实库,go test 全绿)
- DB 中已保存的 manager 主体密钥(经纯 DB 解析)返回 manage+L0-L4;密码登录仍可引导。
- connector 端点:无 key 401,带 DB key 200;authHint 切到 DB key 状态文案。
- public key 解析为 public(L0 only),匿名请求也回退 public,无升权。
- mgmt 端点:无 key / public key 均 401;manager key 200。
- 全部测试 green (server + ai)。

### 文档同步
- README.md / docs/README.md / docs/USAGE.md / docs/IMPORT.md /
  skills/ssw-ontology-reviewer/SKILL.md / web/src/views/ConnectorView.vue /
  server/CHANGELOG.md 同步去掉 .env 密钥说明,改为'首次启动日志 + Access Control 页管理'。
2026-09-07 15:37:22 +08:00
admin d938462bd6 refactor(access): 完全移除 .env 显式密钥,密钥统一由 principals 表管理
理由:管理界面已就位,DB 中由 UI 设置或 seed 随机生成的 key 才是唯一权威来源,
不再需要在部署时手动配置 MANAGER_API_KEY/CONNECTOR_API_KEY/INGEST_API_KEY,
避免环境变量泄漏/不同环境不一致/容器重启覆盖等运维隐患。

### 设计
- 移除 Config 中的 ManagerAPIKey/ConnectorAPIKey/IngestAPIKey 字段及对应环境变量读取。
- principalFromRequest 仅查 principals 表 api_key;不再有 env 优先回退。
- loginRequired/connectorAuth 改为查询 'DB 是否已有密钥' 判定是否进入真实鉴权模式;
  manager 未配置 key 的全新库仍保留开放体验,便于首次引导(密码登录)。
- 首次启动时 seedAccessControlDefaults 为 4 个内置主体(manager/connector/public/ingest)
  随机生成 API Key 并打印到 stdout(幂等,已有 key 不覆盖)。
- handlers_mcp.callConn 内部派发改用 a.builtinKey('connector') 注入 X-API-Key,
  走 DB 查到的密钥而非 env。

### 加固
- 移除固定/空 key 漏洞:seed 写入前先 UPDATE...WHERE api_key IS NULL OR api_key='',
  重复启动幂等;首次启动日志里打印 4 个随机值,运维保存后可在 Access Control 页重置。

### 验证(localhost:8081 真实库,go test 全绿)
- mgr-key-2213 经纯 DB 解析回 manager(manage+L0-L4);密码登录仍可引导。
- connector 端点:无 key 401,带 DB key 200;authHint 切到 DB key 状态文案。
- public key 解析为 public(L0 only),匿名请求也回退 public,无升权。
- mgmt 端点:无 key / public key 均 401;manager key 200。
- 全部测试 green (server + ai)。

### 文档同步
- README.md / docs/README.md / docs/USAGE.md / docs/IMPORT.md /
  skills/ssw-ontology-reviewer/SKILL.md / web/src/views/ConnectorView.vue /
  server/CHANGELOG.md 同步去掉 .env 密钥说明,改为'首次启动日志 + Access Control 页管理'。
2026-09-07 15:29:20 +08:00
admin d0baba4640 fix(access): 允许内置主体 manager/connector 设置自己的 API Key
此前 updatePrincipal 对 manager/connector/public 一律拒绝 api_key 变更,
导致 UI 编辑保存无反应(用户的 mgr-key-2213 保存不了)。现仅禁止匿名
主体 public 设置 key,manager/connector 可通过 UI 或 REST 设置/重置/清空。
鉴权逻辑不变:DB key 与 .env MANAGER_API_KEY/CONNECTOR_API_KEY 并存。
2026-09-07 14:52:15 +08:00
admin 389dbfb4b8 feat(classification): 补 PUT /object-types/:name/classification 端点
背景:v1.2.0 加了 object_types.classification_property/_levels/_default 三列,
 但只暴露了 GET /classification/config,没有配对的 PUT/POST。
 后果:
   - 前端编辑对象类型分级保存按钮看似无反应(POST 到不存在的路由)
   - 587 个打了 data_level 标签的实例是「裸属性」,分级引擎不接管
   - 23 个类型 enabled 全是 false

 改动:
   - 新增 REST PUT /api/v1/ontology/object-types/:name/classification
     (handler: setObjectTypeClassification)
   - 校验:levels 非空有序、default ∈ levels、property 必须是已存在属性
   - 写入后调 invalidateClassCache() 让下一次 GET config 立刻反映
   - 「关闭分级」入口:property=空 允许 levels=[] / default=''
   - 新增 MCP 工具 set_object_type_classification(manager 必填)
   - 24 个测试全绿(11 纯函数 + 13 集成)
2026-09-07 14:33:33 +08:00
admin e7b39805fb feat(backup): 按 schema 镜像 + 请求级 search_path 切库 (issue #4 #5 后续)
「让客户端敢操作」的关键能力:写前/写后打一份快照 → 任意 GET 带 X-Snapshot-Id
 头即可命中 backups_<id> schema 的同名表(业务 SQL 不带 schema 前缀照样切)。

 设计要点:
   - 备份 = 独立 schema backups_<id>(真表,不是单存 JSONB)—— 查询性能与活库一致
   - snapshotRouter 中间件:BeginTx + SET LOCAL search_path → 把 a.pool 临时换
     为事务视图 txPool → handler 结束 commit + 还原 a.pool。业务代码一行不改。
   - a.pool 字段类型从 *pgxpool.Pool 升级为 dbRunner interface(中间件可换 txPool)。
   - 11 个 helper 函数签名同步改为 dbExec(与现有 dbExec 共存,无破坏性)。
   - 写方法(POST/PUT/PATCH/DELETE)带快照头 → 403 拒绝(mistake-safety)。

 接口:
   - POST /api/v1/backups 创建
   - GET /api/v1/backups 列表
   - GET /api/v1/backups/:id 元信息(含 schema_name)
   - GET /api/v1/backups/:id/switch 切库提示
   - DELETE /api/v1/backups/:id 级联删 schema
   - 支持 X-Snapshot-Id (直接 run id) + X-Snapshot-Ts (秒级时间戳) 两种切换入口

 MCP 工具 (5 个):backup_create / backup_list / backup_inspect / backup_switch / backup_delete

 测试 (22 个全绿,~5.5s 集成):
   - SnapshotRouter:改前建快照 → 改后读快照只见改前
   - SnapshotSearchPathPersist:不污染下一个请求
   - SnapshotByTimestamp:ts 头也能切库
   - SnapshotDeleteCleansSchema:delete 真 DROP schema
   - BackupLifecycle / BackupDiffAfterMutation:完整 create→list→inspect→switch→delete

 文档:docs/BACKUP.md 写清用法、机制、客户端工作流;CHANGELOG.md [1.3.0]。
2026-09-07 11:35:47 +08:00
admin ae9a1a69e2 test: 加 16 个回归测试 (11 纯函数 + 5 集成) + docs/TESTING.md
- 纯函数单测(go test -short)覆盖:
  classification (levelIndex/maxLevel/materializeClassification/principalMaxIndex/deniedLevelsFor)、
  display_name (propString/resolveDisplayName)、
  governance (diffProps/mergeProps/parseStringArray/similarity)
- 集成测试(-tags=integration,跑真实 PG)覆盖 issue #4 #5 端到端:
  enum_violation 拦截 + 友好错误;分级过滤 manager vs analyst(L0/L1) 越级 404;
  properties.sensitivity 越级 redact 为 ***;删→恢复关系边 (links_snapshot+edges_created=1);
  recompute dry_run 不落库 / apply=true 落库修正错误分级
- 集成测试踩坑:X-Principal 与 principal_clearances.principal 必须一致;每次新主体必须清
  authzCache(sync.Map 进程级),否则历史空 Authz 会让分级过滤假阴性
- docs/TESTING.md:测试分层 / 跑测命令 / 编写新测试的约定
- CHANGELOG [1.2.0] 加 测试 与 文档 段落
2026-09-07 10:11:39 +08:00
admin da73b1091f feat(governance): restore_object 恢复关系边 + 数据分级通用能力 (issue #4 #5)
- #4 restore_object 默认连同关系边恢复:删除级联存边快照(links_snapshot),回滚重建两端在的边、跳过悬空引用,分级从快照物化
- #5 数据分级(不硬编码字段名/级别名):
  - 类型级 classification_property/levels/default 配置 + objects.classification 物化列+索引
  - 读路径按 principal_clearances 下推过滤,越级默认屏蔽且不泄漏存在性(fail-closed)
  - 字段级 properties.sensitivity 越级脱敏为 ***
  - 枚举写入校验(修复变量遮蔽导致的永不拦截 bug):越界值 400 enum_violation
  - 批量重算 recompute(dry_run 默认/apply 落库) + KM 源文件级分级传导
  - MCP +3 工具(get_classification_config/recompute_classification/set_km_classification)
- 分级路由改挂 /ontology 避免与 /objects/:type/:pk 参数路由冲突
- 更新 CHANGELOG 与 INSTANCE_GOVERNANCE.md §15-§16
- 验证:localhost:8081 真实库跑通删→恢复边、分级过滤、枚举拦截、字段脱敏、重算落库
2026-09-07 09:45:02 +08:00
admin 097910e63e docs(changelog): 记录 v1.1.1 问题反馈通道发布说明 2026-09-05 15:26:32 +08:00
admin 7369706cd4 refactor(feedback): 反馈配置内嵌二进制,移除 .env 依赖
- giteaAPIBase/giteaIssueRepo/giteaIssueToken 常量编译进 server/version.go(含外网地址 :82)
- config.go 移除 Gitea 三个字段;.env/.env.example 清理 GITEA_*,部署零配置
- e2e:零环境变量启动 → POST /api/v1/feedback 自动建 issue #2(外网 issue_url)→ 外网 API 关闭
2026-09-05 15:17:11 +08:00
admin 3f08c55cae feat(feedback): 公开反馈代理 POST /api/v1/feedback — 自动生成 Gitea issue,调用方零凭据
- 实测 Gitea 1.26.1 原生不支持匿名建 issue(401 + Web 跳登录),改为服务端代理
- 服务端持专用 token(GITEA_ISSUE_TOKEN,仅 write:issue scope,不入库 .env)
- 标题自动补 [bug]/[建议] 前缀,正文自动附版本号/commit/时间
- 每 IP 每小时限 10 条;token 未配置时 503 引导 Web 入口
- MCP manifest feedback.api 与 CHANGELOG 同步为 /api/v1/feedback
2026-09-05 15:12:23 +08:00
admin 8f27e34088 feat(changelog): CHANGELOG 头部增加 Issue 反馈机制(Web/API 入口 + 提交约定),MCP manifest 同步 feedback 字段
- issue 入口: https://oadfec13300ad18dm.mayishangshu.cn:82/ssw/ssw-ontology/issues(已探活 200)
- AI 经 Gitea API POST issues 提交 bug/建议,标题 [bug]/[建议] 前缀 + 版本号 + 复现步骤
- MCP manifest 新增 feedback 段(issues/api/convention/changelog_url)
2026-09-05 15:04:08 +08:00
admin 07fd1454f1 feat(version): 版本自描述 — CHANGELOG 内嵌 + 页脚/MCP/API 三端可见
- server/CHANGELOG.md 随 //go:embed 打进二进制,运行时零磁盘依赖
- ldflags 注入 Version/Commit/BuildTime(build.sh 与 Dockerfile 说明同步)
- GET /api/v1/version 与 /api/v1/version/changelog(公开)
- MCP 新增 get_server_info(第 25 个工具),initialize serverInfo / manifest
  version 同步注入值
- 前端页脚版本徽章,点击弹出更新说明对话框
2026-09-05 14:49:56 +08:00