lingyue-zhibao/0211docs/开发优先级计划.md

灵越智报 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辅助能力
• 为后续迭代打好基础