Commit Graph
3 Commits
Author SHA1 Message Date
admin 1b677b8762 docs(update): 同事升级操作说明(面向操作员友好版)
跟 2026-08-24-runbook.md(面向工程师技术细节)的区别:
- 升级说明:3 步命令可复制粘贴、验证清单可逐项打勾、失败兜底列具体场景
- runbook:DDL 设计取舍、FK 顺序、事务行为细节

涵盖:
1. 一句话总结(3 段命令贴进终端跑完即可)
2. 适用场景表(哪些情况要做、哪些不用)
3. 前置要求(PG 版本 / pgcrypto 扩展 / 操作账号权限)
4. 三步执行(改连接变量 → 跑 schema → 跑 seed)
5. 验证清单(7 条 SQL 逐项打勾)
6. 失败兜底(schema / seed / 接口三类问题的修法)
7. 升级前后对比(22 张表 vs 17 张 / 新增哪些列)
8. 升级完后下一步 + 还要问老板的事
2026-08-24 17:56:15 +08:00
admin 81c4dcc5c4 docs(update): 独立 schema 迁移 + builtin seed 脚本 + runbook\n\n把 server/db.go migrate() + ensureAccessControlSchema() +\nensureBuiltinFunctions() + ensureBuiltinInterfaces() +\nseedAccessControlDefaults() + seedIfEmpty() 共 6 段拆成可手动跑的\nSQL 脚本,方便:\n- 手动部署到生产 PG(不让服务自己建表)\n- 调试 schema 演进(不启动服务即可单跑)\n- 离线环境无 server 二进制时也能升级\n\n3 个文件:\n- schema-migrate.sql DDL(事务,幂等):22张表 + 12个索引\n- builtin-seed.sql 数据:4 functions + 6 interfaces + 4 principals +\n clearances/grants + L0 默认标记 + demo 种子\n- runbook.md 执行顺序 + 验证清单 + 回滚 + 设计要点\n\n实测 (空库):\n- schema-migrate.sql 重复跑 2 次,全部 NOTICE/skipped,table_count=22 ✓\n- builtin-seed.sql 一次跑过,验证函数返回全部命中预期值 ✓\n- builtin-seed.sql 含 CREATE EXTENSION pgcrypto 自包含 2026-08-24 17:52:26 +08:00
admin 86730bd52d feat: 对标 Palantir Ontology + P0/P1/P2 全落地 + xeo 端到端导入
## Palantir Ontology 对标(10 项)

P0 核心契约:
- when_to_suggest JSONB + llm_tool_description TEXT 加到 function_types/action_types
- Action 完整契约: submission_criteria / side_effects / impl_function_id / return_type
- FBA (Function-backed Action) 执行链: /api/v1/objects/:type/:pk/actions/:action
- /api/v1/ontology/suggestions 提示调度端点

P1 元原语补全:
- Object Type UX: title_property / subtitle_property / color / primary_key
- Property 字段元数据: format / default_value / indexable / vector_index / backing_column
- Link Type: directional + 独立 link_properties 子表
- Interface Type: shared_properties + parent_interface_id 多态
- Property extended types: geoshape / geopoint / media / timeseries / timestamp

P2 数据管道层:
- materializations / materialization_rows 物化层 + 60s ticker scheduler
- backing_sources 同步源元数据 + 投影字段映射

AI 提示词升级:
- ai/prompt.go 抽出 250+ 行静态 systemPrompt
- 动态上下文注入: 每次 Suggest 前查 db 拉已注册类型清单
- Suggestion struct 扩展 22 字段

## ON CONFLICT 漏 source 修复(4 处)
- handlers_objects createObject/updateObject: COALESCE(NULLIF(EXCLUDED.source,''), objects.source)
- handlers_km upsertObject + ai.ApplySuggestion: SET source=EXCLUDED.source
- 表名必须限定 objects.source, 否则报 ambiguous

## xeo mobileApi 端到端导入
- /api/v1/ai/ingest raw_text 改用 json.dumps 转义, 修复 ingestion_id=56 failed
- 1179 实例 + 1672 links + 1806 物化行
- 占位: 5 TrustedDataSpace + 158 MemberOrg
- 5 类 Materialization 配好(mat_xeo_dataproduct 等)

## 文档
- docs/update/2026-08-24.md: 10 节迁移 + 增量 11 节
- .gitignore: 加 web/vite.config.js.timestamp-*.mjs

Refs: docs/update/2026-08-24.md
2026-08-24 13:54:49 +08:00