4 Commits

Include renames

Author	SHA1	Message	Date
xsl	90349f735a	feat(admin): 用户行为分析看板——/admin/api/v1/users（列表/详情，identity 掩码后输出）、/events（多维过滤分页）、/stats/overview（按天×事件 PV 透视+活跃序列）；X-Admin-Token 鉴权沿用现有 admin 装配	2026-09-15 00:02:55 +08:00
xsl	4764235343	fix(retrieval): list_gaps returns ORM entities; admin switches back to the domain API ... T12 集成实测暴露：select(KbGap) 的结果调 .mappings()，行键是实体类， GapSummary 按列名取值必然 AttributeError。改为 .scalars() 返回实体； admin 的缺口看板从临时自实现切回 retrieval.list_gaps（语义单一定义）。	2026-08-14 21:22:51 +08:00
xsl	3961b6fbfa	feat(admin): minimal console for KB content operations ... 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 的升级路径）。	2026-08-14 21:19:31 +08:00
xsl	746b66da01	feat(api): vertical slice POST /v1/agent/chat and the Celery ping path ... One request exercises every layer: JWT auth, quota reservation, a versioned prompt through the LLM gateway, a cost row, quota commit or refund, and the unified envelope. The trivial ping task proves the queue routing and the tk_task transitions before any real long-running task is written. Routes are mounted at the /api/v1 base path of 架构文档 §9.1; /v1/* is rewritten to it at the ASGI layer so both spellings work from one route table.	2026-08-14 00:26:39 +08:00