# 灵越智报 2.0 - 开发优先级计划

> **制定时间**: 2026-02-12  
> **总工期**: 8周（2个月）  
> **团队配置**: 后端2人 + 前端2人 + AI工程师1人

---

## 一、总体开发策略

### 1.1 开发原则
- ✅ **MVP优先**: 先实现核心功能，再完善辅助功能
- ✅ **垂直切片**: 每个阶段交付可演示的完整功能
- ✅ **前后端并行**: 接口定义后前后端同步开发
- ✅ **持续集成**: 每周发布可测试版本

### 1.2 里程碑
- **Week 2**: 用户登录 + 项目管理
- **Week 4**: 模板管理 + 报告创建
- **Week 6**: 附件上传 + 实体识别 + 规则引擎
- **Week 8**: AI助手 + 导出功能 + 上线

---

## 二、详细开发计划

### 📅 Phase 1: 基础设施 + 用户系统（Week 1-2）

**目标**: 搭建项目框架，完成用户认证和权限管理

#### Week 1: 项目初始化 + 数据库

**后端任务** (优先级: P0)
- [ ] 创建Spring Boot项目结构
  - 配置Maven/Gradle依赖
  - 配置application.yml（数据库、Redis、日志）
  - 配置MyBatis-Plus
  - 配置Swagger/Knife4j
- [ ] 数据库初始化
  - 执行init_mock_new.sql
  - 验证表结构和索引
  - 验证视图创建
- [ ] 公共模块开发
  - 统一返回结果（Result类）
  - 统一异常处理（GlobalExceptionHandler）
  - 统一日志切面（LogAspect）
  - 工具类（DateUtil, StringUtil, JsonUtil）
- [ ] 图数据库基础服务
  - NodeService（节点CRUD）
  - EdgeService（关系CRUD）
  - PropertyService（属性CRUD）
  - GraphQueryService（图查询）

**前端任务** (优先级: P0)
- [ ] 创建Vue 3 + Vite项目
  - 配置TypeScript
  - 配置Vue Router
  - 配置Pinia状态管理
  - 配置Axios + 请求拦截器
- [ ] 基础组件库
  - 安装Element Plus / Ant Design Vue
  - 配置主题色
  - 封装常用组件（Table, Form, Dialog）
- [ ] 项目结构搭建
  - 路由配置
  - 布局组件（Header, Sidebar, Main）
  - 工具函数

**交付物**:
- ✅ 可运行的前后端项目
- ✅ 数据库初始化完成
- ✅ 接口文档可访问（Swagger）

---

#### Week 2: 用户认证 + 权限管理

**后端任务** (优先级: P0)
- [ ] 安全模块
  - JWT工具类（生成Token、解析Token、刷新Token）
  - 密码加密工具（BCrypt）
  - 验证码生成（图形验证码）
  - Security过滤器（JwtAuthenticationFilter）
- [ ] 用户管理模块
  - UserController（11个接口）
  - UserService（用户CRUD、密码重置）
  - 登录日志记录
- [ ] 认证接口
  - 登录接口（/api/v1/auth/login）
  - 登出接口（/api/v1/auth/logout）
  - 刷新Token（/api/v1/auth/refresh）
  - 验证码接口（/api/v1/auth/captcha）
- [ ] 角色权限模块
  - RoleController（8个接口）
  - PermissionController（6个接口）
  - 权限校验注解（@RequiresPermission）
  - 数据权限过滤

**前端任务** (优先级: P0)
- [ ] 登录页面
  - 登录表单（用户名、密码、验证码）
  - 记住密码
  - 登录状态管理（Pinia）
- [ ] 用户管理页面
  - 用户列表（分页、搜索、筛选）
  - 用户新增/编辑对话框
  - 用户状态切换
  - 密码重置
- [ ] 角色管理页面
  - 角色列表
  - 角色新增/编辑
  - 权限分配（树形选择）
- [ ] 权限管理页面
  - 权限树展示
  - 权限新增/编辑

**交付物**:
- ✅ 用户可以登录系统
- ✅ 管理员可以管理用户、角色、权限
- ✅ 权限控制生效（菜单、按钮）

---

### 📅 Phase 2: 核心业务 - 项目与模板（Week 3-4）

**目标**: 完成项目管理和模板管理，支持基于模板创建报告

#### Week 3: 项目管理

**后端任务** (优先级: P0)
- [ ] 项目管理模块
  - ProjectController（6个接口）
  - ProjectService（项目CRUD、归档）
  - 项目节点操作（创建PROJECT节点）
  - 项目关联查询（报告列表、统计）
