jewpms/doc
user 21f5e9c70a fix(database): 修正SQL查询操作符及新增分页查询接口
- 将SQL条件构造中错误的IFNULL操作符修正为ISNULL
- 添加对NOTNULL和BETWEEN操作符的SQL支持,增强查询表达能力
- 修正BETWEEN操作符的参数绑定逻辑,支持范围查询
- 修改前端相关地方原使用的IFNULL操作符为ISNULL,保持一致性
- 为多个资源REST接口新增统一的带分页的POST列表查询方法
- 分页查询方法增加了对分页参数是否合法的校验处理
- 文档中新增PostgreSQL数据库字段要求及连接配置描述
2025-10-10 14:47:45 +08:00
..
rules 初始化项目并添加菜单管理功能 2025-02-26 23:02:11 +08:00
AICode.cmd fix(database): 修正SQL查询操作符及新增分页查询接口 2025-10-10 14:47:45 +08:00
Readme.md feat: 统一选择组件中的标签格式为“名称(编号)”并添加状态字段 2025-06-29 22:34:19 +08:00

项目结构分析

这是一个使用 JHipster 生成的全栈 Web 应用程序项目。项目整合了 Java 后端和现代前端技术栈。

核心技术栈

  • 后端:

    • 语言: Java
    • 框架: Spring Boot
    • 构建工具: Apache Maven (pom.xml)
    • 数据库迁移: Liquibase (src/main/resources/config/liquibase/)
  • 前端:

    • 语言: TypeScript
    • 框架: Vue.js (src/main/webapp/app/app.vue)
    • 构建/开发工具: Vite (vite.config.mts)
    • 包管理器: npm (package.json)

目录结构

  • pom.xml: 定义了 Java 项目的依赖和构建生命周期,是 Maven 项目的核心。
  • package.json: 定义了前端项目的依赖和脚本,是 npm/Node.js 项目的核心。
  • src/main/java/com/vxnet/pms/: 存放所有后端 Java 源代码。
  • src/main/resources/: 存放后端应用的配置文件 (application.yml)、国际化资源 (i18n/) 和数据库迁移脚本 (Liquibase)。
  • src/main/webapp/: 存放所有前端代码和资源。
    • app/: 前端 Vue/TypeScript 应用程序的源代码。
    • content/: 存放 CSS 和图片等静态资源。
    • i18n/: 前端国际化文件。
  • src/test/: 包含了后端 (Java/JUnit) 和前端 (TypeScript/Vitest) 的测试代码。
  • src/main/docker/: 包含了用于构建和运行应用的 Docker Compose 配置文件,方便进行容器化部署(例如,app.yml, mysql.yml)。

开发与质量工具

  • 版本控制: Git (.git/)。
  • 代码质量:
    • ESLint (eslint.config.mjs) 和 Prettier (.prettierrc) 用于保证前端代码风格和质量。
    • Checkstyle (checkstyle.xml) 用于 Java 代码规范。
    • SonarQube (sonar-project.properties) 用于静态代码分析。
  • Git Hooks: Husky (.husky/) 用于在提交代码前自动运行检查 (linting)。
  • 开发容器: 支持使用 Dev Containers (.devcontainer/) 进行标准化的容器化开发。

总结

该项目是一个结构清晰、工具链完善的 JHipster 单体应用。它遵循了标准的 Maven 和 npm 项目布局,将后端和前端代码清晰地分离在同一个仓库中。开发者可以通过 mvnw (或 mvnw.cmd) 来管理后端,通过 npmw (或 npmw.cmd) 来管理前端。