Files

T

2026-04-17 18:15:26 +08:00

38 KiB

Raw Permalink Blame History

健身房管理系统基础设施重构实现计划

面向 AI 代理的工作者： 必需子技能：使用 superpowers:subagent-driven-development（推荐）或 superpowers:executing-plans 逐任务实现此计划。步骤使用复选框（- [ ]）语法来跟踪进度。

目标： 将通用后台管理系统重构为健身房管理系统，包括项目重命名、包名修改、测试迁移和移动端项目创建

架构： 采用分阶段渐进重构策略，共 5 个阶段：后端重构 → 前端重构 → 测试迁移 → UniApp 创建 → 根目录整理

技术栈： Java 21 + Spring Boot 3.5.13 + Maven (后端) | Vue 3 + TypeScript + Vite (前端) | UniApp + Vue 3 (移动端) | Playwright (E2E 测试)

文件结构

阶段 1：后端项目重构（gym-manage-api）

重命名的目录：

novalon-manage-api/ → gym-manage-api/

修改的文件：

gym-manage-api/pom.xml - Maven 父 POM 配置
gym-manage-api/manage-app/pom.xml - 主应用模块配置
gym-manage-api/manage-gateway/pom.xml - 网关模块配置
gym-manage-api/manage-sys/pom.xml - 系统模块配置
gym-manage-api/manage-db/pom.xml - 数据库模块配置
gym-manage-api/manage-common/pom.xml - 公共模块配置
gym-manage-api/manage-audit/pom.xml - 审计模块配置
gym-manage-api/manage-notify/pom.xml - 通知模块配置
gym-manage-api/manage-file/pom.xml - 文件模块配置
gym-manage-api/manage-app/src/main/resources/application.yml - 应用配置
gym-manage-api/manage-app/src/main/resources/application-dev.yml - 开发环境配置
gym-manage-api/manage-app/src/main/resources/application-prod.yml - 生产环境配置
gym-manage-api/manage-gateway/src/main/resources/application.yml - 网关配置
所有 Java 文件 - 包名和 import 语句

重命名的包目录：

gym-manage-api/*/src/main/java/cn/novalon/manage/ → gym-manage-api/*/src/main/java/cn/novalon/gym/manage/
gym-manage-api/*/src/test/java/cn/novalon/manage/ → gym-manage-api/*/src/test/java/cn/novalon/gym/manage/

阶段 2：前端项目重构（gym-manage-web）

重命名的目录：

novalon-manage-web/ → gym-manage-web/

修改的文件：

gym-manage-web/package.json - NPM 项目配置
gym-manage-web/index.html - HTML 入口文件
gym-manage-web/vite.config.ts - Vite 构建配置

阶段 3：测试文件迁移（e2e-tests）

创建的目录：

e2e-tests/ - 独立测试项目根目录
e2e-tests/e2e/ - 测试用例目录
e2e-tests/playwright/ - Playwright 配置目录
e2e-tests/scripts/ - 测试脚本目录

迁移的文件：

