fundplatform/AGENTS.md
zhangjf 455a20c1df 完善项目配置和测试用例
新增内容:
1. 添加 AGENTS.md 和 CLAUDE.md AI 助手配置文件
2. 添加安全修复说明文档 (doc/security-fixes.md)
3. 新增单元测试用例:
   - fund-common: TenantContextHolderTest, UserContextHolderTest, PageResultTest, ResultTest
   - fund-sys: AuthServiceImplTest, RoleServiceImplTest, TenantServiceImplTest

修改内容:
1. 数据库初始化脚本更新 (fund_sys_init.sql)
2. 前端依赖更新 (package.json)
3. 登录和密码管理功能优化:
   - 管理后台和移动端登录页面
   - 密码修改功能
4. 租户上下文处理优化 (TenantLineHandlerImpl)
5. 网关过滤器增强:
   - TenantGatewayFilter 租户过滤
   - TokenAuthFilter 认证过滤
6. Controller 层代码优化
7. DTO 和 Service 层代码改进

技术改进:
- 密码加密方式从 BCrypt 改为 MD5(前后端一致)
- 登录验证流程优化,支持多租户
- 增加日志输出便于调试
- 代码规范性和可维护性提升
2026-03-01 19:06:42 +08:00

2.1 KiB
Raw Permalink Blame History

Repository Guidelines

项目结构与模块组织

  • 后端为 Maven 多模块 Spring Boot 工程。核心服务位于 fund-* 模块(如 fund-sysfund-custfund-projfund-gateway),共享代码在 fund-common
  • 前端为独立 Vite 项目:管理端在 fund-admin,移动端 H5 在 fund-mobile
  • 运维与打包相关内容在 scripts/deploy/docker/assembly/。前端构建先生成各模块 dist/,再通过 scripts/build-frontend.sh 复制到 deploy/;后端构建产物也统一放置在 deploy/

构建、测试与本地开发命令

  • mvn -q -DskipTests package: 在仓库根目录构建所有后端模块。
  • mvn test: 运行后端单元测试(依赖 Spring Boot Test
  • cd fund-admin && npm install && npm run dev: 本地启动管理端。
  • cd fund-mobile && npm install && npm run dev: 本地启动移动端。
  • ./scripts/build-frontend.sh [admin|mobile]: 构建单个或全部前端。
  • ./scripts/docker-build.sh build-all: 构建后端服务 Docker 镜像。
  • docker-compose up -d: 启动 docker-compose.yml 中定义的本地依赖/服务。

编码风格与命名规范

  • Java 采用常规 Spring Boot 风格,包名格式如 com.fundplatform.{模块}.{层级}
  • 后端类命名按职责清晰命名(如 CustomerControllerCustomerServiceImpl)。
  • 前端 TypeScript/Vue 没有统一的格式化配置,保持与现有代码风格一致。

测试指南

  • 后端测试放在各模块 src/test/java,通过 mvn test 运行。
  • 前端 package.json 未配置测试脚本,若新增测试需同时引入对应测试工具。

提交与拉取请求规范

  • Git 历史显示轻量 Conventional Commits 风格,建议使用 feat:fix: 等前缀,描述简洁明确。
  • PR 需说明范围;有需求单则关联;涉及 UIfund-adminfund-mobile)请附截图。
  • 涉及配置或部署脚本的变更(scripts/deploy/docker/)需显式说明。

配置与运行说明

  • 服务启动脚本读取 conf/env.propertiesconf/service.properties(见 scripts/start.sh)。
  • pom.xml 指定 Java 版本为 21