张翔
971d51cb36
PRD更新： - 新增2.6 UI模版定制模块 - 包含品牌定制、布局调整、预设模板、配置历史、可视化配置器五个子模块 - 每个子模块包含功能描述、用户故事、功能点、业务规则、验收标准 HLD更新： - 业务范围中新增UI模版定制模块 - 新增3.5 UI模版定制流程（业务场景、业务流程、业务规则、异常处理） - 新增4.6 UI模版定制规则（品牌元素应用、Logo格式限制、颜色格式限制等8条规则） LLD更新： - 新增2.6 UI模版定制模块（模块概述、数据模型设计、核心业务逻辑） - 数据模型包含4个表：tenant_ui_config、ui_template、ui_config_history、ui_resource - 核心业务逻辑包含4个Service：BrandConfigService、LayoutConfigService、TemplateService、ConfigHistoryService - 新增3.5 UI模版定制模块API（10个API接口，涵盖品牌定制、布局调整、模板管理、配置历史） 所有文档已保持一致性，UI模版定制功能已完整同步到产品需求、概要设计、详细设计文档中
健身房管理系统 POC
项目简介
本项目是健身房管理系统的概念验证(POC)，采用响应式架构(Spring WebFlux + R2DBC)实现，旨在验证技术方案的可行性和性能指标。
技术栈
- 框架: Spring Boot 3.2.3
- 响应式Web: Spring WebFlux
- 响应式数据访问: Spring Data R2DBC
- 数据库: PostgreSQL 16.x
- 数据库驱动: R2DBC PostgreSQL 1.0.5.RELEASE
- 对象映射: MapStruct 1.5.5.Final
- 代码简化: Lombok 1.18.30
- API文档: SpringDoc OpenAPI 2.3.0
- 测试: JUnit 5, Reactor Test, Testcontainers
项目结构
gym-manage/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/gym/manage/
│ │ │ ├── api/ # API层
│ │ │ ├── application/ # 应用层
│ │ │ ├── domain/ # 领域层
│ │ │ ├── infrastructure/ # 基础设施层
│ │ │ └── common/ # 公共模块
│ │ └── resources/
│ │ ├── application.yml
│ │ └── schema.sql
│ └── test/
│ └── java/
└── pom.xml
快速开始
前置条件
- JDK 17+
- Maven 3.9+
- PostgreSQL 16+
数据库准备
CREATE DATABASE gym_manage;
运行项目
mvn clean install
mvn spring-boot:run
访问API文档
- Swagger UI: http://localhost:8080/swagger-ui.html
- OpenAPI JSON: http://localhost:8080/v3/api-docs
核心模块
会员模块
- 会员注册、查询、更新
- 会员卡管理
预约模块
- 团课预约
- 私教预约
- 时段管理
签到模块
- 扫码签到
- 签到记录查询
权益模块
- 权益管理
- 权益扣减
订阅模块
- 模块订阅
- 计费管理
营销模块
- 营销活动管理
- 推荐奖励
数据分析模块
- 统计报表
- 数据概览
性能目标
- 并发连接数: ≥ 1000
- API响应时间(P99): < 500ms
- 吞吐量(QPS): ≥ 3000
- 内存占用: < 1GB
- CPU利用率: < 60%
测试
mvn test
文档
许可证
MIT License
联系方式
- 技术负责人: 张翔
- 邮箱: zhangxiang@example.com