Files
ssw-ontology/server/schema_audit.go
T
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

134 lines
4.8 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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)
// - 同点追加 schema_versions(append-only 全局版本流水,GB/T 48000.3 版本追踪)
// 失败只打日志,不阻断主流程(与 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)
}
// 同步追加一条全局单调版本(schema_versions,append-only)。
// version 列走 DEFAULT 序列(nextval),INSERT 不显式传。
// 与审计写入同策略:失败仅记日志,绝不阻断 schema 写主流程。
if _, err := a.pool.Exec(context.Background(),
`INSERT INTO schema_versions(action, target_kind, target_name, actor, details)
VALUES($1,$2,$3,$4,$5::jsonb)`,
action, targetType, targetPK, actor, string(b)); err != nil {
log.Printf("[schema_versions] 写入失败 %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, &ltName)
if err != nil {
return nil
}
p.EnumValues = parseStringArray(enum)
m := toMap(p)
if m != nil {
m["link_type"] = ltName
}
return m
}