model-platform

302 Commits 2 Branches 2 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
tao.chenandtao.chen	9f7b6ba18c	feat(audit): skip audit log for excluded health/root paths 健康检查与根路径（/health/live、/health/ready、/api/v1/health、 /、/health/storage）没有用户、没业务动作，每秒被 K8s/LB 探针刷一次只会灌进无意义噪音。命中排除集即跳过审计行；诊断日志（method/path/status/ms 走 stderr）照常打，对容器运维排错仍有用。 * settings.audit_excluded_paths: list[str] 默认覆盖 5 条基础设施路径，env AUDIT_EXCLUDED_PATHS 用逗号分隔（pydantic NoDecode + field_validator 兼容 str/list） * main.py 模块级 _AUDIT_EXCLUDED = frozenset(...)， access_log 的 success/exception 两条审计行各加守卫诊断无条件打 * 测试用 _AccessLogReplica 复刻 access_log 契约（不 import 真实 main.py），新增 4 个 case：排除根路径、排除 /health/live、不排除路径照写审计、自定义排除集顺带 schedule 模块：ExecutionResult 与 context 已迁到 schedule.domain.*（execution.py / orchestrator.py / scheduler.py / worker.py），调用点跟进；schedule 自身 18 个测试在改前改后均通过。	2026-09-02 10:10:41 +08:00
tao.chenandtao.chen	8dc2311536	refactor(audit): fold audit logging into access_log, drop AuditMiddleware 按用户复查意见把审计折进 main.py 已有的 access_log 中间件，少一个 middleware、让诊断与合规共用一个出口。 * 删 backend.audit.AuditMiddleware（user_id 解析搬到 main.py 的 _audit_user_id 模块级 helper，cookie/Bearer 头 + JWT 验签，失败/缺失一律 '-'，全异常捕获不让审计拖死业务）。 * access_log 在 success 路径补 logger.bind(user_id, method, path, status).info('audit')；exception 路径同样补一条 status=500 的审计行，然后 re-raise 让全局 handler 转 500。 * 删 app.add_middleware(AuditMiddleware)。 * audit.py 只剩 _DailyFileSink / configure_audit_logging / AUDIT_LOG_FORMAT，文件 sink 与 retention 清理逻辑不变。 * 测试改用 _AccessLogReplica 复制 access_log 审计契约（不 import main.py 避免触发 lifespan 里的 MySQL/engine 初始化），删 3 个 middleware 单独 case，加 access_log 端到端 success / 5xx / 无 JWT 三个 case。	2026-09-02 10:10:41 +08:00
tao.chenandtao.chen	ff33523867	feat(audit): per-request loguru audit middleware with daily rotation 按需为每个 HTTP 接口写一条合规记录到 data/logs/audit/audit-YYYY-MM-DD.log，字段：时间 / 用户 / METHOD path / 状态码。设计： * 复用全局 loguru logger，文件 sink 由 audit._DailyFileSink 自管：缓存当天文件句柄、跨日重建。不走 loguru 的 rotation=00:00（产物是 audit.log.YYYY-MM-DD_HH-MM-SS，不符合按天单文件的命名要求）。 * AuditMiddleware 只做 CPU 验签拿 user_id：cookie access_token 优先，Authorization Bearer 兜底，无/坏 JWT 一律记 '-'。绝不查 DB（RequestContext 在路由解析后才注入）。 * 审计失败不拖死请求：所有异常捕获。 * 与 main.py 现有 access_log 严格分离：access_log 走 stderr 诊断（method/path/status/耗时），audit 走独立文件合规（时间/用户/接口），并存。 * 启动时按 settings.audit_log_retention_days 清理过期文件（设 0 关闭）。 * 新增 settings.audit_log_dir（默认 data/logs/audit，相对 cwd）与 settings.audit_log_retention_days（默认 30）两个配置项； .env.example 同步。新增 9 个 case：文件创建、行字段、未登录 '-'、坏 JWT、ULID path、retention 清理/关闭、Bearer 头、幂等。	2026-09-02 10:10:41 +08:00

Author

SHA1

Message

Date

tao.chenandtao.chen

