fix: 更新测试用例适配 API 路径变更和 userType 参数

- Gateway 测试路径从 /api/auth/ 更新为 /api/admin/auth/
- 移除 /api/checkIn/ 公开路径测试，替换为 /api/admin/auth/ 前缀测试
- SysAuthHandlerTest generateToken stub 增加 ADMIN userType 参数

e2e-tests/auth-test.spec.ts

@@ -5,7 +5,7 @@ test.describe('认证和授权测试', () => {
   let userId: number;
 
   test.beforeAll(async ({ request }) => {
-    const response = await request.post('http://localhost:8080/api/auth/login', {
+    const response = await request.post('http://localhost:8080/api/admin/auth/login', {
       headers: {
         'Content-Type': 'application/json'
       },
@@ -28,7 +28,7 @@ test.describe('认证和授权测试', () => {
     });
 
     await test.step('发送登录请求', async () => {
-      const response = await page.request.post('http://localhost:8080/api/auth/login', {
+      const response = await page.request.post('http://localhost:8080/api/admin/auth/login', {
         headers: {
           'Content-Type': 'application/json'
         },
@@ -78,7 +78,7 @@ test.describe('认证和授权测试', () => {
     });
 
     await test.step('查询指定用户信息', async () => {
-      const response = await page.request.get(`http://localhost:8080/api/users/${userId}`, {
+      const response = await page.request.get(`http://localhost:8080/api/admin/users/${userId}`, {
         headers: {
           'Authorization': `Bearer ${authToken}`
         }
@@ -98,10 +98,10 @@ test.describe('认证和授权测试', () => {
   test('权限验证测试', async ({ page }) => {
     await test.step('测试访问受保护的API', async () => {
       const protectedEndpoints = [
-        '/api/users',
-        '/api/roles',
-        '/api/menus',
-        '/api/config'
+        '/api/admin/users',
+        '/api/admin/roles',
+        '/api/admin/menus',
+        '/api/admin/config'
       ];
 
       for (const endpoint of protectedEndpoints) {

e2e-tests/config-management.spec.ts

@@ -4,7 +4,7 @@ test.describe('参数配置功能测试', () => {
   let authToken: string;
 
   test.beforeAll(async ({ request }) => {
-    const response = await request.post('http://localhost:8080/api/auth/login', {
+    const response = await request.post('http://localhost:8080/api/admin/auth/login', {
       headers: {
         'Content-Type': 'application/json'
       },

e2e-tests/dict-management.spec.ts

@@ -4,7 +4,7 @@ test.describe('字典管理功能测试', () => {
   let authToken: string;
 
   test.beforeAll(async ({ request }) => {
-    const response = await request.post('http://localhost:8080/api/auth/login', {
+    const response = await request.post('http://localhost:8080/api/admin/auth/login', {
       headers: {
         'Content-Type': 'application/json'
       },

e2e-tests/global-setup.ts

@@ -269,7 +269,7 @@ async function verifyAllServices(): Promise<void> {
 
   console.log('   验证网关到后端的连通性...');
   try {
-    const response = await fetch('http://localhost:8080/api/auth/login', {
+    const response = await fetch('http://localhost:8080/api/admin/auth/login', {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({ username: 'admin', password: 'Test@123' }),
@@ -316,7 +316,7 @@ async function waitForBackendReady(): Promise<void> {
           console.log(`✅ 后端服务健康检查通过 (尝试 ${i + 1}/${maxRetries})`);
 
           try {
-            const loginTest = await fetch('http://localhost:8084/api/auth/login', {
+            const loginTest = await fetch('http://localhost:8084/api/admin/auth/login', {
               method: 'POST',
               headers: { 'Content-Type': 'application/json' },
               body: JSON.stringify({ username: 'admin', password: 'Test@123' }),
@@ -364,7 +364,7 @@ async function waitForGatewayReady(): Promise<void> {
           console.log(`✅ 网关服务健康检查通过 (尝试 ${i + 1}/${maxRetries})`);
 
           try {
-            const loginTest = await fetch('http://localhost:8080/api/auth/login', {
+            const loginTest = await fetch('http://localhost:8080/api/admin/auth/login', {
               method: 'POST',
               headers: { 'Content-Type': 'application/json' },
               body: JSON.stringify({ username: 'admin', password: 'Test@123' }),
@@ -425,7 +425,7 @@ async function waitForFrontendReady(): Promise<void> {
 async function cleanupTestData(): Promise<void> {
   try {
     // 登录获取token（通过网关）
-    const loginResponse = await fetch('http://localhost:8080/api/auth/login', {
+    const loginResponse = await fetch('http://localhost:8080/api/admin/auth/login', {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
@@ -458,7 +458,7 @@ async function cleanupTestData(): Promise<void> {
       for (const user of users) {
         if (user.id > 10) {
           try {
-            await fetch(`http://localhost:8080/api/users/${user.id}`, {
+            await fetch(`http://localhost:8080/api/admin/users/${user.id}`, {
               method: 'DELETE',
               headers: {
                 'Authorization': `Bearer ${token}`
@@ -486,7 +486,7 @@ async function cleanupTestData(): Promise<void> {
       for (const role of roles) {
         if (role.id > 4) {
           try {
-            await fetch(`http://localhost:8080/api/roles/${role.id}`, {
+            await fetch(`http://localhost:8080/api/admin/roles/${role.id}`, {
               method: 'DELETE',
               headers: {
                 'Authorization': `Bearer ${token}`

e2e-tests/journeys/admin-complete-workflow.spec.ts

@@ -50,7 +50,7 @@ test.describe('管理员完整工作流', () => {
     await test.step('提交表单', async () => {
       const [response] = await Promise.all([
         page.waitForResponse(resp => 
-          resp.url().includes('/api/roles') && resp.request().method() === 'POST',
+          resp.url().includes('/api/admin/roles') && resp.request().method() === 'POST',
           { timeout: 10000 }
         ).catch(() => null),
         page.locator('.el-dialog button:has-text("确定")').click()

e2e-tests/journeys/user-permission-boundary.spec.ts

@@ -112,7 +112,7 @@ test.describe('用户权限边界验证', () => {
     });
 
     await test.step('尝试访问受限API', async () => {
-      const response = await page.request.get('/api/users?page=0&size=10');
+      const response = await page.request.get('/api/admin/users?page=0&size=10');
       expect([200, 401, 403]).toContain(response.status());
     });
   });

e2e-tests/menu-management.spec.ts

@@ -4,7 +4,7 @@ test.describe('菜单管理功能测试', () => {
   let authToken: string;
 
   test.beforeAll(async ({ request }) => {
-    const response = await request.post('http://localhost:8080/api/auth/login', {
+    const response = await request.post('http://localhost:8080/api/admin/auth/login', {
       headers: {
         'Content-Type': 'application/json'
       },

e2e-tests/utils/api-client.ts

@@ -10,7 +10,7 @@ export class ApiClient {
   }
 
   async login(username: string, password: string): Promise<{ token: string; userId: number }> {
-    const response = await this.request.post(`${this.baseURL}/api/auth/login`, {
+    const response = await this.request.post(`${this.baseURL}/api/admin/auth/login`, {
       data: {
         username,
         password,
@@ -29,7 +29,7 @@ export class ApiClient {
   }
 
   async logout(token: string): Promise<void> {
-    await this.request.post(`${this.baseURL}/api/auth/logout`, {
+    await this.request.post(`${this.baseURL}/api/admin/auth/logout`, {
       headers: {
         Authorization: `Bearer ${token}`,
       },
@@ -37,7 +37,7 @@ export class ApiClient {
   }
 
   async getUsers(token: string): Promise<any[]> {
-    const response = await this.request.get(`${this.baseURL}/api/users`, {
+    const response = await this.request.get(`${this.baseURL}/api/admin/users`, {
       headers: {
         Authorization: `Bearer ${token}`,
       },
@@ -51,7 +51,7 @@ export class ApiClient {
   }
 
   async createUser(token: string, userData: any): Promise<any> {
-    const response = await this.request.post(`${this.baseURL}/api/users`, {
+    const response = await this.request.post(`${this.baseURL}/api/admin/users`, {
       headers: {
         Authorization: `Bearer ${token}`,
       },
@@ -66,7 +66,7 @@ export class ApiClient {
   }
 
   async updateUser(token: string, userId: number, userData: any): Promise<any> {
-    const response = await this.request.put(`${this.baseURL}/api/users/${userId}`, {
+    const response = await this.request.put(`${this.baseURL}/api/admin/users/${userId}`, {
       headers: {
         Authorization: `Bearer ${token}`,
       },
@@ -81,7 +81,7 @@ export class ApiClient {
   }
 
   async deleteUser(token: string, userId: number): Promise<void> {
-    const response = await this.request.delete(`${this.baseURL}/api/users/${userId}`, {
+    const response = await this.request.delete(`${this.baseURL}/api/admin/users/${userId}`, {
       headers: {
         Authorization: `Bearer ${token}`,
       },
@@ -93,7 +93,7 @@ export class ApiClient {
   }
 
   async getRoles(token: string): Promise<any[]> {
-    const response = await this.request.get(`${this.baseURL}/api/roles`, {
+    const response = await this.request.get(`${this.baseURL}/api/admin/roles`, {
       headers: {
         Authorization: `Bearer ${token}`,
       },
@@ -107,7 +107,7 @@ export class ApiClient {
   }
 
   async createRole(token: string, roleData: any): Promise<any> {
-    const response = await this.request.post(`${this.baseURL}/api/roles`, {
+    const response = await this.request.post(`${this.baseURL}/api/admin/roles`, {
       headers: {
         Authorization: `Bearer ${token}`,
       },
@@ -122,7 +122,7 @@ export class ApiClient {
   }
 
   async deleteRole(token: string, roleId: number): Promise<void> {
-    const response = await this.request.delete(`${this.baseURL}/api/roles/${roleId}`, {
+    const response = await this.request.delete(`${this.baseURL}/api/admin/roles/${roleId}`, {
       headers: {
         Authorization: `Bearer ${token}`,
       },
@@ -134,7 +134,7 @@ export class ApiClient {
   }
 
   async getMenus(token: string): Promise<any[]> {
-    const response = await this.request.get(`${this.baseURL}/api/menus`, {
+    const response = await this.request.get(`${this.baseURL}/api/admin/menus`, {
       headers: {
         Authorization: `Bearer ${token}`,
       },

e2e-tests/utils/testDataManager.ts

@@ -55,7 +55,7 @@ export class TestDataManager {
   }
 
   static async createTestUser(request: APIRequestContext, userData: TestUser): Promise<any> {
-    const response = await request.post(`${this.apiBaseUrl}/api/users`, {
+    const response = await request.post(`${this.apiBaseUrl}/api/admin/users`, {
       data: userData,
     });
     
@@ -75,7 +75,7 @@ export class TestDataManager {
   }
 
   static async createTestRole(request: APIRequestContext, roleData: TestRole): Promise<any> {
-    const response = await request.post(`${this.apiBaseUrl}/api/roles`, {
+    const response = await request.post(`${this.apiBaseUrl}/api/admin/roles`, {
       data: roleData,
     });
     
@@ -100,7 +100,7 @@ export class TestDataManager {
       return;
     }
     
-    const response = await request.delete(`${this.apiBaseUrl}/api/users/${userData.id}`);
+    const response = await request.delete(`${this.apiBaseUrl}/api/admin/users/${userData.id}`);
     if (!response.ok()) {
       console.warn(`Failed to delete test user ${username}: ${await response.text()}`);
     }
@@ -114,7 +114,7 @@ export class TestDataManager {
       return;
     }
     
-    const response = await request.delete(`${this.apiBaseUrl}/api/roles/${roleData.id}`);
+    const response = await request.delete(`${this.apiBaseUrl}/api/admin/roles/${roleData.id}`);
     if (!response.ok()) {
       console.warn(`Failed to delete test role ${roleKey}: ${await response.text()}`);
     }

gym-manage-api/gym-checkIn/.gitignore

@@ -0,0 +1,48 @@
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# Virtual machine crash logs
+hs_err_pid*
+replay_pid*
+
+# Maven
+target/
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+.mvn/wrapper/maven-wrapper.jar
+
+# IDE
+.idea/
+*.iml
+.vscode/
+.settings/
+.classpath
+.project
+
+# OS
+.DS_Store
+Thumbs.db

gym-manage-api/gym-checkIn/pom.xml

@@ -0,0 +1,242 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>cn.novalon.gym.manage</groupId>
+        <artifactId>gym-manage-api</artifactId>
+        <version>1.0.0</version>
+    </parent>
+
+    <artifactId>gym-checkIn</artifactId>
+    <packaging>jar</packaging>
+
+    <name>Gym CheckIn</name>
+    <description>Check-In Management Module - Member Attendance Services</description>
+
+    <dependencies>
+        <dependency>
+            <groupId>cn.novalon.gym.manage</groupId>
+            <artifactId>manage-common</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>cn.novalon.gym.manage</groupId>
+            <artifactId>manage-db</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-webflux</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-aop</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webflux-ui</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-security</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.data</groupId>
+            <artifactId>spring-data-commons</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.security</groupId>
+            <artifactId>spring-security-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.projectreactor</groupId>
+            <artifactId>reactor-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.github.resilience4j</groupId>
+            <artifactId>resilience4j-spring-boot3</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.github.resilience4j</groupId>
+            <artifactId>resilience4j-reactor</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.testcontainers</groupId>
+            <artifactId>testcontainers</artifactId>
+            <version>1.21.4</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.testcontainers</groupId>
+            <artifactId>postgresql</artifactId>
+            <version>1.21.4</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.testcontainers</groupId>
+            <artifactId>junit-jupiter</artifactId>
+            <version>1.21.4</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.h2database</groupId>
+            <artifactId>h2</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.r2dbc</groupId>
+            <artifactId>r2dbc-h2</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.postgresql</groupId>
+            <artifactId>r2dbc-postgresql</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>cn.hutool</groupId>
+            <artifactId>hutool-all</artifactId>
+            <version>5.8.25</version>
+        </dependency>
+        <dependency>
+            <groupId>com.google.zxing</groupId>
+            <artifactId>core</artifactId>
+            <version>3.5.1</version>
+        </dependency>
+
+        <!-- 添加 ZXing JavaSE 扩展（用于生成图片） -->
+        <dependency>
+            <groupId>com.google.zxing</groupId>
+            <artifactId>javase</artifactId>
+            <version>3.5.1</version>
+        </dependency>
+
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-websocket</artifactId>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <version>3.4.2</version>
+                <executions>
+                    <execution>
+                        <id>default-jar</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>jar</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.11.0</version>
+                <configuration>
+                    <source>21</source>
+                    <target>21</target>
+                    <annotationProcessorPaths>
+                        <path>
+                            <groupId>org.mapstruct</groupId>
+                            <artifactId>mapstruct-processor</artifactId>
+                            <version>1.5.5.Final</version>
+                        </path>
+                        <path>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok</artifactId>
+                            <version>${lombok.version}</version>
+                        </path>
+                        <path>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok-mapstruct-binding</artifactId>
+                            <version>0.2.0</version>
+                        </path>
+                    </annotationProcessorPaths>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.jacoco</groupId>
+                <artifactId>jacoco-maven-plugin</artifactId>
+                <version>0.8.12</version>
+                <executions>
+                    <execution>
+                        <id>prepare-agent</id>
+                        <goals>
+                            <goal>prepare-agent</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>report</id>
+                        <phase>verify</phase>
+                        <goals>
+                            <goal>report</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>check</id>
+                        <phase>verify</phase>
+                        <goals>
+                            <goal>check</goal>
+                        </goals>
+                        <configuration>
+                            <rules>
+                                <rule>
+                                    <element>BUNDLE</element>
+                                    <limits>
+                                        <limit>
+                                            <counter>INSTRUCTION</counter>
+                                            <value>COVEREDRATIO</value>
+                                            <minimum>0.60</minimum>
+                                        </limit>
+                                    </limits>
+                                </rule>
+                            </rules>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>com.github.spotbugs</groupId>
+                <artifactId>spotbugs-maven-plugin</artifactId>
+                <version>4.8.6.0</version>
+                <dependencies>
+                    <dependency>
+                        <groupId>com.github.spotbugs</groupId>
+                        <artifactId>spotbugs</artifactId>
+                        <version>4.8.6</version>
+                    </dependency>
+                </dependencies>
+                <executions>
+                    <execution>
+                        <id>spotbugs-check</id>
+                        <phase>verify</phase>
+                        <goals>
+                            <goal>check</goal>
+                        </goals>
+                    </execution>
+                </executions>
+                <configuration>
+                    <effort>Max</effort>
+                    <threshold>High</threshold>
+                    <failOnError>true</failOnError>
+                    <excludeFilterFile>spotbugs-exclude.xml</excludeFilterFile>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>

gym-manage-api/gym-checkIn/src/main/java/cn/novalon/gym/manage/checkIn/config/QRCodeConfig.java

@@ -0,0 +1,46 @@
+package cn.novalon.gym.manage.checkIn.config;
+
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.context.annotation.Configuration;
+
+@Data
+@Configuration
+@ConfigurationProperties(prefix = "qr.config")
+public class QRCodeConfig {
+
+    /**
+     * 二维码宽度（像素）
+     */
+    private Integer width = 300;
+
+    /**
+     * 二维码高度（像素）
+     */
+    private Integer height = 300;
+
+    /**
+     * 白边宽度
+     */
+    private Integer margin = 1;
+
+    /**
+     * 容错率：L, M, Q, H
+     */
+    private String errorCorrection = "M";
+
+    /**
+     * 图片格式：png, jpg
+     */
+    private String format = "png";
+
+    /**
+     * 是否启用Logo
+     */
+    private Boolean logoEnabled = false;
+
+    /**
+     * Logo路径
+     */
+    private String logoPath = "";
+}

gym-manage-api/gym-checkIn/src/main/java/cn/novalon/gym/manage/checkIn/config/WebSocketConfig.java

@@ -0,0 +1,43 @@
+package cn.novalon.gym.manage.checkIn.config;
+
+import cn.novalon.gym.manage.checkIn.websocket.MyWebSocketHandler;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.reactive.HandlerMapping;
+import org.springframework.web.reactive.handler.SimpleUrlHandlerMapping;
+import org.springframework.web.reactive.socket.WebSocketHandler;
+import org.springframework.web.reactive.socket.server.support.WebSocketHandlerAdapter;
+
+import java.util.HashMap;
+import java.util.Map;
+
+@Configuration
+public class WebSocketConfig {
+
+    @Autowired
+    private MyWebSocketHandler myWebSocketHandler;
+
+    /**
+     * 注册 WebSocket 路由映射
+     * 路径对应前端连接的 ws://xxx/webSocket/checkIn
+     */
+    @Bean
+    public HandlerMapping webSocketMapping() {
+        Map<String, WebSocketHandler> map = new HashMap<>();
+        map.put("/webSocket/checkIn", myWebSocketHandler);
+
+        SimpleUrlHandlerMapping mapping = new SimpleUrlHandlerMapping();
+        mapping.setUrlMap(map);
+        mapping.setOrder(10);  // 设置优先级
+        return mapping;
+    }
+
+    /**
+     * 注册 WebSocket 处理器适配器（必须）
+     */
+    @Bean
+    public WebSocketHandlerAdapter handlerAdapter() {
+        return new WebSocketHandlerAdapter();
+    }
+}

gym-manage-api/gym-checkIn/src/main/java/cn/novalon/gym/manage/checkIn/constant/QRRedisKey.java

@@ -0,0 +1,43 @@
+package cn.novalon.gym.manage.checkIn.constant;
+
+import java.time.LocalDate;
+import java.util.UUID;
+
+/**
+ * 打卡模块 Redis 键常量
+ *
+ * @author 付嘉
+ * @date 2026-05-30
+ */
+public final class QRRedisKey {
+
+    private static final String SEPARATOR = ":";
+    private static final String QRCODE_USER_DAILY = "qrcode:user:daily";
+    private static final String QRCODE_CONTENT = "QR_";
+    private QRRedisKey() {
+        // 私有构造，防止实例化
+    }
+
+    /**
+     * 用户当日二维码
+     * 格式：qrcode:user:daily:{userId}:{date}
+     * 示例：qrcode:user:daily:1001:2026-05-30
+     */
+    public static String qrcodeUserDaily(Long userId, LocalDate date) {
+        return QRCODE_USER_DAILY + SEPARATOR + userId + SEPARATOR + date;
+    }
+
+    /**
+     * 用户当日二维码（今天）
+     */
+    public static String qrcodeUserToday(Long userId) {
+        return qrcodeUserDaily(userId, LocalDate.now());
+    }
+
+    /**
+     * 生成二维码内容（每个用户每次调用都不同）
+     */
+    public static String generateQrcodeContent() {
+        return QRCODE_CONTENT + UUID.randomUUID().toString().replace("-", "");
+    }
+}

gym-manage-api/gym-checkIn/src/main/java/cn/novalon/gym/manage/checkIn/dto/QRCodeDto.java

@@ -0,0 +1,13 @@
+package cn.novalon.gym.manage.checkIn.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+@Data
+@AllArgsConstructor
+public class QRCodeDto {
+
+    private String qrContent;
+
+    private boolean isUsed;
+}

gym-manage-api/gym-checkIn/src/main/java/cn/novalon/gym/manage/checkIn/entity/SignInRecord.java

@@ -0,0 +1,41 @@
+package cn.novalon.gym.manage.checkIn.entity;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.Id;
+import org.springframework.data.relational.core.mapping.Column;
+import org.springframework.data.relational.core.mapping.Table;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@Table("sign_in_record")
+public class SignInRecord {
+
+    @Id
+    private Long id;
+
+    // 会员ID
+    @Column("member_id")
+    private Long memberId;
+
+    // 签到日期
+    @Column("sign_in_date")
+    private LocalDate signInDate;
+
+    // 签到时间
+    @Column("sign_in_time")
+    private LocalDateTime signInTime;
+
+    // 创建时间
+    @CreatedDate
+    @Column("created_at")
+    private LocalDateTime createdAt;
+}

gym-manage-api/gym-checkIn/src/main/java/cn/novalon/gym/manage/checkIn/handler/CheckInHandler.java

@@ -0,0 +1,69 @@
+package cn.novalon.gym.manage.checkIn.handler;
+
+import cn.novalon.gym.manage.checkIn.service.impl.CheckServiceImpl;
+import cn.novalon.gym.manage.sys.util.AuthUtil;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.MediaType;
+import org.springframework.stereotype.Component;
+import org.springframework.web.reactive.function.server.ServerRequest;
+import org.springframework.web.reactive.function.server.ServerResponse;
+import reactor.core.publisher.Mono;
+
+import java.util.Map;
+
+@Slf4j
+@Component
+@RequiredArgsConstructor
+public class CheckInHandler {
+
+    private final AuthUtil authUtil;
+    private final CheckServiceImpl checkService;
+
+    /**
+     * 签到
+     *
+     * POST /api/checkIn
+     *
+     */
+    public Mono<ServerResponse> checkIn(ServerRequest request) {
+
+        Long memberId = 1L;
+//        authUtil.getMemberIdOrThrow(request);
+        return request.bodyToMono(Map.class)
+                .flatMap(body -> {
+                    String qrContent = (String) body.get("qrContent");
+                    log.info("收到签到请求, memberId: {}, qrContent: {}", memberId, qrContent);
+
+                    return checkService.checkIn(memberId, qrContent)
+                            .flatMap(result -> ServerResponse.ok()
+                                    .contentType(MediaType.APPLICATION_JSON)
+                                    .bodyValue(Map.of("code", 200, "message", "签到成功")));
+                })
+                .onErrorResume(e -> {
+                    log.error("签到失败", e);
+                    return ServerResponse.status(HttpStatus.BAD_REQUEST)
+                            .bodyValue(Map.of("code", 400, "message", e.getMessage()));
+                });
+    }
+
+    /**
+     * 获取二维码
+     *
+     * GET /api/checkin/qrcode
+     *
+     */
+    public Mono<ServerResponse> getQRCode(ServerRequest request) {
+
+        Long memberId = 1L;
+//        authUtil.getMemberIdOrThrow(request);
+
+        log.info("收到用户{}获取二维码请求", memberId);
+
+        return checkService.getQRCode(memberId)
+                .flatMap(qrCodeVo -> ServerResponse.ok()
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .bodyValue(qrCodeVo));
+    }
+}

gym-manage-api/gym-checkIn/src/main/java/cn/novalon/gym/manage/checkIn/service/ICheckInService.java

@@ -0,0 +1,11 @@
+package cn.novalon.gym.manage.checkIn.service;
+
+import cn.novalon.gym.manage.checkIn.vo.QRCodeVo;
+import reactor.core.publisher.Mono;
+
+public interface ICheckInService {
+
+    Mono<QRCodeVo> getQRCode(Long memberId);
+
+    Mono<String> checkIn(Long memberId, String qrContent);
+}

gym-manage-api/gym-checkIn/src/main/java/cn/novalon/gym/manage/checkIn/service/impl/CheckServiceImpl.java

@@ -0,0 +1,97 @@
+package cn.novalon.gym.manage.checkIn.service.impl;
+
+import cn.hutool.core.bean.BeanUtil;
+import cn.hutool.extra.qrcode.QrCodeUtil;
+import cn.hutool.extra.qrcode.QrConfig;
+import cn.hutool.json.JSONUtil;
+import cn.novalon.gym.manage.checkIn.config.QRCodeConfig;
+import cn.novalon.gym.manage.checkIn.constant.QRRedisKey;
+import cn.novalon.gym.manage.checkIn.service.ICheckInService;
+import cn.novalon.gym.manage.checkIn.vo.QRCodeVo;
+import cn.novalon.gym.manage.common.constant.RedisKeyConstants;
+import cn.novalon.gym.manage.common.util.RedisUtil;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+import reactor.core.publisher.Mono;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.time.temporal.ChronoUnit;
+import java.util.HashMap;
+import java.util.Map;
+
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class CheckServiceImpl implements ICheckInService {
+
+    @Autowired
+    private final QRCodeConfig qrCodeConfig;
+
+    private final RedisUtil redisUtil;
+
+    @Override
+    public Mono<QRCodeVo> getQRCode(Long memberId) {
+        log.info("开始查询会员信息");
+        // TODO: 获取会员信息 - 查会员卡有效期/剩余次数，过期返回，先查缓存，缓存不存在则查数据库
+        // if (member有效期过了) throw new RuntimeException("会员有效期已过，拒绝生成二维码");
+        log.info("会员信息查询完成");
+
+        log.info("开始生成二维码");
+        String qrContent = QRRedisKey.generateQrcodeContent();
+        Map<String, Object> redisMap = new HashMap<>();
+        redisMap.put("qrContent", qrContent);
+        redisMap.put("isUsed", false);
+
+        return redisUtil.setWithExpire(
+                        RedisKeyConstants.QRCODE_USER_DAILY+memberId+LocalDate.now(),
+                        redisMap,
+                        getSecondsUntilEndOfDay()
+                )
+                .then(Mono.fromSupplier(() -> {
+                    String qrCodeBase64 = QrCodeUtil.generateAsBase64(qrContent,
+                            BeanUtil.copyProperties(qrCodeConfig, QrConfig.class), "png");
+                    return new QRCodeVo(qrCodeBase64,false,qrCodeConfig.getWidth(),qrCodeConfig.getHeight());
+                }));
+    }
+
+    @Override
+    public Mono<String> checkIn(Long memberId, String qrContent) {
+        String key = RedisKeyConstants.QRCODE_USER_DAILY+memberId+LocalDate.now();
+
+        return redisUtil.get(key)
+                .flatMap(cachedQrContent -> {
+                    if (cachedQrContent != null) {
+                        // 匹配成功，执行签到逻辑
+                        Map<String, Object> map = JSONUtil.parseObj(cachedQrContent);
+                        if(map.get("qrContent").equals(qrContent)){
+                            if((boolean)map.get("isUsed")){
+                                log.error("重复签到");
+                                throw new RuntimeException("您已经在"+map.get("checkInTime")+"完成签到，请勿重复签到");
+                            }
+                            log.info("二维码匹配成功，memberId: {}", memberId);
+                            // TODO查会员卡缓存，按照卡有效期进行扣减次数，没有缓存查数据库
+                            map.put("isUsed", true);
+                            map.put("checkInTime", LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
+
+                            return redisUtil.set(key,map).
+                                    then(Mono.just("签到成功"));
+                        }
+                    }
+                    throw new RuntimeException("二维码无效");
+                })
+                .switchIfEmpty(Mono.error(new RuntimeException("二维码已过期或不存在")));
+    }
+
+    private long getSecondsUntilEndOfDay() {
+        LocalDateTime now = LocalDateTime.now();
+        LocalDateTime endOfDay = now.toLocalDate().atTime(23, 59, 59);
+
+        if (now.isAfter(endOfDay)) return 1;
+
+        return ChronoUnit.SECONDS.between(now, endOfDay);
+    }
+}

gym-manage-api/gym-checkIn/src/main/java/cn/novalon/gym/manage/checkIn/vo/QRCodeVo.java

@@ -0,0 +1,17 @@
+package cn.novalon.gym.manage.checkIn.vo;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+@Data
+@AllArgsConstructor
+public class QRCodeVo {
+
+    private String qrCodeBase64;
+
+    private boolean isUsed;
+
+    private Integer width;
+
+    private Integer height;
+}

gym-manage-api/gym-checkIn/src/main/java/cn/novalon/gym/manage/checkIn/websocket/MyWebSocketHandler.java

@@ -0,0 +1,98 @@
+package cn.novalon.gym.manage.checkIn.websocket;
+
+import cn.hutool.json.JSONUtil;
+import cn.novalon.gym.manage.checkIn.dto.QRCodeDto;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+import org.springframework.web.reactive.socket.WebSocketHandler;
+import org.springframework.web.reactive.socket.WebSocketMessage;
+import org.springframework.web.reactive.socket.WebSocketSession;
+import reactor.core.publisher.Flux;
+import reactor.core.publisher.Mono;
+
+import java.util.Map;
+import java.util.concurrent.ConcurrentHashMap;
+
+@Slf4j
+@Component
+public class MyWebSocketHandler implements WebSocketHandler {
+
+    // 存储所有连接
+    private static final Map<String, WebSocketSession> sessions = new ConcurrentHashMap<>();
+
+    @Override
+    public Mono<Void> handle(WebSocketSession session) {
+        String sessionId = session.getId();
+
+        // 连接建立
+        sessions.put(sessionId, session);
+        log.info("WebSocket 连接建立，sessionId：{}，当前连接数：{}", sessionId, sessions.size());
+
+        // 处理接收到的消息
+        Flux<WebSocketMessage> output = session.receive()
+                .doOnNext(message -> {
+                    String payload = message.getPayloadAsText();
+                    log.info("收到消息：{}", payload);
+                })
+                .map(message -> {
+                    String payload = message.getPayloadAsText();
+                    String response = processMessage(payload, sessionId);
+                    return session.textMessage(response);
+                });
+
+        // 连接关闭时清理
+        return session.send(output)
+                .doFinally(signalType -> {
+                    sessions.remove(sessionId);
+                    log.info("WebSocket 连接关闭，sessionId：{}，剩余连接数：{}", sessionId, sessions.size());
+                });
+    }
+
+    /**
+     * 处理消息逻辑
+     */
+    private String processMessage(String message, String sessionId) {
+        try {
+            // 解析 QRCodeDto
+            QRCodeDto qrCodeDto = JSONUtil.toBean(message, QRCodeDto.class);
+
+            String response;
+
+            // 判断二维码是否有效
+            if (qrCodeDto.getQrContent() != null
+                    && !qrCodeDto.getQrContent().isEmpty()
+                    && !qrCodeDto.isUsed()) {
+                // 有效：qrContent 有值且 isUsed 为 false
+                response = "正在进行签到";
+
+                // 可选：将二维码标记为已使用（需要调用后端服务）
+                // checkInService.handleCheckIn(qrCodeDto.getQrContent());
+
+                log.info("二维码有效，sessionId：{}，qrContent：{}", sessionId, qrCodeDto.getQrContent());
+            } else {
+                // 无效：qrContent 为空 或 isUsed 为 true
+                String reason = "";
+                if (qrCodeDto.getQrContent() == null || qrCodeDto.getQrContent().isEmpty()) {
+                    reason = "二维码内容为空";
+                } else if (qrCodeDto.isUsed()) {
+                    reason = "二维码已被使用";
+                }
+                response = "二维码无效：" + reason;
+                log.warn("二维码无效，sessionId：{}，原因：{}", sessionId, reason);
+            }
+
+            return response;
+
+        } catch (Exception e) {
+            log.error("解析消息失败，sessionId：{}", sessionId, e);
+            return "消息格式错误";
+        }
+    }
+
+    /**
+     * 获取当前在线连接数
+     */
+    public static int getOnlineCount() {
+        return sessions.size();
+    }
+}

gym-manage-api/gym-checkIn/src/main/resources/checkIn-config.yml

@@ -0,0 +1,10 @@
+# 二维码配置
+qr:
+  config:
+    width: 300 # 二维码宽度（像素）
+    height: 300 # 二维码高度（像素）
+    margin: 1 # 白边宽度（像素）
+    format: png # 图片格式：png / jpg
+    error-correction: L #容错率：L, M, Q, H，如果启用Logo（logo-enabled: true），必须设置为 H
+    logo-enabled: false # 是否启用Logo（启用时error-correction必须为H）
+#    logo-path: static/logo.png    # Logo图片路径（支持相对路径或绝对路径）

gym-manage-api/gym-checkIn/src/test/java/cn/novalon/gym/manage/checkin/CheckInModuleTest.java

@@ -1,13 +1,12 @@
-package cn.novalon.gym.manage.gymmembercard;
+package cn.novalon.gym.manage.checkin;
 
 import org.junit.jupiter.api.Test;
 import org.springframework.boot.test.context.SpringBootTest;
 
 @SpringBootTest
-class GymMemberCardApplicationTests {
+public class CheckInModuleTest {
 
     @Test
-    void contextLoads() {
+    public void contextLoads() {
     }
-
 }

gym-manage-api/gym-checkIn/src/test/resources/application-test.yml

@@ -0,0 +1 @@
+# Test Configuration

gym-manage-api/gym-member-card/pom.xml

@@ -1,112 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
-    <modelVersion>4.0.0</modelVersion>
-    <parent>
-        <groupId>org.springframework.boot</groupId>
-        <artifactId>spring-boot-starter-parent</artifactId>
-        <version>3.5.13</version>
-        <relativePath/> <!-- lookup parent from repository -->
-    </parent>
-    <groupId>cn.novalon.gym.manage</groupId>
-    <artifactId>gym-member-card</artifactId>
-    <version>0.0.1-SNAPSHOT</version>
-    <name>gym-member-card</name>
-    <description>gym-member-card</description>
-
-    <properties>
-        <java.version>21</java.version>
-    </properties>
-
-    <dependencies>
-        <!-- WebFlux 启动器（响应式） -->
-        <dependency>
-            <groupId>org.springframework.boot</groupId>
-            <artifactId>spring-boot-starter-webflux</artifactId>
-        </dependency>
-
-        <!-- PostgreSQL 驱动（JDBC，如果工具类需要） -->
-        <dependency>
-            <groupId>org.postgresql</groupId>
-            <artifactId>postgresql</artifactId>
-            <scope>runtime</scope>
-        </dependency>
-
-        <!-- 你的内部模块 -->
-        <dependency>
-            <groupId>cn.novalon.gym.manage</groupId>
-            <artifactId>manage-db</artifactId>
-            <version>1.0.0</version>
-            <scope>compile</scope>
-        </dependency>
-
-        <!-- Lombok -->
-        <dependency>
-            <groupId>org.projectlombok</groupId>
-            <artifactId>lombok</artifactId>
-            <version>1.18.36</version>
-            <scope>provided</scope>
-        </dependency>
-
-        <!-- Hutool 工具箱 -->
-        <dependency>
-            <groupId>cn.hutool</groupId>
-            <artifactId>hutool-all</artifactId>
-            <version>5.8.22</version>
-        </dependency>
-
-        <!-- Spring 上下文（其实 WebFlux 已经包含，保留也可以） -->
-        <dependency>
-            <groupId>org.springframework</groupId>
-            <artifactId>spring-context</artifactId>
-        </dependency>
-
-            <!-- Redis响应式支持 -->
-    <dependency>
-        <groupId>org.springframework.boot</groupId>
-        <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
-    </dependency>
-
-<!--    &lt;!&ndash; ⭐ Redisson 响应式客户端 &ndash;&gt;-->
-<!--    <dependency>-->
-<!--        <groupId>org.redisson</groupId>-->
-<!--        <artifactId>redisson-spring-boot-starter</artifactId>-->
-<!--        <version>3.27.0</version>-->
-<!--    </dependency>-->
-
-<!--    &lt;!&ndash; ⭐ RabbitMQ 支持 &ndash;&gt;-->
-<!--    <dependency>-->
-<!--        <groupId>org.springframework.boot</groupId>-->
-<!--        <artifactId>spring-boot-starter-amqp</artifactId>-->
-<!--    </dependency>-->
-
-    <!-- Jackson for JSON处理 -->
-    <dependency>
-        <groupId>org.springframework.boot</groupId>
-        <artifactId>spring-boot-starter-json</artifactId>
-    </dependency>
-
-
-        <!-- ⭐ 必须添加：测试依赖 -->
-        <dependency>
-            <groupId>org.springframework.boot</groupId>
-            <artifactId>spring-boot-starter-test</artifactId>
-            <scope>test</scope>
-        </dependency>
-
-
-    </dependencies>
-
-    <build>
-        <plugins>
-            <plugin>
-                <groupId>org.springframework.boot</groupId>
-                <artifactId>spring-boot-maven-plugin</artifactId>
-                <configuration>
-                    <!-- 保留标准 JAR，供其他模块引用 -->
-                    <classifier>exec</classifier>
-                </configuration>
-            </plugin>
-        </plugins>
-    </build>
-</project>

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/GymMemberCardApplication.java

@@ -1,17 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard;
-
-import org.springframework.boot.SpringApplication;
-import org.springframework.boot.autoconfigure.SpringBootApplication;
-import org.springframework.data.r2dbc.repository.config.EnableR2dbcRepositories;
-import org.springframework.scheduling.annotation.EnableScheduling;
-
-@SpringBootApplication
-@EnableR2dbcRepositories(basePackages = "cn.novalon.gym.manage.gymmembercard.dao")
-@EnableScheduling
-public class GymMemberCardApplication {
-
-    public static void main(String[] args) {
-        SpringApplication.run(GymMemberCardApplication.class, args);
-    }
-
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/dao/MemberCardDao.java

@@ -1,130 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.dao;
-
-import cn.novalon.gym.manage.gymmembercard.entity.MemberCardEntity;
-import org.springframework.data.domain.Pageable;
-import org.springframework.data.r2dbc.repository.Modifying;
-import org.springframework.data.r2dbc.repository.Query;
-import org.springframework.data.r2dbc.repository.R2dbcRepository;
-import org.springframework.stereotype.Repository;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-@Repository
-public interface MemberCardDao extends R2dbcRepository<MemberCardEntity, Long> {
-
-    /**
-     * 根据会员卡ID查询会员卡详情（用于编辑前回显或小程序端展示）
-     * @param memberCardId 会员卡ID
-     * @return 会员卡完整信息，如果不存在或已删除则返回空
-     */
-    Mono<MemberCardEntity> findByMemberCardIdAndDeletedAtIsNull(Long memberCardId);
-
-    /**
-     * 条件查询会员卡列表（后台卡种列表展示，支持多条件组合+分页+排序）
-     * 注意：模糊查询使用前后缀通配符，若数据量较大可能影响索引效率，建议后期引入全文索引或改用后缀模糊
-     * @param status 会员卡状态（上架/下架）
-     * @param name 会员卡名称（模糊查询）
-     * @param type 会员卡类型
-     * @param minPrice 最低价格
-     * @param maxPrice 最高价格
-     * @param pageable 分页和排序参数
-     * @return 符合条件的会员卡列表
-     */
-    @Query("SELECT * FROM member_card WHERE deleted_at IS NULL " +
-            "AND (:status IS NULL OR member_card_status = :status) " +
-            "AND (:name IS NULL OR member_card_name LIKE CONCAT('%', :name, '%')) " +
-            "AND (:type IS NULL OR member_card_type = :type) " +
-            "AND (:minPrice IS NULL OR member_card_price >= :minPrice) " +
-            "AND (:maxPrice IS NULL OR member_card_price <= :maxPrice) " +
-            "ORDER BY created_at DESC LIMIT :#{#pageable.pageSize} OFFSET :#{#pageable.offset}")
-    Flux<MemberCardEntity> findWithConditions(Integer status, String name, String type,
-                                              Double minPrice, Double maxPrice, Pageable pageable);
-
-    /**
-     * 统计符合条件的会员卡总数（配合列表查询使用）
-     * @param status 会员卡状态
-     * @param name 会员卡名称（模糊查询）
-     * @param type 会员卡类型
-     * @param minPrice 最低价格
-     * @param maxPrice 最高价格
-     * @return 符合条件的会员卡数量
-     */
-    @Query("SELECT COUNT(*) FROM member_card WHERE deleted_at IS NULL " +
-            "AND (:status IS NULL OR member_card_status = :status) " +
-            "AND (:name IS NULL OR member_card_name LIKE CONCAT('%', :name, '%')) " +
-            "AND (:type IS NULL OR member_card_type = :type) " +
-            "AND (:minPrice IS NULL OR member_card_price >= :minPrice) " +
-            "AND (:maxPrice IS NULL OR member_card_price <= :maxPrice)")
-    Mono<Long> countWithConditions(Integer status, String name, String type,
-                                   Double minPrice, Double maxPrice);
-
-    /**
-     * 按状态查询会员卡列表（用于小程序端展示可购买卡列表，只展示上架的卡）
-     * @param status 会员卡状态（通常传上架状态）
-     * @param pageable 分页和排序参数
-     * @return 符合条件的会员卡列表
-     */
-    Flux<MemberCardEntity> findByMemberCardStatusAndDeletedAtIsNull(Integer status, Pageable pageable);
-
-    /**
-     * 检查会员卡是否已被购买（用于删除前的校验）
-     * 注意：此查询关联到 member_card_record 表，建议后续独立至 MemberCardRecordDao
-     * @param memberCardId 会员卡ID
-     * @return 如果存在关联的会员记录则返回true，否则返回false
-     */
-    @Query("SELECT EXISTS(SELECT 1 FROM member_card_record WHERE member_card_id = :memberCardId AND deleted_at IS NULL LIMIT 1)")
-    Mono<Boolean> existsPurchasedRecord(Long memberCardId);
-
-    /**
-     * 逻辑删除会员卡（下架卡种，防止已购会员数据异常）
-     * @param memberCardId 会员卡ID
-     * @return 受影响的行数
-     */
-    @Modifying
-    @Query("UPDATE member_card SET deleted_at = NOW() WHERE member_card_id = :memberCardId AND deleted_at IS NULL")
-    Mono<Integer> logicalDelete(Long memberCardId);
-
-    /**
-     * 【新增】安全更新会员卡信息（仅允许修改业务相关字段，防止覆盖敏感字段）
-     * @param memberCardId 会员卡ID
-     * @param name 卡种名称
-     * @param price 价格
-     * @param durationDays 有效天数
-     * @param totalCount 总次数
-     * @param denomination 面额
-     * @param status 状态
-     * @return 受影响的行数
-     */
-    @Modifying
-    @Query("UPDATE member_card SET " +
-            "member_card_name = COALESCE(:name, member_card_name), " +
-            "member_card_price = COALESCE(:price, member_card_price), " +
-            "duration_days = COALESCE(:durationDays, duration_days), " +
-            "total_count = COALESCE(:totalCount, total_count), " +
-            "denomination = COALESCE(:denomination, denomination), " +
-            "member_card_status = COALESCE(:status, member_card_status), " +
-            "updated_at = NOW() " +
-            "WHERE member_card_id = :memberCardId AND deleted_at IS NULL")
-    Mono<Integer> updateSafe(Long memberCardId, String name, Double price,
-                             Integer durationDays, Integer totalCount,
-                             Double denomination, Integer status);
-
-    /**
-     * 保存卡种信息（新增或更新）
-     * - 新增：entity.memberCardId 为 null 时，插入新记录
-     * - 更新：entity.memberCardId 不为 null 时，根据ID更新现有记录
-     * 注意：直接 save 会更新所有字段，如需安全更新请调用 updateSafe 方法
-     * @param entity 卡种信息
-     * @return 保存后的实体对象
-     */
-    @Override
-    <S extends MemberCardEntity> Mono<S> save(S entity);
-
-    /**
-     * 批量查询上架的会员卡（用于小程序端展示）
-     * @param status 上架状态值
-     * @return 上架的会员卡列表
-     */
-    @Query("SELECT * FROM member_card WHERE deleted_at IS NULL AND member_card_status = :status ORDER BY member_card_price ASC")
-    Flux<MemberCardEntity> findActiveCards(Integer status);
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/dao/MemberCardTransactionsDao.java

@@ -1,173 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.dao;
-
-import cn.novalon.gym.manage.gymmembercard.entity.MemberCardTransactionsEntity;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsAction;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsType;
-import org.springframework.data.domain.Pageable;
-import org.springframework.data.r2dbc.repository.Modifying;
-import org.springframework.data.r2dbc.repository.Query;
-import org.springframework.data.r2dbc.repository.R2dbcRepository;
-import org.springframework.data.repository.query.Param;
-import org.springframework.stereotype.Repository;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-import java.time.LocalDateTime;
-
-@Repository
-public interface MemberCardTransactionsDao extends R2dbcRepository<MemberCardTransactionsEntity, Long> {
-    /**
-     * 记录每一次变动
-     * 购卡、扣次、续费、退款、过期，均插入一条流水，记录变动前后快照
-     * 注意：返回值依赖 PostgreSQL 的 RETURNING 语法，若使用 MySQL 请删除 RETURNING * 并改用 save()
-     * @param memberCardId 会员卡ID
-     * @param memberId 会员ID
-     * @param operationType 操作类型
-     * @param changeAmount 变动次数（次卡）
-     * @param changeBalance 变动金额（储值卡）
-     * @param afterRemainingCount 变动后剩余次数
-     * @param afterRemainingBalance 变动后剩余余额
-     * @param relatedBizType 关联业务类型
-     * @param remark 备注
-     * @return 插入的流水记录
-     */
-    @Modifying
-    @Query("INSERT INTO member_card_transactions (member_card_id, member_id, operation_type, change_amount, " +
-            "change_balance, after_remaining_count, after_remaining_balance, related_biz_type, remark, created_at, updated_at) " +
-            "VALUES (:memberCardId, :memberId, :operationType, :changeAmount, :changeBalance, " +
-            ":afterRemainingCount, :afterRemainingBalance, :relatedBizType, :remark, NOW(), NOW()) " +
-            "RETURNING *")
-    Mono<MemberCardTransactionsEntity> insertTransaction(@Param("memberCardId") Long memberCardId,
-                                                         @Param("memberId") Long memberId,
-                                                         @Param("operationType") MemberCardTransactionsAction operationType,
-                                                         @Param("changeAmount") Integer changeAmount,
-                                                         @Param("changeBalance") Double changeBalance,
-                                                         @Param("afterRemainingCount") Integer afterRemainingCount,
-                                                         @Param("afterRemainingBalance") Double afterRemainingBalance,
-                                                         @Param("relatedBizType") MemberCardTransactionsType relatedBizType,
-                                                         @Param("remark") String remark);
-
-    /**
-     * 会员端"使用记录"
-     * 按会员ID和时间范围查询，按时间倒序，显示每次变动明细
-     * @param memberId 会员ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @param pageable 分页参数
-     * @return 流水记录列表
-     */
-    @Query("SELECT * FROM member_card_transactions WHERE member_id = :memberId " +
-            "AND created_at BETWEEN :startTime AND :endTime AND deleted_at IS NULL " +
-            "ORDER BY created_at DESC LIMIT :#{#pageable.pageSize} OFFSET :#{#pageable.offset}")
-    Flux<MemberCardTransactionsEntity> findByMemberIdAndTimeRange(@Param("memberId") Long memberId,
-                                                                  @Param("startTime") LocalDateTime startTime,
-                                                                  @Param("endTime") LocalDateTime endTime,
-                                                                  Pageable pageable);
-
-    /**
-     * 后台"使用记录查询"
-     * 按会员、卡号、操作类型、时间范围等条件组合查询
-     * @param memberId 会员ID
-     * @param memberCardId 会员卡ID
-     * @param operationType 操作类型
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @param pageable 分页参数
-     * @return 流水记录列表
-     */
-    @Query("SELECT * FROM member_card_transactions WHERE deleted_at IS NULL " +
-            "AND (:memberId IS NULL OR member_id = :memberId) " +
-            "AND (:memberCardId IS NULL OR member_card_id = :memberCardId) " +
-            "AND (:operationType IS NULL OR operation_type = :operationType) " +
-            "AND (:startTime IS NULL OR created_at >= :startTime) " +
-            "AND (:endTime IS NULL OR created_at <= :endTime) " +
-            "ORDER BY created_at DESC LIMIT :#{#pageable.pageSize} OFFSET :#{#pageable.offset}")
-    Flux<MemberCardTransactionsEntity> findWithConditions(@Param("memberId") Long memberId,
-                                                          @Param("memberCardId") Long memberCardId,
-                                                          @Param("operationType") MemberCardTransactionsAction operationType,
-                                                          @Param("startTime") LocalDateTime startTime,
-                                                          @Param("endTime") LocalDateTime endTime,
-                                                          Pageable pageable);
-
-    /**
-     * 统计符合条件的流水总数
-     * @param memberId 会员ID
-     * @param memberCardId 会员卡ID
-     * @param operationType 操作类型
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 流水记录数量
-     */
-    @Query("SELECT COUNT(*) FROM member_card_transactions WHERE deleted_at IS NULL " +
-            "AND (:memberId IS NULL OR member_id = :memberId) " +
-            "AND (:memberCardId IS NULL OR member_card_id = :memberCardId) " +
-            "AND (:operationType IS NULL OR operation_type = :operationType) " +
-            "AND (:startTime IS NULL OR created_at >= :startTime) " +
-            "AND (:endTime IS NULL OR created_at <= :endTime)")
-    Mono<Long> countWithConditions(@Param("memberId") Long memberId,
-                                   @Param("memberCardId") Long memberCardId,
-                                   @Param("operationType") MemberCardTransactionsAction operationType,
-                                   @Param("startTime") LocalDateTime startTime,
-                                   @Param("endTime") LocalDateTime endTime);
-
-    /**
-     * 按会员卡ID查询所有流水记录（补充常用方法）
-     * @param memberCardId 会员卡ID
-     * @return 该卡的所有流水记录，按时间倒序
-     */
-    @Query("SELECT * FROM member_card_transactions WHERE member_card_id = :memberCardId AND deleted_at IS NULL ORDER BY created_at DESC")
-    Flux<MemberCardTransactionsEntity> findByMemberCardId(@Param("memberCardId") Long memberCardId);
-
-    /**
-     * 数据统计 - 统计某卡种的总扣次数
-     * @param memberCardId 会员卡ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 总扣次数
-     */
-    @Query("SELECT COALESCE(SUM(change_amount), 0) FROM member_card_transactions " +
-            "WHERE member_card_id = :memberCardId AND operation_type = 'DEDUCT' " +
-            "AND created_at BETWEEN :startTime AND :endTime AND deleted_at IS NULL")
-    Mono<Long> sumDeductCountByCardId(@Param("memberCardId") Long memberCardId,
-                                      @Param("startTime") LocalDateTime startTime,
-                                      @Param("endTime") LocalDateTime endTime);
-
-    /**
-     * 数据统计 - 统计某时间段的续费总金额
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 续费总金额
-     */
-    @Query("SELECT COALESCE(SUM(change_balance), 0) FROM member_card_transactions " +
-            "WHERE operation_type = 'RENEW' AND created_at BETWEEN :startTime AND :endTime AND deleted_at IS NULL")
-    Mono<Double> sumRenewAmountByTimeRange(@Param("startTime") LocalDateTime startTime,
-                                           @Param("endTime") LocalDateTime endTime);
-
-    /**
-     * 数据统计 - 统计某会员的购卡总金额
-     * @param memberId 会员ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 购卡总金额
-     */
-    @Query("SELECT COALESCE(SUM(change_balance), 0) FROM member_card_transactions " +
-            "WHERE member_id = :memberId AND operation_type = 'PURCHASE' " +
-            "AND created_at BETWEEN :startTime AND :endTime AND deleted_at IS NULL")
-    Mono<Double> sumPurchaseAmountByMemberId(@Param("memberId") Long memberId, @Param("startTime") LocalDateTime startTime,
-                                             @Param("endTime") LocalDateTime endTime);
-    /**
-     * 按会员ID查询所有流水记录
-     * @param memberId 会员ID
-     * @return 该会员的所有流水记录，按时间倒序
-     */
-    @Query("SELECT * FROM member_card_transactions WHERE member_id = :memberId ORDER BY created_at DESC")
-    Flux<MemberCardTransactionsEntity> findByMemberId(Long memberId);
-    /**
-     * 按会员卡记录ID查询所有流水记录
-     * @param recordId 会员卡记录ID
-     * @return 该会员卡的所有流水记录，按时间倒序
-     */
-    @Query("SELECT * FROM member_card_transactions WHERE member_card_record_id = :recordId ORDER BY created_at DESC")
-    Flux<MemberCardTransactionsEntity> findByRecordId(Long recordId);
-
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/domain/MemberCard.java

@@ -1,121 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.domain;
-
-import cn.novalon.gym.manage.sys.core.domain.BaseDomain;
-import io.swagger.v3.oas.annotations.media.Schema;
-
-import java.time.LocalDateTime;
-
-/*
- *@Author:shizhounian
- *@Date:2026/5/10-05 22:47:31
- */
-@Schema(description = "会员卡类型表")
-public class MemberCard extends BaseDomain {
-    //会员卡id
-    @Schema(description = "会员卡Id",example = "1")
-    private Long memberCardId;
-
-    //会员卡名称
-    @Schema(description = "会员卡名称",example = "月卡")
-    private String memberCardName;
-
-    //会员卡类型
-    @Schema(description = "会员卡类型",example = "TIME_CARD")
-    private String memberCardType;
-
-    //会员卡价格
-    @Schema(description = "会员卡价格",example = "199.0")
-    private Double memberCardPrice;
-
-    //会员卡有效天数（时长卡用）
-    @Schema(description = "会员卡有效天数",example = "30")
-    private Integer memberCardValidityDays;
-
-    //会员卡总次数（次卡用）
-    @Schema(description = "会员卡总次数",example = "10")
-    private Integer memberCardTotalTimes;
-
-    //会员卡面额（储值卡用）
-    @Schema(description = "会员卡面额",example = "500.0")
-    private Double memberCardAmount;
-
-    //会员卡状态：0-正常，1-禁用
-    @Schema(description = "会员卡状态",example = "0")
-    private Integer memberCardStatus;
-
-    //会员卡创建时间
-    @Schema(description = "会员卡创建时间",example = "2026-05-10 05:22:47")
-    private LocalDateTime memberCardCreateTime;
-
-    public Long getMemberCardId() {
-        return memberCardId;
-    }
-
-    public void setMemberCardId(Long memberCardId) {
-        this.memberCardId = memberCardId;
-    }
-
-    public String getMemberCardName() {
-        return memberCardName;
-    }
-
-    public void setMemberCardName(String memberCardName) {
-        this.memberCardName = memberCardName;
-    }
-
-    public String getMemberCardType() {
-        return memberCardType;
-    }
-
-    public void setMemberCardType(String memberCardType) {
-        this.memberCardType = memberCardType;
-    }
-
-    public Double getMemberCardPrice() {
-        return memberCardPrice;
-    }
-
-    public void setMemberCardPrice(Double memberCardPrice) {
-        this.memberCardPrice = memberCardPrice;
-    }
-
-    public Integer getMemberCardValidityDays() {
-        return memberCardValidityDays;
-    }
-
-    public void setMemberCardValidityDays(Integer memberCardValidityDays) {
-        this.memberCardValidityDays = memberCardValidityDays;
-    }
-
-    public Integer getMemberCardTotalTimes() {
-        return memberCardTotalTimes;
-    }
-
-    public void setMemberCardTotalTimes(Integer memberCardTotalTimes) {
-        this.memberCardTotalTimes = memberCardTotalTimes;
-    }
-
-    public Double getMemberCardAmount() {
-        return memberCardAmount;
-    }
-
-    public void setMemberCardAmount(Double memberCardAmount) {
-        this.memberCardAmount = memberCardAmount;
-    }
-
-    public Integer getMemberCardStatus() {
-        return memberCardStatus;
-    }
-
-    public void setMemberCardStatus(Integer memberCardStatus) {
-        this.memberCardStatus = memberCardStatus;
-    }
-
-    public LocalDateTime getMemberCardCreateTime() {
-        return memberCardCreateTime;
-    }
-
-    public void setMemberCardCreateTime(LocalDateTime memberCardCreateTime) {
-        this.memberCardCreateTime = memberCardCreateTime;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/domain/MemberCardRecord.java

@@ -1,109 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.domain;
-
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardRecordStatus;
-import cn.novalon.gym.manage.sys.core.domain.BaseDomain;
-import io.swagger.v3.oas.annotations.media.Schema;
-
-import java.time.LocalDateTime;
-
-@Schema(description = "会员卡记录")
-public class MemberCardRecord extends BaseDomain {
-    @Schema(description = "会员持有卡ID", example = "1")
-    private Long memberCardRecordId;
-
-    @Schema(description = "会员ID", example = "1001")
-    private Long memberId;
-
-    @Schema(description = "关联会员卡ID", example = "1")
-    private Long memberCardId;
-
-    @Schema(description = "状态：ACTIVE-有效, USED_UP-用完, EXPIRED-过期, REFUNDED-已退款", example = "ACTIVE")
-    private MemberCardRecordStatus status;
-
-    @Schema(description = "剩余次数", example = "10")
-    private Integer remainingTimes;
-
-    @Schema(description = "剩余余额", example = "500.0")
-    private Double remainingAmount;
-
-    @Schema(description = "到期时间", example = "2026-06-23 10:00:00")
-    private LocalDateTime expireTime;
-
-    @Schema(description = "购买订单ID", example = "10001")
-    private Long sourceOrderId;
-
-    @Schema(description = "购买时间", example = "2026-05-23 10:00:00")
-    private LocalDateTime purchaseTime;
-
-    public Long getMemberCardRecordId() {
-        return memberCardRecordId;
-    }
-
-    public void setMemberCardRecordId(Long memberCardRecordId) {
-        this.memberCardRecordId = memberCardRecordId;
-    }
-
-    public Long getMemberId() {
-        return memberId;
-    }
-
-    public void setMemberId(Long memberId) {
-        this.memberId = memberId;
-    }
-
-    public Long getMemberCardId() {
-        return memberCardId;
-    }
-
-    public void setMemberCardId(Long memberCardId) {
-        this.memberCardId = memberCardId;
-    }
-
-    public MemberCardRecordStatus getStatus() {
-        return status;
-    }
-
-    public void setStatus(MemberCardRecordStatus status) {
-        this.status = status;
-    }
-
-    public Integer getRemainingTimes() {
-        return remainingTimes;
-    }
-
-    public void setRemainingTimes(Integer remainingTimes) {
-        this.remainingTimes = remainingTimes;
-    }
-
-    public Double getRemainingAmount() {
-        return remainingAmount;
-    }
-
-    public void setRemainingAmount(Double remainingAmount) {
-        this.remainingAmount = remainingAmount;
-    }
-
-    public LocalDateTime getExpireTime() {
-        return expireTime;
-    }
-
-    public void setExpireTime(LocalDateTime expireTime) {
-        this.expireTime = expireTime;
-    }
-
-    public Long getSourceOrderId() {
-        return sourceOrderId;
-    }
-
-    public void setSourceOrderId(Long sourceOrderId) {
-        this.sourceOrderId = sourceOrderId;
-    }
-
-    public LocalDateTime getPurchaseTime() {
-        return purchaseTime;
-    }
-
-    public void setPurchaseTime(LocalDateTime purchaseTime) {
-        this.purchaseTime = purchaseTime;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/domain/MemberCardTransactions.java

@@ -1,159 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.domain;
-
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsAction;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsType;
-import cn.novalon.gym.manage.sys.core.domain.BaseDomain;
-import io.swagger.v3.oas.annotations.media.Schema;
-
-import java.time.LocalDateTime;
-
-/*
- *@Author:shizhounian
- *@Date:2026/5/10-05 22:47:31
- */
-@Schema(description = "会员卡流水")
-public class MemberCardTransactions extends BaseDomain {
-    //会员卡流水Id
-    @Schema(description = "会员卡流水Id",example = "1")
-    private Long memberCardTransactionsId;
-
-    //会员卡Id
-    @Schema(description = "会员卡Id",example = "1")
-    private Long memberCardId;
-
-    //会员Id
-    @Schema(description = "会员Id",example = "1")
-    private Long memberId;
-
-    //操作类型：PURCHASE(购买) / DEDUCT(扣次/扣费) / RENEW(续费) / REFUND(退款) / EXPIRE(过期)
-    @Schema(description = "操作类型",example = "PURCHASE")
-    private MemberCardTransactionsAction operationType;
-
-    //变动次数（次卡用）
-    @Schema(description = "变动次数（次卡用）",example = "1")
-    private Integer changeAmount;
-
-    //变动金额（储值卡用）
-    @Schema(description = "变动金额（储值卡用）",example = "1")
-    private Double changeBalance;
-
-    //变动后剩余次数
-    @Schema(description = "变动后剩余次数",example = "1")
-    private Integer afterRemainingCount;
-
-    //变动后剩余金额
-    @Schema(description = "变动后剩余金额",example = "500.0")
-    private Double afterRemainingBalance;
-
-    //关联业务类型
-    @Schema(description = "关联业务类型",example = "GROUP_CLASS")
-    private MemberCardTransactionsType relatedBizType;
-
-    //备注
-    @Schema(description = "备注",example = "预约团课：瑜伽课扣1次")
-    private String remark;
-
-    //关联订单ID
-    @Schema(description = "关联订单ID",example = "1")
-    private Long sourceOrderId;
-
-    //创建时间
-    @Schema(description = "创建时间",example = "2026-05-10 05:22:47")
-    private LocalDateTime createdAt;
-
-    public Long getMemberCardTransactionsId() {
-        return memberCardTransactionsId;
-    }
-
-    public void setMemberCardTransactionsId(Long memberCardTransactionsId) {
-        this.memberCardTransactionsId = memberCardTransactionsId;
-    }
-
-    public Long getMemberCardId() {
-        return memberCardId;
-    }
-
-    public void setMemberCardId(Long memberCardId) {
-        this.memberCardId = memberCardId;
-    }
-
-    public Long getMemberId() {
-        return memberId;
-    }
-
-    public void setMemberId(Long memberId) {
-        this.memberId = memberId;
-    }
-
-    public MemberCardTransactionsAction getOperationType() {
-        return operationType;
-    }
-
-    public void setOperationType(MemberCardTransactionsAction operationType) {
-        this.operationType = operationType;
-    }
-
-    public Integer getChangeAmount() {
-        return changeAmount;
-    }
-
-    public void setChangeAmount(Integer changeAmount) {
-        this.changeAmount = changeAmount;
-    }
-
-    public Double getChangeBalance() {
-        return changeBalance;
-    }
-
-    public void setChangeBalance(Double changeBalance) {
-        this.changeBalance = changeBalance;
-    }
-
-    public Integer getAfterRemainingCount() {
-        return afterRemainingCount;
-    }
-
-    public void setAfterRemainingCount(Integer afterRemainingCount) {
-        this.afterRemainingCount = afterRemainingCount;
-    }
-
-    public Double getAfterRemainingBalance() {
-        return afterRemainingBalance;
-    }
-
-    public void setAfterRemainingBalance(Double afterRemainingBalance) {
-        this.afterRemainingBalance = afterRemainingBalance;
-    }
-
-    public MemberCardTransactionsType getRelatedBizType() {
-        return relatedBizType;
-    }
-
-    public void setRelatedBizType(MemberCardTransactionsType relatedBizType) {
-        this.relatedBizType = relatedBizType;
-    }
-
-    public String getRemark() {
-        return remark;
-    }
-
-    public void setRemark(String remark) {
-        this.remark = remark;
-    }
-
-    public Long getSourceOrderId() {
-        return sourceOrderId;
-    }
-
-    public void setSourceOrderId(Long sourceOrderId) {
-        this.sourceOrderId = sourceOrderId;
-    }
-
-    public LocalDateTime getCreatedAt() {
-        return createdAt;
-    }
-
-    public void setCreatedAt(LocalDateTime createdAt) {
-        this.createdAt = createdAt;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/domain/RefundApplication.java

@@ -1,127 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.domain;
-
-import cn.novalon.gym.manage.sys.core.domain.BaseDomain;
-import io.swagger.v3.oas.annotations.media.Schema;
-
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-
-/**
- * 退款申请领域对象
- *
- * @author shizhounian
- * @date 2026-05-23 21:11:46
- */
-@Schema(description = "退款申请", example = "refund_application")
-public class RefundApplication extends BaseDomain {
-
-    @Schema(description = "退款申请ID", example = "1")
-    private Long id;
-
-    @Schema(description = "会员卡记录ID", example = "1")
-    private Long recordId;
-
-    @Schema(description = "会员ID", example = "1")
-    private Long memberId;
-
-    @Schema(description = "状态：PENDING-待审核, APPROVED-已批准, REJECTED-已拒绝, PROCESSING-处理中, SUCCESS-成功, FAILED-失败", example = "PENDING")
-    private String status;
-
-    @Schema(description = "退款原因", example = "个人原因申请退款")
-    private String reason;
-
-    @Schema(description = "申请时间", example = "2026-05-23 21:09:14")
-    private LocalDateTime applyTime;
-
-    @Schema(description = "审核时间", example = "2026-05-24 10:00:00")
-    private LocalDateTime auditTime;
-
-    @Schema(description = "审核人ID", example = "1")
-    private Long auditorId;
-
-    @Schema(description = "审核备注", example = "同意退款")
-    private String auditRemark;
-
-    @Schema(description = "退款金额", example = "500.00")
-    private BigDecimal refundAmount;
-
-    public Long getId() {
-        return id;
-    }
-
-    public void setId(Long id) {
-        this.id = id;
-    }
-
-    public Long getRecordId() {
-        return recordId;
-    }
-
-    public void setRecordId(Long recordId) {
-        this.recordId = recordId;
-    }
-
-    public Long getMemberId() {
-        return memberId;
-    }
-
-    public void setMemberId(Long memberId) {
-        this.memberId = memberId;
-    }
-
-    public String getStatus() {
-        return status;
-    }
-
-    public void setStatus(String status) {
-        this.status = status;
-    }
-
-    public String getReason() {
-        return reason;
-    }
-
-    public void setReason(String reason) {
-        this.reason = reason;
-    }
-
-    public LocalDateTime getApplyTime() {
-        return applyTime;
-    }
-
-    public void setApplyTime(LocalDateTime applyTime) {
-        this.applyTime = applyTime;
-    }
-
-    public LocalDateTime getAuditTime() {
-        return auditTime;
-    }
-
-    public void setAuditTime(LocalDateTime auditTime) {
-        this.auditTime = auditTime;
-    }
-
-    public Long getAuditorId() {
-        return auditorId;
-    }
-
-    public void setAuditorId(Long auditorId) {
-        this.auditorId = auditorId;
-    }
-
-    public String getAuditRemark() {
-        return auditRemark;
-    }
-
-    public void setAuditRemark(String auditRemark) {
-        this.auditRemark = auditRemark;
-    }
-
-    public BigDecimal getRefundAmount() {
-        return refundAmount;
-    }
-
-    public void setRefundAmount(BigDecimal refundAmount) {
-        this.refundAmount = refundAmount;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/entity/MemberCardEntity.java

@@ -1,123 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.entity;
-
-import cn.novalon.gym.manage.db.entity.BaseEntity;
-import lombok.Data;
-import org.springframework.data.relational.core.mapping.Column;
-import org.springframework.data.relational.core.mapping.Table;
-
-import java.time.LocalDateTime;
-
-/*
- *@Author:shizhounian
- *@Date:2026/5/10-05 22:47:31
- */
-@Table("member_card")
-public class MemberCardEntity extends BaseEntity {
-    //会员卡id
-    @Column("member_card_id")
-    private Long memberCardId;
-
-    //会员卡名称
-    @Column("member_card_name")
-    private String memberCardName;
-
-    //会员卡类型
-    @Column("member_card_type")
-    private String memberCardType;
-
-    //会员卡价格
-    @Column("member_card_price")
-    private Double memberCardPrice;
-
-    //会员卡有效天数（时长卡用）
-    @Column("member_card_validity_days")
-    private Integer memberCardValidityDays;
-
-    //会员卡总次数（次卡用）
-    @Column("member_card_total_times")
-    private Integer memberCardTotalTimes;
-
-    //会员卡面额（储值卡用）
-    @Column("member_card_amount")
-    private Double memberCardAmount;
-
-    //会员卡状态：0-正常，1-禁用
-    @Column("member_card_status")
-    private Integer memberCardStatus;
-
-    //会员卡创建时间
-    @Column("member_card_create_time")
-    private LocalDateTime memberCardCreateTime;
-
-    public Long getMemberCardId() {
-        return memberCardId;
-    }
-
-    public void setMemberCardId(Long memberCardId) {
-        this.memberCardId = memberCardId;
-    }
-
-    public String getMemberCardName() {
-        return memberCardName;
-    }
-
-    public void setMemberCardName(String memberCardName) {
-        this.memberCardName = memberCardName;
-    }
-
-    public String getMemberCardType() {
-        return memberCardType;
-    }
-
-    public void setMemberCardType(String memberCardType) {
-        this.memberCardType = memberCardType;
-    }
-
-    public Double getMemberCardPrice() {
-        return memberCardPrice;
-    }
-
-    public void setMemberCardPrice(Double memberCardPrice) {
-        this.memberCardPrice = memberCardPrice;
-    }
-
-    public Integer getMemberCardValidityDays() {
-        return memberCardValidityDays;
-    }
-
-    public void setMemberCardValidityDays(Integer memberCardValidityDays) {
-        this.memberCardValidityDays = memberCardValidityDays;
-    }
-
-    public Integer getMemberCardTotalTimes() {
-        return memberCardTotalTimes;
-    }
-
-    public void setMemberCardTotalTimes(Integer memberCardTotalTimes) {
-        this.memberCardTotalTimes = memberCardTotalTimes;
-    }
-
-    public Double getMemberCardAmount() {
-        return memberCardAmount;
-    }
-
-    public void setMemberCardAmount(Double memberCardAmount) {
-        this.memberCardAmount = memberCardAmount;
-    }
-
-    public Integer getMemberCardStatus() {
-        return memberCardStatus;
-    }
-
-    public void setMemberCardStatus(Integer memberCardStatus) {
-        this.memberCardStatus = memberCardStatus;
-    }
-
-    public LocalDateTime getMemberCardCreateTime() {
-        return memberCardCreateTime;
-    }
-
-    public void setMemberCardCreateTime(LocalDateTime memberCardCreateTime) {
-        this.memberCardCreateTime = memberCardCreateTime;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/entity/MemberCardRecordEntity.java

@@ -1,124 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.entity;
-
-import cn.novalon.gym.manage.db.entity.BaseEntity;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardRecordStatus;
-import lombok.Data;
-import org.springframework.data.relational.core.mapping.Column;
-import org.springframework.data.relational.core.mapping.Table;
-
-import java.time.LocalDateTime;
-
-/*
- *@Author:shizhounian
- *@Date:2026/5/10-05 22:47:31
- */
-@Table("member_card_record")
-public class MemberCardRecordEntity extends BaseEntity {
-    //会员持有卡id
-    @Column("member_card_record_id")
-    private Long memberCardRecordId;
-
-    //会员Id
-    @Column("member_id")
-    private Long memberId;
-
-    //关联会员卡Id
-    @Column("member_card_id")
-    private Long memberCardId;
-
-    //状态：ACTIVE(有效) / USED_UP(用完) / EXPIRED(过期) / REFUNDED(已退款)
-    @Column("status")
-    private MemberCardRecordStatus status;
-
-    //剩余次数
-    @Column("remaining_times")
-    private Integer remainingTimes;
-
-    //剩余余额
-    @Column("remaining_amount")
-    private Double remainingAmount;
-
-    //到期时间
-    @Column("expire_time")
-    private LocalDateTime expireTime;
-
-    //购买订单Id
-    @Column("source_order_id")
-    private Long sourceOrderId;
-
-    //购买时间
-    @Column("purchase_time")
-    private LocalDateTime purchaseTime;
-
-    public Long getMemberCardRecordId() {
-        return memberCardRecordId;
-    }
-
-    public void setMemberCardRecordId(Long memberCardRecordId) {
-        this.memberCardRecordId = memberCardRecordId;
-    }
-
-    public Long getMemberId() {
-        return memberId;
-    }
-
-    public void setMemberId(Long memberId) {
-        this.memberId = memberId;
-    }
-
-    public Long getMemberCardId() {
-        return memberCardId;
-    }
-
-    public void setMemberCardId(Long memberCardId) {
-        this.memberCardId = memberCardId;
-    }
-
-    public MemberCardRecordStatus getStatus() {
-        return status;
-    }
-
-    public void setStatus(MemberCardRecordStatus status) {
-        this.status = status;
-    }
-
-    public Integer getRemainingTimes() {
-        return remainingTimes;
-    }
-
-    public void setRemainingTimes(Integer remainingTimes) {
-        this.remainingTimes = remainingTimes;
-    }
-
-    public Double getRemainingAmount() {
-        return remainingAmount;
-    }
-
-    public void setRemainingAmount(Double remainingAmount) {
-        this.remainingAmount = remainingAmount;
-    }
-
-    public LocalDateTime getExpireTime() {
-        return expireTime;
-    }
-
-    public void setExpireTime(LocalDateTime expireTime) {
-        this.expireTime = expireTime;
-    }
-
-    public Long getSourceOrderId() {
-        return sourceOrderId;
-    }
-
-    public void setSourceOrderId(Long sourceOrderId) {
-        this.sourceOrderId = sourceOrderId;
-    }
-
-    public LocalDateTime getPurchaseTime() {
-        return purchaseTime;
-    }
-
-    public void setPurchaseTime(LocalDateTime purchaseTime) {
-        this.purchaseTime = purchaseTime;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/entity/MemberCardTransactionsEntity.java

@@ -1,160 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.entity;
-
-import cn.novalon.gym.manage.db.entity.BaseEntity;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsAction;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsType;
-import org.springframework.data.relational.core.mapping.Column;
-import org.springframework.data.relational.core.mapping.Table;
-
-import java.time.LocalDateTime;
-
-/*
- *@Author:shizhounian
- *@Date:2026/5/10-05 22:47:31
- */
-@Table("member_card_transactions")
-public class MemberCardTransactionsEntity extends BaseEntity{
-
-    @Column("id")
-    private Long id;
-
-    @Column("member_card_record_id")
-    private Long memberCardRecordId;
-
-    @Column("member_id")
-    private Long memberId;
-
-    @Column("member_card_id")
-    private Long memberCardId;
-
-    @Column("operation_type")
-    private MemberCardTransactionsAction operationType;
-
-    @Column("change_amount")
-    private Integer changeAmount;
-
-    @Column("change_balance")
-    private Double changeBalance;
-
-    @Column("after_remaining_count")
-    private Integer afterRemainingCount;
-
-    @Column("after_remaining_balance")
-    private Double afterRemainingBalance;
-
-    @Column("related_biz_type")
-    private MemberCardTransactionsType relatedBizType;
-
-    @Column("source_order_id")
-    private Long sourceOrderId;
-
-    @Column("remark")
-    private String remark;
-
-    @Column("created_at")
-    private LocalDateTime createdAt;
-
-    public Long getId() {
-        return id;
-    }
-
-    public void setId(Long id) {
-        this.id = id;
-    }
-
-    public Long getMemberCardRecordId() {
-        return memberCardRecordId;
-    }
-
-    public void setMemberCardRecordId(Long memberCardRecordId) {
-        this.memberCardRecordId = memberCardRecordId;
-    }
-
-    public Long getMemberId() {
-        return memberId;
-    }
-
-    public void setMemberId(Long memberId) {
-        this.memberId = memberId;
-    }
-
-    public Long getMemberCardId() {
-        return memberCardId;
-    }
-
-    public void setMemberCardId(Long memberCardId) {
-        this.memberCardId = memberCardId;
-    }
-
-    public MemberCardTransactionsAction getOperationType() {
-        return operationType;
-    }
-
-    public void setOperationType(MemberCardTransactionsAction operationType) {
-        this.operationType = operationType;
-    }
-
-    public Integer getChangeAmount() {
-        return changeAmount;
-    }
-
-    public void setChangeAmount(Integer changeAmount) {
-        this.changeAmount = changeAmount;
-    }
-
-    public Double getChangeBalance() {
-        return changeBalance;
-    }
-
-    public void setChangeBalance(Double changeBalance) {
-        this.changeBalance = changeBalance;
-    }
-
-    public Integer getAfterRemainingCount() {
-        return afterRemainingCount;
-    }
-
-    public void setAfterRemainingCount(Integer afterRemainingCount) {
-        this.afterRemainingCount = afterRemainingCount;
-    }
-
-    public Double getAfterRemainingBalance() {
-        return afterRemainingBalance;
-    }
-
-    public void setAfterRemainingBalance(Double afterRemainingBalance) {
-        this.afterRemainingBalance = afterRemainingBalance;
-    }
-
-    public MemberCardTransactionsType getRelatedBizType() {
-        return relatedBizType;
-    }
-
-    public void setRelatedBizType(MemberCardTransactionsType relatedBizType) {
-        this.relatedBizType = relatedBizType;
-    }
-
-    public Long getSourceOrderId() {
-        return sourceOrderId;
-    }
-
-    public void setSourceOrderId(Long sourceOrderId) {
-        this.sourceOrderId = sourceOrderId;
-    }
-
-    public String getRemark() {
-        return remark;
-    }
-
-    public void setRemark(String remark) {
-        this.remark = remark;
-    }
-
-    public LocalDateTime getCreatedAt() {
-        return createdAt;
-    }
-
-    public void setCreatedAt(LocalDateTime createdAt) {
-        this.createdAt = createdAt;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/entity/RefundApplicationEntity.java

@@ -1,127 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.entity;
-
-import cn.novalon.gym.manage.db.entity.BaseEntity;
-import io.swagger.v3.oas.annotations.media.Schema;
-
-import java.math.BigDecimal;
-import java.time.LocalDateTime;
-
-/**
- * 退款申请实体类
- *
- * @author shizhounian
- * @date 2026-05-23 21:09:14
- */
-@Schema(description = "退款申请实体", example = "refund_application")
-public class RefundApplicationEntity extends BaseEntity {
-
-    @Schema(description = "退款申请ID", example = "1")
-    private Long id;
-
-    @Schema(description = "会员卡记录ID", example = "1")
-    private Long recordId;
-
-    @Schema(description = "会员ID", example = "1")
-    private Long memberId;
-
-    @Schema(description = "状态：PENDING-待审核, APPROVED-已批准, REJECTED-已拒绝, PROCESSING-处理中, SUCCESS-成功, FAILED-失败", example = "PENDING")
-    private String status;
-
-    @Schema(description = "退款原因", example = "个人原因申请退款")
-    private String reason;
-
-    @Schema(description = "申请时间", example = "2026-05-23 21:09:14")
-    private LocalDateTime applyTime;
-
-    @Schema(description = "审核时间", example = "2026-05-24 10:00:00")
-    private LocalDateTime auditTime;
-
-    @Schema(description = "审核人ID", example = "1")
-    private Long auditorId;
-
-    @Schema(description = "审核备注", example = "同意退款")
-    private String auditRemark;
-
-    @Schema(description = "退款金额", example = "500.00")
-    private BigDecimal refundAmount;
-
-    public Long getId() {
-        return id;
-    }
-
-    public void setId(Long id) {
-        this.id = id;
-    }
-
-    public Long getRecordId() {
-        return recordId;
-    }
-
-    public void setRecordId(Long recordId) {
-        this.recordId = recordId;
-    }
-
-    public Long getMemberId() {
-        return memberId;
-    }
-
-    public void setMemberId(Long memberId) {
-        this.memberId = memberId;
-    }
-
-    public String getStatus() {
-        return status;
-    }
-
-    public void setStatus(String status) {
-        this.status = status;
-    }
-
-    public String getReason() {
-        return reason;
-    }
-
-    public void setReason(String reason) {
-        this.reason = reason;
-    }
-
-    public LocalDateTime getApplyTime() {
-        return applyTime;
-    }
-
-    public void setApplyTime(LocalDateTime applyTime) {
-        this.applyTime = applyTime;
-    }
-
-    public LocalDateTime getAuditTime() {
-        return auditTime;
-    }
-
-    public void setAuditTime(LocalDateTime auditTime) {
-        this.auditTime = auditTime;
-    }
-
-    public Long getAuditorId() {
-        return auditorId;
-    }
-
-    public void setAuditorId(Long auditorId) {
-        this.auditorId = auditorId;
-    }
-
-    public String getAuditRemark() {
-        return auditRemark;
-    }
-
-    public void setAuditRemark(String auditRemark) {
-        this.auditRemark = auditRemark;
-    }
-
-    public BigDecimal getRefundAmount() {
-        return refundAmount;
-    }
-
-    public void setRefundAmount(BigDecimal refundAmount) {
-        this.refundAmount = refundAmount;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/enums/MemberCardEvent.java

@@ -1,34 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.enums;
-
-import io.swagger.v3.oas.annotations.media.Schema;
-
-@Schema(description = "会员卡状态机事件")
-public enum MemberCardEvent {
-    @Schema(description = "激活卡片")
-    ACTIVATE("激活卡片"),
-
-    @Schema(description = "使用卡片")
-    USE("使用卡片"),
-
-    @Schema(description = "续费")
-    RENEW("续费"),
-
-    @Schema(description = "过期")
-    EXPIRE("过期"),
-
-    @Schema(description = "退款")
-    REFUND("退款"),
-
-    @Schema(description = "禁用")
-    DISABLE("禁用");
-
-    private final String desc;
-
-    MemberCardEvent(String desc) {
-        this.desc = desc;
-    }
-
-    public String getDesc() {
-        return desc;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/enums/MemberCardRecordStatus.java

@@ -1,36 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.enums;
-
-import io.swagger.v3.oas.annotations.media.Schema;
-
-/*
- *@Author:shizhounian
- *@Date:2026/5/10-05 23:59:29
- */
-@Schema(description = "会员卡状态枚举")
-public enum MemberCardRecordStatus {
-    //有效
-    @Schema(description = "有效")
-    ACTIVE("有效"),
-
-    //用完
-    @Schema(description = "用完")
-    USED_UP("用完"),
-
-    //过期
-    @Schema(description = "过期")
-    EXPIRED("过期"),
-
-    //已退款
-    @Schema(description = "已退款")
-    REFUNDED("已退款");
-
-    private final String desc;
-
-    MemberCardRecordStatus(String desc) {
-        this.desc = desc;
-    }
-
-    public String getDesc() {
-        return desc;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/enums/MemberCardTransactionsAction.java

@@ -1,40 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.enums;
-
-import io.swagger.v3.oas.annotations.media.Schema;
-
-/*
- *@Author:shizhounian
- *@Date:2026/5/10-05 23:59:29
- */
-@Schema(description = "会员卡流水操作枚举")
-public enum MemberCardTransactionsAction {
-    //购买
-    @Schema(description = "购买")
-    PURCHASE("购买"),
-
-    //扣次/扣费
-    @Schema(description = "扣次/扣费")
-    DEDUCT("扣次/扣费"),
-
-    //续费
-    @Schema(description = "续费")
-    RENEW("续费"),
-
-    //退款
-    @Schema(description = "退款")
-    REFUND("退款"),
-
-    //过期
-    @Schema(description = "过期")
-    EXPIRE("过期");
-
-    private final String desc;
-
-    MemberCardTransactionsAction(String desc) {
-        this.desc = desc;
-    }
-
-    public String getDesc() {
-        return desc;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/enums/MemberCardTransactionsType.java

@@ -1,32 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.enums;
-
-import io.swagger.v3.oas.annotations.media.Schema;
-
-/*
- *@Author:shizhounian
- *@Date:2026/5/10-05 23:59:29
- */
-@Schema(description = "会员卡流水关联业务类型枚举")
-public enum MemberCardTransactionsType {
-    //团课
-    @Schema(description = "团课")
-    GROUP_CLASS("团课"),
-
-    //私教
-    @Schema(description = "私教")
-    PT_CLASS("私教"),
-
-    //签到
-    @Schema(description = "签到")
-    CHECK_IN("签到");
-
-    private final String desc;
-
-    MemberCardTransactionsType(String desc) {
-        this.desc = desc;
-    }
-
-    public String getDesc() {
-        return desc;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/repository/IMemberCardRecordRepository.java

@@ -1,34 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.repository;
-
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardRecord;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardRecordStatus;
-import org.springframework.data.domain.Pageable;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-public interface IMemberCardRecordRepository {
-    
-    Mono<MemberCardRecord> findById(Long id);
-    
-    Mono<MemberCardRecord> save(MemberCardRecord record);
-    
-    Mono<MemberCardRecord> insertActiveRecord(MemberCardRecord record);
-    
-    Flux<MemberCardRecord> findByMemberId(Long memberId, Pageable pageable);
-    
-    Flux<MemberCardRecord> findActiveCardsByMemberId(Long memberId);
-    
-    Flux<MemberCardRecord> findActiveRecords();
-    
-    Mono<Integer> updateStatus(Long id, MemberCardRecordStatus status);
-    
-    Mono<Integer> deductUsage(Long recordId, Integer deductTimes, Double deductAmount);
-    
-    Mono<Integer> renewCard(Long recordId, Integer addTimes, Double addAmount, java.time.LocalDateTime newExpireTime);
-    
-    Flux<MemberCardRecord> findExpiredCards();
-    
-    Mono<MemberCardRecord> validateCountCard(Long recordId, Integer requiredTimes);
-    
-    Mono<MemberCardRecord> validateStoredCard(Long recordId, Double requiredAmount);
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/repository/IMemberCardRepository.java

@@ -1,78 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.repository;
-
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCard;
-import org.springframework.data.domain.Pageable;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-public interface IMemberCardRepository {
-    /**
-     * 根据会员卡ID查询会员卡详情（用于编辑前回显或小程序端展示）
-     * @param memberCardId 会员卡ID
-     * @return 会员卡完整信息，如果不存在或已删除则返回空
-     */
-    Mono<MemberCard> findByMemberCardIdAndDeletedAtIsNull(Long memberCardId);
-
-    /**
-     * 条件查询会员卡列表（后台卡种列表展示，支持多条件组合+分页+排序）
-     * @param status 会员卡状态（上架/下架）
-     * @param name 会员卡名称（模糊查询）
-     * @param type 会员卡类型
-     * @param minPrice 最低价格
-     * @param maxPrice 最高价格
-     * @param pageable 分页和排序参数
-     * @return 符合条件的会员卡列表
-     */
-    Flux<MemberCard> findWithConditions(Integer status, String name, String type,
-                                              Double minPrice, Double maxPrice, Pageable pageable);
-
-    /**
-     * 统计符合条件的会员卡总数（配合列表查询使用）
-     * @param status 会员卡状态
-     * @param name 会员卡名称（模糊查询）
-     * @param type 会员卡类型
-     * @param minPrice 最低价格
-     * @param maxPrice 最高价格
-     * @return 符合条件的会员卡数量
-     */
-    Mono<Long> countWithConditions(Integer status, String name, String type,
-                                   Double minPrice, Double maxPrice);
-
-    /**
-     * 按状态查询会员卡列表（用于小程序端展示可购买卡列表，只展示上架的卡）
-     * @param status 会员卡状态（通常传上架状态）
-     * @param pageable 分页和排序参数
-     * @return 符合条件的会员卡列表
-     */
-    Flux<MemberCard> findByMemberCardStatusAndDeletedAtIsNull(Integer status, Pageable pageable);
-
-    /**
-     * 检查会员卡是否已被购买（用于删除前的校验）
-     * @param memberCardId 会员卡ID
-     * @return 如果存在关联的会员记录则返回true，否则返回false
-     */
-    Mono<Boolean> existsPurchasedRecord(Long memberCardId);
-
-    /**
-     * 逻辑删除会员卡（下架卡种，防止已购会员数据异常）
-     * @param memberCardId 会员卡ID
-     * @return 受影响的行数
-     */
-    Mono<Integer> logicalDelete(Long memberCardId);
-
-    /**
-     * 保存卡种信息（新增或更新）
-     * - 新增：entity.memberCardId 为 null 时，插入新记录
-     * - 更新：entity.memberCardId 不为 null 时，根据ID更新现有记录
-     * @param entity 卡种信息
-     * @return 保存后的实体对象
-     */
-    Mono<MemberCard> save(MemberCard entity);
-
-    /**
-     * 批量查询上架的会员卡（用于小程序端展示）
-     * @param status 上架状态值
-     * @return 上架的会员卡列表
-     */
-    Flux<MemberCard> findActiveCards(Integer status);
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/repository/IMemberCardTransactionsRepository.java

@@ -1,112 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.repository;
-
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardTransactions;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsAction;
-import org.springframework.data.domain.Pageable;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-import java.time.LocalDateTime;
-
-public interface IMemberCardTransactionsRepository {
-
-    /**
-     * 记录每一次变动
-     * @param transactions 流水记录
-     * @return 插入的流水记录
-     */
-    Mono<MemberCardTransactions> insertTransaction(MemberCardTransactions transactions);
-
-    /**
-     * 会员端"使用记录"
-     * @param memberId 会员ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @param pageable 分页参数
-     * @return 流水记录列表
-     */
-    Flux<MemberCardTransactions> findByMemberIdAndTimeRange(Long memberId, LocalDateTime startTime,
-                                                             LocalDateTime endTime, Pageable pageable);
-
-    /**
-     * 后台"使用记录查询"
-     * @param memberId 会员ID
-     * @param memberCardId 会员卡ID
-     * @param operationType 操作类型
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @param pageable 分页参数
-     * @return 流水记录列表
-     */
-    Flux<MemberCardTransactions> findWithConditions(Long memberId, Long memberCardId,
-                                                     MemberCardTransactionsAction operationType,
-                                                     LocalDateTime startTime, LocalDateTime endTime,
-                                                     Pageable pageable);
-
-    /**
-     * 统计符合条件的流水总数
-     * @param memberId 会员ID
-     * @param memberCardId 会员卡ID
-     * @param operationType 操作类型
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 流水记录数量
-     */
-    Mono<Long> countWithConditions(Long memberId, Long memberCardId,
-                                   MemberCardTransactionsAction operationType,
-                                   LocalDateTime startTime, LocalDateTime endTime);
-
-    /**
-     * 按会员卡ID查询所有流水记录
-     * @param memberCardId 会员卡ID
-     * @return 该卡的所有流水记录，按时间倒序
-     */
-    Flux<MemberCardTransactions> findByMemberCardId(Long memberCardId);
-
-    /**
-     * 数据统计 - 统计某卡种的总扣次数
-     * @param memberCardId 会员卡ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 总扣次数
-     */
-    Mono<Long> sumDeductCountByCardId(Long memberCardId, LocalDateTime startTime, LocalDateTime endTime);
-
-    /**
-     * 数据统计 - 统计某时间段的续费总金额
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 续费总金额
-     */
-    Mono<Double> sumRenewAmountByTimeRange(LocalDateTime startTime, LocalDateTime endTime);
-
-    /**
-     * 数据统计 - 统计某会员的购卡总金额
-     * @param memberId 会员ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 购卡总金额
-     */
-    Mono<Double> sumPurchaseAmountByMemberId(Long memberId, LocalDateTime startTime, LocalDateTime endTime);
-
-    /**
-     * 保存流水记录
-     * @param transaction 流水记录
-     * @return 保存后的流水记录
-     */
-    Mono<MemberCardTransactions> save(MemberCardTransactions transaction);
-
-    /**
-     * 按会员ID查询所有流水记录
-     * @param memberId 会员ID
-     * @return 该会员的所有流水记录，按时间倒序
-     */
-    Flux<MemberCardTransactions> findByMemberId(Long memberId);
-
-    /**
-     * 按流水ID查询流水记录
-     * @param recordId 流水ID
-     * @return 该流水记录
-     */
-    Flux<MemberCardTransactions> findByRecordId(Long recordId);
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/repository/IRefundApplicationRepository.java

@@ -1,81 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.repository;
-
-import cn.novalon.gym.manage.gymmembercard.domain.RefundApplication;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-/**
- * 退款申请仓储接口
- *
- * @author shizhounian
- * @date 2026-05-23
- */
-public interface IRefundApplicationRepository {
-
-    /**
-     * 创建退款申请
-     *
-     * @param application 退款申请对象
-     * @return 创建后的退款申请
-     */
-    Mono<RefundApplication> create(RefundApplication application);
-
-    /**
-     * 根据ID查询退款申请
-     *
-     * @param id 退款申请ID
-     * @return 退款申请对象
-     */
-    Mono<RefundApplication> findById(Long id);
-
-    /**
-     * 根据会员卡记录ID查询退款申请
-     *
-     * @param recordId 会员卡记录ID
-     * @return 退款申请对象
-     */
-    Mono<RefundApplication> findByRecordId(Long recordId);
-
-    /**
-     * 根据会员ID查询退款申请列表
-     *
-     * @param memberId 会员ID
-     * @return 退款申请列表
-     */
-    Flux<RefundApplication> findByMemberId(Long memberId);
-
-    /**
-     * 根据状态查询退款申请列表
-     *
-     * @param status 状态
-     * @return 退款申请列表
-     */
-    Flux<RefundApplication> findByStatus(String status);
-
-    /**
-     * 更新退款申请
-     *
-     * @param application 退款申请对象
-     * @return 更新后的退款申请
-     */
-    Mono<RefundApplication> update(RefundApplication application);
-
-    /**
-     * 审核退款申请
-     *
-     * @param id 退款申请ID
-     * @param status 审核状态（APPROVED/REJECTED）
-     * @param auditorId 审核人ID
-     * @param auditRemark 审核备注
-     * @return 更新后的退款申请
-     */
-    Mono<RefundApplication> approve(Long id, String status, Long auditorId, String auditRemark);
-
-    /**
-     * 删除退款申请（逻辑删除）
-     *
-     * @param id 退款申请ID
-     * @return 受影响的行数
-     */
-    Mono<Integer> delete(Long id);
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/repository/impl/MemberCardRecordRepositoryImpl.java

@@ -1,105 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.repository.impl;
-
-import cn.novalon.gym.manage.gymmembercard.dao.MemberCardRecordDao;
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardRecord;
-import cn.novalon.gym.manage.gymmembercard.entity.MemberCardRecordEntity;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardRecordStatus;
-import cn.novalon.gym.manage.gymmembercard.repository.IMemberCardRecordRepository;
-import cn.novalon.gym.manage.gymmembercard.util.BeanConvertUtil;
-import org.springframework.data.domain.Pageable;
-import org.springframework.data.r2dbc.core.R2dbcEntityTemplate;
-import org.springframework.stereotype.Repository;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-@Repository
-public class MemberCardRecordRepositoryImpl implements IMemberCardRecordRepository {
-    private final MemberCardRecordDao memberCardRecordDao;
-    private final BeanConvertUtil beanConvertUtil;
-    private final R2dbcEntityTemplate r2dbcEntityTemplate;
-
-    public MemberCardRecordRepositoryImpl(MemberCardRecordDao memberCardRecordDao,
-                                          BeanConvertUtil beanConvertUtil,
-                                          R2dbcEntityTemplate r2dbcEntityTemplate) {
-        this.memberCardRecordDao = memberCardRecordDao;
-        this.beanConvertUtil = beanConvertUtil;
-        this.r2dbcEntityTemplate = r2dbcEntityTemplate;
-    }
-
-    @Override
-    public Mono<MemberCardRecord> findById(Long id) {
-        return memberCardRecordDao.findById(id)
-                .map(e -> beanConvertUtil.toBean(e, MemberCardRecord.class));
-    }
-
-    @Override
-    public Mono<MemberCardRecord> save(MemberCardRecord record) {
-        MemberCardRecordEntity entity = beanConvertUtil.toBean(record, MemberCardRecordEntity.class);
-        return memberCardRecordDao.save(entity)
-                .map(e -> beanConvertUtil.toBean(e, MemberCardRecord.class));
-    }
-
-    @Override
-    public Mono<MemberCardRecord> insertActiveRecord(MemberCardRecord record) {
-        MemberCardRecordEntity entity = beanConvertUtil.toBean(record, MemberCardRecordEntity.class);
-        return memberCardRecordDao.insertActiveRecord(
-                        entity.getMemberId(),
-                        entity.getMemberCardId(),
-                        entity.getExpireTime(),
-                        entity.getRemainingTimes(),
-                        entity.getRemainingAmount(),
-                        entity.getSourceOrderId())
-                .map(e -> beanConvertUtil.toBean(e, MemberCardRecord.class));
-    }
-
-    @Override
-    public Flux<MemberCardRecord> findByMemberId(Long memberId, Pageable pageable) {
-        return memberCardRecordDao.findByMemberId(memberId, pageable)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCardRecord.class));
-    }
-
-    @Override
-    public Flux<MemberCardRecord> findActiveCardsByMemberId(Long memberId) {
-        return memberCardRecordDao.findActiveCardsByMemberId(memberId)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCardRecord.class));
-    }
-
-    @Override
-    public Flux<MemberCardRecord> findActiveRecords() {
-        return memberCardRecordDao.findActiveRecords()
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCardRecord.class));
-    }
-
-    @Override
-    public Mono<Integer> updateStatus(Long id, MemberCardRecordStatus status) {
-        return memberCardRecordDao.updateStatus(id, status);
-    }
-
-    @Override
-    public Mono<Integer> deductUsage(Long recordId, Integer deductTimes, Double deductAmount) {
-        return memberCardRecordDao.deductUsage(recordId, deductTimes, deductAmount);
-    }
-
-    @Override
-    public Mono<Integer> renewCard(Long recordId, Integer addTimes, Double addAmount, java.time.LocalDateTime newExpireTime) {
-        return memberCardRecordDao.renewCard(recordId, addTimes, addAmount, newExpireTime);
-    }
-
-    @Override
-    public Flux<MemberCardRecord> findExpiredCards() {
-        return memberCardRecordDao.findExpiredCards()
-                .map(e -> beanConvertUtil.toBean(e, MemberCardRecord.class));
-    }
-
-    @Override
-    public Mono<MemberCardRecord> validateCountCard(Long recordId, Integer requiredTimes) {
-        return memberCardRecordDao.validateCountCard(recordId, requiredTimes)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCardRecord.class));
-    }
-
-    @Override
-    public Mono<MemberCardRecord> validateStoredCard(Long recordId, Double requiredAmount) {
-        return memberCardRecordDao.validateStoredCard(recordId, requiredAmount)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCardRecord.class));
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/repository/impl/MemberCardRepositoryImpl.java

@@ -1,146 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.repository.impl;
-
-import cn.novalon.gym.manage.gymmembercard.dao.MemberCardDao;
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCard;
-import cn.novalon.gym.manage.gymmembercard.entity.MemberCardEntity;
-import cn.novalon.gym.manage.gymmembercard.repository.IMemberCardRepository;
-import cn.novalon.gym.manage.gymmembercard.util.BeanConvertUtil;
-import org.springframework.data.domain.Pageable;
-import org.springframework.data.r2dbc.core.R2dbcEntityTemplate;
-import org.springframework.stereotype.Repository;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-@Repository
-public class MemberCardRepositoryImpl implements IMemberCardRepository {
-    private final MemberCardDao memberCardDao;
-    private final BeanConvertUtil beanConvertUtil;
-    private final R2dbcEntityTemplate r2dbcEntityTemplate;
-    //构造函数,初始化
-    public MemberCardRepositoryImpl(MemberCardDao memberCardDao, BeanConvertUtil beanConvertUtil, R2dbcEntityTemplate r2dbcEntityTemplate) {
-        this.memberCardDao = memberCardDao;
-        this.beanConvertUtil = beanConvertUtil;
-        this.r2dbcEntityTemplate = r2dbcEntityTemplate;
-    }
-
-    /**
-     * 根据会员卡ID查询会员卡详情（用于编辑前回显或小程序端展示）
-     * @param memberCardId 会员卡ID
-     * @return 会员卡完整信息，如果不存在或已删除则返回空
-     */
-    @Override
-    public Mono<MemberCard> findByMemberCardIdAndDeletedAtIsNull(Long memberCardId) {
-        return memberCardDao.findByMemberCardIdAndDeletedAtIsNull(memberCardId)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCard.class));
-    }
-
-    /**
-     * 条件查询会员卡列表（后台卡种列表展示，支持多条件组合+分页+排序）
-     * @param status 会员卡状态（上架/下架）
-     * @param name 会员卡名称（模糊查询）
-     * @param type 会员卡类型
-     * @param minPrice 最低价格
-     * @param maxPrice 最高价格
-     * @param pageable 分页和排序参数
-     * @return 符合条件的会员卡列表
-     */
-    @Override
-    public Flux<MemberCard> findWithConditions(Integer status, String name, String type,
-                                               Double minPrice, Double maxPrice, Pageable pageable) {
-        return memberCardDao.findWithConditions(status, name, type, minPrice, maxPrice, pageable)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCard.class));
-    }
-
-    /**
-     * 统计符合条件的会员卡总数（配合列表查询使用）
-     * @param status 会员卡状态
-     * @param name 会员卡名称（模糊查询）
-     * @param type 会员卡类型
-     * @param minPrice 最低价格
-     * @param maxPrice 最高价格
-     * @return 符合条件的会员卡数量
-     */
-    @Override
-    public Mono<Long> countWithConditions(Integer status, String name, String type,
-                                          Double minPrice, Double maxPrice) {
-        return memberCardDao.countWithConditions(status, name, type, minPrice, maxPrice);
-    }
-
-    /**
-     * 按状态查询会员卡列表（用于小程序端展示可购买卡列表，只展示上架的卡）
-     * @param status 会员卡状态（通常传上架状态）
-     * @param pageable 分页和排序参数
-     * @return 符合条件的会员卡列表
-     */
-    @Override
-    public Flux<MemberCard> findByMemberCardStatusAndDeletedAtIsNull(Integer status, Pageable pageable) {
-        return memberCardDao.findByMemberCardStatusAndDeletedAtIsNull(status, pageable)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCard.class));
-    }
-
-    /**
-     * 检查会员卡是否已被购买（用于删除前的校验）
-     * @param memberCardId 会员卡ID
-     * @return 如果存在关联的会员记录则返回true，否则返回false
-     */
-    @Override
-    public Mono<Boolean> existsPurchasedRecord(Long memberCardId) {
-        return memberCardDao.existsPurchasedRecord(memberCardId);
-    }
-
-    /**
-     * 逻辑删除会员卡（下架卡种，防止已购会员数据异常）
-     * @param memberCardId 会员卡ID
-     * @return 受影响的行数
-     */
-    @Override
-    public Mono<Integer> logicalDelete(Long memberCardId) {
-        return memberCardDao.logicalDelete(memberCardId);
-    }
-
-    /**
-     * 安全更新会员卡信息（不覆盖不允许修改的字段）
-     * @param memberCardId 会员卡ID
-     * @param updateData 需要更新的卡种信息
-     * @return 受影响的行数
-     */
-    public Mono<Integer> updateSafe(Long memberCardId, MemberCard updateData) {
-        MemberCardEntity memberCardEntity = beanConvertUtil.toBean(updateData, MemberCardEntity.class);
-        return memberCardDao.updateSafe(
-                memberCardId,
-                memberCardEntity.getMemberCardName(),
-                memberCardEntity.getMemberCardPrice(),
-                memberCardEntity.getMemberCardValidityDays(),
-                memberCardEntity.getMemberCardTotalTimes(),
-                memberCardEntity.getMemberCardAmount(),
-                memberCardEntity.getMemberCardStatus()
-        );
-    }
-
-
-    /**
-     * 保存卡种信息（新增或更新）
-     * - 新增：entity.memberCardId 为 null 时，插入新记录
-     * - 更新：entity.memberCardId 不为 null 时，根据ID更新现有记录
-     * 建议：更新时优先使用 updateSafe 方法避免全字段覆盖
-     * @param entity 卡种信息
-     * @return 保存后的实体对象
-     */
-    @Override
-    public Mono<MemberCard> save(MemberCard entity) {
-        MemberCardEntity cardEntity = beanConvertUtil.toBean(entity, MemberCardEntity.class);
-        return memberCardDao.save(cardEntity)
-                .map(savedEntity -> beanConvertUtil.toBean(savedEntity, MemberCard.class));
-    }
-
-    /**
-     * 批量查询上架的会员卡（用于小程序端展示）
-     * @param status 上架状态值
-     * @return 上架的会员卡列表
-     */
-    @Override
-    public Flux<MemberCard> findActiveCards(Integer status) {
-        return memberCardDao.findActiveCards(status)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCard.class));
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/repository/impl/MemberCardTransactionsRepositoryImpl.java

@@ -1,170 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.repository.impl;
-
-import cn.novalon.gym.manage.gymmembercard.dao.MemberCardTransactionsDao;
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardTransactions;
-import cn.novalon.gym.manage.gymmembercard.entity.MemberCardTransactionsEntity;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsAction;
-import cn.novalon.gym.manage.gymmembercard.repository.IMemberCardTransactionsRepository;
-import cn.novalon.gym.manage.gymmembercard.util.BeanConvertUtil;
-import org.springframework.data.domain.Pageable;
-import org.springframework.data.r2dbc.core.R2dbcEntityTemplate;
-import org.springframework.stereotype.Repository;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-import java.time.LocalDateTime;
-
-@Repository
-public class MemberCardTransactionsRepositoryImpl implements IMemberCardTransactionsRepository {
-    private final MemberCardTransactionsDao memberCardTransactionsDao;
-    private final BeanConvertUtil beanConvertUtil;
-    private final R2dbcEntityTemplate r2dbcEntityTemplate;
-
-    public MemberCardTransactionsRepositoryImpl(MemberCardTransactionsDao memberCardTransactionsDao, BeanConvertUtil beanConvertUtil, R2dbcEntityTemplate r2dbcEntityTemplate) {
-        this.memberCardTransactionsDao = memberCardTransactionsDao;
-        this.beanConvertUtil = beanConvertUtil;
-        this.r2dbcEntityTemplate = r2dbcEntityTemplate;
-    }
-
-    /**
-     * 记录每一次变动
-     * @param transactions 流水记录
-     * @return 插入的流水记录
-     */
-    @Override
-    public Mono<MemberCardTransactions> insertTransaction(MemberCardTransactions transactions) {
-        MemberCardTransactionsEntity entity = beanConvertUtil.toBean(transactions, MemberCardTransactionsEntity.class);
-        return memberCardTransactionsDao.insertTransaction(
-                        entity.getMemberCardId(),
-                        entity.getMemberId(),
-                        entity.getOperationType(),
-                        entity.getChangeAmount(),
-                        entity.getChangeBalance(),
-                        entity.getAfterRemainingCount(),
-                        entity.getAfterRemainingBalance(),
-                        entity.getRelatedBizType(),
-                        entity.getRemark())
-                .map(e -> beanConvertUtil.toBean(e, MemberCardTransactions.class));
-    }
-
-    /**
-     * 会员端"使用记录"
-     * @param memberId 会员ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @param pageable 分页参数
-     * @return 流水记录列表
-     */
-    @Override
-    public Flux<MemberCardTransactions> findByMemberIdAndTimeRange(Long memberId, LocalDateTime startTime,
-                                                                    LocalDateTime endTime, Pageable pageable) {
-        return memberCardTransactionsDao.findByMemberIdAndTimeRange(memberId, startTime, endTime, pageable)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCardTransactions.class));
-    }
-
-    /**
-     * 后台"使用记录查询"
-     * @param memberId 会员ID
-     * @param memberCardId 会员卡ID
-     * @param operationType 操作类型
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @param pageable 分页参数
-     * @return 流水记录列表
-     */
-    @Override
-    public Flux<MemberCardTransactions> findWithConditions(Long memberId, Long memberCardId,
-                                                            MemberCardTransactionsAction operationType,
-                                                            LocalDateTime startTime, LocalDateTime endTime,
-                                                            Pageable pageable) {
-        return memberCardTransactionsDao.findWithConditions(memberId, memberCardId, operationType,
-                                                             startTime, endTime, pageable)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCardTransactions.class));
-    }
-
-    /**
-     * 统计符合条件的流水总数
-     * @param memberId 会员ID
-     * @param memberCardId 会员卡ID
-     * @param operationType 操作类型
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 流水记录数量
-     */
-    @Override
-    public Mono<Long> countWithConditions(Long memberId, Long memberCardId,
-                                          MemberCardTransactionsAction operationType,
-                                          LocalDateTime startTime, LocalDateTime endTime) {
-        return memberCardTransactionsDao.countWithConditions(memberId, memberCardId,
-                                                              operationType, startTime, endTime);
-    }
-
-    /**
-     * 按会员卡ID查询所有流水记录
-     * @param memberCardId 会员卡ID
-     * @return 该卡的所有流水记录，按时间倒序
-     */
-    @Override
-    public Flux<MemberCardTransactions> findByMemberCardId(Long memberCardId) {
-        return memberCardTransactionsDao.findByMemberCardId(memberCardId)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCardTransactions.class));
-    }
-
-    /**
-     * 数据统计 - 统计某卡种的总扣次数
-     * @param memberCardId 会员卡ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 总扣次数
-     */
-    @Override
-    public Mono<Long> sumDeductCountByCardId(Long memberCardId, LocalDateTime startTime, LocalDateTime endTime) {
-        return memberCardTransactionsDao.sumDeductCountByCardId(memberCardId, startTime, endTime);
-    }
-
-    /**
-     * 数据统计 - 统计某时间段的续费总金额
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 续费总金额
-     */
-    @Override
-    public Mono<Double> sumRenewAmountByTimeRange(LocalDateTime startTime, LocalDateTime endTime) {
-        return memberCardTransactionsDao.sumRenewAmountByTimeRange(startTime, endTime);
-    }
-
-    /**
-     * 数据统计 - 统计某会员的购卡总金额
-     * @param memberId 会员ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 购卡总金额
-     */
-    @Override
-    public Mono<Double> sumPurchaseAmountByMemberId(Long memberId, LocalDateTime startTime, LocalDateTime endTime) {
-        return memberCardTransactionsDao.sumPurchaseAmountByMemberId(memberId, startTime, endTime);
-    }
-    /**
-     * 保存流水记录
-     * @param transaction 流水记录
-     * @return 保存后的流水记录
-     */
-    @Override
-    public Mono<MemberCardTransactions> save(MemberCardTransactions transaction) {
-        MemberCardTransactionsEntity entity = beanConvertUtil.toBean(transaction, MemberCardTransactionsEntity.class);
-        return memberCardTransactionsDao.save(entity)
-                .map(savedEntity -> beanConvertUtil.toBean(savedEntity, MemberCardTransactions.class));
-    }
-
-    @Override
-    public Flux<MemberCardTransactions> findByMemberId(Long memberId) {
-        return memberCardTransactionsDao.findByMemberId(memberId)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCardTransactions.class));
-    }
-
-    @Override
-    public Flux<MemberCardTransactions> findByRecordId(Long recordId) {
-        return memberCardTransactionsDao.findByRecordId(recordId)
-                .map(entity -> beanConvertUtil.toBean(entity, MemberCardTransactions.class));
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/repository/impl/RefundApplicationRepositoryImpl.java

@@ -1,125 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.repository.impl;
-
-import cn.novalon.gym.manage.gymmembercard.dao.RefundApplicationDao;
-import cn.novalon.gym.manage.gymmembercard.domain.RefundApplication;
-import cn.novalon.gym.manage.gymmembercard.entity.RefundApplicationEntity;
-import cn.novalon.gym.manage.gymmembercard.repository.IRefundApplicationRepository;
-import lombok.RequiredArgsConstructor;
-import org.springframework.stereotype.Repository;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-import java.time.LocalDateTime;
-
-/**
- * 退款申请仓储实现类
- *
- * @author shizhounian
- * @date 2026-05-23 21:16:36
- */
-@Repository
-@RequiredArgsConstructor
-public class RefundApplicationRepositoryImpl implements IRefundApplicationRepository {
-
-    private final RefundApplicationDao refundApplicationDao;
-
-    @Override
-    public Mono<RefundApplication> create(RefundApplication application) {
-        RefundApplicationEntity entity = new RefundApplicationEntity();
-        entity.setRecordId(application.getRecordId());
-        entity.setMemberId(application.getMemberId());
-        entity.setStatus(application.getStatus() != null ? application.getStatus() : "PENDING");
-        entity.setReason(application.getReason());
-        entity.setApplyTime(application.getApplyTime() != null ? application.getApplyTime() : LocalDateTime.now());
-        entity.setRefundAmount(application.getRefundAmount());
-
-        return refundApplicationDao.save(entity)
-                .map(this::convertToDomain);
-    }
-
-    @Override
-    public Mono<RefundApplication> findById(Long id) {
-        return refundApplicationDao.findById(id)
-                .map(this::convertToDomain);
-    }
-
-    @Override
-    public Mono<RefundApplication> findByRecordId(Long recordId) {
-        return refundApplicationDao.findByRecordId(recordId)
-                .map(this::convertToDomain);
-    }
-
-    @Override
-    public Flux<RefundApplication> findByMemberId(Long memberId) {
-        return refundApplicationDao.findByMemberId(memberId)
-                .map(this::convertToDomain);
-    }
-
-    @Override
-    public Flux<RefundApplication> findByStatus(String status) {
-        return refundApplicationDao.findByStatus(status)
-                .map(this::convertToDomain);
-    }
-
-    @Override
-    public Mono<RefundApplication> update(RefundApplication application) {
-        return refundApplicationDao.findById(application.getId())
-                .flatMap(entity -> {
-                    if (application.getStatus() != null) {
-                        entity.setStatus(application.getStatus());
-                    }
-                    if (application.getReason() != null) {
-                        entity.setReason(application.getReason());
-                    }
-                    if (application.getAuditTime() != null) {
-                        entity.setAuditTime(application.getAuditTime());
-                    }
-                    if (application.getAuditorId() != null) {
-                        entity.setAuditorId(application.getAuditorId());
-                    }
-                    if (application.getAuditRemark() != null) {
-                        entity.setAuditRemark(application.getAuditRemark());
-                    }
-                    if (application.getRefundAmount() != null) {
-                        entity.setRefundAmount(application.getRefundAmount());
-                    }
-                    return refundApplicationDao.save(entity);
-                })
-                .map(this::convertToDomain);
-    }
-
-    @Override
-    public Mono<RefundApplication> approve(Long id, String status, Long auditorId, String auditRemark) {
-        return refundApplicationDao.approve(id, status, auditorId, auditRemark)
-                .flatMap(rows -> {
-                    if (rows > 0) {
-                        return refundApplicationDao.findById(id)
-                                .map(this::convertToDomain);
-                    }
-                    return Mono.empty();
-                });
-    }
-
-    @Override
-    public Mono<Integer> delete(Long id) {
-        return refundApplicationDao.logicalDelete(id);
-    }
-
-    /**
-     * Entity转Domain
-     */
-    private RefundApplication convertToDomain(RefundApplicationEntity entity) {
-        RefundApplication domain = new RefundApplication();
-        domain.setId(entity.getId());
-        domain.setRecordId(entity.getRecordId());
-        domain.setMemberId(entity.getMemberId());
-        domain.setStatus(entity.getStatus());
-        domain.setReason(entity.getReason());
-        domain.setApplyTime(entity.getApplyTime());
-        domain.setAuditTime(entity.getAuditTime());
-        domain.setAuditorId(entity.getAuditorId());
-        domain.setAuditRemark(entity.getAuditRemark());
-        domain.setRefundAmount(entity.getRefundAmount());
-        return domain;
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/sevice/IMemberCardTransactionsService.java

@@ -1,112 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.sevice;
-
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardTransactions;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsAction;
-import org.springframework.data.domain.Pageable;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-import java.time.LocalDateTime;
-
-public interface IMemberCardTransactionsService {
-
-    /**
-     * 记录每一次变动
-     * @param transactions 流水记录
-     * @return 插入的流水记录
-     */
-    Mono<MemberCardTransactions> insertTransaction(MemberCardTransactions transactions);
-
-    /**
-     * 会员端"使用记录"
-     * @param memberId 会员ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @param pageable 分页参数
-     * @return 流水记录列表
-     */
-    Flux<MemberCardTransactions> findByMemberIdAndTimeRange(Long memberId, LocalDateTime startTime,
-                                                            LocalDateTime endTime, Pageable pageable);
-
-    /**
-     * 后台"使用记录查询"
-     * @param memberId 会员ID
-     * @param memberCardId 会员卡ID
-     * @param operationType 操作类型
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @param pageable 分页参数
-     * @return 流水记录列表
-     */
-    Flux<MemberCardTransactions> findWithConditions(Long memberId, Long memberCardId,
-                                                    MemberCardTransactionsAction operationType,
-                                                    LocalDateTime startTime, LocalDateTime endTime,
-                                                    Pageable pageable);
-
-    /**
-     * 统计符合条件的流水总数
-     * @param memberId 会员ID
-     * @param memberCardId 会员卡ID
-     * @param operationType 操作类型
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 流水记录数量
-     */
-    Mono<Long> countWithConditions(Long memberId, Long memberCardId,
-                                   MemberCardTransactionsAction operationType,
-                                   LocalDateTime startTime, LocalDateTime endTime);
-
-    /**
-     * 按会员卡ID查询所有流水记录
-     * @param memberCardId 会员卡ID
-     * @return 该卡的所有流水记录，按时间倒序
-     */
-    Flux<MemberCardTransactions> findByMemberCardId(Long memberCardId);
-
-    /**
-     * 数据统计 - 统计某卡种的总扣次数
-     * @param memberCardId 会员卡ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 总扣次数
-     */
-    Mono<Long> sumDeductCountByCardId(Long memberCardId, LocalDateTime startTime, LocalDateTime endTime);
-
-    /**
-     * 数据统计 - 统计某时间段的续费总金额
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 续费总金额
-     */
-    Mono<Double> sumRenewAmountByTimeRange(LocalDateTime startTime, LocalDateTime endTime);
-
-    /**
-     * 数据统计 - 统计某会员的购卡总金额
-     * @param memberId 会员ID
-     * @param startTime 开始时间
-     * @param endTime 结束时间
-     * @return 购卡总金额
-     */
-    Mono<Double> sumPurchaseAmountByMemberId(Long memberId, LocalDateTime startTime, LocalDateTime endTime);
-
-    /**
-     * 创建交易记录
-     * @param transaction 交易记录
-     * @return 创建的交易记录
-     */
-    Mono<Void> createTransaction(MemberCardTransactions transaction);
-
-    /**
-     * 查询会员的交易记录
-     * @param memberId 会员ID
-     * @return 交易记录列表
-     */
-    Flux<MemberCardTransactions> findByMemberId(Long memberId);
-
-    /**
-     * 查询会员卡记录的交易历史
-     * @param recordId 会员卡记录ID
-     * @return 交易记录列表
-     */
-    Flux<MemberCardTransactions> findByRecordId(Long recordId);
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/sevice/impl/MemberCardRecordServiceImpl.java

@@ -1,72 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.sevice.impl;
-
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardRecord;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardRecordStatus;
-import cn.novalon.gym.manage.gymmembercard.repository.IMemberCardRecordRepository;
-import cn.novalon.gym.manage.gymmembercard.sevice.IMemberCardRecordService;
-import org.springframework.beans.factory.annotation.Qualifier;
-import org.springframework.data.domain.Pageable;
-import org.springframework.stereotype.Service;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-import java.time.LocalDateTime;
-
-@Service
-public class MemberCardRecordServiceImpl implements IMemberCardRecordService {
-    private final IMemberCardRecordRepository memberCardRecordRepository;
-
-    public MemberCardRecordServiceImpl(IMemberCardRecordRepository memberCardRecordRepository) {
-        this.memberCardRecordRepository = memberCardRecordRepository;
-    }
-
-    @Override
-    public Mono<MemberCardRecord> insertActiveRecord(MemberCardRecord record) {
-        return memberCardRecordRepository.insertActiveRecord(record);
-    }
-
-    @Override
-    public Mono<Integer> deductUsage(Long recordId, Integer deductTimes, Double deductAmount) {
-        return memberCardRecordRepository.deductUsage(recordId, deductTimes, deductAmount);
-    }
-
-    @Override
-    public Mono<Integer> renewCard(Long recordId, Integer addTimes, Double addAmount, LocalDateTime newExpireTime) {
-        return memberCardRecordRepository.renewCard(recordId, addTimes, addAmount, newExpireTime);
-    }
-
-    @Override
-    public Mono<Integer> updateStatus(Long recordId, MemberCardRecordStatus status) {
-        return memberCardRecordRepository.updateStatus(recordId, status);
-    }
-
-    @Override
-    public Flux<MemberCardRecord> findActiveCardsByMemberId(Long memberId) {
-        return memberCardRecordRepository.findActiveCardsByMemberId(memberId);
-    }
-
-    @Override
-    public Flux<MemberCardRecord> findByMemberId(Long memberId, Pageable pageable) {
-        return memberCardRecordRepository.findByMemberId(memberId, pageable);
-    }
-
-    @Override
-    public Mono<MemberCardRecord> validateCountCard(Long recordId, Integer requiredTimes) {
-        return memberCardRecordRepository.validateCountCard(recordId, requiredTimes);
-    }
-
-    @Override
-    public Mono<MemberCardRecord> validateStoredCard(Long recordId, Double requiredAmount) {
-        return memberCardRecordRepository.validateStoredCard(recordId, requiredAmount);
-    }
-
-    @Override
-    public Flux<MemberCardRecord> findExpiredCards() {
-        return memberCardRecordRepository.findExpiredCards();
-    }
-
-    @Override
-    public Mono<MemberCardRecord> findById(Long recordId) {
-        return memberCardRecordRepository.findById(recordId);
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/sevice/impl/MemberCardTransactionsServiceImpl.java

@@ -1,89 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.sevice.impl;
-
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardTransactions;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsAction;
-import cn.novalon.gym.manage.gymmembercard.repository.IMemberCardTransactionsRepository;
-import cn.novalon.gym.manage.gymmembercard.sevice.IMemberCardTransactionsService;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.data.domain.Pageable;
-import org.springframework.stereotype.Service;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-import java.time.LocalDateTime;
-
-@Slf4j
-@Service
-public class MemberCardTransactionsServiceImpl implements IMemberCardTransactionsService {
-    private final IMemberCardTransactionsRepository memberCardTransactionsRepository;
-
-    public MemberCardTransactionsServiceImpl(IMemberCardTransactionsRepository memberCardTransactionsRepository) {
-        this.memberCardTransactionsRepository = memberCardTransactionsRepository;
-    }
-
-    @Override
-    public Mono<MemberCardTransactions> insertTransaction(MemberCardTransactions transactions) {
-        return memberCardTransactionsRepository.insertTransaction(transactions);
-    }
-
-    @Override
-    public Flux<MemberCardTransactions> findByMemberIdAndTimeRange(Long memberId, LocalDateTime startTime,
-                                                                    LocalDateTime endTime, Pageable pageable) {
-        return memberCardTransactionsRepository.findByMemberIdAndTimeRange(memberId, startTime, endTime, pageable);
-    }
-
-    @Override
-    public Flux<MemberCardTransactions> findWithConditions(Long memberId, Long memberCardId,
-                                                            MemberCardTransactionsAction operationType,
-                                                            LocalDateTime startTime, LocalDateTime endTime,
-                                                            Pageable pageable) {
-        return memberCardTransactionsRepository.findWithConditions(memberId, memberCardId, operationType,
-                                                             startTime, endTime, pageable);
-    }
-
-    @Override
-    public Mono<Long> countWithConditions(Long memberId, Long memberCardId,
-                                          MemberCardTransactionsAction operationType,
-                                          LocalDateTime startTime, LocalDateTime endTime) {
-        return memberCardTransactionsRepository.countWithConditions(memberId, memberCardId,
-                                                              operationType, startTime, endTime);
-    }
-
-    @Override
-    public Flux<MemberCardTransactions> findByMemberCardId(Long memberCardId) {
-        return memberCardTransactionsRepository.findByMemberCardId(memberCardId);
-    }
-
-    @Override
-    public Mono<Long> sumDeductCountByCardId(Long memberCardId, LocalDateTime startTime, LocalDateTime endTime) {
-        return memberCardTransactionsRepository.sumDeductCountByCardId(memberCardId, startTime, endTime);
-    }
-
-    @Override
-    public Mono<Double> sumRenewAmountByTimeRange(LocalDateTime startTime, LocalDateTime endTime) {
-        return memberCardTransactionsRepository.sumRenewAmountByTimeRange(startTime, endTime);
-    }
-
-    @Override
-    public Mono<Double> sumPurchaseAmountByMemberId(Long memberId, LocalDateTime startTime, LocalDateTime endTime) {
-        return memberCardTransactionsRepository.sumPurchaseAmountByMemberId(memberId, startTime, endTime);
-    }
-
-    @Override
-    public Mono<Void> createTransaction(MemberCardTransactions transaction) {
-        return memberCardTransactionsRepository.save(transaction)
-                .then()
-                .doOnSuccess(v -> log.info("创建会员卡交易记录: memberId={}, cardId={}, type={}",
-                        transaction.getMemberId(), transaction.getMemberCardId(), transaction.getOperationType()));
-    }
-
-    @Override
-    public Flux<MemberCardTransactions> findByMemberId(Long memberId) {
-        return memberCardTransactionsRepository.findByMemberId(memberId);
-    }
-
-    @Override
-    public Flux<MemberCardTransactions> findByRecordId(Long recordId) {
-        return memberCardTransactionsRepository.findByRecordId(recordId);
-    }
-}

gym-manage-api/gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/sevice/impl/RefundApplicationServiceImpl.java

@@ -1,85 +0,0 @@
-package cn.novalon.gym.manage.gymmembercard.sevice.impl;
-
-import cn.novalon.gym.manage.gymmembercard.domain.RefundApplication;
-import cn.novalon.gym.manage.gymmembercard.repository.IRefundApplicationRepository;
-import cn.novalon.gym.manage.gymmembercard.sevice.IRefundApplicationService;
-import lombok.extern.slf4j.Slf4j;
-import org.springframework.stereotype.Service;
-import reactor.core.publisher.Flux;
-import reactor.core.publisher.Mono;
-
-import java.time.LocalDateTime;
-
-/**
- * 退款申请服务实现类
- *
- * @author shizhounian
- * @date 2026-05-23 21:18:33
- */
-@Slf4j
-@Service
-public class RefundApplicationServiceImpl implements IRefundApplicationService {
-
-    private final IRefundApplicationRepository refundApplicationRepository;
-
-    public RefundApplicationServiceImpl(IRefundApplicationRepository refundApplicationRepository) {
-        this.refundApplicationRepository = refundApplicationRepository;
-    }
-
-    @Override
-    public Mono<RefundApplication> create(Long recordId, String reason) {
-        return refundApplicationRepository.findByRecordId(recordId)
-                .flatMap(existing -> {
-                    if (existing != null) {
-                        return Mono.error(new RuntimeException("该会员卡记录已有退款申请"));
-                    }
-                    return Mono.empty();
-                })
-                .then(Mono.defer(() -> {
-                    RefundApplication application = new RefundApplication();
-                    application.setRecordId(recordId);
-                    application.setReason(reason);
-                    application.setStatus("PENDING");
-                    application.setApplyTime(LocalDateTime.now());
-
-                    return refundApplicationRepository.create(application)
-                            .doOnSuccess(app -> log.info("创建退款申请成功: applicationId={}, recordId={}",
-                                app.getId(), recordId));
-                }));
-    }
-
-    @Override
-    public Mono<RefundApplication> approve(Long applicationId, Long auditorId, String remark) {
-        return refundApplicationRepository.findById(applicationId)
-                .switchIfEmpty(Mono.error(new RuntimeException("退款申请不存在")))
-                .flatMap(application -> {
-                    if (!"PENDING".equals(application.getStatus())) {
-                        return Mono.error(new RuntimeException("退款申请状态不正确，当前状态: " + application.getStatus()));
-                    }
-
-                    return refundApplicationRepository.approve(applicationId, "APPROVED", auditorId, remark)
-                            .doOnSuccess(app -> log.info("批准退款申请成功: applicationId={}, auditorId={}",
-                                applicationId, auditorId));
-                });
-    }
-
-    @Override
-    public Mono<RefundApplication> reject(Long applicationId, Long auditorId, String remark) {
-        return refundApplicationRepository.findById(applicationId)
-                .switchIfEmpty(Mono.error(new RuntimeException("退款申请不存在")))
-                .flatMap(application -> {
-                    if (!"PENDING".equals(application.getStatus())) {
-                        return Mono.error(new RuntimeException("退款申请状态不正确，当前状态: " + application.getStatus()));
-                    }
-
-                    return refundApplicationRepository.approve(applicationId, "REJECTED", auditorId, remark)
-                            .doOnSuccess(app -> log.info("拒绝退款申请成功: applicationId={}, auditorId={}",
-                                applicationId, auditorId));
-                });
-    }
-
-    @Override
-    public Mono<RefundApplication> findByRecordId(Long recordId) {
-        return refundApplicationRepository.findByRecordId(recordId);
-    }
-}

gym-manage-api/gym-member-card/src/main/resources/sql

@@ -1,132 +0,0 @@
--- ============================================
--- 会员卡类型表
--- ============================================
-CREATE TABLE IF NOT EXISTS member_card (
-    member_card_id BIGSERIAL PRIMARY KEY,
-    member_card_name VARCHAR(100) NOT NULL,
-    member_card_type VARCHAR(20) NOT NULL,
-    member_card_price DECIMAL(10, 2) NOT NULL,
-    member_card_validity_days INTEGER,
-    member_card_total_times INTEGER,
-    member_card_amount DECIMAL(10, 2),
-    member_card_status INTEGER DEFAULT 1 NOT NULL,
-    extra_config JSONB DEFAULT '{}'::jsonb,
-    created_at TIMESTAMPTZ DEFAULT NOW(),
-    updated_at TIMESTAMPTZ DEFAULT NOW(),
-    deleted_at TIMESTAMPTZ
-);
-
-COMMENT ON TABLE member_card IS '会员卡类型表';
-COMMENT ON COLUMN member_card.member_card_id IS '会员卡ID';
-COMMENT ON COLUMN member_card.member_card_name IS '会员卡名称';
-COMMENT ON COLUMN member_card.member_card_type IS '会员卡类型：TIME_CARD-时长卡, COUNT_CARD-次卡, STORED_VALUE_CARD-储值卡';
-COMMENT ON COLUMN member_card.member_card_price IS '会员卡价格';
-COMMENT ON COLUMN member_card.member_card_validity_days IS '有效天数（时长卡用）';
-COMMENT ON COLUMN member_card.member_card_total_times IS '总次数（次卡用）';
-COMMENT ON COLUMN member_card.member_card_amount IS '面额（储值卡用）';
-COMMENT ON COLUMN member_card.member_card_status IS '状态：0-下架, 1-上架';
-COMMENT ON COLUMN member_card.extra_config IS '扩展配置（JSON格式，用于未来组合卡等）';
-
--- ============================================
--- 会员卡记录表（会员持有的卡）
--- ============================================
-CREATE TABLE IF NOT EXISTS member_card_record (
-    member_card_record_id BIGSERIAL PRIMARY KEY,
-    member_id BIGINT NOT NULL,
-    member_card_id BIGINT NOT NULL,
-    status VARCHAR(20) NOT NULL DEFAULT 'ACTIVE',
-    remaining_times INTEGER DEFAULT 0,
-    remaining_amount DECIMAL(10, 2) DEFAULT 0.00,
-    expire_time TIMESTAMPTZ,
-    source_order_id BIGINT,
-    purchase_time TIMESTAMPTZ DEFAULT NOW(),
-    version INTEGER DEFAULT 0 NOT NULL,
-    card_composition JSONB DEFAULT NULL,
-    created_at TIMESTAMPTZ DEFAULT NOW(),
-    updated_at TIMESTAMPTZ DEFAULT NOW(),
-    deleted_at TIMESTAMPTZ
-    -- 移除外键约束，改用应用层验证
-);
-
--- 索引优化
-CREATE INDEX idx_member_card_record_member_id ON member_card_record(member_id);
-CREATE INDEX idx_member_card_record_status ON member_card_record(status);
-CREATE INDEX idx_member_card_record_expire_time ON member_card_record(expire_time);
-CREATE INDEX idx_member_card_record_member_status ON member_card_record(member_id, status);
-CREATE INDEX idx_member_card_record_status_expire ON member_card_record(status, expire_time)
-    WHERE status = 'ACTIVE';
-
-COMMENT ON TABLE member_card_record IS '会员卡记录表';
-COMMENT ON COLUMN member_card_record.member_card_record_id IS '会员卡记录ID';
-COMMENT ON COLUMN member_card_record.member_id IS '会员ID';
-COMMENT ON COLUMN member_card_record.member_card_id IS '会员卡类型ID';
-COMMENT ON COLUMN member_card_record.status IS '状态：ACTIVE-有效, USED_UP-用完, EXPIRED-过期, REFUNDED-已退款';
-COMMENT ON COLUMN member_card_record.remaining_times IS '剩余次数';
-COMMENT ON COLUMN member_card_record.remaining_amount IS '剩余金额';
-COMMENT ON COLUMN member_card_record.expire_time IS '到期时间';
-COMMENT ON COLUMN member_card_record.source_order_id IS '来源订单ID';
-COMMENT ON COLUMN member_card_record.purchase_time IS '购买时间';
-COMMENT ON COLUMN member_card_record.version IS '乐观锁版本号';
-COMMENT ON COLUMN member_card_record.card_composition IS '卡片组成（JSON格式，用于组合卡）';
-
--- ============================================
--- 会员卡交易流水表
--- ============================================
-CREATE TABLE IF NOT EXISTS member_card_transactions (
-    id BIGSERIAL PRIMARY KEY,
-    member_card_record_id BIGINT NOT NULL,
-    member_id BIGINT NOT NULL,
-    member_card_id BIGINT NOT NULL,
-    operation_type VARCHAR(20) NOT NULL,
-    change_amount INTEGER DEFAULT 0,
-    change_balance DECIMAL(10, 2) DEFAULT 0.00,
-    after_remaining_count INTEGER DEFAULT 0,
-    after_remaining_balance DECIMAL(10, 2) DEFAULT 0.00,
-    related_biz_type VARCHAR(20),
-    source_order_id BIGINT,
-    remark VARCHAR(500),
-    is_archived BOOLEAN DEFAULT FALSE NOT NULL,
-    archived_at TIMESTAMPTZ,
-    created_at TIMESTAMPTZ DEFAULT NOW()
-    -- 移除外键约束，改用应用层验证
-);
-
--- 退款申请表
-CREATE TABLE IF NOT EXISTS refund_application (
-    id BIGSERIAL PRIMARY KEY,
-    record_id BIGINT NOT NULL,
-    member_id BIGINT NOT NULL,
-    status VARCHAR(20) NOT NULL DEFAULT 'PENDING', -- PENDING/APPROVED/REJECTED/PROCESSING/SUCCESS/FAILED
-    reason VARCHAR(500),
-    apply_time TIMESTAMPTZ DEFAULT NOW(),
-    audit_time TIMESTAMPTZ,
-    auditor_id BIGINT,
-    audit_remark VARCHAR(500),
-    refund_amount DECIMAL(10, 2),
-    created_at TIMESTAMPTZ DEFAULT NOW(),
-    updated_at TIMESTAMPTZ DEFAULT NOW()
-);
-
-CREATE INDEX idx_refund_application_record_id ON refund_application(record_id);
-CREATE INDEX idx_refund_application_status ON refund_application(status);
-
-COMMENT ON TABLE refund_application IS '退款申请表';
-COMMENT ON COLUMN refund_application.status IS '状态：PENDING-待审核, APPROVED-已批准, REJECTED-已拒绝, PROCESSING-处理中, SUCCESS-成功, FAILED-失败';
-
-
--- 索引优化
-CREATE INDEX idx_member_card_transactions_member_id ON member_card_transactions(member_id);
-CREATE INDEX idx_member_card_transactions_record_id ON member_card_transactions(member_card_record_id);
-CREATE INDEX idx_member_card_transactions_created_at ON member_card_transactions(created_at);
-CREATE INDEX idx_member_card_transactions_member_type_time
-    ON member_card_transactions(member_id, operation_type, created_at);
-
-COMMENT ON TABLE member_card_transactions IS '会员卡交易流水表';
-COMMENT ON COLUMN member_card_transactions.operation_type IS '操作类型：PURCHASE-购买, DEDUCT-扣次/扣费, RENEW-续费, REFUND-退款, EXPIRE-过期';
-COMMENT ON COLUMN member_card_transactions.change_amount IS '变动次数';
-COMMENT ON COLUMN member_card_transactions.change_balance IS '变动金额';
-COMMENT ON COLUMN member_card_transactions.after_remaining_count IS '变动后剩余次数';
-COMMENT ON COLUMN member_card_transactions.after_remaining_balance IS '变动后剩余金额';
-COMMENT ON COLUMN member_card_transactions.related_biz_type IS '关联业务类型：GROUP_CLASS-团课, PT_CLASS-私教, CHECK_IN-签到';
-COMMENT ON COLUMN member_card_transactions.is_archived IS '是否已归档';
-COMMENT ON COLUMN member_card_transactions.archived_at IS '归档时间';

gym-manage-api/gym-member/.gitignore

@@ -0,0 +1,47 @@
+target/
+!.mvn/wrapper/maven-wrapper.jar
+!**/src/main/**/target/
+!**/src/test/**/target/
+
+### STS ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+
+### IntelliJ IDEA ###
+.idea
+*.iws
+*.iml
+*.ipr
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+build/
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### VS Code ###
+.vscode/
+
+### Maven ###
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+.mvn/wrapper/maven-wrapper.jar
+
+### System Files ###
+.DS_Store
+Thumbs.db

gym-manage-api/gym-member/CARD_MERGE_REPORT.md

@@ -0,0 +1,199 @@
+# gym-member-card 模块合并到 gym-member 完成报告
+
+## 合并概述
+将 `gym-member-card` 模块的功能合并到 `gym-member` 模块的 `card` 子包中，保持功能不变，代码风格以 `gym-member` 为基准。
+
+## 已完成的工作
+
+### 1. 目录结构创建 ✅
+在 `gym-member/src/main/java/cn/novalon/gym/manage/member/card` 下创建了以下子目录：
+- `entity/` - 实体类
+- `dto/` - 数据传输对象
+- `vo/` - 视图对象
+- `repository/` - 数据访问层
+- `service/` - 服务接口
+- `service/impl/` - 服务实现
+- `handler/` - 业务处理器
+- `enums/` - 枚举类
+- `util/` - 工具类
+
+### 2. 实体类重构（Entity）✅
+按照 gym-member 的风格（使用 Lombok），创建了以下实体类：
+
+| 原文件 | 新文件 | 说明 |
+|--------|--------|------|
+| MemberCardEntity.java + MemberCard.java | card/entity/MemberCard.java | 会员卡类型实体 |
+| MemberCardRecordEntity.java + MemberCardRecord.java | card/entity/MemberCardRecord.java | 会员持卡记录实体 |
+| MemberCardTransactionsEntity.java | card/entity/MemberCardTransaction.java | 交易流水实体 |
+| RefundApplicationEntity.java | card/entity/RefundApplication.java | 退款申请实体 |
+
+**主要改进：**
+- 使用 `@Data`, `@Builder`, `@NoArgsConstructor`, `@AllArgsConstructor` Lombok 注解
+- 继承 `cn.novalon.gym.manage.member.entity.BaseEntity`
+- 移除手动编写的 getter/setter
+- 添加规范的 JavaDoc 注释
+
+### 3. 枚举类创建 ✅
+创建了以下枚举类：
+
+| 原文件 | 新文件 | 说明 |
+|--------|--------|------|
+| MemberCardType.java | card/enums/MemberCardType.java | 会员卡类型 |
+| MemberCardRecordStatus.java | card/enums/MemberCardRecordStatus.java | 卡片状态 |
+| MemberCardTransactionsAction.java | card/enums/TransactionType.java | 交易操作类型 |
+| MemberCardTransactionsType.java | card/enums/BizType.java | 关联业务类型 |
+| MemberCardEvent.java | card/enums/CardEvent.java | 状态机事件 |
+
+### 4. Repository 层合并 ✅
+将原有的 DAO 接口整合为 Repository 接口，直接继承 `R2dbcRepository`：
+
+| 原文件 | 新文件 | 说明 |
+|--------|--------|------|
+| MemberCardDao.java | card/repository/MemberCardRepository.java | 会员卡类型 Repository |
+| MemberCardRecordDao.java | card/repository/MemberCardRecordRepository.java | 持卡记录 Repository |
+| MemberCardTransactionsDao.java | card/repository/MemberCardTransactionRepository.java | 交易流水 Repository |
+| RefundApplicationDao.java | card/repository/RefundApplicationRepository.java | 退款申请 Repository |
+
+**主要改进：**
+- 统一命名规范（移除 Dao，使用 Repository）
+- 继承 `R2dbcRepository<Entity, Long>`
+- 保留所有自定义查询方法
+- 更新参数类型为新的实体类
+
+### 5. 数据库 Schema 迁移 ✅
+将会员卡相关的表结构添加到 `gym-member/src/main/resources/db/schema.sql`：
+
+新增表：
+- `member_card` - 会员卡类型表
+- `member_card_record` - 会员持卡记录表
+- `member_card_transactions` - 交易流水表
+- `refund_application` - 退款申请表
+
+包含完整的索引和注释。
+
+### 6. pom.xml 依赖更新 ✅
+在 `gym-member/pom.xml` 中添加了 Redis 响应式支持：
+```xml
+<dependency>
+    <groupId>org.springframework.boot</groupId>
+    <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
+</dependency>
+```
+
+## 待完成的工作
+
+### 需要手动复制的文件（约30个）
+
+以下文件需要从 `gym-member-card` 复制到 `gym-member/card`，并修改包名：
+
+#### Handler 层（8个文件）
+源路径：`gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/handler/`
+目标路径：`gym-member/src/main/java/cn/novalon/gym/manage/member/card/handler/`
+
+- DistributedLockService.java
+- ExpirationReminderService.java
+- MemberCardHandler.java
+- MemberCardRecordHandler.java
+- MemberCardScheduledHandler.java
+- MemberCardStateMachine.java
+- MemberCardTransactionHandler.java
+- RefundSagaHandler.java
+
+#### Service 接口层（4个文件）
+源路径：`gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/sevice/`
+目标路径：`gym-member/src/main/java/cn/novalon/gym/manage/member/card/service/`
+
+注意：目录名从 `sevice`（拼写错误）改为 `service`
+
+- IMemberCardService.java
+- IMemberCardRecordService.java
+- IMemberCardTransactionsService.java
+- IRefundApplicationService.java
+
+#### Service 实现层（4个文件）
+源路径：`gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/sevice/impl/`
+目标路径：`gym-member/src/main/java/cn/novalon/gym/manage/member/card/service/impl/`
+
+- MemberCardServiceImpl.java
+- MemberCardRecordServiceImpl.java
+- MemberCardTransactionsServiceImpl.java
+- RefundApplicationServiceImpl.java
+
+#### Util 工具类（1个文件）
+源路径：`gym-member-card/src/main/java/cn/novalon/gym/manage/gymmembercard/util/`
+目标路径：`gym-member/src/main/java/cn/novalon/gym/manage/member/card/util/`
+
+- BeanConvertUtil.java
+
+### 批量替换规则
+
+复制每个文件后，需要进行以下文本替换：
+
+1. **包名替换：**
+   ```
+   package cn.novalon.gym.manage.gymmembercard -> package cn.novalon.gym.manage.member.card
+   ```
+
+2. **导入语句替换：**
+   ```
+   import cn.novalon.gym.manage.gymmembercard -> import cn.novalon.gym.manage.member.card
+   ```
+
+3. **BaseEntity 导入替换：**
+   ```
+   import cn.novalon.gym.manage.db.entity.BaseEntity -> import cn.novalon.gym.manage.member.entity.BaseEntity
+   ```
+
+4. **BaseDomain 处理（如果存在）：**
+   ```
+   import cn.novalon.gym.manage.sys.core.domain.BaseDomain -> （注释掉或删除）
+   ```
+
+5. **Repository 引用更新（如果需要）：**
+   ```
+   IMemberCardRepository -> MemberCardRepository
+   IMemberCardRecordRepository -> MemberCardRecordRepository
+   IMemberCardTransactionsRepository -> MemberCardTransactionRepository
+   IRefundApplicationRepository -> RefundApplicationRepository
+   ```
+
+## 验证步骤
+
+完成文件复制后，执行以下验证：
+
+1. **编译验证：**
+   ```bash
+   cd gym-manage-api/gym-member
+   mvn clean compile
+   ```
+
+2. **检查是否有编译错误：**
+   - 修复任何缺失的导入
+   - 确认所有依赖类都已正确迁移
+   - 检查枚举引用是否正确
+
+3. **运行测试（如果有）：**
+   ```bash
+   mvn test
+   ```
+
+## 注意事项
+
+1. **包名一致性：** 确保所有文件中的包声明和导入语句都正确更新
+2. **依赖注入：** Spring 的 `@Autowired` 或构造函数注入应自动工作，因为使用了相同的注解
+3. **数据库兼容性：** schema.sql 已追加新表，不会影响现有表
+4. **Redis 配置：** 确保 application.yml 中有 Redis 配置（如果需要分布式锁功能）
+5. **定时任务：** MemberCardScheduledHandler 和 ExpirationReminderService 可能需要启用 `@EnableScheduling`
+
+## 自动化脚本
+
+项目根目录下提供了两个辅助脚本：
+- `gym-member-card/migrate_to_member.py` - Python 迁移脚本
+- `gym-member-card/migrate-to-member.ps1` - PowerShell 迁移脚本
+
+可以运行这些脚本来自动完成文件复制和包名替换。
+
+---
+
+**生成时间：** 2026-05-27
+**合并状态：** 基础架构完成，待复制业务逻辑文件

gym-manage-api/gym-member/MEMBER_USER_TABLE_SIMPLE.sql

@@ -0,0 +1,58 @@
+-- ============================================
+-- member_user 表 - 简洁版建表语句
+-- ============================================
+-- 用途：直接复制执行，快速创建会员表
+-- ============================================
+
+CREATE TABLE IF NOT EXISTS member_user (
+    -- 主键和基础字段
+    id BIGSERIAL PRIMARY KEY,
+    created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    
+    -- 会员核心字段
+    member_no VARCHAR(50) NOT NULL UNIQUE,
+    nickname VARCHAR(100),
+    phone VARCHAR(255),
+    gender INTEGER DEFAULT 0,
+    birthday TIMESTAMP,
+    address VARCHAR(500),
+    avatar VARCHAR(500),
+    subscribed BOOLEAN DEFAULT FALSE,
+    last_login_at TIMESTAMP,
+    
+    -- 微信相关字段
+    union_id VARCHAR(100),
+    miniapp_open_id VARCHAR(100),
+    official_open_id VARCHAR(100),
+    
+    -- 软删除字段
+    is_deleted BOOLEAN DEFAULT FALSE
+);
+
+-- 创建索引
+CREATE UNIQUE INDEX IF NOT EXISTS idx_member_user_member_no ON member_user(member_no);
+CREATE INDEX IF NOT EXISTS idx_member_user_union_id ON member_user(union_id);
+CREATE INDEX IF NOT EXISTS idx_member_user_miniapp_openid ON member_user(miniapp_open_id);
+CREATE INDEX IF NOT EXISTS idx_member_user_official_openid ON member_user(official_open_id);
+CREATE INDEX IF NOT EXISTS idx_member_user_phone ON member_user(phone);
+CREATE INDEX IF NOT EXISTS idx_member_user_is_deleted ON member_user(is_deleted);
+
+-- 添加注释
+COMMENT ON TABLE member_user IS '会员表';
+COMMENT ON COLUMN member_user.id IS '主键ID';
+COMMENT ON COLUMN member_user.created_at IS '创建时间';
+COMMENT ON COLUMN member_user.updated_at IS '更新时间';
+COMMENT ON COLUMN member_user.member_no IS '会员编号（唯一）';
+COMMENT ON COLUMN member_user.nickname IS '昵称';
+COMMENT ON COLUMN member_user.phone IS '手机号（AES加密存储）';
+COMMENT ON COLUMN member_user.gender IS '性别：0-未知，1-男，2-女';
+COMMENT ON COLUMN member_user.birthday IS '生日';
+COMMENT ON COLUMN member_user.address IS '地址';
+COMMENT ON COLUMN member_user.avatar IS '头像URL';
+COMMENT ON COLUMN member_user.subscribed IS '是否关注服务号';
+COMMENT ON COLUMN member_user.last_login_at IS '最后登录时间';
+COMMENT ON COLUMN member_user.union_id IS '微信UnionID（跨应用唯一标识）';
+COMMENT ON COLUMN member_user.miniapp_open_id IS '小程序OpenID';
+COMMENT ON COLUMN member_user.official_open_id IS '服务号OpenID';
+COMMENT ON COLUMN member_user.is_deleted IS '是否删除（软删除标记）';

gym-manage-api/gym-member/pom.xml

@@ -0,0 +1,250 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>cn.novalon.gym.manage</groupId>
+        <artifactId>gym-manage-api</artifactId>
+        <version>1.0.0</version>
+    </parent>
+
+    <artifactId>gym-member</artifactId>
+    <packaging>jar</packaging>
+
+    <name>Gym Member</name>
+    <description>Member Management Module - Frontend User Services</description>
+
+    <dependencies>
+        <dependency>
+            <groupId>cn.novalon.gym.manage</groupId>
+            <artifactId>manage-common</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>cn.novalon.gym.manage</groupId>
+            <artifactId>manage-db</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>cn.novalon.gym.manage</groupId>
+            <artifactId>manage-sys</artifactId>
+            <version>${project.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-webflux</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-aop</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webflux-ui</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-security</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.data</groupId>
+            <artifactId>spring-data-commons</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.security</groupId>
+            <artifactId>spring-security-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.projectreactor</groupId>
+            <artifactId>reactor-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.github.resilience4j</groupId>
+            <artifactId>resilience4j-spring-boot3</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.github.resilience4j</groupId>
+            <artifactId>resilience4j-reactor</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.testcontainers</groupId>
+            <artifactId>testcontainers</artifactId>
+            <version>1.21.4</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.testcontainers</groupId>
+            <artifactId>postgresql</artifactId>
+            <version>1.21.4</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.testcontainers</groupId>
+            <artifactId>junit-jupiter</artifactId>
+            <version>1.21.4</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.h2database</groupId>
+            <artifactId>h2</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>io.r2dbc</groupId>
+            <artifactId>r2dbc-h2</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.postgresql</groupId>
+            <artifactId>r2dbc-postgresql</artifactId>
+            <scope>test</scope>
+        </dependency>
+        <!-- 微信SDK依赖 -->
+        <dependency>
+            <groupId>com.github.binarywang</groupId>
+            <artifactId>weixin-java-miniapp</artifactId>
+            <version>4.6.0</version>
+        </dependency>
+        <dependency>
+            <groupId>com.github.binarywang</groupId>
+            <artifactId>weixin-java-mp</artifactId>
+            <version>4.6.0</version>
+        </dependency>
+        <dependency>
+            <groupId>cn.hutool</groupId>
+            <artifactId>hutool-all</artifactId>
+            <version>5.8.25</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
+        </dependency>
+        <!-- Redis响应式支持（会员卡模块需要） -->
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
+        </dependency>
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <version>3.4.2</version>
+                <executions>
+                    <execution>
+                        <id>default-jar</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>jar</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.11.0</version>
+                <configuration>
+                    <source>21</source>
+                    <target>21</target>
+                    <annotationProcessorPaths>
+                        <path>
+                            <groupId>org.mapstruct</groupId>
+                            <artifactId>mapstruct-processor</artifactId>
+                            <version>1.5.5.Final</version>
+                        </path>
+                        <path>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok</artifactId>
+                            <version>${lombok.version}</version>
+                        </path>
+                        <path>
+                            <groupId>org.projectlombok</groupId>
+                            <artifactId>lombok-mapstruct-binding</artifactId>
+                            <version>0.2.0</version>
+                        </path>
+                    </annotationProcessorPaths>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.jacoco</groupId>
+                <artifactId>jacoco-maven-plugin</artifactId>
+                <version>0.8.12</version>
+                <executions>
+                    <execution>
+                        <id>prepare-agent</id>
+                        <goals>
+                            <goal>prepare-agent</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>report</id>
+                        <phase>verify</phase>
+                        <goals>
+                            <goal>report</goal>
+                        </goals>
+                    </execution>
+                    <execution>
+                        <id>check</id>
+                        <phase>verify</phase>
+                        <goals>
+                            <goal>check</goal>
+                        </goals>
+                        <configuration>
+                            <rules>
+                                <rule>
+                                    <element>BUNDLE</element>
+                                    <limits>
+                                        <limit>
+                                            <counter>INSTRUCTION</counter>
+                                            <value>COVEREDRATIO</value>
+                                            <minimum>0.60</minimum>
+                                        </limit>
+                                    </limits>
+                                </rule>
+                            </rules>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <groupId>com.github.spotbugs</groupId>
+                <artifactId>spotbugs-maven-plugin</artifactId>
+                <version>4.8.6.0</version>
+                <dependencies>
+                    <dependency>
+                        <groupId>com.github.spotbugs</groupId>
+                        <artifactId>spotbugs</artifactId>
+                        <version>4.8.6</version>
+                    </dependency>
+                </dependencies>
+                <executions>
+                    <execution>
+                        <id>spotbugs-check</id>
+                        <phase>verify</phase>
+                        <goals>
+                            <goal>check</goal>
+                        </goals>
+                    </execution>
+                </executions>
+                <configuration>
+                    <effort>Max</effort>
+                    <threshold>High</threshold>
+                    <failOnError>true</failOnError>
+                    <excludeFilterFile>spotbugs-exclude.xml</excludeFilterFile>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+</project>

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/config/HttpClientConfig.java

@@ -0,0 +1,22 @@
+package cn.novalon.gym.manage.member.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.web.reactive.function.client.WebClient;
+
+/**
+ * HTTP 客户端配置
+ * 
+ * @author 付嘉
+ * @date 2026-05-01
+ */
+
+@Configuration
+public class HttpClientConfig {
+
+    // WebClient Bean，用于调用微信 API
+    @Bean
+    public WebClient webClient() {
+        return WebClient.builder().build();
+    }
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/config/WechatProperties.java

@@ -0,0 +1,63 @@
+package cn.novalon.gym.manage.member.config;
+
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.stereotype.Component;
+
+/**
+ * 微信配置
+ * 
+ * @author 付嘉
+ * @date 2026-05-01
+ */
+
+@Data
+@Component
+@ConfigurationProperties(prefix = "wechat")
+public class WechatProperties {
+
+    // 小程序配置
+    private MiniApp miniapp = new MiniApp();
+
+    // 服务号配置
+    private Mp mp = new Mp();
+
+    // 手机号加密配置
+    private PhoneEncryption phoneEncryption = new PhoneEncryption();
+
+    @Data
+    public static class MiniApp {
+        // 小程序 AppID
+        private String appId;
+
+        // 小程序 AppSecret
+        private String appSecret;
+    }
+
+    @Data
+    public static class Mp {
+        // 服务号 AppID
+        private String appId;
+
+        // 服务号 AppSecret
+        private String appSecret;
+
+        // Token 验证信息
+        private String token;
+
+        // EncodingAESKey
+        private String aesKey;
+
+        // 回调地址（微信服务号事件推送 URL）
+        private String callbackUrl;
+    }
+
+    @Data
+    public static class PhoneEncryption {
+        // 手机号加密密钥
+        private String secretKey;
+
+        // 初始化向量 IV
+        private String iv;
+    }
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/dto/AdminUpdatePhoneDto.java

@@ -0,0 +1,17 @@
+package cn.novalon.gym.manage.member.dto;
+
+import lombok.Data;
+
+/**
+ * 更新手机号Dto
+ * 
+ * @author 付嘉
+ * @date 2026-05-01
+ */
+
+@Data
+public class AdminUpdatePhoneDto {
+    
+    // 手机号
+    private String phone;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/dto/CreateMemberCardRequest.java

@@ -0,0 +1,61 @@
+package cn.novalon.gym.manage.member.dto
+;
+
+import lombok.Data;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.math.BigDecimal;
+
+/**
+ * 创建会员卡类型请求 DTO
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+@Data
+public class CreateMemberCardRequest {
+
+    /**
+     * 会员卡名称
+     */
+    @NotBlank(message = "会员卡名称不能为空")
+    private String memberCardName;
+
+    /**
+     * 会员卡类型：TIME_CARD-时长卡, COUNT_CARD-次卡, STORED_VALUE_CARD-储值卡
+     */
+    @NotBlank(message = "会员卡类型不能为空")
+    private String memberCardType;
+
+    /**
+     * 会员卡价格
+     */
+    @NotNull(message = "会员卡价格不能为空")
+    private BigDecimal memberCardPrice;
+
+    /**
+     * 有效天数（时长卡用）
+     */
+    private Integer memberCardValidityDays;
+
+    /**
+     * 总次数（次卡用）
+     */
+    private Integer memberCardTotalTimes;
+
+    /**
+     * 面额（储值卡用）
+     */
+    private BigDecimal memberCardAmount;
+
+    /**
+     * 状态：0-下架, 1-上架
+     */
+    private Integer memberCardStatus = 1;
+
+    /**
+     * 扩展配置（JSON格式）
+     */
+    private String extraConfig;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/dto/PurchaseCardRequest.java

@@ -0,0 +1,32 @@
+package cn.novalon.gym.manage.member.dto;
+
+import lombok.Data;
+
+import jakarta.validation.constraints.NotNull;
+
+/**
+ * 购买会员卡请求 DTO
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+@Data
+public class PurchaseCardRequest {
+
+    /**
+     * 会员ID
+     */
+    @NotNull(message = "会员ID不能为空")
+    private Long memberId;
+
+    /**
+     * 会员卡类型ID
+     */
+    @NotNull(message = "会员卡类型ID不能为空")
+    private Long memberCardId;
+
+    /**
+     * 来源订单ID
+     */
+    private Long sourceOrderId;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/dto/RefundCardRequest.java

@@ -0,0 +1,21 @@
+package cn.novalon.gym.manage.member.dto;
+
+import lombok.Data;
+
+import jakarta.validation.constraints.NotBlank;
+
+/**
+ * 退款申请请求 DTO
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+@Data
+public class RefundCardRequest {
+
+    /**
+     * 退款原因
+     */
+    @NotBlank(message = "退款原因不能为空")
+    private String reason;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/dto/RenewCardRequest.java

@@ -0,0 +1,35 @@
+package cn.novalon.gym.manage.member.dto;
+
+import lombok.Data;
+
+import jakarta.validation.constraints.NotNull;
+
+/**
+ * 续费会员卡请求 DTO
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+@Data
+public class RenewCardRequest {
+
+    /**
+     * 增加的次数
+     */
+    private Integer addTimes;
+
+    /**
+     * 增加的金额
+     */
+    private Double addAmount;
+
+    /**
+     * 增加的天数
+     */
+    private Integer addDays;
+
+    /**
+     * 来源订单ID
+     */
+    private Long sourceOrderId;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/dto/SearchMemberDto.java

@@ -0,0 +1,20 @@
+package cn.novalon.gym.manage.member.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+public class SearchMemberDto {
+
+    // 搜索字段 - 包括 会员号、昵称、手机号
+    private String searchValue;
+
+    // 页码
+    private Integer pageNum = 1;
+
+    // 页大小
+    private Integer pageSize = 10;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/dto/UpdateMemberCardRequest.java

@@ -0,0 +1,60 @@
+package cn.novalon.gym.manage.member.dto;
+
+import lombok.Data;
+
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import java.math.BigDecimal;
+
+/**
+ * 更新会员卡类型请求 DTO
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+@Data
+public class UpdateMemberCardRequest {
+
+    /**
+     * 会员卡名称
+     */
+    @NotBlank(message = "会员卡名称不能为空")
+    private String memberCardName;
+
+    /**
+     * 会员卡类型：TIME_CARD-时长卡, COUNT_CARD-次卡, STORED_VALUE_CARD-储值卡
+     */
+    @NotBlank(message = "会员卡类型不能为空")
+    private String memberCardType;
+
+    /**
+     * 会员卡价格
+     */
+    @NotNull(message = "会员卡价格不能为空")
+    private BigDecimal memberCardPrice;
+
+    /**
+     * 有效天数（时长卡用）
+     */
+    private Integer memberCardValidityDays;
+
+    /**
+     * 总次数（次卡用）
+     */
+    private Integer memberCardTotalTimes;
+
+    /**
+     * 面额（储值卡用）
+     */
+    private BigDecimal memberCardAmount;
+
+    /**
+     * 状态：0-下架, 1-上架
+     */
+    private Integer memberCardStatus;
+
+    /**
+     * 扩展配置（JSON格式）
+     */
+    private String extraConfig;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/dto/UpdateMemberInfoDto.java

@@ -0,0 +1,32 @@
+package cn.novalon.gym.manage.member.dto;
+
+import cn.novalon.gym.manage.member.enums.GenderEnum;
+import lombok.Data;
+
+import java.time.LocalDate;
+import java.util.Date;
+
+/**
+ * 更新会员信息Dto
+ *
+ * @author 付嘉
+ * @date 2026-05-10
+ */
+@Data
+public class UpdateMemberInfoDto {
+
+    // 昵称
+    private String nickname;
+
+    // 性别
+    private GenderEnum gender;
+
+    // 生日
+    private LocalDate birthday;
+
+    // 头像
+    private String avatar;
+
+    // 地址
+    private String address;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/dto/UseCardRequest.java

@@ -0,0 +1,23 @@
+package cn.novalon.gym.manage.member.dto;
+
+import lombok.Data;
+
+/**
+ * 使用会员卡请求 DTO
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+@Data
+public class UseCardRequest {
+
+    /**
+     * 扣减的次数
+     */
+    private Integer deductTimes;
+
+    /**
+     * 扣减的金额
+     */
+    private Double deductAmount;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/dto/WechatLoginDto.java

@@ -0,0 +1,29 @@
+package cn.novalon.gym.manage.member.dto;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import jakarta.validation.constraints.NotBlank;
+
+/**
+ * 微信小程序登录 DTO
+ * 
+ * @author 付嘉
+ * @date 2026-05-01
+ */
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class WechatLoginDto {
+
+    // 微信小程序登录 code
+    @NotBlank(message = "登录code不能为空")
+    private String code;
+
+    // 手机号code
+    private String phoneCode;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/dto/WechatOfficialEventDto.java

@@ -0,0 +1,35 @@
+package cn.novalon.gym.manage.member.dto;
+
+import lombok.Data;
+
+/**
+ * 微信服务号事件 DTO
+ * 
+ * @author 付嘉
+ * @date 2026-05-01
+ */
+
+@Data
+public class WechatOfficialEventDto {
+
+    // 微信号
+    private String toUserName;
+
+    // 发送方帐号（一个 OpenID）
+    private String fromUserName;
+
+    // 消息创建时间（整型）
+    private Long createTime;
+
+    // 消息类型，event
+    private String msgType;
+
+    // 事件类型：subscribe（关注）/ unsubscribe（取消关注）
+    private String event;
+
+    // 事件 KEY
+    private String eventKey;
+
+    // 二维码 ticket（获取二维码图片）
+    private String ticket;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/entity/BaseEntity.java

@@ -0,0 +1,44 @@
+package cn.novalon.gym.manage.member.entity;
+
+import org.springframework.data.annotation.CreatedDate;
+import org.springframework.data.annotation.Id;
+import org.springframework.data.annotation.LastModifiedDate;
+import org.springframework.data.domain.Persistable;
+import org.springframework.data.relational.core.mapping.Column;
+
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+/**
+ * 会员模块实体基类
+ * 
+ * @author 付嘉
+ * @date 2026-05-08
+ */
+@Data
+public abstract class BaseEntity implements Persistable<Long> {
+
+    // ID
+    @Id
+    private Long id;
+
+    // 创建时间
+    @CreatedDate
+    @Column("created_at")
+    private LocalDateTime createdAt;
+
+    // 更新时间
+    @LastModifiedDate
+    @Column("updated_at")
+    private LocalDateTime updatedAt;
+
+    @Column("deleted_at")
+    private LocalDateTime deletedAt;
+
+    // 判断当前实体是否是新建的
+    @Override
+    public boolean isNew() {
+        return createdAt == null;
+    }
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/entity/Member.java

@@ -0,0 +1,78 @@
+package cn.novalon.gym.manage.member.entity;
+
+import lombok.*;
+import org.springframework.data.relational.core.mapping.Column;
+import org.springframework.data.relational.core.mapping.Table;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.Date;
+
+/**
+ * 会员实体类 - 对应 member_user 表 
+ * 
+ * @author 付嘉
+ * @date 2026-05-01
+ */
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@Table("member_user")
+public class Member extends BaseEntity {
+
+    //会员号
+    @Column("member_no")
+    private String memberNo;
+
+    //昵称
+    @Column("nickname")
+    private String nickname;
+
+    //手机号（AES 加密存储
+    @Column("phone")
+    private String phone;
+
+    //性别
+    @Column("gender")
+    private Integer gender;
+
+    //生日
+    @Column("birthday")
+    private LocalDate birthday;
+
+    //地址
+    @Column("address")
+    private String address;
+
+    //是否关注服务号
+    @Column("subscribed")
+    private Boolean subscribed;
+
+    // 最后登录时间
+    @Column("last_login_at")
+    private LocalDateTime lastLoginAt;
+
+    // 头像
+    @Column("avatar")
+    private String avatar;
+
+    // 微信UnionID
+    @Column("union_id")
+    private String unionId;
+
+    // 微信OpenID小程序
+    @Column("miniapp_open_id")
+    private String miniappOpenId;
+
+    // 服务号openid
+    @Column("official_open_id")
+    private String officialOpenId;
+
+    // 软删除
+    @Column("is_deleted")
+    private Boolean isDeleted;
+
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/entity/MemberCard.java

@@ -0,0 +1,63 @@
+package cn.novalon.gym.manage.member.entity;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.springframework.data.relational.core.mapping.Column;
+import org.springframework.data.relational.core.mapping.Table;
+
+import java.time.LocalDateTime;
+
+/**
+ * 会员卡类型实体 - 对应 member_card 表
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@Table("member_card")
+public class MemberCard extends BaseEntity {
+
+    // 会员卡ID
+    @Column("member_card_id")
+    private Long memberCardId;
+
+    // 会员卡名称
+    @Column("member_card_name")
+    private String memberCardName;
+
+    // 会员卡类型：TIME_CARD-时长卡, COUNT_CARD-次卡, STORED_VALUE_CARD-储值卡
+    @Column("member_card_type")
+    private String memberCardType;
+
+    // 会员卡价格
+    @Column("member_card_price")
+    private Double memberCardPrice;
+
+    // 有效天数（时长卡用）
+    @Column("member_card_validity_days")
+    private Integer memberCardValidityDays;
+
+    // 总次数（次卡用）
+    @Column("member_card_total_times")
+    private Integer memberCardTotalTimes;
+
+    // 面额（储值卡用）
+    @Column("member_card_amount")
+    private Double memberCardAmount;
+
+    // 状态：0-下架, 1-上架
+    @Column("member_card_status")
+    private Integer memberCardStatus;
+
+    // 扩展配置（JSON格式）
+    @Column("extra_config")
+    private String extraConfig;
+
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/entity/MemberCardRecord.java

@@ -0,0 +1,72 @@
+package cn.novalon.gym.manage.member.entity;
+
+import cn.novalon.gym.manage.member.enums.MemberCardRecordStatus;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.springframework.data.relational.core.mapping.Column;
+import org.springframework.data.relational.core.mapping.Table;
+
+import java.time.LocalDateTime;
+
+/**
+ * 会员卡记录实体（会员持有的卡）- 对应 member_card_record 表
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@Table("member_card_record")
+public class MemberCardRecord extends BaseEntity {
+
+    // 会员持有卡ID
+    @Column("member_card_record_id")
+    private Long memberCardRecordId;
+
+    // 会员ID
+    @Column("member_id")
+    private Long memberId;
+
+    // 关联会员卡ID
+    @Column("member_card_id")
+    private Long memberCardId;
+
+    // 状态：ACTIVE-有效, USED_UP-用完, EXPIRED-过期, REFUNDED-已退款
+    @Column("status")
+    private MemberCardRecordStatus status;
+
+    // 剩余次数
+    @Column("remaining_times")
+    private Integer remainingTimes;
+
+    // 剩余金额
+    @Column("remaining_amount")
+    private Double remainingAmount;
+
+    // 到期时间
+    @Column("expire_time")
+    private LocalDateTime expireTime;
+
+    // 来源订单ID
+    @Column("source_order_id")
+    private Long sourceOrderId;
+
+    // 购买时间
+    @Column("purchase_time")
+    private LocalDateTime purchaseTime;
+
+    // 乐观锁版本号
+    @Column("version")
+    private Integer version;
+
+    // 卡片组成（JSON格式，用于组合卡）
+    @Column("card_composition")
+    private String cardComposition;
+
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/entity/MemberCardTransaction.java

@@ -0,0 +1,77 @@
+package cn.novalon.gym.manage.member.entity;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.springframework.data.relational.core.mapping.Column;
+import org.springframework.data.relational.core.mapping.Table;
+
+/**
+ * 会员卡交易流水实体 - 对应 member_card_transactions 表
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@Table("member_card_transactions")
+public class MemberCardTransaction extends BaseEntity {
+
+    // 交易ID
+    @Column("member_card_record_id")
+    private Long memberCardRecordId;
+
+    // 会员ID
+    @Column("member_id")
+    private Long memberId;
+
+    // 会员卡ID
+    @Column("member_card_id")
+    private Long memberCardId;
+
+    // 操作类型：PURCHASE-购买, DEDUCT-扣次/扣费, RENEW-续费, REFUND-退款, EXPIRE-过期
+    @Column("operation_type")
+    private String operationType;
+
+    // 变动次数
+    @Column("change_amount")
+    private Integer changeAmount;
+
+    // 变动金额
+    @Column("change_balance")
+    private Double changeBalance;
+
+    // 变动后剩余次数
+    @Column("after_remaining_count")
+    private Integer afterRemainingCount;
+
+    // 变动后剩余金额
+    @Column("after_remaining_balance")
+    private Double afterRemainingBalance;
+
+    // 关联业务类型：GROUP_CLASS-团课, PT_CLASS-私教, CHECK_IN-签到
+    @Column("related_biz_type")
+    private String relatedBizType;
+
+    // 来源订单ID
+    @Column("source_order_id")
+    private Long sourceOrderId;
+
+    // 备注
+    @Column("remark")
+    private String remark;
+
+    // 是否已归档
+    @Column("is_archived")
+    private Boolean isArchived;
+
+    // 归档时间
+    @Column("archived_at")
+    private java.time.LocalDateTime archivedAt;
+
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/entity/RefundApplication.java

@@ -0,0 +1,65 @@
+package cn.novalon.gym.manage.member.entity;
+
+import cn.novalon.gym.manage.member.enums.RefundStatus;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.springframework.data.relational.core.mapping.Column;
+import org.springframework.data.relational.core.mapping.Table;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * 退款申请实体 - 对应 refund_application 表
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@Table("refund_application")
+public class RefundApplication extends BaseEntity {
+
+    // 会员卡记录ID
+    @Column("record_id")
+    private Long recordId;
+
+    // 会员ID
+    @Column("member_id")
+    private Long memberId;
+
+    // 状态：PENDING-待审核, APPROVED-已批准, REJECTED-已拒绝, PROCESSING-处理中, SUCCESS-成功, FAILED-失败
+    @Column("status")
+    private RefundStatus status;
+
+    // 退款原因
+    @Column("reason")
+    private String reason;
+
+    // 申请时间
+    @Column("apply_time")
+    private LocalDateTime applyTime;
+
+    // 审核时间
+    @Column("audit_time")
+    private LocalDateTime auditTime;
+
+    // 审核人ID
+    @Column("auditor_id")
+    private Long auditorId;
+
+    // 审核备注
+    @Column("audit_remark")
+    private String auditRemark;
+
+    // 退款金额
+    @Column("refund_amount")
+    private BigDecimal refundAmount;
+
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/entity/WechatUser.java

@@ -0,0 +1,55 @@
+package cn.novalon.gym.manage.member.entity;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import org.springframework.data.relational.core.mapping.Column;
+import org.springframework.data.relational.core.mapping.Table;
+
+import java.time.LocalDateTime;
+
+/**
+ * 微信用户信息
+ * 
+ * @author 付嘉
+ * @date 2026-05-01
+ */
+
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@Table("wechat_user")
+public class WechatUser extends BaseEntity {
+
+    // 会员 ID
+    @Column("member_id")
+    private Long memberId;
+
+    // 微信 UnionID
+    @Column("union_id")
+    private String unionId;
+
+    // 小程序 OpenID
+    @Column("miniapp_openid")
+    private String miniappOpenid;
+
+    // 服务号 OpenID
+    @Column("mp_openid")
+    private String mpOpenid;
+
+    // 是否关注服务号
+    @Column("is_subscribed")
+    private Boolean isSubscribed;
+
+    // 首次关注时间公众号的时间
+    @Column("subscribe_time")
+    private LocalDateTime subscribeTime;
+
+    // 最后一次取消关注的时间
+    @Column("unsubscribe_time")
+    private LocalDateTime unsubscribeTime;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/enums/BizType.java

@@ -0,0 +1,24 @@
+package cn.novalon.gym.manage.member.enums;
+
+/**
+ * 会员卡流水关联业务类型枚举
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+public enum BizType {
+    
+    GROUP_CLASS("团课"),
+    PT_CLASS("私教"),
+    CHECK_IN("签到");
+
+    private final String desc;
+
+    BizType(String desc) {
+        this.desc = desc;
+    }
+
+    public String getDesc() {
+        return desc;
+    }
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/enums/CardEvent.java

@@ -0,0 +1,27 @@
+package cn.novalon.gym.manage.member.enums;
+
+/**
+ * 会员卡状态机事件枚举
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+public enum CardEvent {
+    
+    ACTIVATE("激活卡片"),
+    USE("使用卡片"),
+    RENEW("续费"),
+    EXPIRE("过期"),
+    REFUND("退款"),
+    DISABLE("禁用");
+
+    private final String desc;
+
+    CardEvent(String desc) {
+        this.desc = desc;
+    }
+
+    public String getDesc() {
+        return desc;
+    }
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/enums/GenderEnum.java

@@ -0,0 +1,37 @@
+package cn.novalon.gym.manage.member.enums;
+
+import lombok.Getter;
+
+/**
+ * 性别枚举
+ *
+ * @author 付嘉
+ * @date 2026-05-29
+ */
+@Getter
+public enum GenderEnum {
+
+    UNKNOWN(0, "未知"),
+    MALE(1, "男"),
+    FEMALE(2, "女");
+
+    private final Integer code;
+    private final String desc;
+
+    GenderEnum(Integer code, String desc) {
+        this.code = code;
+        this.desc = desc;
+    }
+
+    public static GenderEnum fromCode(Integer code) {
+        if (code == null) {
+            return UNKNOWN;
+        }
+        for (GenderEnum gender : values()) {
+            if (gender.code.equals(code)) {
+                return gender;
+            }
+        }
+        return UNKNOWN;
+    }
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/enums/MemberCardRecordStatus.java

@@ -0,0 +1,25 @@
+package cn.novalon.gym.manage.member.enums;
+
+/**
+ * 会员卡记录状态枚举
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+public enum MemberCardRecordStatus {
+    
+    ACTIVE("有效"),
+    USED_UP("用完"),
+    EXPIRED("过期"),
+    REFUNDED("已退款");
+
+    private final String desc;
+
+    MemberCardRecordStatus(String desc) {
+        this.desc = desc;
+    }
+
+    public String getDesc() {
+        return desc;
+    }
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/enums/MemberCardType.java

@@ -1,16 +1,15 @@
-package cn.novalon.gym.manage.gymmembercard.enums;
+package cn.novalon.gym.manage.member.enums;
 
-import io.swagger.v3.oas.annotations.media.Schema;
-
-@Schema(description = "会员卡类型枚举")
+/**
+ * 会员卡类型枚举
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
 public enum MemberCardType {
-    @Schema(description = "时长卡")
+    
     TIME_CARD("时长卡"),
-
-    @Schema(description = "次卡")
     COUNT_CARD("次卡"),
-
-    @Schema(description = "储值卡")
     STORED_VALUE_CARD("储值卡");
 
     private final String desc;
@@ -22,4 +21,4 @@ public enum MemberCardType {
     public String getDesc() {
         return desc;
     }
-}
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/enums/RefundStatus.java

@@ -0,0 +1,27 @@
+package cn.novalon.gym.manage.member.enums;
+
+/**
+ * 退款申请状态枚举
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+public enum RefundStatus {
+    
+    PENDING("待审核"),
+    APPROVED("已批准"),
+    REJECTED("已拒绝"),
+    PROCESSING("处理中"),
+    SUCCESS("成功"),
+    FAILED("失败");
+
+    private final String desc;
+
+    RefundStatus(String desc) {
+        this.desc = desc;
+    }
+
+    public String getDesc() {
+        return desc;
+    }
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/enums/TransactionType.java

@@ -0,0 +1,26 @@
+package cn.novalon.gym.manage.member.enums;
+
+/**
+ * 会员卡流水操作类型枚举
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
+public enum TransactionType {
+    
+    PURCHASE("购买"),
+    DEDUCT("扣次/扣费"),
+    RENEW("续费"),
+    REFUND("退款"),
+    EXPIRE("过期");
+
+    private final String desc;
+
+    TransactionType(String desc) {
+        this.desc = desc;
+    }
+
+    public String getDesc() {
+        return desc;
+    }
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/es/entity/MemberES.java

@@ -0,0 +1,41 @@
+package cn.novalon.gym.manage.member.es.entity;
+
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+import org.springframework.data.annotation.Id;
+import org.springframework.data.elasticsearch.annotations.Document;
+import org.springframework.data.elasticsearch.annotations.Field;
+import org.springframework.data.elasticsearch.annotations.FieldType;
+
+import java.time.LocalDateTime;
+
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@Document(indexName = "gym_members")
+public class MemberES {
+
+    @Id
+    private String id;
+
+    // 会员号 - 需要搜索（精确匹配）
+    @Field(type = FieldType.Keyword)
+    private String memberNo;
+
+    // 昵称 - 需要搜索（模糊搜索）
+    @Field(type = FieldType.Text)
+    private String nickname;
+
+    // 手机号 - 需要搜索（精确匹配）
+    @Field(type = FieldType.Keyword)
+    private String phone;
+
+    // 性别 - 用于筛选
+    @Field(type = FieldType.Integer)
+    private Integer gender;
+
+    // 头像 - 列表展示
+    @Field(type = FieldType.Keyword)
+    private String avatar;
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/es/repository/MemberESRepository.java

@@ -0,0 +1,21 @@
+package cn.novalon.gym.manage.member.es.repository;
+
+import cn.novalon.gym.manage.member.es.entity.MemberES;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.elasticsearch.annotations.Query;
+import org.springframework.data.elasticsearch.repository.ReactiveElasticsearchRepository;
+import org.springframework.stereotype.Repository;
+import reactor.core.publisher.Flux;
+
+/**
+ * ES 会员数据访问层
+ */
+@Repository
+public interface MemberESRepository extends ReactiveElasticsearchRepository<MemberES, String> {
+
+    /**
+     * 前台通用搜索：会员号（精确匹配） 或 昵称（模糊匹配） 或 手机号（精确匹配）并且 性别筛选（精确匹配）
+     */
+    Flux<MemberES> findByMemberNoOrPhoneOrNicknameContaining(
+            String memberNo, String phone, String nickname, Pageable pageable);
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/handler/DistributedLockService.java

@@ -1,4 +1,4 @@
-package cn.novalon.gym.manage.gymmembercard.handler;
+package cn.novalon.gym.manage.member.handler;
 
 import org.springframework.stereotype.Component;
 import reactor.core.publisher.Mono;
@@ -8,9 +8,9 @@ import java.util.concurrent.locks.ReentrantLock;
 
 /**
  * 分布式锁服务（简化版，使用本地锁）
- *
- * @author shizhounian
- * @date 2026-05-23
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
  */
 @Component
 public class DistributedLockService {

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/handler/ExpirationReminderService.java

@@ -1,6 +1,6 @@
-package cn.novalon.gym.manage.gymmembercard.handler;
+package cn.novalon.gym.manage.member.handler;
 
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardRecord;
+import cn.novalon.gym.manage.member.entity.MemberCardRecord;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
@@ -16,6 +16,12 @@ import java.time.Duration;
 import java.time.LocalDateTime;
 import java.util.UUID;
 
+/**
+ * 会员卡到期提醒服务
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
 @Slf4j
 @Component
 @RequiredArgsConstructor
@@ -84,7 +90,7 @@ public class ExpirationReminderService {
         return reminderFlux.then();
     }
 
-        /**
+    /**
      * 定时任务：每分钟扫描到期的提醒并发送
      */
     @Scheduled(fixedRate = 60000)

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/handler/MemberCardHandler.java

@@ -1,8 +1,7 @@
-package cn.novalon.gym.manage.gymmembercard.handler;
+package cn.novalon.gym.manage.member.handler;
 
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCard;
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardRecord;
-import cn.novalon.gym.manage.gymmembercard.sevice.IMemberCardService;
+import cn.novalon.gym.manage.member.entity.MemberCard;
+import cn.novalon.gym.manage.member.service.IMemberCardService;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.extern.slf4j.Slf4j;
@@ -15,9 +14,9 @@ import reactor.core.publisher.Mono;
 
 /**
  * 会员卡管理处理器
- *
- * @author shizhounian
- * @date 2026-05-23
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
  */
 @Slf4j
 @Component

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/handler/MemberCardRecordHandler.java

@@ -1,8 +1,8 @@
-package cn.novalon.gym.manage.gymmembercard.handler;
+package cn.novalon.gym.manage.member.handler;
 
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardRecord;
-import cn.novalon.gym.manage.gymmembercard.sevice.IMemberCardRecordService;
-import cn.novalon.gym.manage.gymmembercard.sevice.IMemberCardService;
+import cn.novalon.gym.manage.member.entity.MemberCardRecord;
+import cn.novalon.gym.manage.member.service.IMemberCardRecordService;
+import cn.novalon.gym.manage.member.service.IMemberCardService;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import lombok.Data;
@@ -11,6 +11,12 @@ import org.springframework.web.reactive.function.server.ServerRequest;
 import org.springframework.web.reactive.function.server.ServerResponse;
 import reactor.core.publisher.Mono;
 
+/**
+ * 会员卡记录管理处理器
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
 @Component
 @Tag(name = "会员卡记录管理", description = "会员卡购买、续费、使用、退款等核心业务")
 public class MemberCardRecordHandler {
@@ -109,4 +115,4 @@ public class MemberCardRecordHandler {
         private Integer addDays;
         private Long sourceOrderId;
     }
-}
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/handler/MemberCardScheduledHandler.java

@@ -1,9 +1,7 @@
-package cn.novalon.gym.manage.gymmembercard.handler;
+package cn.novalon.gym.manage.member.handler;
 
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardRecord;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardEvent;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardRecordStatus;
-import cn.novalon.gym.manage.gymmembercard.repository.IMemberCardRecordRepository;
+import cn.novalon.gym.manage.member.enums.CardEvent;
+import cn.novalon.gym.manage.member.repository.MemberCardRecordRepository;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.scheduling.annotation.Scheduled;
@@ -12,17 +10,23 @@ import reactor.core.publisher.Mono;
 
 import java.time.LocalDateTime;
 
+/**
+ * 会员卡定时任务处理器
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
 @Slf4j
 @Component
 @RequiredArgsConstructor
 public class MemberCardScheduledHandler {
 
-    private final IMemberCardRecordRepository recordRepository;
+    private final MemberCardRecordRepository recordRepository;
     private final ExpirationReminderService expirationReminderService;
     private final MemberCardStateMachine stateMachine;
     private final DistributedLockService distributedLockService;
 
-        /**
+    /**
      * 每日凌晨2点检查过期会员卡
      */
     @Scheduled(cron = "0 0 2 * * ?")
@@ -38,7 +42,7 @@ public class MemberCardScheduledHandler {
                 recordRepository.findActiveRecords()
                     .filter(record -> record.getExpireTime() != null && record.getExpireTime().isBefore(now))
                     .flatMap(record ->
-                            stateMachine.transition(record.getStatus(), MemberCardEvent.EXPIRE)
+                            stateMachine.transition(record.getStatus(), CardEvent.EXPIRE)
                                     .flatMap(newState -> {
                                         record.setStatus(newState);
                                         return recordRepository.save(record);
@@ -55,9 +59,8 @@ public class MemberCardScheduledHandler {
         ).subscribe();
     }
 
-        /**
+    /**
      * 每日凌晨3点检查是否有遗漏的到期提醒（兜底机制）
-     * 主要依赖购卡/续费时的主动调用和每分钟扫描任务，此任务仅用于异常恢复
      */
     @Scheduled(cron = "0 0 3 * * ?")
     public void checkAndSendExpirationReminders() {

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/handler/MemberCardStateMachine.java

@@ -1,8 +1,8 @@
-package cn.novalon.gym.manage.gymmembercard.handler;
+package cn.novalon.gym.manage.member.handler;
 
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardRecord;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardEvent;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardRecordStatus;
+import cn.novalon.gym.manage.member.entity.MemberCardRecord;
+import cn.novalon.gym.manage.member.enums.CardEvent;
+import cn.novalon.gym.manage.member.enums.MemberCardRecordStatus;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Component;
 import reactor.core.publisher.Mono;
@@ -10,36 +10,42 @@ import reactor.core.publisher.Mono;
 import java.util.HashMap;
 import java.util.Map;
 
+/**
+ * 会员卡状态机处理器
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
 @Slf4j
 @Component
 public class MemberCardStateMachine {
 
-    private final Map<MemberCardRecordStatus, Map<MemberCardEvent, MemberCardRecordStatus>> stateTransitionMap;
+    private final Map<MemberCardRecordStatus, Map<CardEvent, MemberCardRecordStatus>> stateTransitionMap;
 
     public MemberCardStateMachine() {
         this.stateTransitionMap = buildStateTransitionMap();
     }
 
-    private Map<MemberCardRecordStatus, Map<MemberCardEvent, MemberCardRecordStatus>> buildStateTransitionMap() {
-        Map<MemberCardRecordStatus, Map<MemberCardEvent, MemberCardRecordStatus>> map = new HashMap<>();
+    private Map<MemberCardRecordStatus, Map<CardEvent, MemberCardRecordStatus>> buildStateTransitionMap() {
+        Map<MemberCardRecordStatus, Map<CardEvent, MemberCardRecordStatus>> map = new HashMap<>();
 
         // ACTIVE 状态可以转换的事件
-        Map<MemberCardEvent, MemberCardRecordStatus> activeTransitions = new HashMap<>();
-        activeTransitions.put(MemberCardEvent.USE, MemberCardRecordStatus.ACTIVE);
-        activeTransitions.put(MemberCardEvent.RENEW, MemberCardRecordStatus.ACTIVE);
-        activeTransitions.put(MemberCardEvent.EXPIRE, MemberCardRecordStatus.EXPIRED);
-        activeTransitions.put(MemberCardEvent.REFUND, MemberCardRecordStatus.REFUNDED);
+        Map<CardEvent, MemberCardRecordStatus> activeTransitions = new HashMap<>();
+        activeTransitions.put(CardEvent.USE, MemberCardRecordStatus.ACTIVE);
+        activeTransitions.put(CardEvent.RENEW, MemberCardRecordStatus.ACTIVE);
+        activeTransitions.put(CardEvent.EXPIRE, MemberCardRecordStatus.EXPIRED);
+        activeTransitions.put(CardEvent.REFUND, MemberCardRecordStatus.REFUNDED);
         map.put(MemberCardRecordStatus.ACTIVE, activeTransitions);
 
         // USED_UP 状态可以转换的事件
-        Map<MemberCardEvent, MemberCardRecordStatus> usedUpTransitions = new HashMap<>();
-        usedUpTransitions.put(MemberCardEvent.RENEW, MemberCardRecordStatus.ACTIVE);
-        usedUpTransitions.put(MemberCardEvent.REFUND, MemberCardRecordStatus.REFUNDED);
+        Map<CardEvent, MemberCardRecordStatus> usedUpTransitions = new HashMap<>();
+        usedUpTransitions.put(CardEvent.RENEW, MemberCardRecordStatus.ACTIVE);
+        usedUpTransitions.put(CardEvent.REFUND, MemberCardRecordStatus.REFUNDED);
         map.put(MemberCardRecordStatus.USED_UP, usedUpTransitions);
 
         // EXPIRED 状态可以转换的事件
-        Map<MemberCardEvent, MemberCardRecordStatus> expiredTransitions = new HashMap<>();
-        expiredTransitions.put(MemberCardEvent.RENEW, MemberCardRecordStatus.ACTIVE);
+        Map<CardEvent, MemberCardRecordStatus> expiredTransitions = new HashMap<>();
+        expiredTransitions.put(CardEvent.RENEW, MemberCardRecordStatus.ACTIVE);
         map.put(MemberCardRecordStatus.EXPIRED, expiredTransitions);
 
         // REFUNDED 状态是终态，不允许任何转换
@@ -47,9 +53,9 @@ public class MemberCardStateMachine {
         return map;
     }
 
-    public Mono<Boolean> canTransition(MemberCardRecordStatus currentState, MemberCardEvent event) {
+    public Mono<Boolean> canTransition(MemberCardRecordStatus currentState, CardEvent event) {
         return Mono.fromSupplier(() -> {
-            Map<MemberCardEvent, MemberCardRecordStatus> transitions = stateTransitionMap.get(currentState);
+            Map<CardEvent, MemberCardRecordStatus> transitions = stateTransitionMap.get(currentState);
             if (transitions == null) {
                 return false;
             }
@@ -57,9 +63,9 @@ public class MemberCardStateMachine {
         });
     }
 
-    public Mono<MemberCardRecordStatus> transition(MemberCardRecordStatus currentState, MemberCardEvent event) {
+    public Mono<MemberCardRecordStatus> transition(MemberCardRecordStatus currentState, CardEvent event) {
         return Mono.fromSupplier(() -> {
-            Map<MemberCardEvent, MemberCardRecordStatus> transitions = stateTransitionMap.get(currentState);
+            Map<CardEvent, MemberCardRecordStatus> transitions = stateTransitionMap.get(currentState);
             if (transitions == null || !transitions.containsKey(event)) {
                 log.error("Invalid state transition: currentState={}, event={}", currentState, event);
                 throw new IllegalStateException(
@@ -71,7 +77,7 @@ public class MemberCardStateMachine {
         });
     }
 
-    public Mono<Void> validateTransition(MemberCardRecord card, MemberCardEvent event) {
+    public Mono<Void> validateTransition(MemberCardRecord card, CardEvent event) {
         return canTransition(card.getStatus(), event)
                 .flatMap(canTransition -> {
                     if (!canTransition) {

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/handler/MemberCardTransactionHandler.java

@@ -1,9 +1,9 @@
-package cn.novalon.gym.manage.gymmembercard.handler;
+package cn.novalon.gym.manage.member.handler;
 
 import cn.hutool.db.PageResult;
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardTransactions;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsAction;
-import cn.novalon.gym.manage.gymmembercard.sevice.IMemberCardTransactionsService;
+import cn.novalon.gym.manage.member.entity.MemberCardTransaction;
+import cn.novalon.gym.manage.member.enums.TransactionType;
+import cn.novalon.gym.manage.member.service.IMemberCardTransactionService;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Validator;
@@ -19,20 +19,22 @@ import reactor.core.publisher.Mono;
 import java.time.LocalDateTime;
 import java.util.List;
 
-/*
- *@Author:shizhounian
- *@Date:2026/5/17-05 20:10:22
+/**
+ * 会员卡流水管理处理器
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
  */
 @Component
 @Tag(name = "会员卡流水管理", description = "会员卡流水相关操作")
 public class MemberCardTransactionHandler {
 
-    private final IMemberCardTransactionsService memberCardTransactionsService;
+    private final IMemberCardTransactionService memberCardTransactionService;
     private final Validator validator;
 
-    public MemberCardTransactionHandler(IMemberCardTransactionsService memberCardTransactionsService,
+    public MemberCardTransactionHandler(IMemberCardTransactionService memberCardTransactionService,
                                         Validator validator) {
-        this.memberCardTransactionsService = memberCardTransactionsService;
+        this.memberCardTransactionService = memberCardTransactionService;
         this.validator = validator;
     }
 
@@ -41,8 +43,8 @@ public class MemberCardTransactionHandler {
      */
     @Operation(summary = "插入流水记录", description = "购卡、扣次、续费、退款、过期时插入流水")
     public Mono<ServerResponse> insertTransaction(ServerRequest request) {
-        return request.bodyToMono(MemberCardTransactions.class)
-                .flatMap(memberCardTransactionsService::insertTransaction)
+        return request.bodyToMono(MemberCardTransaction.class)
+                .flatMap(memberCardTransactionService::insertTransaction)
                 .flatMap(record -> ServerResponse.ok().bodyValue(record));
     }
 
@@ -61,8 +63,8 @@ public class MemberCardTransactionHandler {
         Pageable pageable = PageRequest.of(page, size, Sort.by("created_at").descending());
 
         return ServerResponse.ok()
-                .body(memberCardTransactionsService.findByMemberIdAndTimeRange(
-                        memberId, startTime, endTime, pageable), MemberCardTransactions.class);
+                .body(memberCardTransactionService.findByMemberIdAndTimeRange(
+                        memberId, startTime, endTime, pageable), MemberCardTransaction.class);
     }
 
     /**
@@ -72,25 +74,25 @@ public class MemberCardTransactionHandler {
     public Mono<ServerResponse> getTransactionsWithConditions(ServerRequest request) {
         Long memberId = request.queryParam("memberId").map(Long::parseLong).orElse(null);
         Long memberCardId = request.queryParam("memberCardId").map(Long::parseLong).orElse(null);
-        MemberCardTransactionsAction operationType = request.queryParam("operationType")
-                .map(s -> MemberCardTransactionsAction.valueOf(s.toUpperCase())).orElse(null);
+        TransactionType operationType = request.queryParam("operationType")
+                .map(s -> TransactionType.valueOf(s.toUpperCase())).orElse(null);
         LocalDateTime startTime = request.queryParam("startTime").map(LocalDateTime::parse).orElse(null);
         LocalDateTime endTime = request.queryParam("endTime").map(LocalDateTime::parse).orElse(null);
         int page = request.queryParam("page").map(Integer::parseInt).orElse(0);
         int size = request.queryParam("size").map(Integer::parseInt).orElse(10);
         Pageable pageable = PageRequest.of(page, size, Sort.by("created_at").descending());
 
-        Mono<Long> countMono = memberCardTransactionsService.countWithConditions(
+        Mono<Long> countMono = memberCardTransactionService.countWithConditions(
                 memberId, memberCardId, operationType, startTime, endTime);
-        Flux<MemberCardTransactions> flux = memberCardTransactionsService.findWithConditions(
+        Flux<MemberCardTransaction> flux = memberCardTransactionService.findWithConditions(
                 memberId, memberCardId, operationType, startTime, endTime, pageable);
 
         return Mono.zip(countMono, flux.collectList())
                 .flatMap(tuple -> {
                     Long total = tuple.getT1();
-                    List<MemberCardTransactions> list = tuple.getT2();
+                    List<MemberCardTransaction> list = tuple.getT2();
                     // 构造 PageResult，内部自动计算总页数
-                    PageResult<MemberCardTransactions> result = new PageResult<>(page, size, total.intValue());
+                    PageResult<MemberCardTransaction> result = new PageResult<>(page, size, total.intValue());
                     result.addAll(list);
                     return ServerResponse.ok().bodyValue(result);
                 });
@@ -103,8 +105,8 @@ public class MemberCardTransactionHandler {
     public Mono<ServerResponse> getTransactionsByCardId(ServerRequest request) {
         Long memberCardId = Long.parseLong(request.pathVariable("cardId"));
         return ServerResponse.ok()
-                .body(memberCardTransactionsService.findByMemberCardId(memberCardId),
-                        MemberCardTransactions.class);
+                .body(memberCardTransactionService.findByMemberCardId(memberCardId),
+                        MemberCardTransaction.class);
     }
 
     /**
@@ -117,7 +119,7 @@ public class MemberCardTransactionHandler {
                 .map(LocalDateTime::parse).orElse(LocalDateTime.now().minusMonths(1));
         LocalDateTime endTime = request.queryParam("endTime")
                 .map(LocalDateTime::parse).orElse(LocalDateTime.now());
-        return memberCardTransactionsService.sumDeductCountByCardId(memberCardId, startTime, endTime)
+        return memberCardTransactionService.sumDeductCountByCardId(memberCardId, startTime, endTime)
                 .flatMap(count -> ServerResponse.ok().bodyValue(count));
     }
 
@@ -130,7 +132,7 @@ public class MemberCardTransactionHandler {
                 .map(LocalDateTime::parse).orElse(LocalDateTime.now().minusMonths(1));
         LocalDateTime endTime = request.queryParam("endTime")
                 .map(LocalDateTime::parse).orElse(LocalDateTime.now());
-        return memberCardTransactionsService.sumRenewAmountByTimeRange(startTime, endTime)
+        return memberCardTransactionService.sumRenewAmountByTimeRange(startTime, endTime)
                 .flatMap(amount -> ServerResponse.ok().bodyValue(amount));
     }
 
@@ -144,7 +146,7 @@ public class MemberCardTransactionHandler {
                 .map(LocalDateTime::parse).orElse(LocalDateTime.now().minusMonths(1));
         LocalDateTime endTime = request.queryParam("endTime")
                 .map(LocalDateTime::parse).orElse(LocalDateTime.now());
-        return memberCardTransactionsService.sumPurchaseAmountByMemberId(memberId, startTime, endTime)
+        return memberCardTransactionService.sumPurchaseAmountByMemberId(memberId, startTime, endTime)
                 .flatMap(amount -> ServerResponse.ok().bodyValue(amount));
     }
-}
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/handler/MemberHandler.java

@@ -0,0 +1,241 @@
+package cn.novalon.gym.manage.member.handler;
+
+import cn.novalon.gym.manage.member.config.WechatProperties;
+import cn.novalon.gym.manage.member.dto.AdminUpdatePhoneDto;
+import cn.novalon.gym.manage.member.dto.SearchMemberDto;
+import cn.novalon.gym.manage.member.dto.UpdateMemberInfoDto;
+import cn.novalon.gym.manage.member.service.MemberService;
+import cn.novalon.gym.manage.member.service.WechatAuthService;
+import cn.novalon.gym.manage.member.service.WechatOfficialService;
+import cn.novalon.gym.manage.member.util.AesUtil;
+import cn.novalon.gym.manage.member.util.WechatPhoneUtil;
+import cn.novalon.gym.manage.sys.util.AuthUtil;
+import cn.novalon.gym.manage.sys.security.JwtTokenProvider;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.apache.commons.lang3.math.NumberUtils;
+import org.springframework.http.MediaType;
+import org.springframework.stereotype.Component;
+import org.springframework.web.reactive.function.server.ServerRequest;
+import org.springframework.web.reactive.function.server.ServerResponse;
+import reactor.core.publisher.Mono;
+
+/**
+ * 会员信息处理器
+ *
+ * @author 付嘉
+ * @date 2026-05-01
+ */
+
+@Slf4j
+@Component
+@RequiredArgsConstructor
+@Tag(name = "会员管理", description = "会员信息管理、微信绑定、服务号关注等")
+public class MemberHandler {
+
+    private final MemberService memberService;
+    private final WechatAuthService wechatAuthService;
+    private final WechatOfficialService wechatOfficialService;
+    private final AuthUtil authUtil;
+
+    @Operation(summary = "获取会员信息", description = "根据当前登录用户获取会员基本信息")
+    public Mono<ServerResponse> getMemberInfo(ServerRequest request) {
+
+        Long memberId = authUtil.getMemberUserIdOrThrow(request);
+
+        log.info("获取会员信息, memberId: {}", memberId);
+
+        return memberService.getMemberInfo(memberId)
+                .flatMap(info -> ServerResponse.ok()
+                            .contentType(MediaType.APPLICATION_JSON)
+                            .bodyValue(info));
+    }
+
+    @Operation(summary = "更新会员信息", description = "更新会员昵称、性别、生日、头像、地址等信息")
+    public Mono<ServerResponse> updateMemberInfo(ServerRequest request) {
+
+        Long memberId = authUtil.getMemberUserIdOrThrow(request);
+
+        log.info("更新会员信息, memberId: {}", memberId);
+
+        return request.bodyToMono(UpdateMemberInfoDto.class)
+                .flatMap(updateDto -> memberService.updateMemberInfo(memberId, updateDto))
+                .flatMap(info -> ServerResponse.ok()
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .bodyValue(info));
+    }
+
+    @Operation(summary = "绑定手机号", description = "通过微信小程序手机号code绑定会员手机号")
+    public Mono<ServerResponse> bindPhone(ServerRequest request) {
+
+        Long memberId = authUtil.getMemberUserIdOrThrow(request);
+
+        String phoneCode = request.queryParam("phoneCode").orElse("");
+
+        if (phoneCode.trim().isEmpty()) throw new IllegalArgumentException("手机号code不能为空");
+
+        log.info("收到绑定手机号请求, memberId: {}, phoneCode: {}", memberId, phoneCode);
+
+        return wechatAuthService.bindPhone(memberId, phoneCode)
+                .flatMap(success -> ServerResponse.ok()
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .bodyValue(success));
+    }
+
+    @Operation(summary = "查询服务号关注状态", description = "查询会员是否关注微信服务号")
+    public Mono<ServerResponse> checkSubscribeStatus(ServerRequest request) {
+
+        Long memberId = authUtil.getMemberUserIdOrThrow(request);
+
+        log.info("查询服务号关注状态, memberId: {}", memberId);
+
+        return wechatOfficialService.checkSubscribeStatus(memberId)
+                .flatMap(subscribed -> {
+                    return ServerResponse.ok()
+                            .contentType(MediaType.APPLICATION_JSON)
+                            .bodyValue(subscribed);
+                });
+    }
+
+    @Operation(summary = "管理员更新手机号", description = "后台管理员为会员更新手机号")
+    public Mono<ServerResponse> adminUpdatePhone(ServerRequest request) {
+
+        Long adminId = authUtil.getAdminUserIdOrThrow(request);
+
+        String memberIdStr = request.pathVariable("id");
+        long memberId = NumberUtils.toLong(memberIdStr, 0L);
+
+        if (memberId <= 0) throw new IllegalArgumentException("更新手机号失败: memberId 无效");
+
+        log.info("收到更新手机号请求, memberId: {}", memberId);
+
+        return request.bodyToMono(AdminUpdatePhoneDto.class)
+                .flatMap(body -> {
+                    String phone = body.getPhone();
+
+                    if (phone == null || phone.isEmpty()) return Mono.error(new IllegalArgumentException("手机号不能为空"));
+
+                    if (!phone.matches("^1[3-9]\\d{9}$")) return Mono.error(new IllegalArgumentException("手机号格式不正确"));
+
+                    log.info("开始更新手机号, memberId: {}, phone: {}", memberId, phone);
+
+                    return memberService.adminUpdatePhone(memberId, phone);
+                })
+                .flatMap(success -> {
+                    log.info("手机号更新成功, memberId: {}", memberId);
+                    return ServerResponse.ok()
+                            .contentType(MediaType.APPLICATION_JSON)
+                            .bodyValue(success);
+                });
+    }
+
+    @Operation(summary = "管理员查看会员详情", description = "后台管理员查看指定会员的详细信息")
+    public Mono<ServerResponse> adminGetMemberInfo(ServerRequest request) {
+
+        Long adminId = authUtil.getAdminUserIdOrThrow(request);
+
+        String memberIdStr = request.pathVariable("id");
+        long memberId = NumberUtils.toLong(memberIdStr, 0L);
+        if(memberId <= 0) throw new IllegalArgumentException("会员ID格式错误");
+
+        log.info("前台查看会员信息, adminId: {}, memberId: {}", adminId, memberId);
+
+        return memberService.getMemberDetail(memberId)
+                .flatMap(detail -> {
+                    if (detail.getPhone() != null && !detail.getPhone().isEmpty()) {
+                        try {
+                            String decryptedPhone = AesUtil.decrypt(detail.getPhone());
+                            detail.setPhone(WechatPhoneUtil.maskPhone(decryptedPhone));
+                        } catch (Exception e) {
+                            log.error("手机号解密失败, memberId: {}", detail.getId(), e);
+                            detail.setPhone(null);
+                        }
+                    }
+                    return ServerResponse.ok()
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .bodyValue(detail);
+                });
+    }
+
+    @Operation(summary = "管理员编辑会员信息", description = "后台管理员编辑会员信息")
+    public Mono<ServerResponse> adminUpdateMemberInfo(ServerRequest request) {
+
+        Long adminId = authUtil.getAdminUserIdOrThrow(request);
+
+        String memberIdStr = request.pathVariable("id");
+        long memberId = NumberUtils.toLong(memberIdStr, 0L);
+        if(memberId <= 0L) throw new IllegalArgumentException("会员ID格式错误");
+
+        // TODO: 补充签到记录
+        log.info("前台编辑会员信息, adminId: {}, memberId: {}", adminId, memberId);
+
+        return request.bodyToMono(UpdateMemberInfoDto.class)
+                .flatMap(updateDto -> memberService.adminUpdateMemberInfo(memberId, updateDto))
+                .flatMap(detail -> ServerResponse.ok()
+                        .contentType(MediaType.APPLICATION_JSON)
+                        .bodyValue(detail));
+    }
+
+    @Operation(summary = "搜索会员列表", description = "后台管理员按关键词搜索会员，支持性别筛选和分页")
+    public Mono<ServerResponse> searchMembers(ServerRequest request) {
+
+        Long adminId = authUtil.getAdminUserIdOrThrow(request);
+
+        String keyword = request.queryParam("searchValue").orElse(null);
+        Integer pageNum = NumberUtils.toInt(request.queryParam("pageNum").orElse("1"), 1);
+        Integer pageSize = NumberUtils.toInt(request.queryParam("pageSize").orElse("10"), 10);
+
+        log.info("前台搜索会员列表, adminId: {}, keyword: {},pageNum: {}, pageSize: {}",
+                adminId, keyword, pageNum, pageSize);
+
+        return memberService.searchMember(new SearchMemberDto(keyword, pageNum, pageSize))
+                .map(member -> {
+                    // 解密手机号
+                    if (member.getPhone() != null && !member.getPhone().isEmpty()) {
+                        try {
+                            String decryptedPhone = AesUtil.decrypt(member.getPhone());
+                            member.setPhone(WechatPhoneUtil.maskPhone(decryptedPhone));
+                        } catch (Exception e) {
+                            log.error("手机号解密失败, memberId: {}", member.getId(), e);
+                            member.setPhone(null);
+                        }
+                    }
+                    return member;
+                })
+                .collectList()
+                .flatMap(list -> ServerResponse.ok().bodyValue(list));
+    }
+
+
+    @Operation(summary = "查看会员列表", description = "后台管理员分页查看所有会员列表")
+    public Mono<ServerResponse> getAllMembers(ServerRequest request) {
+
+        Long adminId = authUtil.getAdminUserIdOrThrow(request);
+
+        int pageNum = NumberUtils.toInt(request.queryParam("pageNum").orElse("1"), 1);
+        int pageSize = NumberUtils.toInt(request.queryParam("pageSize").orElse("10"), 10);
+
+        log.info("前台查看会员列表, adminId: {}, pageNum: {}, pageSize: {}", adminId, pageNum, pageSize);
+        // TODO: 补充签到记录
+
+        return memberService.findAll(pageNum, pageSize)
+                .map(member -> {
+                    // 解密手机号
+                    if (member.getPhone() != null && !member.getPhone().isEmpty()) {
+                        try {
+                            String decryptedPhone = AesUtil.decrypt(member.getPhone());
+                            member.setPhone(WechatPhoneUtil.maskPhone(decryptedPhone));
+                        } catch (Exception e) {
+                            log.error("手机号解密失败, memberId: {}", member.getId(), e);
+                            member.setPhone(null);
+                        }
+                    }
+                    return member;
+                })
+                .collectList()
+                .flatMap(list -> ServerResponse.ok().bodyValue(list));
+    }
+
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/handler/RefundSagaHandler.java

@@ -1,12 +1,12 @@
-package cn.novalon.gym.manage.gymmembercard.handler;
+package cn.novalon.gym.manage.member.handler;
 
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardRecord;
-import cn.novalon.gym.manage.gymmembercard.domain.MemberCardTransactions;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardEvent;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardRecordStatus;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardTransactionsAction;
-import cn.novalon.gym.manage.gymmembercard.repository.IMemberCardRecordRepository;
-import cn.novalon.gym.manage.gymmembercard.sevice.IMemberCardTransactionsService;
+import cn.novalon.gym.manage.member.entity.MemberCardRecord;
+import cn.novalon.gym.manage.member.entity.MemberCardTransaction;
+import cn.novalon.gym.manage.member.enums.CardEvent;
+import cn.novalon.gym.manage.member.enums.MemberCardRecordStatus;
+import cn.novalon.gym.manage.member.enums.TransactionType;
+import cn.novalon.gym.manage.member.repository.MemberCardRecordRepository;
+import cn.novalon.gym.manage.member.service.IMemberCardTransactionService;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.stereotype.Component;
@@ -15,19 +15,25 @@ import reactor.core.publisher.Mono;
 import java.util.ArrayList;
 import java.util.List;
 
+/**
+ * 退款 Saga 处理器
+ * 
+ * @author 付嘉
+ * @date 2026-05-27
+ */
 @Slf4j
 @Component
 @RequiredArgsConstructor
 public class RefundSagaHandler {
 
-    private final IMemberCardRecordRepository recordRepository;
-    private final IMemberCardTransactionsService transactionsService;
+    private final MemberCardRecordRepository recordRepository;
+    private final IMemberCardTransactionService transactionService;
     private final MemberCardStateMachine stateMachine;
 
     public Mono<Void> executeRefund(Long recordId) {
         return recordRepository.findById(recordId)
                 .switchIfEmpty(Mono.error(new RuntimeException("会员卡记录不存在")))
-                .flatMap(record -> stateMachine.validateTransition(record, MemberCardEvent.REFUND)
+                .flatMap(record -> stateMachine.validateTransition(record, CardEvent.REFUND)
                         .then(Mono.defer(() -> doExecuteRefund(recordId, record))));
     }
 
@@ -55,7 +61,7 @@ public class RefundSagaHandler {
     }
 
     private Mono<Void> updateCardStatus(Long recordId, MemberCardRecordStatus status) {
-        return recordRepository.updateStatus(recordId, status)
+        return recordRepository.updateStatus(recordId, status.name())
                 .flatMap(rows -> {
                     if (rows == 0) {
                         return Mono.error(new RuntimeException("更新会员卡状态失败"));
@@ -65,29 +71,31 @@ public class RefundSagaHandler {
     }
 
     private Mono<Void> createRefundTransaction(MemberCardRecord record) {
-        MemberCardTransactions transaction = new MemberCardTransactions();
-        transaction.setMemberId(record.getMemberId());
-        transaction.setMemberCardId(record.getMemberCardId());
-        transaction.setOperationType(MemberCardTransactionsAction.REFUND);
-        transaction.setChangeAmount(-record.getRemainingTimes());
-        transaction.setChangeBalance(-record.getRemainingAmount());
-        transaction.setAfterRemainingCount(0);
-        transaction.setAfterRemainingBalance(0.0);
-        transaction.setRemark("会员卡退款");
+        MemberCardTransaction transaction = MemberCardTransaction.builder()
+                .memberId(record.getMemberId())
+                .memberCardId(record.getMemberCardId())
+                .operationType(TransactionType.REFUND.name())
+                .changeAmount(-record.getRemainingTimes())
+                .changeBalance(-record.getRemainingAmount())
+                .afterRemainingCount(0)
+                .afterRemainingBalance(0.0)
+                .remark("会员卡退款")
+                .build();
 
-        return transactionsService.createTransaction(transaction);
+        return transactionService.createTransaction(transaction);
     }
 
     private Mono<Void> createReversalTransaction(MemberCardRecord record) {
-        MemberCardTransactions reversal = new MemberCardTransactions();
-        reversal.setMemberId(record.getMemberId());
-        reversal.setMemberCardId(record.getMemberCardId());
-        reversal.setOperationType(MemberCardTransactionsAction.REFUND);
-        reversal.setChangeAmount(record.getRemainingTimes());
-        reversal.setChangeBalance(record.getRemainingAmount());
-        reversal.setRemark("退款冲正");
+        MemberCardTransaction reversal = MemberCardTransaction.builder()
+                .memberId(record.getMemberId())
+                .memberCardId(record.getMemberCardId())
+                .operationType(TransactionType.REFUND.name())
+                .changeAmount(record.getRemainingTimes())
+                .changeBalance(record.getRemainingAmount())
+                .remark("退款冲正")
+                .build();
 
-        return transactionsService.createTransaction(reversal);
+        return transactionService.createTransaction(reversal);
     }
 
     private Mono<Void> executeSaga(List<SagaStep> steps, List<SagaStep> rollbackSteps) {
@@ -123,4 +131,4 @@ public class RefundSagaHandler {
     }
 
     private record SagaStep(String description, Mono<Void> operation, Mono<Void> rollbackOperation) {}
-}
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/handler/WechatAuthHandler.java

@@ -0,0 +1,57 @@
+package cn.novalon.gym.manage.member.handler;
+
+import cn.novalon.gym.manage.member.dto.WechatLoginDto;
+import cn.novalon.gym.manage.member.service.WechatAuthService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.MediaType;
+import org.springframework.stereotype.Component;
+import org.springframework.web.reactive.function.server.ServerRequest;
+import org.springframework.web.reactive.function.server.ServerResponse;
+import reactor.core.publisher.Mono;
+
+/**
+ * 微信认证
+ * 
+ * @author 付嘉
+ * @date 2026-05-01
+ */
+
+@Slf4j
+@Component
+@RequiredArgsConstructor
+@Tag(name = "微信认证", description = "微信小程序登录、公众号回调等")
+public class WechatAuthHandler {
+
+    private final WechatAuthService wechatAuthService;
+    private final WechatOfficialEventHandler wechatOfficialEventHandler;
+
+    @Operation(summary = "微信小程序登录", description = "通过微信小程序code获取session_key，完成会员登录或注册")
+    public Mono<ServerResponse> miniappLogin(ServerRequest request) {
+        log.info("收到小程序登录请求");
+        
+        return request.bodyToMono(WechatLoginDto.class)
+                .flatMap(loginRequest -> {
+                    log.info("开始微信AuthService, code: {}", loginRequest.getCode());
+                    return wechatAuthService.miniappLogin(loginRequest);
+                })
+                .flatMap(response -> {
+                    log.info("更新成功, memberId: {}", response.getMemberId());
+                    return ServerResponse.ok()
+                            .contentType(MediaType.APPLICATION_JSON)
+                            .bodyValue(response);
+                });
+    }
+
+    @Operation(summary = "微信公众号回调", description = "处理微信公众号事件（关注、取消关注等）")
+    public Mono<ServerResponse> mpCallback(ServerRequest request) {
+        return wechatOfficialEventHandler.handleEvent(request);
+    }
+
+    @Operation(summary = "验证微信公众号签名", description = "微信公众号服务器验证，返回echostr")
+    public Mono<ServerResponse> verifyMpSignature(ServerRequest request) {
+        return wechatOfficialEventHandler.verifySignature(request);
+    }
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/handler/WechatOfficialEventHandler.java

@@ -0,0 +1,215 @@
+package cn.novalon.gym.manage.member.handler;
+
+import cn.novalon.gym.manage.member.config.WechatProperties;
+import cn.novalon.gym.manage.member.service.WechatOfficialService;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.http.MediaType;
+import org.springframework.stereotype.Component;
+import org.springframework.web.reactive.function.server.ServerRequest;
+import org.springframework.web.reactive.function.server.ServerResponse;
+import reactor.core.publisher.Mono;
+
+import java.nio.charset.StandardCharsets;
+import java.security.MessageDigest;
+import java.util.Arrays;
+
+/**
+ * 微信公众号事件处理器
+ * 
+ * @author 付嘉
+ * @date 2026-05-01
+ */
+
+@Slf4j
+@Component
+@RequiredArgsConstructor
+public class WechatOfficialEventHandler {
+
+    private final WechatOfficialService wechatOfficialService;
+    private final WechatProperties wechatProperties;
+
+    /**
+     * 处理微信公众号事件
+     * 
+     * 请求格式:XML
+     * 响应格式:success 或 回复消息内容
+     */
+    public Mono<ServerResponse> handleEvent(ServerRequest request) {
+        return request.bodyToMono(String.class)
+                .flatMap(xmlBody -> {
+                    log.info("收到微信公众号事件 {}", xmlBody);
+                    
+                    String openId = extractOpenId(xmlBody);
+                    String event = extractEvent(xmlBody);
+
+                    if (openId == null || event == null) {
+                        log.error("无法解析微信公众号事件");
+                        return ServerResponse.badRequest().bodyValue("error");
+                    }
+
+                    log.info("处理事件 openId={}, event={}", openId, event);
+
+                    // 根据事件类型处理
+                    if ("subscribe".equals(event)) {
+                        return wechatOfficialService.handleSubscribeEvent(openId)
+                                .then(ServerResponse.ok()
+                                        .contentType(MediaType.TEXT_PLAIN)
+                                        .bodyValue("success"));
+                    } else if ("unsubscribe".equals(event)) {
+                        return wechatOfficialService.handleUnsubscribeEvent(openId)
+                                .then(ServerResponse.ok()
+                                        .contentType(MediaType.TEXT_PLAIN)
+                                        .bodyValue("success"));
+                    } else {
+                        log.warn("未知事件类型: {}", event);
+                        return ServerResponse.ok()
+                                .contentType(MediaType.TEXT_PLAIN)
+                                .bodyValue("success");
+                    }
+                })
+                .onErrorResume(e -> {
+                    log.error("处理微信公众号事件失败", e);
+                    return ServerResponse.ok()
+                            .contentType(MediaType.TEXT_PLAIN)
+                            .bodyValue("success"); // 即使处理失败也返回success避免微信重试
+                });
+    }
+
+    /**
+     * 验证微信公众号签名
+     * 
+     * GET请求用于验证服务器地址
+     */
+    public Mono<ServerResponse> verifySignature(ServerRequest request) {
+        String signature = request.queryParam("signature").orElse("");
+        String timestamp = request.queryParam("timestamp").orElse("");
+        String nonce = request.queryParam("nonce").orElse("");
+        String echostr = request.queryParam("echostr").orElse("");
+
+        log.info("========== 微信公众号签名验证 ==========");
+        log.info("收到的参数:");
+        log.info("  signature: {}", signature);
+        log.info("  timestamp: {}", timestamp);
+        log.info("  nonce: {}", nonce);
+        log.info("  echostr: {}", echostr);
+
+        // 获取配置的Token
+        String token = wechatProperties.getMp().getToken();
+        log.info("配置的Token: {}", token);
+
+        // 验证签名
+        if (checkSignature(signature, timestamp, nonce, token)) {
+            log.info("签名验证成功，返回echostr: {}", echostr);
+            log.info("========== 微信公众号签名验证结束 ==========");
+            return ServerResponse.ok()
+                    .contentType(MediaType.TEXT_PLAIN)
+                    .bodyValue(echostr);
+        } else {
+            log.warn("签名验证失败");
+            log.info("========== 微信公众号签名验证结束 ==========");
+            return ServerResponse.badRequest()
+                    .contentType(MediaType.TEXT_PLAIN)
+                    .bodyValue("error");
+        }
+    }
+
+    /**
+     * 验证签名
+     * 
+     * @param signature 微信加密签名
+     * @param timestamp 时间戳
+     * @param nonce     随机数
+     * @param token     Token
+     * @return 是否验证通过
+     */
+    private boolean checkSignature(String signature, String timestamp, String nonce, String token) {
+        // 1. 将token、timestamp、nonce三个参数进行字典序排序
+        String[] arr = new String[]{token, timestamp, nonce};
+        Arrays.sort(arr);
+
+        // 2. 将三个参数字符串拼接成一个字符串
+        StringBuilder sb = new StringBuilder();
+        for (String str : arr) {
+            sb.append(str);
+        }
+
+        // 3. 将拼接后的字符串进行sha1加密
+        String encrypted = sha1(sb.toString());
+        log.debug("计算的签名 {}", encrypted);
+
+        // 4. 将加密后的字符串与signature对比
+        return encrypted != null && encrypted.equalsIgnoreCase(signature);
+    }
+
+    /**
+     * SHA1加密
+     * 
+     * @param str 待加密字符串
+     * @return 加密后字符串
+     */
+    private String sha1(String str) {
+        try {
+            MessageDigest md = MessageDigest.getInstance("SHA-1");
+            byte[] digest = md.digest(str.getBytes(StandardCharsets.UTF_8));
+            StringBuilder hexString = new StringBuilder();
+            for (byte b : digest) {
+                String hex = Integer.toHexString(0xff & b);
+                if (hex.length() == 1) {
+                    hexString.append('0');
+                }
+                hexString.append(hex);
+            }
+            return hexString.toString();
+        } catch (Exception e) {
+            log.error("SHA1加密失败", e);
+            return null;
+        }
+    }
+
+    /**
+     * 从XML中提取OpenID
+     */
+    private String extractOpenId(String xml) {
+        int start = xml.indexOf("<FromUserName>");
+        int end = xml.indexOf("</FromUserName>");
+        if (start != -1 && end != -1) {
+            String value = xml.substring(start + 14, end);
+            // 去除 CDATA 标记
+            return cleanCdata(value);
+        }
+        return null;
+    }
+    
+    /**
+     * 从XML中获取事件类型
+     */
+    private String extractEvent(String xml) {
+        int start = xml.indexOf("<Event>");
+        int end = xml.indexOf("</Event>");
+        if (start != -1 && end != -1) {
+            String value = xml.substring(start + 7, end);
+            // 去除 CDATA 标记
+            return cleanCdata(value);
+        }
+        return null;
+    }
+    
+    /**
+     * 清理 CDATA 标记
+     * 例如: <![CDATA[subscribe]]> -> subscribe
+     */
+    private String cleanCdata(String value) {
+        if (value == null) {
+            return null;
+        }
+        // 去除前后空白
+        value = value.trim();
+        // 提取 CDATA 中间内容
+        // 格式: <![CDATA[xxx]]>
+        if (value.startsWith("<![CDATA[") && value.endsWith("]]>")) {
+            return value.substring(9, value.length() - 3);
+        }
+        return value;
+    }
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/repository/IMemberRepository.java

@@ -0,0 +1,75 @@
+package cn.novalon.gym.manage.member.repository;
+
+import cn.novalon.gym.manage.member.entity.Member;
+import cn.novalon.gym.manage.member.vo.MemberCardInfoVO;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.r2dbc.repository.Query;
+import org.springframework.data.r2dbc.repository.R2dbcRepository;
+import org.springframework.stereotype.Repository;
+import reactor.core.publisher.Flux;
+import reactor.core.publisher.Mono;
+
+/**
+ *  会员Repository
+ *  @author 付嘉
+ *  @date 2026-05-01
+ */
+
+@Repository
+public interface IMemberRepository extends R2dbcRepository<Member, Long> {
+
+    // UnionID查询会员
+    Mono<Member> findByUnionId(String unionId);
+
+    // 小程序OpenID查询会员
+    Mono<Member> findByMiniappOpenId(String miniappOpenId);
+
+    // 服务号OpenID查询会员
+    Mono<Member> findByOfficialOpenId(String officialOpenId);
+
+    // 手机号查询
+    Mono<Member> findByPhone(String phone);
+
+    /**
+     * 分页查询所有会员
+     */
+    Flux<Member> findAllBy(Pageable pageable);
+
+    /**
+     * 查询会员的所有卡片
+     */
+    @Query("SELECT " +
+            "   r.id, " +
+            "   r.member_card_record_id, " +
+            "   r.member_id, " +
+            "   r.member_card_id, " +
+            "   r.status, " +
+            "   r.remaining_times, " +
+            "   r.remaining_amount, " +
+            "   r.expire_time, " +
+            "   r.purchase_time, " +
+            "   r.source_order_id, " +
+            "   r.created_at, " +
+            "   r.updated_at, " +
+            "   r.version, " +
+            "   r.card_composition, " +
+            "   c.id AS card_id, " +
+            "   c.member_card_id, " +
+            "   c.member_card_name, " +
+            "   c.member_card_type, " +
+            "   c.member_card_price, " +
+            "   c.member_card_validity_days, " +
+            "   c.member_card_total_times, " +
+            "   c.member_card_amount, " +
+            "   c.member_card_status, " +
+            "   c.extra_config, " +
+            "   c.created_at AS card_created_at, " +
+            "   c.updated_at AS card_updated_at " +
+            "FROM member_card_record r " +
+            "LEFT JOIN member_card c ON r.member_card_id = c.id " +
+            "WHERE r.member_id = :memberId " +
+            "AND r.deleted_at IS NULL " +
+            "AND c.deleted_at IS NULL " +
+            "ORDER BY r.created_at DESC")
+    Flux<MemberCardInfoVO> findCardRecordsWithCardInfoByMemberId(Long memberId);
+}

gym-manage-api/gym-member/src/main/java/cn/novalon/gym/manage/member/repository/MemberCardRecordRepository.java

@@ -1,32 +1,39 @@
-package cn.novalon.gym.manage.gymmembercard.dao;
+package cn.novalon.gym.manage.member.repository;
 
-import cn.novalon.gym.manage.gymmembercard.entity.MemberCardRecordEntity;
-import cn.novalon.gym.manage.gymmembercard.enums.MemberCardRecordStatus;
+import cn.novalon.gym.manage.member.entity.MemberCardRecord;
 import org.springframework.data.domain.Pageable;
 import org.springframework.data.r2dbc.repository.Modifying;
 import org.springframework.data.r2dbc.repository.Query;
 import org.springframework.data.r2dbc.repository.R2dbcRepository;
-import org.springframework.data.repository.query.Param;
 import org.springframework.stereotype.Repository;
 import reactor.core.publisher.Flux;
 import reactor.core.publisher.Mono;
 
 import java.time.LocalDateTime;
 
+/**
+ * 会员卡记录 Repository（会员持有的卡）
+ *
+ * @author 付嘉
+ * @date 2026-05-27
+ */
 @Repository
-public interface MemberCardRecordDao extends R2dbcRepository<MemberCardRecordEntity, Long> {
+public interface MemberCardRecordRepository extends R2dbcRepository<MemberCardRecord, Long> {
 
+    /**
+     * 插入新的激活卡记录
+     */
     @Modifying
     @Query("INSERT INTO member_card_record (member_id, member_card_id, status, expire_time, remaining_times, remaining_amount, source_order_id, purchase_time, created_at, updated_at) " +
             "VALUES (:memberId, :memberCardId, 'ACTIVE', :expireTime, :remainingTimes, :remainingAmount, :sourceOrderId, NOW(), NOW(), NOW()) " +
             "RETURNING *")
-    Mono<MemberCardRecordEntity> insertActiveRecord(@Param("memberId") Long memberId,
-                                                    @Param("memberCardId") Long memberCardId,
-                                                    @Param("expireTime") LocalDateTime expireTime,
-                                                    @Param("remainingTimes") Integer remainingTimes,
-                                                    @Param("remainingAmount") Double remainingAmount,
-                                                    @Param("sourceOrderId") Long sourceOrderId);
+    Mono<MemberCardRecord> insertActiveRecord(Long memberId, Long memberCardId,
+                                              LocalDateTime expireTime, Integer remainingTimes,
+                                              Double remainingAmount, Long sourceOrderId);
 
+    /**
+     * 扣减使用次数/金额
+     */
     @Modifying
     @Query("UPDATE member_card_record SET " +
             "remaining_times = remaining_times - :deductTimes, " +
@@ -36,52 +43,67 @@ public interface MemberCardRecordDao extends R2dbcRepository<MemberCardRecordEnt
             "AND deleted_at IS NULL " +
             "AND remaining_times >= :deductTimes " +
             "AND remaining_amount >= :deductAmount")
-    Mono<Integer> deductUsage(@Param("recordId") Long recordId,
-                              @Param("deductTimes") Integer deductTimes,
-                              @Param("deductAmount") Double deductAmount);
+    Mono<Integer> deductUsage(Long recordId, Integer deductTimes, Double deductAmount);
 
+    /**
+     * 续费卡片
+     */
     @Modifying
     @Query("UPDATE member_card_record SET remaining_times = remaining_times + :addTimes, " +
             "remaining_amount = remaining_amount + :addAmount, expire_time = :newExpireTime, updated_at = NOW() " +
             "WHERE member_card_record_id = :recordId AND deleted_at IS NULL")
-    Mono<Integer> renewCard(@Param("recordId") Long recordId,
-                            @Param("addTimes") Integer addTimes,
-                            @Param("addAmount") Double addAmount,
-                            @Param("newExpireTime") LocalDateTime newExpireTime);
+    Mono<Integer> renewCard(Long recordId, Integer addTimes, Double addAmount, LocalDateTime newExpireTime);
 
+    /**
+     * 更新卡片状态
+     */
     @Modifying
     @Query("UPDATE member_card_record SET status = :status, updated_at = NOW() " +
             "WHERE member_card_record_id = :recordId AND deleted_at IS NULL")
-    Mono<Integer> updateStatus(@Param("recordId") Long recordId,
-                               @Param("status") MemberCardRecordStatus status);
+    Mono<Integer> updateStatus(Long recordId, String status);
 
+    /**
+     * 查询会员的有效卡片
+     */
     @Query("SELECT * FROM member_card_record WHERE member_id = :memberId AND status = 'ACTIVE' AND deleted_at IS NULL ORDER BY expire_time ASC")
-    Flux<MemberCardRecordEntity> findActiveCardsByMemberId(@Param("memberId") Long memberId);
+    Flux<MemberCardRecord> findActiveCardsByMemberId(Long memberId);
 
+    /**
+     * 查询会员的所有卡片（分页）
+     */
     @Query("SELECT mcr.* FROM member_card_record mcr " +
-            "INNER JOIN member m ON mcr.member_id = m.member_id " +
+            "INNER JOIN member_user m ON mcr.member_id = m.id " +
             "WHERE mcr.member_id = :memberId AND mcr.deleted_at IS NULL " +
             "ORDER BY mcr.purchase_time DESC LIMIT :#{#pageable.pageSize} OFFSET :#{#pageable.offset}")
-    Flux<MemberCardRecordEntity> findByMemberId(@Param("memberId") Long memberId, Pageable pageable);
+    Flux<MemberCardRecord> findByMemberId(Long memberId, Pageable pageable);
 
+    /**
+     * 验证次卡是否有足够次数
+     */
     @Query("SELECT * FROM member_card_record WHERE member_card_record_id = :recordId " +
             "AND status = 'ACTIVE' AND deleted_at IS NULL " +
             "AND expire_time > NOW() " +
             "AND remaining_times >= :requiredTimes")
-    Mono<MemberCardRecordEntity> validateCountCard(@Param("recordId") Long recordId,
-                                                   @Param("requiredTimes") Integer requiredTimes);
+    Mono<MemberCardRecord> validateCountCard(Long recordId, Integer requiredTimes);
 
+    /**
+     * 验证储值卡是否有足够余额
+     */
     @Query("SELECT * FROM member_card_record WHERE member_card_record_id = :recordId " +
             "AND status = 'ACTIVE' AND deleted_at IS NULL " +
             "AND expire_time > NOW() " +
             "AND remaining_amount >= :requiredAmount")
-    Mono<MemberCardRecordEntity> validateStoredCard(@Param("recordId") Long recordId,
-                                                    @Param("requiredAmount") Double requiredAmount);
+    Mono<MemberCardRecord> validateStoredCard(Long recordId, Double requiredAmount);
 
+    /**
+     * 查询已过期的卡片
+     */
     @Query("SELECT * FROM member_card_record WHERE status = 'ACTIVE' AND expire_time < NOW() AND deleted_at IS NULL LIMIT 500")
-    Flux<MemberCardRecordEntity> findExpiredCards();
+    Flux<MemberCardRecord> findExpiredCards();
 
+    /**
+     * 查询所有有效记录
+     */
     @Query("SELECT * FROM member_card_record WHERE status = 'ACTIVE' AND deleted_at IS NULL")
-    Flux<MemberCardRecordEntity> findActiveRecords();
-
-}
+    Flux<MemberCardRecord> findActiveRecords();
+}