- [ ] 数据字典模块
  - DictController（8个接口）
  - DictService（字典类型、字典项管理）
  - 字典缓存（Redis）

**前端任务** (优先级: P0)
- [ ] 首页Dashboard
  - 统计卡片（项目数、报告数、模板数）
  - 最近报告列表
  - 快速操作入口
- [ ] 项目管理页面
  - 项目列表（卡片视图 + 列表视图）
  - 项目新增/编辑对话框
  - 项目详情页（报告列表、统计信息）
  - 项目归档

**交付物**:
- ✅ 用户可以创建和管理项目
- ✅ 首页展示统计信息

---

#### Week 4: 模板管理

**后端任务** (优先级: P0)
- [ ] 模板管理模块
  - TemplateController（5个接口）
  - TemplateService（模板CRUD）
  - ElementController（要素定义管理）
  - ElementService（要素CRUD）
- [ ] 模板解析服务
  - TemplateParseService（解析样本文档）
  - 提取要素定义（标题、段落、表格）
  - 创建ELEMENT节点
  - 建立HAS_ELEMENT关系

**前端任务** (优先级: P0)
- [ ] 模板管理页面
  - 模板列表（卡片视图）
  - 模板详情页
  - 要素定义列表（可拖拽排序）
  - 要素新增/编辑（支持text/paragraph/table类型）
- [ ] 模板创建向导
  - 上传样本文档
  - 自动识别要素
  - 手动调整要素定义
  - 保存模板

**交付物**:
- ✅ 用户可以创建和管理模板
- ✅ 支持上传样本文档自动生成模板
- ✅ 要素定义可配置

---

### 📅 Phase 3: 核心业务 - 报告管理（Week 5-6）

**目标**: 完成报告创建、编辑、附件上传、实体识别、规则配置

#### Week 5: 报告创建 + 附件上传

**后端任务** (优先级: P0)
- [ ] 报告管理模块
  - ReportController（9个接口）
  - ReportService（报告CRUD、复制）
  - ReportValueService（要素值管理）
  - 基于模板创建报告（初始化VALUE节点）
- [ ] 文件服务模块
  - FileUploadController（上传接口）
  - FileStorageService（本地存储/OSS）
  - FilePreviewService（文件预览）
- [ ] 附件管理模块
  - AttachmentController（6个接口）
  - AttachmentService（附件CRUD）
  - AttachmentUploadService（上传处理）
- [ ] 文件解析服务
  - PdfParser（PDF解析）
  - DocxParser（Word解析）
  - XlsxParser（Excel解析）
  - 异步解析任务（@Async）

**前端任务** (优先级: P0)
- [ ] 报告列表页面
  - 报告列表（分页、搜索、筛选）
  - 报告状态标签
  - 快速操作（编辑、复制、删除、导出）
- [ ] 报告创建对话框
  - 选择项目
  - 选择模板
  - 输入报告标题
- [ ] 报告编辑器页面
  - 三栏布局（左侧资源、中间编辑、右侧助手）
  - 顶部工具栏（保存、预览、导出）
  - 左侧面板：附件列表
  - 中间编辑区：富文本编辑器
  - 右侧面板：要素管理 + AI助手
- [ ] 附件上传
  - 拖拽上传
  - 文件列表
  - 解析进度展示（WebSocket）
  - 文件预览

**交付物**:
- ✅ 用户可以基于模板创建报告
- ✅ 用户可以上传附件
- ✅ 附件自动解析并提取文本

---

#### Week 6: 实体识别 + 规则引擎

**后端任务** (优先级: P0)
- [ ] 实体管理模块
  - EntityController（5个接口）
  - EntityService（实体CRUD、合并）
  - EntityExtractionService（实体提取）
- [ ] NER服务集成
  - NerServiceClient（调用Python NER服务）
  - 异步实体识别任务
  - 创建ENTITY节点
  - 建立HAS_ENTITY关系
- [ ] 规则引擎模块
  - RuleController（7个接口）
  - RuleService（规则CRUD）
  - RuleExecutor（规则执行器基类）
  - DirectEntityExecutor（直接引用实体）
  - RegexExtractExecutor（正则提取）
  - 规则执行结果更新VALUE节点
- [ ] WebSocket服务
  - WebSocketConfig（配置）
  - ParseProgressHandler（解析进度推送）
  - NotificationHandler（通知推送）

**前端任务** (优先级: P0)
- [ ] 实体管理
  - 实体列表（按类型分组）
  - 实体标签（ORG/PERSON/DATE/NUMBER）
  - 实体详情弹窗
  - 实体合并功能
