xsl
3961b6fbfa
apps/admin 独立应用：X-Admin-Token 鉴权（空=全部路由不注册=404）、实体/规则
维护与状态机流转、发布编排（publish/archive → 规则缓存 invalidate +
retrieval invalidate_cache 双失效）、素材登记与审核（tryon_ready 门禁透传）、
缺口看板（T-P2-09，FR-ADM-01~05）。V1 共享令牌鉴权，无角色无审计字段，
操作留证靠 structlog request_id。
测试：单测 tests/unit/test_admin_app.py（10 例：空令牌 404、错/缺/非 ASCII
令牌 40100、正确令牌 200 假服务、发布编排接线、幂等重放无副作用）；
集成 tests/integration/test_admin_console.py（5 例：顾问全流程不碰客户端
API、双失效副作用可观察、非法跃迁 40900、素材审核门禁、缺口看板排序、
令牌 401）。483 单测 + 43 集成全绿；ruff/mypy/lint-imports 全绿。
偏差说明：
1. packages/retrieval.repo.list_gaps 有缺陷：对 select(KbGap) 的结果调
.mappings()，行键是实体名而非列名，GapSummary(row) 取 row.gap_id 必然
AttributeError（该路径无既有测试覆盖，接真库即暴露）。packages/** 本
任务禁改，故缺口查询在 apps/admin/routers/gaps.py 以等价 SQL 自实现
（hit_count 降序、同频次按 last_seen_at 降序、limit/offset 语义一致）；
建议合并阶段修复上游后切回 retrieval.list_gaps。
2. 实体 transition 的 target 收全量四态（任务文档示例仅列 reviewing/
published/archived）：按任务测试要求 published→draft 必须返回 40900
（状态机语义冲突）而非 schema 422；draft 作为目标由服务层跃迁矩阵恒拒。
3. 规则路由以 rule_key 为路径参数（任务文档写 /rules/{id}，但 RuleService
全程以 rule_key 寻址，无按数字 id 的接口，以代码为准）。
4. 发布编排触发面含 archived（撤稿）：依据 retrieval.invalidate_cache 的
自身契约「发布/归档知识后调用」，比文档字面的「发布成功后」多了撤稿
方向；reviewing 等其余状态不触发。
5. updated_by/author 记 "admin-console"：V1 共享令牌无操作者身份，字段
留渠道来源；运营账号体系属 V2（见包 docstring 的升级路径）。
36 lines
1.8 KiB
Python
36 lines
1.8 KiB
Python
"""发布编排：知识变更后的下游缓存「自然失效」（T-P2-10 的入口）。
|
|
|
|
运营后台是唯一有「发布 / 撤稿」动作的地方，因此失效编排长在这里而不是
|
|
service 层：``KbService``/``RuleService`` 管状态机，跨域的缓存联动（规则缓存
|
|
+ 检索缓存）是应用层的编排职责。T-P2-10 要求的「发布后自然失效」——顾问点
|
|
发布，检索立刻能看见新知识，不需要任何人记得去刷缓存。
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from packages.retrieval import service as retrieval_service
|
|
from packages.rules import service as rules_service
|
|
from packages.shared.logging import get_logger
|
|
|
|
logger = get_logger(__name__)
|
|
|
|
#: 落地后必须让下游缓存失效的目标状态：``published`` 让新知识对检索可见，
|
|
#: ``archived`` 让旧知识从检索消失——两个方向都是线上知识集合的真实变更。
|
|
#: （依据 ``packages.retrieval.service.invalidate_cache`` 的契约：「发布/归档
|
|
#: 知识后调用」。）
|
|
CACHE_AFFECTING_TARGETS: frozenset[str] = frozenset({"published", "archived"})
|
|
|
|
|
|
def invalidate_downstream_caches(*, domain: str, key: str, target: str) -> None:
|
|
"""规则进程内缓存 + 检索结果缓存整体失效。
|
|
|
|
- 规则缓存：``RuleService.publish/archive`` 内部已会失效一次，这里显式
|
|
再调是编排契约的一部分（实体发布同样要失效规则缓存——实体变更可能
|
|
改变规则命中的知识基础），幂等无副作用；
|
|
- 检索缓存：当前是失效版本号桩，T14 会在背后接真正的进程内缓存实现，
|
|
调用点无需再改。
|
|
"""
|
|
rules_service.invalidate_published_cache()
|
|
retrieval_service.invalidate_cache()
|
|
logger.info("admin_knowledge_invalidated", domain=domain, key=key, target=target)
|