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

124 lines
4.1 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)
// 失败只打日志,不阻断主流程(与 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,''), 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, &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,'')
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)
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
}