Etusivu Tutki Apua
Kirjaudu sisään
hewensong
/
lingyue-zhibao
1
0
Fork 0
Tiedostot Ongelmat 0 Pull-pyynnöt 0 Wiki
Haara: dev
Haarat Tagit
lingyue-zhibao
/
0211docs
/
开发优先级计划-简化版.md

开发优先级计划-简化版.md 15 KB
Pysyvä linkki Historia Raaka

灵越智报 2.0 - 开发优先级计划（简化版）

制定时间: 2026-02-12
核心变化: 前端只关心"项目"概念，不区分项目/模板/报告
总工期: 6周（1.5个月）
团队配置: 后端2人 + 前端2人 + AI工程师1人

一、总体开发策略

1.1 开发原则

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

1.2 简化带来的优势

  • 开发周期缩短: 从8周缩短到6周（减少25%）
  • 代码量减少: 前后端代码量减少约30%
  • 概念更简单: 只有"项目"一个核心概念
  • 测试更容易: 减少状态管理复杂度

1.3 里程碑

  • Week 2: 用户登录 + 项目管理
  • Week 4: 附件上传 + 实体识别 + 规则引擎
  • Week 6: AI助手 + 导出功能 + 上线

二、详细开发计划

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

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

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

后端任务 (优先级: P0)

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