gym-manage-web/e2e/* → e2e-tests/e2e/
gym-manage-web/playwright/* → e2e-tests/playwright/
gym-manage-web/scripts/* → e2e-tests/scripts/
gym-manage-web/playwright.config.ts → e2e-tests/playwright.config.ts
gym-manage-web/playwright-complete.config.ts → e2e-tests/playwright-complete.config.ts
gym-manage-web/playwright-simple.config.ts → e2e-tests/playwright-simple.config.ts

创建的文件：

e2e-tests/package.json - 测试项目依赖配置

删除的文件：

package.json (根目录) - 测试依赖已迁移

修改的文件：

e2e-tests/playwright.config.ts - 更新测试路径配置

阶段 4：创建 UniApp 项目（gym-manage-uniapp）

创建的目录：

gym-manage-uniapp/ - 移动端项目根目录
gym-manage-uniapp/src/ - 源代码目录
gym-manage-uniapp/src/pages/ - 页面目录
gym-manage-uniapp/src/pages/index/ - 首页目录
gym-manage-uniapp/src/pages/login/ - 登录页目录
gym-manage-uniapp/src/components/ - 组件目录
gym-manage-uniapp/src/api/ - API 接口目录
gym-manage-uniapp/src/store/ - 状态管理目录
gym-manage-uniapp/src/utils/ - 工具函数目录
gym-manage-uniapp/src/static/ - 静态资源目录

创建的文件：

gym-manage-uniapp/package.json - NPM 项目配置
gym-manage-uniapp/tsconfig.json - TypeScript 配置
gym-manage-uniapp/vite.config.ts - Vite 构建配置
gym-manage-uniapp/src/manifest.json - UniApp 应用配置
gym-manage-uniapp/src/pages.json - UniApp 页面配置
gym-manage-uniapp/src/main.ts - 应用入口
gym-manage-uniapp/src/App.vue - 应用根组件
gym-manage-uniapp/src/pages/index/index.vue - 首页组件
gym-manage-uniapp/src/pages/login/index.vue - 登录页组件
gym-manage-uniapp/src/api/request.ts - 请求封装
gym-manage-uniapp/src/store/index.ts - Pinia 配置
gym-manage-uniapp/src/store/user.ts - 用户状态管理

阶段 5：根目录整理与文档更新

修改的文件：

docker-compose.yml - Docker 编排配置
Jenkinsfile - CI/CD 配置
README.md - 项目文档

阶段 1：后端项目重构（gym-manage-api）

任务 1.1：重命名后端项目目录

文件：

重命名：novalon-manage-api/ → gym-manage-api/
步骤 1：使用 Git 重命名项目目录

git mv novalon-manage-api gym-manage-api

步骤 2：验证重命名结果

运行：ls -la | grep gym-manage-api 预期：显示 gym-manage-api 目录

任务 1.2：修改 Maven 父 POM 配置

文件：

修改：gym-manage-api/pom.xml
步骤 1：更新 Maven 父 POM 的 groupId

修改 gym-manage-api/pom.xml 第 21 行：

<groupId>cn.novalon.gym.manage</groupId>

步骤 2：更新 Maven 父 POM 的 artifactId

修改 gym-manage-api/pom.xml 第 22 行：

<artifactId>gym-manage-api</artifactId>

步骤 3：更新 Maven 父 POM 的 name

修改 gym-manage-api/pom.xml 第 26 行：

<name>Gym Manage API</name>

步骤 4：更新 Maven 父 POM 的 description

修改 gym-manage-api/pom.xml 第 27 行：

<description>Gym Management System API</description>

任务 1.3：修改 manage-app 模块 POM 配置

文件：

修改：gym-manage-api/manage-app/pom.xml
步骤 1：更新 parent 引用的 groupId

修改 gym-manage-api/manage-app/pom.xml：

<parent>
    <groupId>cn.novalon.gym.manage</groupId>
    <artifactId>gym-manage-api</artifactId>
    <version>1.0.0</version>
</parent>

步骤 2：更新模块的 groupId

<groupId>cn.novalon.gym.manage</groupId>

步骤 3：更新模块的 artifactId

<artifactId>manage-app</artifactId>

任务 1.4：修改 manage-gateway 模块 POM 配置

文件：

修改：gym-manage-api/manage-gateway/pom.xml
步骤 1：更新 parent 引用的 groupId

修改 gym-manage-api/manage-gateway/pom.xml：

<parent>
    <groupId>cn.novalon.gym.manage</groupId>
    <artifactId>gym-manage-api</artifactId>
    <version>1.0.0</version>
</parent>

步骤 2：更新模块的 groupId

<groupId>cn.novalon.gym.manage</groupId>

任务 1.5：修改 manage-sys 模块 POM 配置

文件：

修改：gym-manage-api/manage-sys/pom.xml
步骤 1：更新 parent 引用的 groupId

修改 gym-manage-api/manage-sys/pom.xml：

<parent>
    <groupId>cn.novalon.gym.manage</groupId>
    <artifactId>gym-manage-api</artifactId>
    <version>1.0.0</version>
</parent>

步骤 2：更新模块的 groupId

<groupId>cn.novalon.gym.manage</groupId>

任务 1.6：修改 manage-db 模块 POM 配置

文件：

修改：gym-manage-api/manage-db/pom.xml
步骤 1：更新 parent 引用的 groupId

修改 gym-manage-api/manage-db/pom.xml：

<parent>
    <groupId>cn.novalon.gym.manage</groupId>
    <artifactId>gym-manage-api</artifactId>
    <version>1.0.0</version>
</parent>

步骤 2：更新模块的 groupId

<groupId>cn.novalon.gym.manage</groupId>

任务 1.7：修改 manage-common 模块 POM 配置

文件：

修改：gym-manage-api/manage-common/pom.xml
步骤 1：更新 parent 引用的 groupId

修改 gym-manage-api/manage-common/pom.xml：

<parent>
    <groupId>cn.novalon.gym.manage</groupId>
    <artifactId>gym-manage-api</artifactId>
    <version>1.0.0</version>
</parent>

步骤 2：更新模块的 groupId

<groupId>cn.novalon.gym.manage</groupId>

任务 1.8：修改 manage-audit 模块 POM 配置

文件：

修改：gym-manage-api/manage-audit/pom.xml
步骤 1：更新 parent 引用的 groupId

修改 gym-manage-api/manage-audit/pom.xml：

<parent>
    <groupId>cn.novalon.gym.manage</groupId>
    <artifactId>gym-manage-api</artifactId>
    <version>1.0.0</version>
</parent>

步骤 2：更新模块的 groupId

<groupId>cn.novalon.gym.manage</groupId>

任务 1.9：修改 manage-notify 模块 POM 配置

文件：

修改：gym-manage-api/manage-notify/pom.xml
步骤 1：更新 parent 引用的 groupId

修改 gym-manage-api/manage-notify/pom.xml：

<parent>
    <groupId>cn.novalon.gym.manage</groupId>
    <artifactId>gym-manage-api</artifactId>
    <version>1.0.0</version>
</parent>

步骤 2：更新模块的 groupId

<groupId>cn.novalon.gym.manage</groupId>

任务 1.10：修改 manage-file 模块 POM 配置

文件：

修改：gym-manage-api/manage-file/pom.xml
步骤 1：更新 parent 引用的 groupId

修改 gym-manage-api/manage-file/pom.xml：

<parent>
    <groupId>cn.novalon.gym.manage</groupId>
    <artifactId>gym-manage-api</artifactId>
    <version>1.0.0</version>
</parent>

步骤 2：更新模块的 groupId

<groupId>cn.novalon.gym.manage</groupId>

任务 1.11：重命名 Java 包目录结构

文件：

重命名：所有模块的 Java 包目录
步骤 1：重命名 manage-app 的主代码包目录

cd gym-manage-api/manage-app/src/main/java/cn/novalon
git mv manage gym/manage

步骤 2：重命名 manage-app 的测试代码包目录

cd gym-manage-api/manage-app/src/test/java/cn/novalon
git mv manage gym/manage

步骤 3：重命名 manage-gateway 的主代码包目录

cd gym-manage-api/manage-gateway/src/main/java/cn/novalon
git mv manage gym/manage

步骤 4：重命名 manage-gateway 的测试代码包目录

cd gym-manage-api/manage-gateway/src/test/java/cn/novalon
git mv manage gym/manage

步骤 5：重命名 manage-sys 的主代码包目录

cd gym-manage-api/manage-sys/src/main/java/cn/novalon
git mv manage gym/manage

步骤 6：重命名 manage-sys 的测试代码包目录

cd gym-manage-api/manage-sys/src/test/java/cn/novalon
git mv manage gym/manage

步骤 7：重命名 manage-db 的主代码包目录

cd gym-manage-api/manage-db/src/main/java/cn/novalon
git mv manage gym/manage

步骤 8：重命名 manage-db 的测试代码包目录

cd gym-manage-api/manage-db/src/test/java/cn/novalon
git mv manage gym/manage

步骤 9：重命名 manage-common 的主代码包目录

cd gym-manage-api/manage-common/src/main/java/cn/novalon
git mv manage gym/manage

步骤 10：重命名 manage-common 的测试代码包目录

cd gym-manage-api/manage-common/src/test/java/cn/novalon
git mv manage gym/manage

步骤 11：重命名 manage-audit 的主代码包目录

cd gym-manage-api/manage-audit/src/main/java/cn/novalon
git mv manage gym/manage

步骤 12：重命名 manage-audit 的测试代码包目录

cd gym-manage-api/manage-audit/src/test/java/cn/novalon
git mv manage gym/manage

步骤 13：重命名 manage-notify 的主代码包目录

cd gym-manage-api/manage-notify/src/main/java/cn/novalon
git mv manage gym/manage

步骤 14：重命名 manage-notify 的测试代码包目录

cd gym-manage-api/manage-notify/src/test/java/cn/novalon
git mv manage gym/manage

步骤 15：重命名 manage-file 的主代码包目录

cd gym-manage-api/manage-file/src/main/java/cn/novalon
git mv manage gym/manage

步骤 16：重命名 manage-file 的测试代码包目录

cd gym-manage-api/manage-file/src/test/java/cn/novalon
git mv manage gym/manage

任务 1.12：批量更新 Java 文件的 package 声明

文件：

修改：所有 Java 文件
步骤 1：使用 sed 批量替换 package 声明

find gym-manage-api -type f -name "*.java" -exec sed -i '' 's/^package cn\.novalon\.manage/package cn.novalon.gym.manage/g' {} +

步骤 2：验证替换结果

运行：grep -r "^package cn.novalon.manage" gym-manage-api --include="*.java" | head -5 预期：无输出（所有 package 声明已更新）

任务 1.13：批量更新 Java 文件的 import 语句

文件：

修改：所有 Java 文件
步骤 1：使用 sed 批量替换 import 语句

find gym-manage-api -type f -name "*.java" -exec sed -i '' 's/import cn\.novalon\.manage/import cn.novalon.gym.manage/g' {} +

步骤 2：验证替换结果

运行：grep -r "import cn.novalon.manage" gym-manage-api --include="*.java" | head -5 预期：无输出（所有 import 语句已更新）

任务 1.14：更新 Spring Boot 配置文件

文件：

修改：gym-manage-api/manage-app/src/main/resources/application.yml
修改：gym-manage-api/manage-app/src/main/resources/application-dev.yml
修改：gym-manage-api/manage-app/src/main/resources/application-prod.yml
修改：gym-manage-api/manage-gateway/src/main/resources/application.yml
步骤 1：更新 manage-app 的 application.yml

修改 gym-manage-api/manage-app/src/main/resources/application.yml：

spring:
  application:
    name: gym-manage-api

步骤 2：更新 manage-gateway 的 application.yml

修改 gym-manage-api/manage-gateway/src/main/resources/application.yml：

spring:
  application:
    name: gym-manage-gateway

任务 1.15：验证后端项目编译

文件：

无文件修改，仅验证
步骤 1：清理旧的编译产物

cd gym-manage-api
mvn clean

预期：BUILD SUCCESS

步骤 2：编译项目

mvn compile

预期：BUILD SUCCESS，无编译错误

步骤 3：运行单元测试

mvn test

预期：BUILD SUCCESS，所有测试通过

任务 1.16：提交阶段 1 的变更

文件：

无文件修改，仅提交
步骤 1：查看变更状态

git status

预期：显示所有修改的文件

步骤 2：提交变更

git add .
git commit -m "refactor(backend): 重命名后端项目为 gym-manage-api，修改包名为 cn.novalon.gym.manage"

预期：提交成功

阶段 2：前端项目重构（gym-manage-web）

任务 2.1：重命名前端项目目录

文件：

重命名：novalon-manage-web/ → gym-manage-web/
步骤 1：使用 Git 重命名项目目录

git mv novalon-manage-web gym-manage-web

步骤 2：验证重命名结果

运行：ls -la | grep gym-manage-web 预期：显示 gym-manage-web 目录

任务 2.2：修改 package.json 配置

文件：

修改：gym-manage-web/package.json
步骤 1：更新项目名称

修改 gym-manage-web/package.json 第 2 行：

"name": "gym-manage-web",

步骤 2：更新项目描述

修改 gym-manage-web/package.json 第 4 行：

"description": "Gym Management System Frontend",

任务 2.3：修改 index.html 页面标题

文件：

修改：gym-manage-web/index.html
步骤 1：更新页面标题

修改 gym-manage-web/index.html：

<title>健身房管理系统</title>

任务 2.4：验证前端项目构建

文件：

无文件修改，仅验证
步骤 1：安装依赖

cd gym-manage-web
npm install

预期：依赖安装成功，无错误

步骤 2：构建项目

npm run build

预期：构建成功，生成 dist/ 目录

任务 2.5：提交阶段 2 的变更

文件：

无文件修改，仅提交
步骤 1：查看变更状态

git status

预期：显示所有修改的文件

步骤 2：提交变更

git add .
git commit -m "refactor(frontend): 重命名前端项目为 gym-manage-web"

预期：提交成功

阶段 3：测试文件迁移（e2e-tests）

任务 3.1：创建 e2e-tests 目录结构

文件：

mkdir -p e2e-tests

运行：ls -la | grep e2e-tests 预期：显示 e2e-tests 目录

任务 3.2：迁移测试用例目录

文件：

迁移：gym-manage-web/e2e/ → e2e-tests/e2e/
步骤 1：使用 Git 迁移测试用例目录

git mv gym-manage-web/e2e e2e-tests/e2e

步骤 2：验证迁移结果

运行：ls -la e2e-tests/ 预期：显示 e2e 目录

任务 3.3：迁移 Playwright 配置目录

文件：

迁移：gym-manage-web/playwright/ → e2e-tests/playwright/
步骤 1：使用 Git 迁移 Playwright 配置目录

git mv gym-manage-web/playwright e2e-tests/playwright

步骤 2：验证迁移结果

运行：ls -la e2e-tests/ 预期：显示 playwright 目录

任务 3.4：迁移测试脚本目录

文件：

迁移：gym-manage-web/scripts/ → e2e-tests/scripts/
步骤 1：使用 Git 迁移测试脚本目录

git mv gym-manage-web/scripts e2e-tests/scripts

步骤 2：验证迁移结果

运行：ls -la e2e-tests/ 预期：显示 scripts 目录

任务 3.5：迁移 Playwright 配置文件

文件：

迁移：gym-manage-web/playwright.config.ts → e2e-tests/playwright.config.ts
迁移：gym-manage-web/playwright-complete.config.ts → e2e-tests/playwright-complete.config.ts
迁移：gym-manage-web/playwright-simple.config.ts → e2e-tests/playwright-simple.config.ts
步骤 1：迁移主配置文件

git mv gym-manage-web/playwright.config.ts e2e-tests/

步骤 2：迁移完整配置文件

git mv gym-manage-web/playwright-complete.config.ts e2e-tests/

步骤 3：迁移简化配置文件

git mv gym-manage-web/playwright-simple.config.ts e2e-tests/

步骤 4：验证迁移结果

运行：ls -la e2e-tests/*.ts 预期：显示三个配置文件

任务 3.6：创建 e2e-tests 的 package.json

文件：

创建：e2e-tests/package.json
步骤 1：创建 package.json 文件

创建 e2e-tests/package.json：

{
  "name": "gym-manage-e2e-tests",
  "version": "1.0.0",
  "description": "Gym Management System E2E Tests",
  "type": "module",
  "scripts": {
    "test:e2e": "playwright test",
    "test:e2e:smoke": "playwright test --project=smoke",
    "test:e2e:journeys": "playwright test --project=journeys",
    "test:e2e:headed": "playwright test --headed",
    "test:e2e:debug": "playwright test --debug",
    "test:e2e:perf": "node scripts/measure-e2e-performance.js",
    "test:perf": "node scripts/performance-test.js performance",
    "test:load": "node scripts/performance-test.js load",
    "test:perf:all": "node scripts/performance-test.js all"
  },
  "devDependencies": {
    "@playwright/test": "^1.40.1",
    "@types/node": "^20.10.0",
    "typescript": "^5.9.3"
  }
}

任务 3.7：删除根目录的 package.json

文件：

删除：package.json（根目录）
步骤 1：删除根目录的 package.json

git rm package.json

步骤 2：验证删除结果

运行：ls -la | grep package.json 预期：无输出（根目录无 package.json）

任务 3.8：更新 Playwright 配置文件路径

文件：

修改：e2e-tests/playwright.config.ts
步骤 1：检查当前配置

运行：head -20 e2e-tests/playwright.config.ts 预期：查看当前配置内容

步骤 2：确认 baseURL 配置正确

确保 e2e-tests/playwright.config.ts 中的 baseURL 指向前端服务：

use: {
  baseURL: 'http://localhost:3001',
}

任务 3.9：验证测试运行

文件：

无文件修改，仅验证
步骤 1：安装测试依赖

cd e2e-tests
npm install

预期：依赖安装成功

步骤 2：运行冒烟测试

npm run test:e2e:smoke

预期：测试运行正常（可能失败，因为需要前端服务运行）

任务 3.10：提交阶段 3 的变更

文件：

无文件修改，仅提交
步骤 1：查看变更状态

git status

预期：显示所有修改的文件

步骤 2：提交变更

git add .
git commit -m "refactor(test): 创建独立的 e2e-tests 目录，迁移测试文件"

预期：提交成功

阶段 4：创建 UniApp 项目（gym-manage-uniapp）

任务 4.1：创建 UniApp 项目目录结构

文件：

创建：gym-manage-uniapp/ 及其子目录
步骤 1：创建项目根目录和主要子目录

mkdir -p gym-manage-uniapp/src/{pages/{index,login},components,api,store,utils,static}

运行：tree gym-manage-uniapp -L 3 预期：显示完整的目录结构

任务 4.2：创建 package.json

文件：

创建：gym-manage-uniapp/package.json
步骤 1：创建 package.json 文件

创建 gym-manage-uniapp/package.json：

{
  "name": "gym-manage-uniapp",
  "version": "1.0.0",
  "description": "Gym Management System Mobile App",
  "type": "module",
  "scripts": {
    "dev:h5": "uni -p h5",
    "build:h5": "uni build -p h5",
    "dev:mp-weixin": "uni -p mp-weixin",
    "build:mp-weixin": "uni build -p mp-weixin",
    "dev:app": "uni -p app",
    "build:app": "uni build -p app"
  },
  "dependencies": {
    "@dcloudio/uni-app": "3.0.0-4010520240507001",
    "@dcloudio/uni-app-plus": "3.0.0-4010520240507001",
    "@dcloudio/uni-components": "3.0.0-4010520240507001",
    "@dcloudio/uni-h5": "3.0.0-4010520240507001",
    "@dcloudio/uni-mp-weixin": "3.0.0-4010520240507001",
    "pinia": "^3.0.4",
    "vue": "^3.5.26"
  },
  "devDependencies": {
    "@dcloudio/types": "^3.4.8",
    "@dcloudio/uni-automator": "3.0.0-4010520240507001",
    "@dcloudio/uni-cli-shared": "3.0.0-4010520240507001",
    "@dcloudio/uni-stacktracey": "3.0.0-4010520240507001",
    "@dcloudio/vite-plugin-uni": "3.0.0-4010520240507001",
    "@types/node": "^20.10.0",
    "typescript": "^5.9.3",
    "vite": "^7.3.1"
  }
}

任务 4.3：创建 TypeScript 配置

文件：

创建：gym-manage-uniapp/tsconfig.json
步骤 1：创建 tsconfig.json 文件

创建 gym-manage-uniapp/tsconfig.json：

{
  "compilerOptions": {
    "target": "ESNext",
    "useDefineForClassFields": true,
    "module": "ESNext",
    "moduleResolution": "Node",
    "strict": true,
    "jsx": "preserve",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "esModuleInterop": true,
    "lib": ["ESNext", "DOM"],
    "skipLibCheck": true,
    "noEmit": true,
    "paths": {
      "@/*": ["./src/*"]
    },
    "types": [
      "@dcloudio/types"
    ]
  },
  "include": [
    "src/**/*.ts",
    "src/**/*.d.ts",
    "src/**/*.tsx",
    "src/**/*.vue"
  ],
  "exclude": [
    "node_modules",
    "dist",
    "unpackage"
  ]
}

