lingyue-zhibao/backend/PROJECT_CHECK.md

项目检查报告

检查时间

2024年

项目状态概览

✅ 已完成

1. 项目结构: 所有微服务模块已创建
2. 依赖管理: 父POM已配置所有依赖版本
3. 公共模块: common模块包含统一响应、异常处理、工具类
4. 实体基类: AssignUuidModel、CreationModel、SimpleModel已创建
5. Starter模块: lingyue-starter单体应用启动器已创建
6. 配置文件: 各服务的application.yml已配置

⚠️ 需要修复的问题

1. MyBatis Plus 依赖问题（高优先级）

问题: 多个服务的MyBatisPlusConfig无法解析PaginationInnerInterceptor

• auth-service/src/main/java/com/lingyue/auth/config/MyBatisPlusConfig.java
• document-service/src/main/java/com/lingyue/document/config/MyBatisPlusConfig.java
• parse-service/src/main/java/com/lingyue/parse/config/MyBatisPlusConfig.java
• ai-service/src/main/java/com/lingyue/ai/config/MyBatisPlusConfig.java
• graph-service/src/main/java/com/lingyue/graph/config/MyBatisPlusConfig.java

原因:

• MyBatis Plus 3.5.11版本应该包含此类
• 可能是IDE索引问题，需要重新编译项目

解决方案:

cd backend
mvn clean install -DskipTests

2. 代码警告（低优先级）

• 未使用的import语句（可自动清理）
• 未使用的字段（Controller中的service字段，待实现功能时使用）
• 泛型警告（AjaxResult的raw type使用）

3. 依赖版本问题（已修复）

• ✅ lingyue-starter的pom.xml中已添加版本号
• ✅ common模块已添加MyBatis Plus、Spring Security依赖

模块依赖关系

lingyue-zhibao (父POM)
├── common (公共模块)
│   ├── MyBatis Plus (实体注解)
│   ├── Spring Security (异常处理)
│   └── JWT工具类
├── auth-service
│   ├── common
│   └── MyBatis Plus
├── document-service
│   ├── common
│   └── MyBatis Plus
├── parse-service
│   ├── common
│   └── MyBatis Plus
├── ai-service
│   ├── common
│   └── MyBatis Plus
├── graph-service
│   ├── common
│   └── MyBatis Plus
├── notification-service
│   └── common
└── lingyue-starter (单体应用)
    ├── common
    ├── auth-service
    ├── document-service
    ├── parse-service
    ├── ai-service
    ├── graph-service
    └── notification-service

编译建议

1. 清理并重新编译

cd backend
mvn clean install -DskipTests

2. 如果MyBatis Plus问题仍然存在

检查MyBatis Plus版本：

mvn dependency:tree | grep mybatis-plus

3. IDE刷新

• IntelliJ IDEA: File -> Invalidate Caches / Restart
• Eclipse: Project -> Clean

待实现功能

高优先级（P0）

1. 文档服务: 文件上传、OSS集成
2. 解析服务: PaddleOCR集成
3. AI服务: DeepSeek API集成
4. 关系网络服务: 图计算逻辑

中优先级（P1）

1. WebSocket实时通知
2. 文档预览功能
3. 批注功能

低优先级（P2）

1. 全文搜索
2. 批量处理
3. 数据统计

配置检查清单

• 父POM依赖版本管理
• 各服务pom.xml依赖配置
• application.yml配置文件
• MyBatis Plus配置类
• 全局异常处理器
• 统一响应格式（AjaxResult）
• 实体基类
• JWT工具类
• 密码工具类
• Starter模块配置
• 数据库初始化脚本
• 单元测试
• 集成测试

下一步行动

1. 立即执行: 运行mvn clean install重新编译项目
2. 验证: 检查MyBatis Plus依赖是否正确解析
3. 开发: 开始实现P0优先级功能
4. 测试: 编写单元测试和集成测试

注意事项

1. JWT密钥: 生产环境必须修改默认密钥
2. 数据库密码: 生产环境必须使用强密码
3. Nacos配置: 单体应用模式下可禁用服务发现
4. 日志级别: 生产环境建议使用WARN级别