前端任务 (优先级: 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）
  • 项目管理模块 ⭐
    • ProjectController（8个接口）
    • ProjectService（项目CRUD、复制、归档）
    • ElementController（要素定义管理）
    • ValueController（要素值管理）
    • 项目节点操作（创建PROJECT节点）
    • 要素初始化（创建ELEMENT和VALUE节点）

前端任务 (优先级: P0)

  • 登录页面
    • 登录表单（用户名、密码、验证码）
    • 记住密码
    • 登录状态管理（Pinia）
  • 用户管理页面
    • 用户列表（分页、搜索、筛选）
    • 用户新增/编辑对话框
    • 用户状态切换
    • 密码重置
  • 项目管理页面 ⭐
    • 项目列表（卡片视图 + 列表视图）
    • 项目新增对话框（选择模板类型/从样本创建）
    • 项目详情页
    • 项目快速操作（编辑、复制、归档、删除）
  • 首页Dashboard
    • 统计卡片（项目数、最近更新）
    • 最近项目列表
    • 快速创建入口

交付物:

  • ✅ 用户可以登录系统
  • ✅ 用户可以创建和管理项目
  • ✅ 项目列表展示正常

📅 Phase 2: 项目编辑 + 附件管理（Week 3-4）

目标: 完成项目编辑器、附件上传、实体识别、规则配置

Week 3: 项目编辑器 + 附件上传

后端任务 (优先级: P0)

  • 项目内容管理
    • 项目内容保存（content_html, content_markdown）
    • 要素值更新接口
    • 批量更新要素值
  • 文件服务模块
    • FileUploadController（上传接口）
    • FileStorageService（本地存储/OSS）
    • FilePreviewService（文件预览）
  • 附件管理模块
    • AttachmentController（6个接口）
    • AttachmentService（附件CRUD）
    • AttachmentUploadService（上传处理）
  • 文件解析服务
    • PdfParser（PDF解析）
    • DocxParser（Word解析）
    • XlsxParser（Excel解析）
    • 异步解析任务（@Async）

前端任务 (优先级: P0)

  • 项目编辑器页面 ⭐⭐⭐
    • 三栏布局（左侧资源、中间编辑、右侧助手）
    • 顶部工具栏（项目标题、状态、保存、导出）
    • 左侧面板：附件列表
    • 中间编辑区：富文本编辑器（Quill/TinyMCE）
    • 右侧面板：要素管理 + AI助手
    • 实时保存（防抖3秒）
  • 附件上传
    • 拖拽上传
    • 文件列表
    • 解析进度展示（WebSocket）
    • 文件预览

交付物:

  • ✅ 项目编辑器可用
  • ✅ 用户可以上传附件
  • ✅ 附件自动解析并提取文本

Week 4: 实体识别 + 规则引擎

后端任务 (优先级: P0)

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

前端任务 (优先级: P0)

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

交付物:

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

📅 Phase 3: AI功能 + 导出优化（Week 5-6）

目标: 集成AI助手，支持LLM生成和导出

Week 5: 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生成规则

Week 6: 导出 + 优化 + 上线

后端任务 (优先级: P0)

  • 项目导出服务
    • ProjectExportService（导出服务）
    • Word导出（Apache POI）
    • PDF导出（iText/PDFBox）
    • 模板渲染（FreeMarker/Thymeleaf）
  • 性能优化
    • 数据库查询优化（索引、分页）
    • Redis缓存（字典、配置、用户信息）
    • 接口响应时间优化
    • 并发处理优化
  • 系统配置
    • 系统配置管理（ConfigController）
    • 操作日志记录（LogAspect）
    • 异常监控（Sentry/自定义）

前端任务 (优先级: P0)

  • 项目导出
    • 导出对话框（选择格式、配置选项）
    • 导出进度显示
    • 导出历史记录
  • 系统管理
    • 系统配置页面
    • 操作日志查询
    • 登录日志查询
  • 性能优化
    • 路由懒加载
    • 组件按需加载
    • 图片懒加载
    • 打包优化（Vite配置）
  • 测试与修复
    • 功能测试
    • 兼容性测试
    • Bug修复

交付物:

  • ✅ 项目可以导出为Word/PDF
  • ✅ 系统性能达标
  • ✅ 完成测试，准备上线

三、开发优先级矩阵

P0 - 必须完成（核心功能）

模块 功能 周期
用户系统 登录、权限管理 Week 1-2
项目管理 项目CRUD、要素管理、要素值管理 Week 2
附件管理 上传、解析 Week 3
实体管理 NER识别、实体列表 Week 4
规则引擎 直接引用实体、正则提取 Week 4
项目导出 Word/PDF导出 Week 6

P1 - 重要功能（增强体验）

模块 功能 周期
AI助手 AI对话、文本优化 Week 5
LLM规则 LLM生成要素值 Week 5
项目复制 复制项目 Week 2
实体合并 合并重复实体 Week 4

P2 - 可选功能（后续迭代）

模块 功能 备注
表格聚合规则 从表格聚合数据 可后续添加
项目版本管理 版本对比、回滚 可后续添加
协作功能 多人编辑、评论 可后续添加
知识库 历史项目检索 可后续添加

四、团队分工建议

后端团队（2人）

后端开发1（负责核心业务）

  • Week 1-2: 项目框架 + 图数据库基础服务 + 项目管理
  • Week 3-4: 附件管理 + 文件解析
  • Week 5-6: 项目导出 + 性能优化

后端开发2（负责AI和规则）

  • Week 1-2: 用户系统 + 安全模块
  • Week 3-4: 实体管理 + 规则引擎 + WebSocket
  • Week 5-6: AI服务 + 系统配置

前端团队（2人）

前端开发1（负责核心页面）

  • Week 1-2: 项目框架 + 登录页面 + 项目列表
  • Week 3-4: 项目编辑器（中间编辑区）
  • Week 5-6: 项目导出 + 性能优化

前端开发2（负责辅助功能）

  • Week 1-2: 基础组件 + 用户管理 + 首页
  • Week 3-4: 项目编辑器（左侧资源 + 右侧助手）
  • Week 5-6: AI助手 + 系统管理

AI工程师（1人）

AI工程师（负责AI服务）

  • Week 1-2: 搭建Python NER服务
  • Week 3-4: NER服务集成测试、优化识别准确率
  • Week 5-6: LLM集成、Prompt优化

五、关键风险与应对

5.1 技术风险

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

5.2 进度风险

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

六、每周检查点

Week 1 检查点

  • 项目框架搭建完成
  • 数据库初始化成功（简化版）
  • 图数据库基础服务可用
  • 前端项目可运行

Week 2 检查点

  • 用户可以登录系统
  • 权限控制生效
  • 项目管理功能完成（CRUD）
  • 可以创建项目并初始化要素

Week 3 检查点

  • 项目编辑器可用
  • 附件上传和解析可用
  • 实时保存功能正常

Week 4 检查点

  • 实体识别功能完成
  • 规则引擎可用
  • 要素自动填充
  • WebSocket推送正常

Week 5 检查点

  • AI助手可用
  • LLM生成功能完成

Week 6 检查点

  • 项目导出功能完成
  • 系统测试通过
  • 准备上线

七、交付标准

7.1 代码质量

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

7.2 性能指标

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

7.3 功能完整性

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

八、简化设计带来的优势

8.1 开发效率提升

维度 原设计 简化设计 提升
开发周期 8周 6周 25%
后端接口数 ~100个 ~80个 20%
前端页面数 4个主页面 2个主页面 50%
状态管理复杂度 高（3层） 低（1层） 显著降低

8.2 用户体验提升

维度 原设计 简化设计
概念理解 需要理解项目/模板/报告 只需理解"项目"
操作步骤 创建项目→选模板→创建报告 创建项目→直接编辑
学习成本 中等 低
操作效率 中等 高

8.3 维护成本降低

  • 代码量减少30%: 更少的代码意味着更少的Bug
  • 状态管理简化: 前端状态管理复杂度显著降低
  • 测试用例减少: 减少约25%的测试用例
  • 文档维护简化: 概念更少，文档更简洁

九、总结

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

简化设计的核心优势:

  1. ✅ 概念简单: 只有"项目"一个核心概念
  2. ✅ 开发高效: 6周完成MVP，比原计划缩短25%
  3. ✅ 易于维护: 代码量减少30%，Bug更少
  4. ✅ 用户友好: 操作步骤减少，学习成本降低
  5. ✅ 扩展灵活: 保留图数据库优势，后续可扩展

预期成果:

  • 6周后交付可上线的MVP版本
  • 支持完整的项目编辑和报告生成流程
  • 具备AI辅助能力
  • 为后续迭代打好基础

模板功能保留方式: 虽然前端不区分模板，但通过以下方式保留模板复用能力：

  • 系统预设模板类型
  • 用户可将项目"保存为模板"
  • 支持从模板创建新项目