任务 4.4：创建 Vite 配置

文件：

创建：gym-manage-uniapp/vite.config.ts
步骤 1：创建 vite.config.ts 文件

创建 gym-manage-uniapp/vite.config.ts：

import { defineConfig } from 'vite'
import uni from '@dcloudio/vite-plugin-uni'
import { resolve } from 'path'

export default defineConfig({
  plugins: [uni()],
  resolve: {
    alias: {
      '@': resolve(__dirname, 'src')
    }
  },
  server: {
    port: 3002,
    host: '0.0.0.0',
    proxy: {
      '/api': {
        target: 'http://localhost:8084',
        changeOrigin: true
      }
    }
  }
})

任务 4.5：创建 UniApp 应用配置

文件：

创建：gym-manage-uniapp/src/manifest.json
步骤 1：创建 manifest.json 文件

创建 gym-manage-uniapp/src/manifest.json：

{
  "name": "健身房管理系统",
  "appid": "",
  "description": "健身房管理移动端应用",
  "versionName": "1.0.0",
  "versionCode": "100",
  "transformPx": false,
  "app-plus": {
    "usingComponents": true,
    "nvueStyleCompiler": "uni-app",
    "compilerVersion": 3,
    "splashscreen": {
      "alwaysShowBeforeRender": true,
      "waiting": true,
      "autoclose": true,
      "delay": 0
    },
    "modules": {},
    "distribute": {
      "android": {
        "permissions": []
      },
      "ios": {},
      "sdkConfigs": {}
    }
  },
  "quickapp": {},
  "mp-weixin": {
    "appid": "",
    "setting": {
      "urlCheck": false
    },
    "usingComponents": true
  },
  "mp-alipay": {
    "usingComponents": true
  },
  "mp-baidu": {
    "usingComponents": true
  },
  "mp-toutiao": {
    "usingComponents": true
  },
  "uniStatistics": {
    "enable": false
  },
  "h5": {
    "title": "健身房管理系统",
    "router": {
      "mode": "hash",
      "base": "./"
    }
  }
}