- [ ] 规则配置
  - 从实体添加规则（拖拽实体到要素）
  - 规则列表
  - 规则编辑对话框
  - 规则执行（单个/批量）
- [ ] 要素值管理
  - 要素填充状态（已填充/未填充）
  - 要素值来源标识（AI/附件/人工）
  - 要素值编辑
- [ ] WebSocket集成
  - 连接管理
  - 解析进度实时更新
  - 通知提示

**交付物**:
- ✅ 附件自动识别实体（NER）
- ✅ 用户可以从实体创建规则
- ✅ 规则自动填充要素值
- ✅ 实时推送解析进度

---

### 📅 Phase 4: AI功能 + 高级特性（Week 7）

**目标**: 集成AI助手，支持LLM生成和优化

#### Week 7: AI助手 + LLM集成

**后端任务** (优先级: P1)
- [ ] AI服务模块
  - AIAssistantController（AI对话）
  - LLMService（调用OpenAI API）
  - PromptService（提示词管理）
  - LLMGenerateExecutor（LLM生成规则执行器）
- [ ] AI功能
  - AI对话（上下文管理）
  - AI建议（内容优化建议）
  - AI文本优化（改写、润色）
  - AI生成规则（基于LLM生成要素值）

**前端任务** (优先级: P1)
- [ ] AI助手面板
  - AI对话界面（消息列表、输入框）
  - AI建议卡片
  - 快速操作按钮（优化、改写、扩展）
- [ ] AI功能集成
  - 选中文本后显示AI操作菜单
  - AI建议接受/拒绝
  - AI生成内容插入编辑器

**交付物**:
- ✅ AI助手可以回答问题
- ✅ AI可以优化文本内容
- ✅ 支持LLM生成规则

---

### 📅 Phase 5: 导出与优化（Week 8）

**目标**: 完成报告导出、性能优化、测试和上线

#### Week 8: 导出 + 优化 + 上线

**后端任务** (优先级: P0)
- [ ] 报告导出服务
  - ReportExportService（导出服务）
  - Word导出（Apache POI）
  - PDF导出（iText/PDFBox）
  - 模板渲染（FreeMarker/Thymeleaf）
- [ ] 性能优化
  - 数据库查询优化（索引、分页）
  - Redis缓存（字典、配置、用户信息）
  - 接口响应时间优化
  - 并发处理优化
- [ ] 系统配置
  - 系统配置管理（ConfigController）
  - 操作日志记录（LogAspect）
  - 异常监控（Sentry/自定义）

**前端任务** (优先级: P0)
- [ ] 报告导出
  - 导出对话框（选择格式、配置选项）
  - 导出进度显示
  - 导出历史记录
- [ ] 系统管理
  - 系统配置页面
  - 操作日志查询
  - 登录日志查询
- [ ] 性能优化
  - 路由懒加载
  - 组件按需加载
  - 图片懒加载
  - 打包优化（Vite配置）
- [ ] 测试与修复
  - 功能测试
  - 兼容性测试
  - Bug修复

**交付物**:
- ✅ 报告可以导出为Word/PDF
- ✅ 系统性能达标
- ✅ 完成测试，准备上线

---

## 三、开发优先级矩阵

### P0 - 必须完成（核心功能）
| 模块 | 功能 | 周期 |
|------|------|------|
| 用户系统 | 登录、权限管理 | Week 1-2 |
| 项目管理 | 项目CRUD | Week 3 |
| 模板管理 | 模板CRUD、要素定义 | Week 4 |
| 报告管理 | 报告CRUD、基于模板创建 | Week 5 |
| 附件管理 | 上传、解析 | Week 5 |
| 实体管理 | NER识别、实体列表 | Week 6 |
| 规则引擎 | 直接引用实体、正则提取 | Week 6 |
| 报告导出 | Word/PDF导出 | Week 8 |

### P1 - 重要功能（增强体验）
| 模块 | 功能 | 周期 |
|------|------|------|
| AI助手 | AI对话、文本优化 | Week 7 |
| LLM规则 | LLM生成要素值 | Week 7 |
| 报告复制 | 复制报告到新项目 | Week 5 |
| 实体合并 | 合并重复实体 | Week 6 |

### P2 - 可选功能（后续迭代）
| 模块 | 功能 | 备注 |
|------|------|------|
| 表格聚合规则 | 从表格聚合数据 | 可后续添加 |
| 报告版本管理 | 版本对比、回滚 | 可后续添加 |
| 协作功能 | 多人编辑、评论 | 可后续添加 |
| 知识库 | 历史报告检索 | 可后续添加 |

