Files
knowledge-governance/internal/governance/source_schedule.go
T
zheromiku dcdc8d1ddd feat: 知识治理平台(含已验证发布/回滚契约)
全栈知识治理平台首次入库(P1-P10 + 发布链路模拟验证闭环):

- 治理核心:源目录/变更集/人工审核/发布批次/发布执行(fail-closed 闸口)
- 测试通道:WeKnora 测试 KB 上传/轮询/验收;poll 完成时写入
  parser_generation/index_generation,修复 manual/seed 路径发布闸口永久拦截
- 发布适配器 v071(本地 source=测试角色 / 云端 target=生产角色 模拟验证通过):
  * ES 导出/导入 mapping 自适应(.keyword 子字段、可选 tenant_id)
  * OSS locator 支持嵌套 scheme;chunks.seq_id 由目标序列分配
  * bundle 归档同身份重试原子替换;verifier 按 bundle chunk_type 计数
  * 回滚 job payload 支持 prior_execution_id(strict 解码)
- 三通道发布+回滚演练实测:publish 4/4 verified,检索命中,
  rollback 4/4 rolled_back,目标端 PG is_enabled=false、ES is_enabled=false
- 前端 A·Data-console 风格全站统一,120 用例通过
- 门禁:go vet / go test 全包通过,gofmt 干净
2026-09-30 10:54:06 +08:00

43 lines
1.4 KiB
Go

package governance
import (
"encoding/json"
"errors"
"time"
)
// V1 per-source refresh schedule. The schedule JSONB lives on the ACTIVE
// revision; next_refresh_at on source_connections is ALWAYS derived from it by
// the server (clients can never push an arbitrary due time).
const MinRefreshInterval = 5 * time.Minute
type SourceSchedule struct {
RefreshIntervalSeconds *int `json:"refresh_interval_seconds,omitempty"`
}
// ParseSourceSchedule accepts the stored JSON and normalises it. Missing,
// zero, or sub-5-minute values are rejected as "not configured" (interval 0,
// no error) rather than silently accepted: a source that could stampede the
// portal every few seconds is worse than a manual-only source.
func ParseSourceSchedule(raw []byte) (time.Duration, error) {
if len(raw) == 0 || string(raw) == "{}" {
return 0, nil
}
var schedule SourceSchedule
if err := json.Unmarshal(raw, &schedule); err != nil {
return 0, errors.New("invalid source schedule")
}
if schedule.RefreshIntervalSeconds == nil || *schedule.RefreshIntervalSeconds == 0 {
return 0, nil
}
if *schedule.RefreshIntervalSeconds < 0 {
return 0, errors.New("invalid source schedule")
}
interval := time.Duration(*schedule.RefreshIntervalSeconds) * time.Second
if interval < MinRefreshInterval {
return 0, errors.New("source refresh interval must be at least five minutes")
}
return interval, nil
}