AINative 研发助手

### 1. 立项背景目标

传统软件研发，从需求评审、写 PRD、技术方案、测试文档到上线报告，大量重复文档编写、信息同步工作消耗研发人力，文档版本分散、流程卡点难以追踪。
项目目标：搭建 AI 驱动的研发助手平台，由 AI Agent 自动产出研发全链路文档，线上化管理需求项目，打通需求评审、技术方案、交互原型、编码、测试、上线的完整研发流程，统计模型调用 Token 消耗，实现研发流程自动化提效。

### 2. 软件功能和核心功能模块介绍

1. **账号登录与用户权限管理模块**
管理员账号登录，支持管理员新建用户、分配角色（管理员 admin、产品负责人 pm、技术负责人 tech_lead），支持重置密码、启停用户，隔离不同角色操作权限。
2. **个人设置 & 模型密钥（BYOK）模块**
用户可配置大模型 BaseURL、密钥、鉴权方式（Bearer），支持连通性测试；展示会话、输入输出 Token 用量、缓存命中统计，支持自带密钥调用大模型。
3. **项目会话管理模块**
创建研发项目会话，展示项目列表，每个项目记录状态（执行中 / 已完成 / 已终止）、消耗 Token 数量，可进入项目详情会话。
4. **项目详情 & AI Agent 流程模块（核心）**
单个需求项目内，AI Agent 自动串联全研发节点：需求评审→技术方案→交互原型→编码→测试→上线报告；自动生成对应 md 文档；支持动态留言给 Agent，补充需求迭代。
5. **文档管理**
每个节点自动产出文档（PRD、技术方案、测试计划、上线报告），在线查看文档链接，记录修改动态。

### 3. 业务流程和功能路径描述

1. 管理员登录系统 → 用户管理页面创建 pm/tech_lead 普通账号，分配角色权限；
2. 用户登录账号，进入个人设置，配置 BYOK 模型密钥，测试连通性；
3. 在项目首页点击新建项目，输入需求名称，创建 AI 研发会话；
4. 进入项目会话，AI Agent 自动按顺序推进：需求评审→输出 PRD→生成技术方案→交互原型→编码单元测试→测试计划→上线报告；
5. 研发人员可在动态区域留言补充需求，Agent 接收补充信息迭代文档；
6. 全程查看项目状态、各阶段文档，查看该项目消耗 Token；
7. 所有用户在个人设置页面查看全局 Token 用量、输入输出、缓存命中数据。

### 1. 整体架构，设计思路，不同模块使用的技术栈

- **整体架构**：B/S Web 架构，前端页面 + 后端业务服务 + AI Agent 调度层 + 外部大模型网关。
- **设计思路**
以**项目会话为核心**，一个研发需求对应一个会话；AI Agent 编排研发流水线，按研发阶段顺序执行任务，每个阶段产出文档；权限体系隔离多用户，BYOK 机制让每个用户绑定自己的大模型密钥，独立调用大模型，独立统计用量。
- **模块技术栈**
- 前端：React，实现登录页、项目列表、项目详情、个人设置、用户管理页面，表单、状态标签、文档链接渲染。
- 后端：业务接口，用户账号、角色权限、项目会话数据持久化，存储项目信息、文档地址、Token 用量。
- AI Agent 调度模块：编排研发流水线，分阶段调用大模型 API，接收用户留言，迭代生成文档。
- 模型对接层：对接外部大模型网关（Ark），支持 BYOK，Bearer 鉴权，统计每次调用的输入输出 Token。

### 2. 我的负责模块和结果

>
> 你可以按需调整，这里给通用版本：
> 负责前端页面开发，包含登录页、项目会话列表、项目详情页、个人设置页、用户管理页面。

- 完成多页面表单、列表、状态标签开发；实现角色下拉选择、密钥输入保存、连通性测试交互；
- 对接后端接口，实现项目列表拉取、项目详情动态加载、用户新增 / 重置密码 / 启停操作；
- 完成 Token 用量展示、项目状态（执行中 / 完成 / 终止）UI 渲染；
最终交付完整 Web 前端页面，支持管理员、产品、技术多角色操作，页面可正常完成项目创建、查看、密钥配置、用户管理等全部交互。

>
> 如果是后端版本：
> 负责后端业务接口开发，用户权限模块、项目会话管理、Token 用量统计、BYOK 密钥存储接口；实现用户创建、角色鉴权、项目数据持久化；对接 Agent 调度模块，统计大模型调用 Token 消耗；保证多用户会话隔离，密钥安全存储。最终实现权限校验、项目数据读写、用量统计能力。

### 3. 遇到的难点，坑和解决方案

1. **难点 1：AI Agent 长会话上下文过大，Token 消耗不可控**
坑：需求迭代时，历史对话不断累积，上下文持续膨胀，Token 用量飙升，成本不可控。
解决方案：增加 Token 用量统计模块，实时记录输入输出 token；支持缓存命中优化，重复内容减少模型调用；在个人设置页可视化展示用量，方便研发感知成本。
2. **难点 2：BYOK 密钥安全问题，密钥明文存储风险**
坑：用户填写模型密钥，直接明文保存存在泄露风险。
解决方案：密钥加密存储，前端只做输入，不回显完整密钥；密钥仅在调用模型时临时解密；仅当前用户可以访问自己的密钥，权限隔离