任务 4.6：创建 UniApp 页面配置

文件：

创建：gym-manage-uniapp/src/pages.json
步骤 1：创建 pages.json 文件

创建 gym-manage-uniapp/src/pages.json：

{
  "pages": [
    {
      "path": "pages/index/index",
      "style": {
        "navigationBarTitleText": "首页"
      }
    },
    {
      "path": "pages/login/index",
      "style": {
        "navigationBarTitleText": "登录"
      }
    }
  ],
  "globalStyle": {
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "健身房管理",
    "navigationBarBackgroundColor": "#F8F8F8",
    "backgroundColor": "#F8F8F8"
  },
  "tabBar": {
    "color": "#7A7E83",
    "selectedColor": "#007AFF",
    "borderStyle": "black",
    "backgroundColor": "#F8F8F8",
    "list": [
      {
        "pagePath": "pages/index/index",
        "text": "首页"
      }
    ]
  }
}

任务 4.7：创建应用入口文件

文件：

创建：gym-manage-uniapp/src/main.ts
创建：gym-manage-uniapp/src/App.vue
步骤 1：创建 main.ts 文件

创建 gym-manage-uniapp/src/main.ts：

import { createSSRApp } from 'vue'
import { createPinia } from 'pinia'
import App from './App.vue'

export function createApp() {
  const app = createSSRApp(App)
  const pinia = createPinia()
  
  app.use(pinia)
  
  return {
    app,
    pinia
  }
}

