 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
|
f4ed0e0b50
|
docs(gb48000): GAP 残留三处过期口径收敛(属性脚注/§9 行/#1 卡实现注记)
Co-Authored-By: Claude Opus 4.8 <[email protected]>
|
2026-09-20 17:18:13 +08:00 |
|
 adminandClaude Opus 4.8
|
adc26975b2
|
docs(gb48000): GAP §3.2/§3.3/§4.4 状态行与 PLAN.md 导出表述对齐实现
Co-Authored-By: Claude Opus 4.8 <[email protected]>
|
2026-09-20 17:10:29 +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 |
|
 adminandClaude Opus 4.8
|
34933b7c53
|
docs(gb48000): 差距分析报告 + 标准 PDF + PLAN/README 同步 + 实施计划 + CLAUDE.md
Co-Authored-By: Claude Opus 4.8 <[email protected]>
|
2026-09-20 14:50:56 +08:00 |
|
admin
|
43007cd2d2
|
docs(changelog): v1.4.1 发布说明(导入核对 tab 风格统一)
v1.4.1
|
2026-09-14 10:28:22 +08:00 |
|
admin
|
e92a287a73
|
refactor(web): 导入核对 tab 与全局风格统一
按用户「现在导入核对是一个内嵌页面,很突兀,是不是改为统一风格好点」。
之前 ReviewWorkbench 是个 dark-theme SPA(自带的 sidebar + brand + 进度环 + main),
被 ReviewView 用 stub 直接渲染,与其它 9 个 tab 的 page-title + card 风格完全割裂,
'独占全屏'地把外层 topbar + tabs + footer 全挤掉。
### 改动
- ReviewWorkbench.vue 去掉 app shell(sidebar / brand / 进度环),分类筛选折叠成
顶部单行 filter-bar,保留 header + main + log 三段;样式从 dark 改为沿用平台
浅色(card + #2f6bff 主色 + #059669/d97706/dc2626 状态色),与首页/概览风格一致。
- 状态 select / 操作按钮替换为 el-select / el-button,避免自定义控件风格漂移。
- ReviewView.vue 套 page-title + card 容器,与其它 view 一致。
### 不动的功能
7 项分类筛选、6 项状态筛选、连接/Key 配置、4 张统计卡、详情展开、日志面板、
内置清单导入、MD/JSON 导出、Apply 选中、reset/select-all 等全部保留。
|
2026-09-14 10:19:49 +08:00 |
|
admin
|
5e2ddf7241
|
docs(changelog): v1.4.0 发布说明(使用分析 + schema 层审计)
v1.4.0
|
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 读路径真实身份)
v1.3.6
|
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 配置)
v1.3.3
|
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 本体属性注册修复)
v1.3.2
|
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)
v1.3.1
|
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]。
v1.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 问题反馈通道发布说明
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 |
|