含旁路创建位点回填治愈(seed/merge/AI 摄取):migrate 的三条 UPDATE 抽成 backfillMissingIRI,seedIfEmpty 灌入后、mergeExecute 提交后、ai.ApplySuggestion 落库后(runIngest 单点,覆盖 AI 摄取/km 抽取/连接批量抽取)各调一次治愈空值。 Co-Authored-By: Claude Opus 4.8 <[email protected]>
124 lines
4.2 KiB
Go
124 lines
4.2 KiB
Go
package main
|
||
|
||
// 本体 schema 层审计(2026-09-11)
|
||
//
|
||
// 实例级变更已有 object_changes(字段级 diff + 快照),但 schema 层
|
||
// (对象类型 / 属性 / 链接类型 / 链接属性 / 动作类型)此前只有 access_log 的
|
||
// method+path 间接痕迹,没有 before/after 内容 —— 本文件补齐:
|
||
// - 全部 schema 增删改写入 ontology_audit_log(target_pk 落库)
|
||
// - update/delete 记录变更前快照(before),create 记录输入(after)
|
||
// 失败只打日志,不阻断主流程(与 recordChange 同策略)。
|
||
|
||
import (
|
||
"context"
|
||
"encoding/json"
|
||
"log"
|
||
|
||
"github.com/gin-gonic/gin"
|
||
)
|
||
|
||
// schemaAudit 写一条 schema 层审计记录。
|
||
func (a *app) schemaAudit(c *gin.Context, action, targetType, targetPK string, details map[string]any) {
|
||
actor := a.principalFromRequest(c)
|
||
if actor == "" {
|
||
actor = "anonymous"
|
||
}
|
||
if details == nil {
|
||
details = map[string]any{}
|
||
}
|
||
b, _ := json.Marshal(details)
|
||
if _, err := a.pool.Exec(context.Background(),
|
||
`INSERT INTO ontology_audit_log(actor, action, target_type, target_pk, details, affected_rows)
|
||
VALUES($1,$2,$3,$4,$5::jsonb,$6)`,
|
||
actor, action, targetType, targetPK, string(b), 1); err != nil {
|
||
log.Printf("[schema_audit] 写入失败 %s %s/%s: %v", action, targetType, targetPK, err)
|
||
}
|
||
}
|
||
|
||
// toMap 结构体 → map(审计 details 用,nil 安全)。
|
||
func toMap(v any) map[string]any {
|
||
if v == nil {
|
||
return nil
|
||
}
|
||
b, err := json.Marshal(v)
|
||
if err != nil {
|
||
return nil
|
||
}
|
||
var m map[string]any
|
||
_ = json.Unmarshal(b, &m)
|
||
return m
|
||
}
|
||
|
||
// objectTypeSnapshot 读取对象类型(含属性)当前状态,作 update/delete 的 before 快照。
|
||
func (a *app) objectTypeSnapshot(c *gin.Context, name string) map[string]any {
|
||
o, err := loadObjectType(c, a.pool, name)
|
||
if err != nil {
|
||
return nil
|
||
}
|
||
return toMap(o)
|
||
}
|
||
|
||
// propertySnapshot 按 properties.id 读取属性当前状态(含所属类型 api_name)。
|
||
func (a *app) propertySnapshot(c *gin.Context, id int64) map[string]any {
|
||
var p Property
|
||
var enum, defVal []byte
|
||
var typeName string
|
||
err := a.pool.QueryRow(c, `
|
||
SELECT p.id, p.object_type_id, p.api_name, p.display_name, p.data_type, p.required,
|
||
p.enum_values, p.description, p.format, p.default_value, p.indexable,
|
||
p.vector_index, p.backing_column, COALESCE(p.sensitivity,''), COALESCE(p.iri,''), ot.api_name
|
||
FROM properties p JOIN object_types ot ON ot.id = p.object_type_id
|
||
WHERE p.id=$1`, id).
|
||
Scan(&p.ID, &p.ObjectID, &p.APIName, &p.DisplayName, &p.DataType, &p.Required,
|
||
&enum, &p.Description, &p.Format, &defVal, &p.Indexable,
|
||
&p.VectorIndex, &p.BackingColumn, &p.Sensitivity, &p.IRI, &typeName)
|
||
if err != nil {
|
||
return nil
|
||
}
|
||
p.EnumValues = parseStringArray(enum)
|
||
p.DefaultValue = jsonRaw(defVal)
|
||
m := toMap(p)
|
||
if m != nil {
|
||
m["object_type"] = typeName
|
||
}
|
||
return m
|
||
}
|
||
|
||
// linkTypeSnapshot 读取链接类型当前状态。
|
||
func (a *app) linkTypeSnapshot(c *gin.Context, name string) map[string]any {
|
||
var l LinkType
|
||
err := a.pool.QueryRow(c, `
|
||
SELECT id, api_name, display_name, source_type, target_type, cardinality,
|
||
COALESCE(description,''), directional, COALESCE(source_property,''), COALESCE(target_property,''), COALESCE(iri,'')
|
||
FROM link_types WHERE api_name=$1`, name).
|
||
Scan(&l.ID, &l.APIName, &l.DisplayName, &l.SourceType, &l.TargetType, &l.Cardinality,
|
||
&l.Description, &l.Directional, &l.SourceProperty, &l.TargetProperty, &l.IRI)
|
||
if err != nil {
|
||
return nil
|
||
}
|
||
return toMap(l)
|
||
}
|
||
|
||
// linkPropertySnapshot 按 link_properties.id 读取链接属性当前状态(含所属链接类型 api_name)。
|
||
func (a *app) linkPropertySnapshot(c *gin.Context, id int64) map[string]any {
|
||
var p LinkProperty
|
||
var enum []byte
|
||
var ltName string
|
||
err := a.pool.QueryRow(c, `
|
||
SELECT p.id, p.link_type_id, p.api_name, p.display_name, p.data_type, p.required,
|
||
p.enum_values, COALESCE(p.description,''), lt.api_name
|
||
FROM link_properties p JOIN link_types lt ON lt.id = p.link_type_id
|
||
WHERE p.id=$1`, id).
|
||
Scan(&p.ID, &p.LinkTypeID, &p.APIName, &p.DisplayName, &p.DataType, &p.Required,
|
||
&enum, &p.Description, <Name)
|
||
if err != nil {
|
||
return nil
|
||
}
|
||
p.EnumValues = parseStringArray(enum)
|
||
m := toMap(p)
|
||
if m != nil {
|
||
m["link_type"] = ltName
|
||
}
|
||
return m
|
||
}
|