步骤 2：创建 App.vue 文件

创建 gym-manage-uniapp/src/App.vue：

<script setup lang="ts">
import { onLaunch, onShow, onHide } from '@dcloudio/uni-app'

onLaunch(() => {
  console.log('App Launch')
})

onShow(() => {
  console.log('App Show')
})

onHide(() => {
  console.log('App Hide')
})
</script>

<style>
/* 全局样式 */
page {
  background-color: #f8f8f8;
}
</style>

任务 4.8：创建首页组件

文件：

创建：gym-manage-uniapp/src/pages/index/index.vue
步骤 1：创建首页组件文件

创建 gym-manage-uniapp/src/pages/index/index.vue：

<template>
  <view class="container">
    <view class="header">
      <text class="title">健身房管理系统</text>
      <text class="subtitle">移动端应用</text>
    </view>
    
    <view class="content">
      <text class="description">欢迎使用健身房管理系统移动端应用</text>
    </view>
  </view>
</template>

<script setup lang="ts">
import { ref } from 'vue'

const title = ref('健身房管理系统')
</script>

<style scoped>
.container {
  display: flex;
  flex-direction: column;
  align-items: center;
  padding: 40rpx;
}

.header {
  text-align: center;
  margin-bottom: 60rpx;
}

.title {
  font-size: 48rpx;
  font-weight: bold;
  color: #333;
  display: block;
  margin-bottom: 20rpx;
}

