38 KiB
38 KiB
AI 费用闭环与价值证明 开发 TODO
更新时间:2026-07-16
文档路径:document/development/2026-07-13/feature/ai-expense-closed-loop-and-value-proof/TODO.md
使用规则
- 每个 TODO 必须对应
CONCEPT.md中的目标、能力、方案或验收点。 - 只有完成实现并验证后,才能把
[ ]改成[x]。 - 已完成项必须补充文件、接口、命令、容器测试或真实页面证据。
- 如果需求发生变化,先更新
CONCEPT.md,再调整本 TODO。 - 实施顺序遵循:P0 费用闭环与数据基础 → P1 安全自动化与学习 → P2 费用经营与价值证明 → P3 商业化复制。
- 所有后端、集成、迁移和依赖外部服务的验证只允许在项目容器内运行,单条测试命令最大超时 60s。
1. 调研与边界
- [CONCEPT: 背景与问题] 盘点申请、票据、报销、预算、风险、审批、付款、分析、Agent trace、反馈和 AI 数据飞轮现状。
证据:
server/src/app/api/v1/endpoints、server/src/app/services、web/src、mobile/app/src、容器运行时 OpenAPI 共 156 个业务操作。 - [CONCEPT: 背景与问题] 确认当前主要断点是消费/取票、真实支付入账、结果回流、节省归因和商业计量,而不是页面数量不足。
证据:
CONCEPT.md“背景与问题”;expense_claim_approval_flow.py付款为状态更新;本地容器关键反馈/样本表聚合结果为 0。 - [CONCEPT: 目标与非目标] 确认本功能采用一个总功能点分阶段实施,不一次性替换所有现有接口,不自建支付和商旅供应链网络。
证据:
CONCEPT.md“目标与非目标”。 - [CONCEPT: 风险与开放问题] 记录认证、租户、旧模型迁移、反馈污染、虚假节省、自动化失控、连接器和数据稀疏风险。
证据:
CONCEPT.md“风险与开放问题”。
2. 开发前置门禁:试点与基线
- [CONCEPT: 待确认] 确认首个目标客户规模、部署形态、购买决策人和最小租户边界。
- [CONCEPT: 待确认] 确认首个 90 天试点费用场景,只允许一个场景进入 P0 开发。
- [CONCEPT: 待确认] 确认是否进入企业支付、商旅预订或公司卡领域,并冻结首期连接器范围。
- [CONCEPT: 待确认] 确认客户 ROI 中现金节省与工时价值的口径、基线窗口和签字人。
- [CONCEPT: 指标与验收] 在 P0 开发前采集人工分钟、退回率、完成周期、人工触点、风险反馈、费用金额和付款结果基线。
- [CONCEPT: 指标与验收] 为 P0/P1/P2 分别冻结一条可纵向跑通的闭环验收,不以“模块代码已完成”代替业务结果。
3. 契约与设计
- [CONCEPT: 费用领域与编排] 定义
Expense Case、申请、票据、报销、审批、付款、凭证和归档的领域边界与迁移关系。 - [CONCEPT: 数据与契约] 定义
expense_cases、expense_case_links和最小状态机,明确非法状态跃迁。 - [CONCEPT: 数据与契约] 定义
business_events事件信封、事件词典、correlation ID、幂等键和版本策略。 - [CONCEPT: 业务事件与 AI 决策] 定义
ai_decisions、ai_decision_feedback和workflow_outcomes契约。 证据:ai_learning.py、expense_application_learning.py、20260714_0003_ai_learning_loop.py;三类事实分别表达 AI 建议、用户采纳/显式字段纠正和业务结果,技术执行成功、用户反馈与工作流结果不复用同一状态。 - [CONCEPT: 业务事件与 AI 决策] 定义落单前服务端预览决策的签发、授权、过期、一次消费、重放和续签契约。
证据:
ai_application_preview.py、expense_application_preview_decisions.py、expense_application_snapshot.py;预览不创建空 Case,绑定租户、actor、登录会话与 conversation,30 分钟过期,保存/提交成功后一次消费;保存草稿在业务提交后尽力返回基于服务端事实的新decision_id,续签失败不反转已成功动作。 - [CONCEPT: 记忆与学习] 定义并实现
memory_entries、memory_evidence_links、优先级、有效期、敏感白名单、撤销和遗忘契约;首个切片仅覆盖travel_application.transport_mode。 证据:ai_memory.py、expense_application_memory.py、expense_application_memory_evidence.py、20260714_0005_ai_memory.py;记忆使用租户、主体、场景、字段和值指纹精确隔离,值只允许“飞机/火车/轮船”,服务异常降级为不应用记忆。 - [CONCEPT: 自动化决策] 定义动作风险、金额阈值、置信度、证据完整度、可逆性、抽检率和企业授权策略。
- [CONCEPT: 节省与价值] 定义 Savings Ledger 的机会、执行、实现、确认、去重和归因状态。
- [CONCEPT: 连接器] 定义票据邮箱、税务、企业卡、商旅、支付、银行、ERP、消息和 SSO 连接器协议。
- [CONCEPT: 权限与安全] 定义服务端会话、租户数据范围、角色和动作级授权契约。
- [CONCEPT: 指标与验收] 完成首个试点指标字典、基线采集方案、分子分母、数据源和负责人。
- [CONCEPT: 方案设计] 完成分阶段架构评审,确认新增 service 不继续堆入
ExpenseClaimService、UserAgentService或大型前端 composable。
4. P0 后端实现:费用闭环与数据基础
- [CONCEPT: 权限与安全] 实现服务端可验证会话/JWT,移除客户端身份头作为授权事实来源。
证据:
auth_sessions.py、auth_session.py、deps.py、auth.py、authSessionStorage.js;登录签发不透明 Bearer token,数据库仅保存 SHA-256 摘要,生产代码不再信任X-Auth-*,过期/撤销/伪造会话回归测试通过。 - [CONCEPT: 权限与安全] 为管理面、Bootstrap、Settings、模型连通性、缓存、审计和系统日志补齐平台管理员保护。
证据:
bootstrap.py、settings.py、audit_logs.py、agent_traces.py、system_logs.py、vite.config.js;已初始化 Bootstrap 脱敏且拒绝匿名重配,平台管理员/业务经理权限边界和 Vite Setup 锁测试通过。 - [CONCEPT: 权限与安全] 继续盘点并收口风险规则发布、制度发布及其他尚未纳入本轮的敏感动作,按动作定义平台管理员或双人复核权限。
- [CONCEPT: 权限与安全] 为所有新增表和共享核心数据补齐最小
tenant_id、数据库约束、查询守卫及默认租户迁移。 - [CONCEPT: 权限与安全] 为 Expense Case 查询提供面向用户的精简事件 DTO,移除幂等键、correlation、causation 和 Outbox 投递字段,并明确审批意见、退回原因和操作人可见范围。
证据:
expense_case.py、test_expense_case_endpoints.py;用户态响应只保留安全流程摘要,关联资源 ID 和未知嵌套 payload 被递归过滤,本人、当前审批人、财务、管理员、无权限及跨租户边界测试通过。 - [CONCEPT: 权限与安全] 为 Qdrant collection/namespace、对象存储前缀和缓存键补齐租户隔离回归测试。
- [CONCEPT: 数据与契约] 建立 Alembic baseline 和正式迁移链,停止请求路径运行 DDL。
- [CONCEPT: 兼容策略] 集中 migration-owned 表所有权并在标准启动迁移前执行只读漂移预检,禁止 legacy bootstrap 越权建表。
证据:
schema_ownership.py、migration_preflight.py、server_start.sh、test_migration_preflight.py、test_schema_ownership.py;无版本自有表、缺表、多表、未知/多 revision 均 fail-fast,不自动 stamp 或修改数据库。 - [CONCEPT: 费用领域与编排] 新增
ExpenseCaseService和费用事件查询接口,保持编排与具体职责分离。 证据:server/src/app/services/expense_cases.py、server/src/app/api/v1/endpoints/expense_cases.py、GET /api/v1/expense-cases/by-claim/{claim_id};容器 OpenAPI 校验通过。 - [CONCEPT: 数据与契约] 新增
expense_cases、expense_case_links和business_events表及迁移。 证据:20260713_0001_expense_case_business_events.py;一次性 PostgreSQL 17 已验证表、唯一约束、复合索引、外键级联、降级和再次升级。 - [CONCEPT: 业务事件与 AI 决策] 新增
ai_decisions、ai_decision_feedback、workflow_outcomes表及迁移。 证据:20260714_0003_ai_learning_loop.py、schema_ownership.py、migration_preflight.py;三表具备租户幂等约束,Case/Event/Decision 使用包含费用 Case 的复合租户外键。一次性 PostgreSQL 17 完整升级、重复升级、跨租户及同租户跨 Case 外键拒绝、降级和再次升级 4 项通过,持久开发库未迁移。 - [CONCEPT: 业务事件与 AI 决策] 新增服务端预览决策表、认证签发接口和正式 Decision 关联迁移。
证据:
20260714_0004_ai_application_preview_decisions.py、expense_application_previews.py、reimbursements.py;动作消费与 Claim、Case、Business Event 和学习三表同事务,跨登录会话重放被拒绝;独立版本密钥生成的 HMAC 指纹不保存低熵字段明文,并编码字段存在性。只有从未成功签发的旧调用可无 ID 降级,当前会话已有有效决策时省略 ID 会返回 409。 - [CONCEPT: 数据与契约] 为申请、票据、草稿、提交、退回、审批、付款和归档接入统一 correlation ID。 当前进度:报销显式预审与提交已共享 correlation/causation,AI 草稿和票据归集已透传租户与稳定幂等键;申请、审批、付款和外部连接器仍需继续统一。
- [CONCEPT: 业务事件与 AI 决策] 建立事务 Outbox:申请、提交、退回、审批、支付和入账状态与事件同事务提交,消费端按事件 ID 幂等处理。
- [CONCEPT: 业务事件与 AI 决策] 完成首批草稿、提交、退回、审批、申请转报销、付款和申请归档事件旁写,具备 correlation、causation、幂等键及事务回滚。
证据:
expense_claim_draft_flow.py、expense_claims.py、expense_claim_approval_flow.py、test_expense_case_service.py;容器测试覆盖同 Case 关联、重复事件去重及 Outbox 失败整体回滚。 - [CONCEPT: 风险与预审] 建立申请与报销提交前服务端预审握手,使用稳定 review ID、输入/规则/动态结果指纹、三态决策和结构化整改动作阻止旧预审复用。
证据:
expense_claim_pre_review_decision.py、expense_claim_pre_review.py、expense_claims.py、reimbursement_pre_review.py;提交前始终重算完整风险上下文,needs_fix在预算占用前保持草稿并返回结构化 409,握手期间风险变化返回PRE_REVIEW_CHANGED,相同输入、规则和 findings 重试只保留一条预审事件。申请与报销使用同一契约:提交人可整改风险必须先处理,人工判断或预算治理风险才进入领导与 P8。 - [CONCEPT: 统一费用事件] 补齐票据归集 → 预审 → 提交切片的阶段与事件衔接,并修复非默认租户在 AI 草稿、预览和 Steward 链路回落到 default 的问题。
证据:
expense_receipt_association.py、expense_claim_approval_flow.py、expense_claim_draft_flow.py、expense_claim_review_preview.py、steward_action_executor.py;申请批准生成空报销草稿后 Case 保持approved_to_spend,票据关联后进入claiming,跨租户 Case/Event 不能串线。 - [CONCEPT: 权限与安全] 将 Claim 核心查询和关联报销后台任务纳入服务端租户范围,拒绝同用户名跨租户读取、修改、审批或查询任务。
证据:
expense_claim_tenant_scope.py、expense_claim_access_policy.py、linked_reimbursement_draft_jobs.py;默认租户仅为无 CaseLink 的历史单保留兼容,后台任务强制覆盖客户端 tenant,关联申请按 CaseLink 与租户共同校验。 - [CONCEPT: 业务事件与 AI 决策] 收口 AI 新建申请直接提交入口,统一复用申请提交事务,并消除预算 metadata 检查对外层事务的隐式提交。
证据:
user_agent_application.py、budget.py、test_reimbursement_endpoints.py、test_user_agent_service.py;容器测试覆盖有效预算预占、application_submitted事件、提交风险标记、事件失败整体回滚及保存草稿无提交副作用。 - [CONCEPT: 业务事件与 AI 决策] 为 AI 工作台和小财管家申请草稿补齐新建/更新事件、租户透传、事务回滚和动作幂等。
证据:
expense_application_draft_events.py、user_agent_application.py、reimbursements.py、steward_action_executor.py、test_user_agent_application_draft_events.py、test_reimbursement_endpoints.py、test_steward_action_executor.py;完全相同 HTTP 保存重放复用同一草稿和事件,同一 run 内不同快照分别留痕,事件失败后草稿与 Case 数据整体回滚。 - [CONCEPT: 权限与安全] 将 AI 申请预览快速入口的用户、租户、角色与管理员身份强制绑定到服务端会话,拒绝请求体伪造身份编辑他人申请。
证据:
reimbursements.py、test_reimbursement_endpoints.py;对抗用例修复前返回 200,修复后返回 400,且目标申请和费用事件保持不变。 - [CONCEPT: 权限与安全] 收口通用 Orchestrator 用户消息和会话管理的认证边界,拒绝客户端身份与 decision 注入。
证据:
orchestrator.py、agent_conversations.py、orchestrator_expense_application_workflow.py、steward_graph_action_runtime.py、test_orchestrator_auth_endpoints.py、test_steward_action_executor.py、test_orchestrator_review_flow.py;用户消息、定时任务和系统事件无认证均返回 401,普通用户触发schedule/system_event返回 403,登录态覆盖请求身份和调度操作人别名;Orchestrator 会话创建/恢复/删除及 Steward 幂等检查点同时校验租户与用户名,申请动作只消费服务端会话 decision。 - [CONCEPT: 兼容策略] 建立迁移桥接:服务启动先执行 Alembic,旧 metadata bootstrap 排除 migration-owned 表。
证据:
server_start.sh、schema_ownership.py、migration_preflight.py、20260713_0001_expense_case_business_events.py、20260713_0002_auth_sessions.py;容器 Shell/静态检查及一次性 PostgreSQL 完整 upgrade/downgrade/re-upgrade 通过。 - [CONCEPT: 兼容策略] 为迁移前已有
ExpenseClaim提供显式、幂等且不伪造办理历史的费用事件快照回填。 证据:expense_case_legacy_backfill.py、maintenance_database_target.py、backfill_legacy_expense_claim_cases.py;默认 dry-run,apply 强制租户/截止时间、精确目标、迁移 head、advisory lock 和批次事务,事件使用真实回填时间、history_reconstructed=false与delivery_status=suppressed。一次性克隆库首次创建 4 组 Case/Link/Event,重复 apply 创建 0 条。 - [CONCEPT: 兼容策略] 正式切换前以 shadow 事件校验现有
ExpenseClaim映射;切换后禁止关键事件可丢弃写入。 - [CONCEPT: 兼容策略] 制定旧
ReimbursementRequest只读兼容、迁移和停止新增编排的计划。 - [CONCEPT: 兼容策略] 把新增审批、付款、归档和关系事件移出
risk_flags_json,保留旧数据读取兼容。 - [CONCEPT: 数据与契约] 补齐撤回、取消、驳回、作废、补件、支付失败、对账异常和归档状态。
- [CONCEPT: 连接器] 实现统一连接器基类、幂等、重试、错误状态和回执事件。
- [CONCEPT: 连接器] 实现支付批次、回执、重复付款防护、ERP 凭证和对账的内部契约,首期允许 mock connector 但不得再只写单一“已付款”状态。
- [CONCEPT: 降级策略] 将附件关联和关联报销草稿后台任务迁为可持久化、可恢复、可幂等的任务状态。
证据:新增 migration-owned
attachment_association_jobs与20260716_0006;任务使用租户、owner、票据集合和 generation 去重,运行态带租约与attempt_count + running栅栏,GET 可恢复 queued/租约过期任务。同票据和同 Claim 均由进程锁与 PostgreSQL advisory lock 串行化,Claim 锁内重新匹配;待确认或失败历史保留原代并以新 generation 重新评估,自动关联成功代继续幂等复用。进程状态清空、租约过期、旧 worker 回写、不同票据并发同 Claim 和代际重评估回归通过。 - [CONCEPT: 零录入附件关联任务契约] 扩展附件关联任务的向后兼容结果契约,区分自动完成与需要确认,并返回 Case、申请、置信度、原因、异常、缺失项、风险项和候选。
证据:
attachment_association_job.py与attachmentAssociationJobModel.js保留旧字段并追加结构化结果;status=succeeded + resolution=requires_confirmation明确表示匹配完成但零业务写入。 - [CONCEPT: 零录入报销首个切片] 新增独立票据匹配器,按当前租户、员工、Expense Case、已审批申请、日期、城市和场景计算候选;唯一高置信才允许自动归集。
证据:
expense_receipt_matcher.py只读评分;覆盖唯一高置信、相近候选、无草稿、仅有已审批申请和已关联重放,申请缺少系统草稿时只返回approved_application候选。 - [CONCEPT: 零录入报销首个切片] 新增独立归集编排器,把票据 Link、
receipt_received、附件写入和attachment_associated纳入同一事务,并保证同票据重试不重复建明细或事件。 证据:expense_receipt_association.py统一编排数据库写入,文件系统使用元数据快照和附件目录补偿;稳定幂等键保证相同票据重试只增加跳过数。事件写入失败回归证明 Claim、Case、Link、Event、票据元数据和附件最终状态均回退。 - [CONCEPT: 权限与安全] 将票据夹存储命名空间和附件关联后台任务授权同时绑定租户与用户,补充同用户名跨租户隔离回归。
证据:
receipt_folder.py使用租户与用户联合命名空间,任务状态绑定owner_tenant_id + owner_username;普通用户及平台管理员跨租户查询均返回 404,同用户名跨租户不能读取票据。
5. P0 前端实现:一键报销与真实移动端
- [CONCEPT: 统一费用事件] 在申请/报销详情接入已有真实 Expense Case 事件时间线,展示申请提交、报销提交、退回、审批、自动生成报销草稿、付款和归档事件。
证据:
TravelRequestExpenseCaseTimeline.vue、useExpenseCaseTimeline.js、expenseCases.js、expenseCaseTimeline.js;保留原有横向进度,404 与接口异常均安全降级,容器内 99 条定向前端回归和 Vite 生产构建通过。 - [CONCEPT: 统一费用事件] 补齐计划、消费/票据、入账、对账和复盘事件,并在真实迁移数据库上跑通完整时间线。
- [CONCEPT: 统一费用事件] 自动匹配申请、预算、票据、费用类型、项目、成本中心和常用字段。 首个切片先交付申请、票据、费用事件、日期、城市和费用场景匹配;预算、项目、成本中心和记忆偏好随后接入同一候选契约。
- [CONCEPT: 统一费用事件] 增加“需要确认”区,只展示低置信、缺失或冲突字段。 首个切片在小财管家附件关联结果中复用统一异常模型;后续再收口全屏助手和票据夹入口。
- [CONCEPT: 零录入报销首个切片] 在小财管家实现“上传并发送 → 自动归集已审批申请生成的草稿 → 查看草稿”,不再次上传票据;低置信时只展示候选和异常卡片。 证据:附件任务 composable 将待确认视为安全终态,不发送伪成功通知;自动完成提供“查看草稿”,申请候选提供“查看候选申请”,不伪造报销草稿。
- [CONCEPT: 零录入附件关联任务契约] 会话刷新后恢复新任务结果、候选和异常状态,旧任务结果仍可正常展示。
证据:
workbenchAiMessageModel.js持久化新协议,规范化层兼容旧字段;容器内前端票据关联、协议、卡片、幂等重放、风险复核和会话恢复组合回归 29 项通过。 - [CONCEPT: 风险与预审] 报销详情提交前先执行真实预审,
needs_fix直接展示结构化风险并停止提交,其他结果携带 review ID 与输入指纹完成握手。 证据:reimbursements.js、api.js、useTravelRequestDetailRiskSubmit.js;错误响应保留 status/code/detail/review,风险可即时回填并触发详情刷新,前端预审、409、请求头、时间线组合测试 24 项和 Vite 生产构建通过。 - [CONCEPT: 风险与预审] 风险卡提供一键补件、修正、解释和重新预审入口。
- [CONCEPT: 统一费用事件] 退回后直接定位问题字段,支持断点续办,不要求重新发起对话。
- [CONCEPT: 移动端] 接通真实登录恢复、路由守卫、报销列表、详情、草稿、上传和审批 API。
- [CONCEPT: 移动端] 完成拍照/相册 → OCR → 票据夹 → 费用事件 → 报销草稿真实闭环。
- [CONCEPT: 移动端] 删除或禁用没有真实行为的报销、审批、发送和语音主按钮。
- [CONCEPT: 前端] 修复表格整行点击键盘不可达、弹窗焦点管理、焦点环和移动触控目标。
- [CONCEPT: 前端] 移除页面级全局
transform: scale(),使用真实响应式布局承载费用闭环页面。
6. P1 算法与规则实现:安全自动化与持续学习
- [CONCEPT: 自动化决策] 实现 L0-L5 动作级自动化等级和资格计算器。
- [CONCEPT: 自动化决策] 为每个动作实现硬白名单、金额上限、证据要求、抽检率和企业上限。
- [CONCEPT: 风险与预审] 统一风险输出为事实、规则、证据、判断、建议动作和降级原因。
- [CONCEPT: 记忆激活] 为首个个人出行方式切片实现 candidate/active/suppressed/expired/revoked 记忆状态机。 证据:Candidate/Active 默认有效期分别为 90/180 天;反向或非白名单纠正抑制已激活记忆,过期后新证据创建新 generation,忘记后清值并阻止旧请求复活。
- [CONCEPT: 记忆激活] 实现用户、部门、企业记忆优先级、冲突解释、时间衰减和最小样本要求。
- [CONCEPT: 记忆与学习] 新增租户化个人记忆与证据链接迁移,唯一键保证同一 Expense Case 对同一候选最多计一票。 证据:记忆、证据、Decision、Feedback、Outcome、Expense Case 和 Claim 采用租户复合外键;证据同时校验 actor、员工和 Case/单据 owner,跨租户或跨主体关系不能计票。
- [CONCEPT: 记忆激活] 为常用出行方式实现隐式激活门槛:3 个不同 Case 的一致服务端纠正、至少 2 次审批通过、证据跨 7 天;草稿、client_observed、accepted 和重试不激活。
证据:只有当前有效的
server_verified编辑、application_submitted结果和最新审批状态参与计算;提交事件还必须绑定对应expense_claim与 Claim ID,invalidated/reversed 事实、同 Case 重放和旧请求均被排除。 - [CONCEPT: 记忆与学习] 在服务端申请预览签发前只为空白出行方式应用 active 个人记忆,并返回 memory id、证据数与来源;当前输入、主数据和企业规则优先。
证据:
expense_application_preview_workflow.py应用记忆后重新执行规则测算和签名;仅缺出行方式时前端仍请求服务端,命中记忆后可直接生成完整核对表。 - [CONCEPT: AI 记忆与自动化设置] 提供当前用户记忆查询与“忘记此偏好”接口;撤销后清除可恢复值并在后续预览中不再应用。
证据:
GET /api/v1/expense-application-memories/me与DELETE /api/v1/expense-application-memories/{id}均绑定当前租户和主体,越权以 404 隐藏资源存在性。 - [CONCEPT: 记忆与学习] 当规则中心新增按职级、路线或金额禁用交通方式的制度维度时,在个人记忆应用前接入显式允许性判定、冲突抑制原因和回归测试。
- [CONCEPT: 记忆与学习] 为 AI 申请预填记录用户原样采纳、显式字段修改和草稿/提交结果证据。
证据:
expenseApplicationDecisionFeedback.js、useApplicationPreviewEditor.js、expense_application_learning.py、expense_application_preview_decisions.py;改回原建议会清除字段差异,日期联动同步记录天数,最终值由服务端 facts 重建。旧预览保持client_observed;服务端签发预览由版本化 HMAC 快照与最终 facts 逐字段比对,字段新增、删除或改值都标记为server_verified编辑。两者均保持training_eligible=false,尚不直接训练模型或激活记忆。 - [CONCEPT: 记忆与学习] 将小财管家、Steward 与通用 Orchestrator 的申请预览切换到认证签发与消费链路,并把结构化预览失败策略收口为 fail-closed。
证据:
expense_application_preview_workflow.py、orchestrator_expense_application_workflow.py、steward_action_executor.py、useTravelReimbursementApplicationPreviewActions.js;签发/动作请求 ID 可稳定重试,草稿续签回写服务端会话,字段接受/纠正按server_verified落账,未签发结构化预览不能保存或提交。 - [CONCEPT: 记忆与学习] 从字段接受/修改/拒绝、退回、审批覆盖、付款和审计结果生成记忆证据。
- [CONCEPT: 记忆与学习] 将已确认 few-shot 扩展到报销预审和审批辅助,并按租户、场景、制度版本过滤。
- [CONCEPT: 风险与预审] 完成 golden case、Prompt/规则版本、Canary、回归门禁和自动回滚。
- [CONCEPT: 自动化决策] 先上线 shadow,再按动作逐项开放 L3;L4 必须单独评审。
- [CONCEPT: 降级策略] 对模型、OCR、Qdrant、连接器和记忆服务实现稳定降级和可观测状态。
7. P1 前端实现:审批例外与 AI 记忆
- [CONCEPT: 审批例外工作台] 按风险、金额、预算影响、等待时长和证据完整度排序审批事项。
- [CONCEPT: 审批例外工作台] 展示必要性、预算、政策、相似单、风险证据和 AI 意见草稿。
- [CONCEPT: 审批例外工作台] 补齐批量审批、委托、转交、加签、会签和超时升级交互。
- [CONCEPT: 审批例外工作台] 接入真实企微/钉钉/邮件触达和处理结果回写。
- [CONCEPT: AI 记忆与自动化设置] 新增“我的 AI 记忆”,支持来源解释、修改、忘记和关闭个性化。
- [CONCEPT: AI 记忆与自动化设置] 在申请核对表展示常用出行方式的记忆来源、证据数量和“忘记此偏好”,并在保存/提交后区分候选记录与已应用回执。
证据:
TravelReimbursementMemoryPanel.vue与独立样式分片承载记忆解释、学习回执和可访问的忘记入口;会话快照可跨刷新恢复已应用记忆。 - [CONCEPT: AI 记忆与自动化设置] 新增企业记忆、保留策略、敏感等级和自动化上限管理。
- [CONCEPT: 前端] 展示自动化动作、执行依据、撤销入口、抽检状态和版本信息。
8. P2 实现:费用经营与价值证明
- [CONCEPT: 节省与价值] 新增
savings_opportunities、savings_realizations和去重/确认表结构。 - [CONCEPT: 节省与价值] 实现风险暴露、预计节省、执行中、实际节省和财务确认的严格状态转换。
- [CONCEPT: 费用分析与节省] 持久化员工、部门、费用类型、供应商、城市、项目和流程基线,记录窗口和样本量。
- [CONCEPT: 费用分析与节省] 实现预算预测、异常归因、供应商价格漂移、重复小额浪费和政策模拟。
- [CONCEPT: CFO 价值看板] 展示现金节省、工时价值、直通率、风险护栏、节省来源和责任人。
- [CONCEPT: CFO 价值看板] 实现部门、项目、费用类型、供应商、城市、时间和单据下钻。
- [CONCEPT: CFO 价值看板] 每项节省支持查看基线、建议、执行、实际结果、确认人和证据。
- [CONCEPT: 指标与验收] 生成客户月度 ROI 报告,现金节省与工时价值分开披露。
- [CONCEPT: 风险与开放问题] 建立节省归因复核、重复收益去重和客户财务签字流程。
9. P3 实现:商业化与规模复制
- [CONCEPT: 商业计量] 在 P0 最小租户隔离基础上新增套餐、配额、用量和增值模块授权模型。
- [CONCEPT: 商业计量] 按客户、模型、OCR、文档、分析任务和模块记录成本。
- [CONCEPT: 商业计量] 建立客户贡献毛利、实施成本摊销和私有部署成本看板。
- [CONCEPT: 目标与非目标] 定义年度基础订阅、用量超额、智能风控、预算经营、价值洞察、企业集成和私有部署包。
- [CONCEPT: 目标与非目标] 仅对财务确认的已实现节省提供可选节省分成合同。
- [CONCEPT: 连接器] 建立 ERP、HR、SSO、支付、电子档案和消息平台标准实施模板。
- [CONCEPT: 权限与安全] 完成删除传播、数据导出、审计增强和私有部署安全验收,不把基础租户隔离留到本阶段。
10. 测试与验证
- [CONCEPT: 测试方案] 完成 Expense Case/Link、业务事件幂等、租户边界、同事务回滚、申请转报销同 Case 和付款归档事件首批测试。
证据:容器内
pytest -q server/tests/test_expense_case_service.py7 项通过;联合差旅主链路定向回归共 24 项通过。 - [CONCEPT: 测试方案] 为 AI 新建申请直接提交补充统一事务回归,覆盖提交成功、事件失败回滚和仅保存草稿三条边界。
证据:容器内直接提交定向测试 3 项、申请提交回归 5 项、预算与 Expense Case 回归 13 项通过;相关 Python 文件
ruff --select F,I通过。 - [CONCEPT: 测试方案] 为 Expense Case 状态机、事件账本、AI 决策、结果、记忆、自动化和节省服务补充单元测试。
当前进度:已补充预审决策确定性、嵌套无序集合、动态 findings 变化、申请/报销统一阻断、P8 全链路、真实预算前阻断、事件幂等/回滚、同用户名租户隔离、后台任务 tenant 伪造和 Case
approved_to_spend → claiming阶段测试;学习、自动化和节省仍待后续阶段。 - [CONCEPT: 测试方案] 为服务端会话、管理员保护和 Bootstrap 重配置补充首批安全回归测试。
证据:
test_auth_session_endpoints.py、test_auth_service.py、test_bootstrap_security.py;容器定向测试覆盖 token 摘要、伪造身份头、过期/撤销、登出原子收尾、业务经理越权和初始化后匿名重配置拒绝。 - [CONCEPT: 测试方案] 为租户隔离、跨租户访问、规则/制度发布和双人复核等剩余敏感动作补充安全回归测试。
- [CONCEPT: 测试方案] 为 Expense Case GET 接口补充 owner、审批人、财务、管理员、无权限用户和整 Case 关联事件可见范围的 HTTP 权限测试。
证据:
test_expense_case_endpoints.py容器内 8 项通过,覆盖跨租户、无 Case、申请与报销关联摘要以及内部字段递归过滤。 - [CONCEPT: 测试方案] 为 Alembic baseline、升级、旧数据迁移和回滚边界补充 Postgres 集成测试。
- [CONCEPT: 测试方案] 为当前 migration-owned schema 切片补充一次性 PostgreSQL 集成测试和危险 URL 防误连门禁。
证据:
test_alembic_migrations.py默认无显式 URL 时跳过,主机和库名必须带 disposable 标记;tmpfs PostgreSQL 17 中 4 项通过,覆盖空库升级、重复升级、关键约束/索引、外键级联、base 降级、legacy 哨兵保留、漂移拒绝和再次升级;持久化开发库未被修改。完整 legacy baseline 仍保留在上一条未完成项中。 - [CONCEPT: 测试方案] 为连接器幂等、重试、回执、失败恢复、重复付款和对账补充测试。
- [CONCEPT: 测试方案] 跑通申请 → 票据 → 报销 → 预审 → 审批 → 付款 → 入账 → 归档端到端。 当前进度:申请批准 → 自动报销草稿 → 票据归集 → 预审 → 报销提交已在同一 Case 中跑通;付款回执、ERP 入账和对账仍未接入。
- [CONCEPT: 测试方案] 跑通首个个人出行方式切片的 AI 建议 → 用户修改 → 工作流结果 → 记忆激活 → 下次建议变化闭环。
证据:容器内记忆、预览决策、迁移与所有权组合回归 56 项通过、1 项条件跳过;一次性 PostgreSQL 迁移循环 1 项通过;前端申请快速预览、个人记忆、Steward 与会话恢复组合 83 项通过,Vite 生产构建通过,Python Ruff F/I 与
git diff --check通过。 - [CONCEPT: 测试方案] 跑通首个行为采集切片:AI 申请预填 → 用户接受/显式修改 → 草稿或提交结果同事务落账。
证据:
test_user_agent_application_draft_events.py、test_reimbursement_endpoints.py、expense-application-decision-feedback.test.mjs、expense-application-fast-preview.test.mjs;覆盖可信入口、模板/详情排除、隐私指纹、同事务事件关联、日期联动及异步乱序响应。容器内学习账本与迁移所有权定向 29 项、一次性 PostgreSQL 迁移 4 项和前端关键场景 5 项通过。 - [CONCEPT: 测试方案] 跑通风险反馈 → few-shot → golden case → Canary → 回滚闭环。
- [CONCEPT: 测试方案] 跑通节省机会 → 执行 → 实现 → 财务确认 → ROI 看板闭环。
- [CONCEPT: 测试方案] 为已有 Expense Case 事件时间线补充视图模型、404 降级、详情页接入及相关响应式回归,并完成前端生产构建。
证据:容器内
node --test定向执行 99 项通过;npm --prefix web run build通过。一次性克隆迁移库上的隔离后端已完成真实登录、身份读取和旧单时间线 200 联调;持久开发库仍未迁移,因此日常本地页面仍保持兼容提示。 - [CONCEPT: 测试方案] 为 AI 申请草稿事件补充事务失败回滚、同快照幂等、同 run 多版本留痕和 Steward 重放回归。
证据:本轮受影响后端定向回归 36 项、Expense Case 前端兼容测试 9 项和 Python
ruff --select F,I在容器内通过。 - [CONCEPT: 测试方案] 在现有开发数据的只读一次性克隆上验证迁移、历史回填和真实认证时间线链路。
证据:源库与克隆初始签名均为 40 张表、4 张费用单、105 名员工、248 条预算、62 个 Agent 资产;克隆升级后 dry-run 为 eligible=4,apply created=4,重复 apply created=0,四条事件均为 system/suppressed;登录、
/auth/me、旧单时间线和登出均返回 200,持久库复查不变且仍无 migration-owned 表。 - [CONCEPT: 测试方案] 补充其余前端组件、键盘操作、移动真实接口和完整浏览器关键流程验证。
- [CONCEPT: 测试方案] 验证服务端预览决策签发、字段新增/改值差异判定、跨会话拒绝、无 ID 降级防绕过、安全重放、独立密钥权限、续签失败容错、旧路径兼容、会话恢复和真实 PostgreSQL 迁移。 证据:容器内新增决策安全用例 9 项、旧快速保存/提交 4 项、申请学习账本 9 项、迁移与所有权 26 项通过且条件型 PostgreSQL 用例 1 项跳过;一次性 PostgreSQL 17 迁移 4 项、前端定向 3 组及 Vite 生产构建已通过。临时 PostgreSQL 已清理,持久开发库 8 张 migration-owned 表数量仍为 0。
- [CONCEPT: 测试方案] 验证小财管家、Steward、通用 Orchestrator 的统一预览闭环、认证绑定、fail-closed、稳定重试和跨刷新恢复。
证据:容器内后端组合回归 50 项通过,覆盖服务端预览、Steward 动作/图运行、跨租户 checkpoint、Orchestrator 匿名/普通用户/管理员来源授权及决策消费,Python Ruff F/I 通过;前端结构化动作、会话恢复、工作台路由、富确认和
ai-application-preview-actions共 18 项通过,Vite 生产构建通过。共享规则工作簿相关套件按容器内串行执行,避免并行读取正在变动的 XLSX 产生非业务性 ZIP 竞争。 - [CONCEPT: 测试方案] 所有后端、集成和迁移测试在当前主应用容器内执行,单条命令最大超时 60s。
- [CONCEPT: 指标与验收] 记录测试、lint、typecheck、构建、端到端和未覆盖风险证据。
11. 分阶段试点与价值验证
- [CONCEPT: 指标与验收] 确认开发前置门禁已完成,试点场景、客户群体、基线和纵向验收未发生未经评审的漂移。
- [CONCEPT: 自动化决策] 前四周只运行建议和 shadow,不开放高风险自动化。
- [CONCEPT: 指标与验收] 验证报销创建时间、自动填充率、首次提交完整率、人工触点和风险护栏。
- [CONCEPT: 节省与价值] 由客户财务确认现金节省、工时价值、归因口径和去重结果。
- [CONCEPT: 商业计量] 计算试点客户的订阅、模型、OCR、实施、支持和集成贡献毛利。
- [CONCEPT: 指标与验收] 输出 90 天 ROI 报告和年度合同/扩展模块建议。
12. 文档收尾
- [CONCEPT: 指标与验收] 将试点实际基线替换方向性目标,冻结正式验收阈值。
- [CONCEPT: 风险与开放问题] 更新目标客户、试点场景、支付边界、连接器范围和自动化授权结论。
- [CONCEPT: 本轮实现记录] 每个阶段完成后补充实现文件、迁移、接口、测试和真实页面证据。
- [CONCEPT: 功能一句话] 确认最终实现持续服务于“不用填表、少被退回、真正省钱”的核心结果。