---

## 四、团队分工建议

### 后端团队（2人）

**后端开发1（负责核心业务）**
- Week 1-2: 项目框架 + 图数据库基础服务
- Week 3-4: 项目管理 + 模板管理
- Week 5-6: 报告管理 + 附件管理
- Week 7-8: 报告导出 + 性能优化

**后端开发2（负责AI和规则）**
- Week 1-2: 用户系统 + 安全模块
- Week 3-4: 数据字典 + 文件服务
- Week 5-6: 实体管理 + 规则引擎
- Week 7-8: AI服务 + 系统配置

### 前端团队（2人）

**前端开发1（负责核心页面）**
- Week 1-2: 项目框架 + 登录页面
- Week 3-4: 首页 + 项目管理 + 模板管理
- Week 5-6: 报告列表 + 报告编辑器（中间编辑区）
- Week 7-8: 报告导出 + 性能优化

**前端开发2（负责辅助功能）**
- Week 1-2: 基础组件 + 用户管理
- Week 3-4: 角色权限管理 + 数据字典
- Week 5-6: 报告编辑器（左侧资源 + 右侧助手）
- Week 7-8: AI助手 + 系统管理

### AI工程师（1人）

**AI工程师（负责AI服务）**
- Week 1-2: 搭建Python NER服务
- Week 3-4: 优化NER模型、实体识别准确率
- Week 5-6: NER服务集成测试、实体标注工具
- Week 7-8: LLM集成、Prompt优化

---

## 五、关键风险与应对

### 5.1 技术风险

| 风险 | 影响 | 应对措施 |
|------|------|----------|
| NER识别准确率低 | 实体识别效果差 | 提前准备标注数据，训练专用模型 |
| LLM调用成本高 | 运营成本增加 | 限制调用频率，缓存结果 |
| 文件解析失败 | 附件无法使用 | 多种解析方案备选，人工兜底 |
| 性能瓶颈 | 系统响应慢 | 提前做压测，优化数据库查询 |

### 5.2 进度风险

| 风险 | 影响 | 应对措施 |
|------|------|----------|
| 需求变更 | 开发延期 | 锁定核心需求，变更走评审流程 |
| 人员不足 | 功能缩减 | 优先P0功能，P2功能后续迭代 |
| 技术难点 | 开发卡住 | 提前技术预研，准备备选方案 |

---

## 六、每周检查点

### Week 1 检查点
- [ ] 项目框架搭建完成
- [ ] 数据库初始化成功
- [ ] 图数据库基础服务可用
- [ ] 前端项目可运行

### Week 2 检查点
- [ ] 用户可以登录系统
- [ ] 权限控制生效
- [ ] 用户管理功能可用

### Week 3 检查点
- [ ] 项目管理功能完成
- [ ] 首页Dashboard展示

### Week 4 检查点
- [ ] 模板管理功能完成
- [ ] 可以基于样本创建模板

### Week 5 检查点
- [ ] 报告创建功能完成
- [ ] 附件上传和解析可用

### Week 6 检查点
- [ ] 实体识别功能完成
- [ ] 规则引擎可用
- [ ] 要素自动填充

### Week 7 检查点
- [ ] AI助手可用
- [ ] LLM生成功能完成

### Week 8 检查点
- [ ] 报告导出功能完成
- [ ] 系统测试通过
- [ ] 准备上线

---

## 七、交付标准

### 7.1 代码质量
- ✅ 代码规范（ESLint/Checkstyle）
- ✅ 单元测试覆盖率 > 60%
- ✅ 接口文档完整（Swagger）
- ✅ 代码注释清晰

### 7.2 性能指标
- ✅ 接口响应时间 < 500ms
- ✅ 页面加载时间 < 2s
- ✅ 并发用户数 > 100
- ✅ 文件上传成功率 > 99%

### 7.3 功能完整性
- ✅ P0功能100%完成
- ✅ P1功能80%完成
- ✅ 核心流程可演示
- ✅ 无阻塞性Bug

---

## 八、总结

本开发计划采用**敏捷迭代**方式，每2周一个迭代，每个迭代交付可演示的功能。

**关键成功因素**:
1. ✅ **需求明确**: 核心功能需求已锁定
2. ✅ **技术预研**: 图数据库架构已设计
3. ✅ **团队协作**: 前后端并行开发
4. ✅ **风险控制**: 提前识别技术风险
5. ✅ **持续交付**: 每周发布可测试版本

**预期成果**:
- 8周后交付可上线的MVP版本
- 支持完整的报告生成流程
- 具备AI辅助能力
- 为后续迭代打好基础