.subtitle {
  font-size: 28rpx;
  color: #666;
  display: block;
}

.content {
  text-align: center;
}

.description {
  font-size: 32rpx;
  color: #999;
}
</style>

任务 4.9：创建登录页组件

文件：

创建：gym-manage-uniapp/src/pages/login/index.vue
步骤 1：创建登录页组件文件

创建 gym-manage-uniapp/src/pages/login/index.vue：

<template>
  <view class="login-container">
    <view class="login-header">
      <text class="login-title">健身房管理系统</text>
    </view>
    
    <view class="login-form">
      <view class="form-item">
        <input 
          class="input" 
          type="text" 
          v-model="username" 
          placeholder="请输入用户名"
        />
      </view>
      
      <view class="form-item">
        <input 
          class="input" 
          type="password" 
          v-model="password" 
          placeholder="请输入密码"
        />
      </view>
      
      <button class="login-btn" @click="handleLogin">登录</button>
    </view>
  </view>
</template>

<script setup lang="ts">
import { ref } from 'vue'

const username = ref('')
const password = ref('')

const handleLogin = () => {
  console.log('登录:', username.value, password.value)
  uni.showToast({
    title: '功能待实现',
    icon: 'none'
  })
}
</script>

<style scoped>
.login-container {
  display: flex;
  flex-direction: column;
  align-items: center;
  padding: 80rpx 40rpx;
}

.login-header {
  margin-bottom: 80rpx;
}

.login-title {
  font-size: 48rpx;
  font-weight: bold;
  color: #333;
}

.login-form {
  width: 100%;
}

.form-item {
  margin-bottom: 40rpx;
}

.input {
  width: 100%;
  height: 88rpx;
  padding: 0 30rpx;
  border: 1rpx solid #ddd;
  border-radius: 8rpx;
  font-size: 32rpx;
}

.login-btn {
  width: 100%;
  height: 88rpx;
  line-height: 88rpx;
  background-color: #007AFF;
  color: #fff;
  border: none;
  border-radius: 8rpx;
  font-size: 32rpx;
}
</style>

任务 4.10：创建 API 请求封装

文件：

创建：gym-manage-uniapp/src/api/request.ts
步骤 1：创建请求封装文件

创建 gym-manage-uniapp/src/api/request.ts：

const BASE_URL = 'http://localhost:8084/api'

interface RequestOptions {
  url: string
  method?: 'GET' | 'POST' | 'PUT' | 'DELETE'
  data?: any
  header?: Record<string, string>
}

interface Response<T = any> {
  code: number
  message: string
  data: T
}