9f7b6ba18c

feat(audit): skip audit log for excluded health/root paths

健康检查与根路径（/health/live、/health/ready、/api/v1/health、
/、/health/storage）没有用户、没业务动作，每秒被 K8s/LB
探针刷一次只会灌进无意义噪音。命中排除集即跳过审计行；
诊断日志（method/path/status/ms 走 stderr）照常打，对容器
运维排错仍有用。

* settings.audit_excluded_paths: list[str] 默认覆盖 5 条
  基础设施路径，env AUDIT_EXCLUDED_PATHS 用逗号分隔
  （pydantic NoDecode + field_validator 兼容 str/list）
* main.py 模块级 _AUDIT_EXCLUDED = frozenset(...)，
  access_log 的 success/exception 两条审计行各加守卫
  诊断无条件打
* 测试用 _AccessLogReplica 复刻 access_log 契约（不 import
  真实 main.py），新增 4 个 case：排除根路径、排除 /health/live、
  不排除路径照写审计、自定义排除集

顺带 schedule 模块：ExecutionResult 与 context 已迁到
schedule.domain.*（execution.py / orchestrator.py /
scheduler.py / worker.py），调用点跟进；schedule 自身
18 个测试在改前改后均通过。

2026-09-02 10:10:41 +08:00

tao.chenandtao.chen

8dc2311536

refactor(audit): fold audit logging into access_log, drop AuditMiddleware

按用户复查意见把审计折进 main.py 已有的 access_log 中间件，
少一个 middleware、让诊断与合规共用一个出口。

* 删 backend.audit.AuditMiddleware（user_id 解析搬到 main.py
  的 _audit_user_id 模块级 helper，cookie/Bearer 头 + JWT
  验签，失败/缺失一律 '-'，全异常捕获不让审计拖死业务）。
* access_log 在 success 路径补 logger.bind(user_id, method,
  path, status).info('audit')；exception 路径同样补一条
  status=500 的审计行，然后 re-raise 让全局 handler 转 500。
* 删 app.add_middleware(AuditMiddleware)。
* audit.py 只剩 _DailyFileSink / configure_audit_logging /
  AUDIT_LOG_FORMAT，文件 sink 与 retention 清理逻辑不变。
* 测试改用 _AccessLogReplica 复制 access_log 审计契约（不
  import main.py 避免触发 lifespan 里的 MySQL/engine 初始化），
  删 3 个 middleware 单独 case，加 access_log 端到端 success /
  5xx / 无 JWT 三个 case。

2026-09-02 10:10:41 +08:00

tao.chenandtao.chen

ff33523867

feat(audit): per-request loguru audit middleware with daily rotation

按需为每个 HTTP 接口写一条合规记录到
data/logs/audit/audit-YYYY-MM-DD.log，字段：时间 / 用户 /
METHOD path / 状态码。

设计：
* 复用全局 loguru logger，文件 sink 由 audit._DailyFileSink
  自管：缓存当天文件句柄、跨日重建。不走 loguru 的
  rotation=00:00（产物是 audit.log.YYYY-MM-DD_HH-MM-SS，
  不符合按天单文件的命名要求）。
* AuditMiddleware 只做 CPU 验签拿 user_id：cookie access_token
  优先，Authorization Bearer 兜底，无/坏 JWT 一律记 '-'。
  绝不查 DB（RequestContext 在路由解析后才注入）。
* 审计失败不拖死请求：所有异常捕获。
* 与 main.py 现有 access_log 严格分离：access_log 走 stderr
  诊断（method/path/status/耗时），audit 走独立文件合规
  （时间/用户/接口），并存。
* 启动时按 settings.audit_log_retention_days 清理过期文件
  （设 0 关闭）。
* 新增 settings.audit_log_dir（默认 data/logs/audit，相对 cwd）
  与 settings.audit_log_retention_days（默认 30）两个配置项；
  .env.example 同步。

新增 9 个 case：文件创建、行字段、未登录 '-'、坏 JWT、ULID
path、retention 清理/关闭、Bearer 头、幂等。

2026-09-02 10:10:41 +08:00