X-Financial/.codex/skills/write-development-docs/assets/CONCEPT.md

<功能名> 概念文档

更新时间：

文档路径：document/development//feature/<具体功能点目录>/CONCEPT.md

功能一句话

用一句话说明这个能力解决什么问题、服务谁、交付什么结果。

背景与问题

• 当前现状：
• 用户痛点：
• 业务影响：
• 为什么现在需要做：

目标与非目标

目标

• [G1]
• [G2]
• [G3]

非目标

• [NG1] 本轮不做：
• [NG2] 本轮不改变：
• [NG3] 后续再评估：

用户与场景

• 目标用户：
• 使用入口：
• 核心场景： 1. 2. 3.

• 异常场景：

功能能力

• [C1] 输入能力：
• [C2] 处理能力：
• [C3] 输出能力：
• [C4] 状态与权限：
• [C5] 边界与降级：

方案设计

前端

• 页面/组件：
• 交互状态：
• 展示规则：
• 降级处理：

后端

• 接口/服务：
• 权限与校验：
• 持久化：
• 降级处理：

算法与规则

• 输入：
• 流程：
• 输出：
• 解释：

数据与契约

• 核心字段：
• 状态枚举：
• 兼容策略：
• 版本/审计：

算法与公式

当前功能不涉及显式数学公式。

如涉及公式，使用如下格式：

metric = input_a + input_b

变量说明：

• metric：
• input_a：
• input_b：

测试方案

后端：

前端：

集成：

手工验证：

指标与验收

• [A1] 功能验收：
• [A2] 性能指标：
• [A3] 质量指标：
• [A4] 安全/权限指标：
• [A5] 可观测性：

风险与开放问题

• 风险：
• 已处理依赖：
• 待确认：
• 降级策略：

本轮实现记录