export function request<T = any>(options: RequestOptions): Promise<Response<T>> {
  return new Promise((resolve, reject) => {
    uni.request({
      url: BASE_URL + options.url,
      method: options.method || 'GET',
      data: options.data,
      header: {
        'Content-Type': 'application/json',
        ...options.header
      },
      success: (res: any) => {
        if (res.statusCode === 200) {
          resolve(res.data as Response<T>)
        } else {
          reject(new Error(`请求失败: ${res.statusCode}`))
        }
      },
      fail: (err: any) => {
        reject(new Error(`网络错误: ${err.errMsg}`))
      }
    })
  })
}

export function get<T = any>(url: string, data?: any): Promise<Response<T>> {
  return request<T>({ url, method: 'GET', data })
}

export function post<T = any>(url: string, data?: any): Promise<Response<T>> {
  return request<T>({ url, method: 'POST', data })
}

export function put<T = any>(url: string, data?: any): Promise<Response<T>> {
  return request<T>({ url, method: 'PUT', data })
}

export function del<T = any>(url: string, data?: any): Promise<Response<T>> {
  return request<T>({ url, method: 'DELETE', data })
}

任务 4.11：创建 Pinia Store 配置

文件：

创建：gym-manage-uniapp/src/store/index.ts
创建：gym-manage-uniapp/src/store/user.ts
步骤 1：创建 store 入口文件

创建 gym-manage-uniapp/src/store/index.ts：

export * from './user'

步骤 2：创建用户状态管理文件

创建 gym-manage-uniapp/src/store/user.ts：

import { defineStore } from 'pinia'
import { ref } from 'vue'

export const useUserStore = defineStore('user', () => {
  const token = ref<string>('')
  const userInfo = ref<any>(null)
  const isLoggedIn = ref<boolean>(false)

  const setToken = (newToken: string) => {
    token.value = newToken
    isLoggedIn.value = !!newToken
    uni.setStorageSync('token', newToken)
  }

  const setUserInfo = (info: any) => {
    userInfo.value = info
    uni.setStorageSync('userInfo', info)
  }

  const logout = () => {
    token.value = ''
    userInfo.value = null
    isLoggedIn.value = false
    uni.removeStorageSync('token')
    uni.removeStorageSync('userInfo')
  }

  const init = () => {
    const savedToken = uni.getStorageSync('token')
    const savedUserInfo = uni.getStorageSync('userInfo')
    
    if (savedToken) {
      token.value = savedToken
      isLoggedIn.value = true
    }
    
    if (savedUserInfo) {
      userInfo.value = savedUserInfo
    }
  }

  return {
    token,
    userInfo,
    isLoggedIn,
    setToken,
    setUserInfo,
    logout,
    init
  }
})

任务 4.12：创建工具函数

文件：

创建：gym-manage-uniapp/src/utils/storage.ts
步骤 1：创建本地存储工具文件

创建 gym-manage-uniapp/src/utils/storage.ts：

export function setStorage(key: string, value: any): void {
  try {
    uni.setStorageSync(key, JSON.stringify(value))
  } catch (error) {
    console.error('存储数据失败:', error)
  }
}

export function getStorage<T = any>(key: string): T | null {
  try {
    const value = uni.getStorageSync(key)
    return value ? JSON.parse(value) : null
  } catch (error) {
    console.error('读取数据失败:', error)
    return null
  }
}

export function removeStorage(key: string): void {
  try {
    uni.removeStorageSync(key)
  } catch (error) {
    console.error('删除数据失败:', error)
  }
}

export function clearStorage(): void {
  try {
    uni.clearStorageSync()
  } catch (error) {
    console.error('清空存储失败:', error)
  }
}

任务 4.13：验证 UniApp 项目运行

文件：

无文件修改，仅验证
步骤 1：安装依赖

cd gym-manage-uniapp
npm install

预期：依赖安装成功

步骤 2：运行 H5 开发服务器

npm run dev:h5

预期：开发服务器启动成功，可在浏览器访问

任务 4.14：提交阶段 4 的变更

文件：

无文件修改，仅提交
步骤 1：查看变更状态

git status

预期：显示所有新创建的文件

步骤 2：提交变更

git add .
git commit -m "feat(mobile): 创建 gym-manage-uniapp 项目脚手架"

预期：提交成功

阶段 5：根目录整理与文档更新

任务 5.1：更新 docker-compose.yml

文件：

修改：docker-compose.yml
步骤 1：查看当前配置

运行：cat docker-compose.yml 预期：查看当前 Docker Compose 配置

步骤 2：更新服务名称和路径

根据实际配置，更新服务名称和卷挂载路径，确保引用新的项目目录名称。

任务 5.2：更新 Jenkinsfile

文件：

修改：Jenkinsfile
步骤 1：查看当前配置

运行：cat Jenkinsfile 预期：查看当前 Jenkins 配置

步骤 2：更新项目路径

根据实际配置，更新项目路径和构建命令，确保引用新的项目目录名称。

任务 5.3：更新 README.md

文件：

修改：README.md
步骤 1：更新项目名称和描述

修改 README.md 开头部分：

# 健身房管理系统

企业级健身房管理系统，包含会员管理、课程管理、教练管理、设备管理等核心功能。

## 项目结构

gym-manage/ ├── gym-manage-api/ # 后端 API 项目 │ ├── manage-gateway/ # API 网关服务 │ ├── manage-app/ # 主应用服务 │ ├── manage-sys/ # 系统管理模块 │ ├── manage-db/ # 数据库模块 │ ├── manage-common/ # 公共模块 │ ├── manage-audit/ # 审计模块 │ ├── manage-notify/ # 通知模块 │ └── manage-file/ # 文件管理模块 ├── gym-manage-web/ # 前端 Web 项目 ├── gym-manage-uniapp/ # 移动端 UniApp 项目 └── e2e-tests/ # E2E 测试

步骤 2：更新技术栈描述

更新技术栈部分，添加 UniApp 相关信息：

### 移动端

- UniApp + Vue 3
- TypeScript
- Pinia (状态管理)

任务 5.4：最终验证

文件：

无文件修改，仅验证
步骤 1：验证根目录结构

运行：ls -la 预期：只包含全局性文件和项目目录

步骤 2：验证后端服务

cd gym-manage-api
mvn clean compile

预期：编译成功

步骤 3：验证前端构建

cd gym-manage-web
npm run build

预期：构建成功

步骤 4：验证 UniApp 运行

cd gym-manage-uniapp
npm run dev:h5

预期：开发服务器启动成功

任务 5.5：提交阶段 5 的变更

文件：

无文件修改，仅提交
步骤 1：查看变更状态

git status

预期：显示所有修改的文件

步骤 2：提交变更

git add .
git commit -m "docs: 更新项目文档和全局配置"

预期：提交成功

任务 5.6：推送到远程仓库

文件：

无文件修改，仅推送
步骤 1：查看提交历史

git log --oneline -5

预期：显示最近 5 次提交

步骤 2：推送到远程仓库

git push origin HEAD

预期：推送成功

计划自检

1. 规格覆盖度检查

✅ 所有规格中的需求都有对应的任务：

后端项目重构：任务 1.1 - 1.16
前端项目重构：任务 2.1 - 2.5
测试文件迁移：任务 3.1 - 3.10
UniApp 项目创建：任务 4.1 - 4.14
根目录整理：任务 5.1 - 5.6

2. 占位符扫描

✅ 无占位符：

无"待定"、"TODO"、"后续实现"等词汇
所有步骤都有具体的代码或命令
所有文件路径都是精确的

3. 类型一致性

✅ 类型一致：

所有文件路径使用统一的命名规范
所有代码示例使用一致的语法
所有命令使用一致的格式

计划已完成。

38 KiB Raw Permalink Blame History Unescape Escape

健身房管理系统基础设施重构实现计划

文件结构

阶段 1：后端项目重构（gym-manage-api）

阶段 2：前端项目重构（gym-manage-web）

阶段 3：测试文件迁移（e2e-tests）

阶段 4：创建 UniApp 项目（gym-manage-uniapp）

阶段 5：根目录整理与文档更新

阶段 1：后端项目重构（gym-manage-api）

任务 1.1：重命名后端项目目录

任务 1.2：修改 Maven 父 POM 配置

任务 1.3：修改 manage-app 模块 POM 配置

任务 1.4：修改 manage-gateway 模块 POM 配置

任务 1.5：修改 manage-sys 模块 POM 配置

任务 1.6：修改 manage-db 模块 POM 配置

任务 1.7：修改 manage-common 模块 POM 配置

任务 1.8：修改 manage-audit 模块 POM 配置

任务 1.9：修改 manage-notify 模块 POM 配置

任务 1.10：修改 manage-file 模块 POM 配置

任务 1.11：重命名 Java 包目录结构

任务 1.12：批量更新 Java 文件的 package 声明

任务 1.13：批量更新 Java 文件的 import 语句

任务 1.14：更新 Spring Boot 配置文件

任务 1.15：验证后端项目编译

任务 1.16：提交阶段 1 的变更

阶段 2：前端项目重构（gym-manage-web）

任务 2.1：重命名前端项目目录

任务 2.2：修改 package.json 配置

任务 2.3：修改 index.html 页面标题

任务 2.4：验证前端项目构建

任务 2.5：提交阶段 2 的变更

阶段 3：测试文件迁移（e2e-tests）

任务 3.1：创建 e2e-tests 目录结构

任务 3.2：迁移测试用例目录

任务 3.3：迁移 Playwright 配置目录

任务 3.4：迁移测试脚本目录

任务 3.5：迁移 Playwright 配置文件

任务 3.6：创建 e2e-tests 的 package.json

任务 3.7：删除根目录的 package.json

任务 3.8：更新 Playwright 配置文件路径

任务 3.9：验证测试运行

任务 3.10：提交阶段 3 的变更

阶段 4：创建 UniApp 项目（gym-manage-uniapp）

任务 4.1：创建 UniApp 项目目录结构

任务 4.2：创建 package.json

任务 4.3：创建 TypeScript 配置

任务 4.4：创建 Vite 配置

任务 4.5：创建 UniApp 应用配置

任务 4.6：创建 UniApp 页面配置

任务 4.7：创建应用入口文件

任务 4.8：创建首页组件

任务 4.9：创建登录页组件

任务 4.10：创建 API 请求封装

任务 4.11：创建 Pinia Store 配置

任务 4.12：创建工具函数

任务 4.13：验证 UniApp 项目运行

任务 4.14：提交阶段 4 的变更

阶段 5：根目录整理与文档更新

任务 5.1：更新 docker-compose.yml

任务 5.2：更新 Jenkinsfile

任务 5.3：更新 README.md

任务 5.4：最终验证

任务 5.5：提交阶段 5 的变更

任务 5.6：推送到远程仓库

计划自检

1. 规格覆盖度检查

2. 占位符扫描

3. 类型一致性

38 KiB

Raw Permalink Blame History