@llryiop/avatar-boot-cli 1.0.0

package/templates/avatar-scaffold-service/pom.xml

@@ -0,0 +1,150 @@
+<?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>com.iflytek.avatar</groupId>
+        <artifactId>avatar-template</artifactId>
+        <version>1.0.0-SNAPSHOT</version>
+        <relativePath>../pom.xml</relativePath>
+    </parent>
+
+    <artifactId>avatar-template-service</artifactId>
+
+    <properties>
+        <maven.compiler.source>21</maven.compiler.source>
+        <maven.compiler.target>21</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+    <dependencies>
+        <dependency>
+            <groupId>com.iflytek.avatar</groupId>
+            <artifactId>avatar-template-api</artifactId>
+            <version>1.0.0-SNAPSHOT</version>
+        </dependency>
+        <dependency>
+            <groupId>com.iflytek.avatar.boot</groupId>
+            <artifactId>avatar-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.iflytek.avatar.boot</groupId>
+            <artifactId>avatar-boot-starter-nacos</artifactId>
+        </dependency>
+<!--        <dependency>-->
+<!--            <groupId>com.iflytek.avatar.boot</groupId>-->
+<!--            <artifactId>avatar-boot-starter-mysql</artifactId>-->
+<!--        </dependency>-->
+<!--        <dependency>-->
+<!--            <groupId>com.iflytek.avatar.boot</groupId>-->
+<!--            <artifactId>avatar-boot-starter-redis</artifactId>-->
+<!--        </dependency>-->
+    </dependencies>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+                <version>3.5.3</version>
+            </plugin>
+
+
+            <plugin>
+                <groupId>org.codehaus.mojo</groupId>
+                <artifactId>appassembler-maven-plugin</artifactId>
+                <version>1.10</version>
+                <configuration>
+                    <repositoryLayout>flat</repositoryLayout>
+                    <!-- 在脚本的classpath开始增加配置文件路径 -->
+                    <includeConfigurationDirectoryInClasspath>true</includeConfigurationDirectoryInClasspath>
+                    <!-- 生成配置文件路径 -->
+                    <configurationDirectory>conf</configurationDirectory>
+                    <!-- 配置文件原路径 -->
+                    <configurationSourceDirectory>src/main/resources</configurationSourceDirectory>
+                    <!-- 从原配置文件复制 -->
+                    <copyConfigurationDirectory>true</copyConfigurationDirectory>
+                    <includeConfigurationDirectoryInClasspath>true</includeConfigurationDirectoryInClasspath>
+
+                    <!-- 生成哪几种平台的脚本 -->
+                    <platforms>
+                        <platform>unix</platform>
+                        <platform>windows</platform>
+                    </platforms>
+                    <!-- 生成脚本的后缀 -->
+                    <binFileExtensions>
+                        <unix>.sh</unix>
+                        <windows>.bat</windows>
+                    </binFileExtensions>
+                    <!-- 使用classpath通配符 -->
+                    <useWildcardClassPath>true</useWildcardClassPath>
+                    <!-- JVM参数 -->
+                    <!--					<extraJvmArguments>-Xms512m -Xmx2048m</extraJvmArguments>-->
+                    <!-- 依赖包目录 -->
+                    <repositoryName>lib</repositoryName>
+                    <programs>
+                        <program>
+                            <name>startup</name>
+                            <mainClass>com.iflytek.avatar.Application</mainClass>
+                        </program>
+                    </programs>
+                </configuration>
+                <!-- 绑定生命周期 -->
+                <executions>
+                    <execution>
+                        <id>appassembler</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>assemble</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+            <plugin>
+                <artifactId>maven-assembly-plugin</artifactId>
+                <configuration>
+                    <appendAssemblyId>false</appendAssemblyId>
+                    <descriptors>
+                        <descriptor>packaging/assembly.xml</descriptor>
+                    </descriptors>
+                </configuration>
+                <executions>
+                    <execution>
+                        <id>make-assembly</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>single</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.13.0</version>
+                <configuration>
+                    <source>${java.version}</source>
+                    <target>${java.version}</target>
+                    <encoding>${project.build.sourceEncoding}</encoding>
+                </configuration>
+            </plugin>
+
+            <!-- 设置程序启动的Main Class -->
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-jar-plugin</artifactId>
+                <version>3.0.2</version>
+                <configuration>
+                    <excludes>
+                        <!--以类路径目录为基础-->
+                        <exclude>*.yml</exclude>
+                        <exclude>*.properties</exclude>
+                    </excludes>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

package/templates/avatar-scaffold-service/src/main/java/com/iflytek/avatar/Application.java

@@ -0,0 +1,21 @@
+package com.iflytek.avatar;
+
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.cloud.openfeign.EnableFeignClients;
+
+@EnableFeignClients
+@SpringBootApplication
+public class Application {
+
+    public static void main(String[] args) {
+        // 禁用 Nacos 客户端的文件日志输出,解决 Logback appender 冲突问题
+        // 参考: https://github.com/alibaba/spring-cloud-alibaba/issues/4004
+        // 参考: https://github.com/alibaba/spring-cloud-alibaba/issues/3995
+        System.setProperty("nacos.logging.default.config.enabled", "false");
+        System.setProperty("nacos.logging.config", "");
+
+        SpringApplication.run(Application.class, args);
+    }
+}

package/templates/avatar-scaffold-service/src/main/java/com/iflytek/avatar/login/config/LoginConfig.java

@@ -0,0 +1,20 @@
+package com.iflytek.avatar.login.config;
+
+import com.iflytek.avatar.login.constant.LoginConstant;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * 登录模块配置
+ */
+@Configuration
+public class LoginConfig {
+
+    /**
+     * Token 过期时间（秒），可从配置文件读取，此处为 Demo 默认值
+     */
+    @Bean
+    public int loginTokenExpireSeconds() {
+        return LoginConstant.DEFAULT_TOKEN_EXPIRE_SECONDS;
+    }
+}

package/templates/avatar-scaffold-service/src/main/java/com/iflytek/avatar/login/controller/LoginController.java

@@ -0,0 +1,37 @@
+package com.iflytek.avatar.login.controller;
+
+import com.iflytek.avatar.boot.entity.response.Result;
+import com.iflytek.avatar.login.api.LoginFeignClient;
+import com.iflytek.avatar.login.dto.request.LoginRequest;
+import com.iflytek.avatar.login.dto.request.RefreshTokenRequest;
+import com.iflytek.avatar.login.dto.response.LoginResponse;
+import com.iflytek.avatar.login.dto.response.TokenInfoResponse;
+import com.iflytek.avatar.login.service.LoginService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+/**
+ * 登录 REST 控制器，实现 {@link LoginFeignClient} 契约。
+ * 对外暴露的路径与 Feign 客户端一致（/api/login），供其他服务通过 Feign 调用。
+ */
+@RestController
+@RequestMapping("/api/login")
+@RequiredArgsConstructor
+public class LoginController implements LoginFeignClient {
+
+    private final LoginService loginService;
+
+    @Override
+    public Result<LoginResponse> login(@Valid LoginRequest request) {
+        LoginResponse response = loginService.login(request);
+        return Result.success(response);
+    }
+
+    @Override
+    public Result<TokenInfoResponse> refreshToken(@Valid RefreshTokenRequest request) {
+        TokenInfoResponse response = loginService.refreshToken(request);
+        return Result.success(response);
+    }
+}

package/templates/avatar-scaffold-service/src/main/java/com/iflytek/avatar/login/converter/LoginConverter.java

@@ -0,0 +1,54 @@
+package com.iflytek.avatar.login.converter;
+
+import com.iflytek.avatar.login.dto.response.LoginResponse;
+import com.iflytek.avatar.login.dto.response.TokenInfoResponse;
+import com.iflytek.avatar.login.repository.entity.UserTokenEntity;
+
+import java.time.LocalDateTime;
+import java.time.ZoneId;
+
+/**
+ * 登录模块对象转换器（Entity <-> DTO）
+ */
+public final class LoginConverter {
+
+    private LoginConverter() {}
+
+    /**
+     * UserTokenEntity -> LoginResponse
+     */
+    public static LoginResponse toLoginResponse(UserTokenEntity entity, String username) {
+        if (entity == null) {
+            return null;
+        }
+        long expireMs = toEpochMilli(entity.getExpireTime());
+        return LoginResponse.builder()
+                .token(entity.getToken())
+                .refreshToken(entity.getRefreshToken())
+                .userId(entity.getUserId())
+                .username(username)
+                .expireTime(expireMs)
+                .build();
+    }
+
+    /**
+     * UserTokenEntity -> TokenInfoResponse
+     */
+    public static TokenInfoResponse toTokenInfoResponse(UserTokenEntity entity) {
+        if (entity == null) {
+            return null;
+        }
+        return TokenInfoResponse.builder()
+                .token(entity.getToken())
+                .refreshToken(entity.getRefreshToken())
+                .expireTime(toEpochMilli(entity.getExpireTime()))
+                .build();
+    }
+
+    private static long toEpochMilli(LocalDateTime dateTime) {
+        if (dateTime == null) {
+            return 0L;
+        }
+        return dateTime.atZone(ZoneId.systemDefault()).toInstant().toEpochMilli();
+    }
+}

package/templates/avatar-scaffold-service/src/main/java/com/iflytek/avatar/login/feign/DemoFeign.java

@@ -0,0 +1,21 @@
+package com.iflytek.avatar.login.feign;
+
+import com.iflytek.avatar.boot.config.FeignLoggingConfiguration;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+
+import java.util.Map;
+
+@FeignClient(name = "demo", url = "http://127.0.0.1:8888", configuration = FeignLoggingConfiguration.class)
+public interface DemoFeign {
+
+    @GetMapping("/demo")
+    String demo(@RequestParam String name);
+
+
+    @PostMapping("/demo")
+    String demo2(@RequestBody Map<String, String> map);
+}

package/templates/avatar-scaffold-service/src/main/java/com/iflytek/avatar/login/repository/entity/UserLoginEntity.java

@@ -0,0 +1,33 @@
+package com.iflytek.avatar.login.repository.entity;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+/**
+ * 用户登录表实体（对应 user_login 表）
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class UserLoginEntity {
+
+    /** 主键 */
+    private Long id;
+
+    /** 用户 ID */
+    private Long userId;
+
+    /** 用户名 */
+    private String username;
+
+    /** 登录时间 */
+    private LocalDateTime loginTime;
+
+    /** 登录 IP（可选） */
+    private String loginIp;
+}

package/templates/avatar-scaffold-service/src/main/java/com/iflytek/avatar/login/repository/entity/UserTokenEntity.java

@@ -0,0 +1,39 @@
+package com.iflytek.avatar.login.repository.entity;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+/**
+ * 用户 Token 表实体（对应 user_token 表）
+ */
+@Data
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class UserTokenEntity {
+
+    /** 主键 */
+    private Long id;
+
+    /** 用户 ID */
+    private Long userId;
+
+    /** 访问令牌 */
+    private String token;
+
+    /** 刷新令牌 */
+    private String refreshToken;
+
+    /** 过期时间 */
+    private LocalDateTime expireTime;
+
+    /** 创建时间 */
+    private LocalDateTime createTime;
+
+    /** 更新时间 */
+    private LocalDateTime updateTime;
+}

package/templates/avatar-scaffold-service/src/main/java/com/iflytek/avatar/login/repository/mapper/UserLoginMapper.java

@@ -0,0 +1,20 @@
+package com.iflytek.avatar.login.repository.mapper;
+
+import com.iflytek.avatar.login.repository.entity.UserLoginEntity;
+
+/**
+ * 用户登录 Mapper（MyBatis）
+ * 启用 avatar-boot-starter-mysql 后添加 @Mapper 并编写 XML/注解 SQL；当前为 Demo 接口定义。
+ */
+public interface UserLoginMapper {
+
+    /**
+     * 插入登录记录
+     */
+    int insert(UserLoginEntity entity);
+
+    /**
+     * 按用户 ID 查询最近一次登录记录
+     */
+    UserLoginEntity selectLatestByUserId(Long userId);
+}

package/templates/avatar-scaffold-service/src/main/java/com/iflytek/avatar/login/service/LoginService.java

@@ -0,0 +1,22 @@
+package com.iflytek.avatar.login.service;
+
+import com.iflytek.avatar.login.dto.request.LoginRequest;
+import com.iflytek.avatar.login.dto.request.RefreshTokenRequest;
+import com.iflytek.avatar.login.dto.response.LoginResponse;
+import com.iflytek.avatar.login.dto.response.TokenInfoResponse;
+
+/**
+ * 登录业务接口
+ */
+public interface LoginService {
+
+    /**
+     * 用户登录
+     */
+    LoginResponse login(LoginRequest request);
+
+    /**
+     * 刷新 Token
+     */
+    TokenInfoResponse refreshToken(RefreshTokenRequest request);
+}

package/templates/avatar-scaffold-service/src/main/java/com/iflytek/avatar/login/service/impl/LoginServiceImpl.java

@@ -0,0 +1,43 @@
+package com.iflytek.avatar.login.service.impl;
+
+import com.iflytek.avatar.login.dto.request.LoginRequest;
+import com.iflytek.avatar.login.dto.request.RefreshTokenRequest;
+import com.iflytek.avatar.login.dto.response.LoginResponse;
+import com.iflytek.avatar.login.dto.response.TokenInfoResponse;
+import com.iflytek.avatar.login.service.LoginService;
+import org.springframework.stereotype.Service;
+
+import java.util.concurrent.atomic.AtomicLong;
+
+/**
+ * 登录业务实现（Demo：返回模拟数据）
+ */
+@Service
+public class LoginServiceImpl implements LoginService {
+
+    private static final long TOKEN_EXPIRE_MS = 7200_000L;
+    private static final AtomicLong USER_ID_SEQ = new AtomicLong(1);
+
+    @Override
+    public LoginResponse login(LoginRequest request) {
+        long userId = USER_ID_SEQ.getAndIncrement();
+        long expireTime = System.currentTimeMillis() + TOKEN_EXPIRE_MS;
+        return LoginResponse.builder()
+                .token("demo-token-" + userId)
+                .refreshToken("demo-refresh-" + userId)
+                .userId(userId)
+                .username(request.getUsername())
+                .expireTime(expireTime)
+                .build();
+    }
+
+    @Override
+    public TokenInfoResponse refreshToken(RefreshTokenRequest request) {
+        long expireTime = System.currentTimeMillis() + TOKEN_EXPIRE_MS;
+        return TokenInfoResponse.builder()
+                .token("demo-token-refreshed")
+                .refreshToken(request.getRefreshToken())
+                .expireTime(expireTime)
+                .build();
+    }
+}

package/templates/avatar-scaffold-service/src/main/java/com/iflytek/avatar/login/utils/LoginUtils.java

@@ -0,0 +1,31 @@
+package com.iflytek.avatar.login.utils;
+
+import java.security.SecureRandom;
+import java.util.Base64;
+
+/**
+ * 登录模块工具类
+ */
+public final class LoginUtils {
+
+    private static final SecureRandom RANDOM = new SecureRandom();
+    private static final int TOKEN_BYTES = 24;
+
+    private LoginUtils() {}
+
+    /**
+     * 生成随机 Token 字符串（Demo 用，生产环境建议使用 JWT 等）
+     */
+    public static String generateToken() {
+        byte[] bytes = new byte[TOKEN_BYTES];
+        RANDOM.nextBytes(bytes);
+        return Base64.getUrlEncoder().withoutPadding().encodeToString(bytes);
+    }
+
+    /**
+     * 生成带前缀的 token，便于区分类型
+     */
+    public static String generateTokenWithPrefix(String prefix) {
+        return prefix + generateToken();
+    }
+}

package/templates/avatar-scaffold-service/src/main/resources/application-dev.yaml

@@ -0,0 +1,29 @@
+spring:
+  config:
+    import:
+      # 使用 optional: 前缀，Nacos 不可用时不会阻止启动
+      - optional:nacos:${spring.application.name}.yaml?group=${NACOS_GROUP:AVATAR_PLATFORM}&refreshEnabled=true
+      - optional:nacos:common-database.yaml?group=SHARED_GROUP&refreshEnabled=true
+      - optional:nacos:common-redis.yaml?group=SHARED_GROUP&refreshEnabled=true
+
+  # nacos 配置
+  cloud:
+    nacos:
+      server-addr: ${NACOS_SERVER_ADDR:172.29.242.247:8848}
+      namespace: ${NACOS_NAMESPACE:dev}
+      username: ${NACOS_USERNAME:nacos}
+      password: ${NACOS_PASSWORD:Xnrpt@2026}
+
+      config:
+        enabled: true
+        file-extension: yaml
+        group: ${NACOS_GROUP:AVATAR_PLATFORM}
+
+      discovery:
+        enabled: true
+        register-enabled: true
+        ephemeral: true
+        group: ${NACOS_GROUP:AVATAR_PLATFORM}
+        metadata:
+          version: 1.0.0
+          environment: dev

package/templates/avatar-scaffold-service/src/main/resources/application-local.yaml

@@ -0,0 +1,61 @@
+# 本地开发配置（Nacos 不可用时使用）
+# 使用方式: --spring.profiles.active=local
+
+spring:
+  # 禁用 Nacos 配置导入
+  cloud:
+    nacos:
+      # 完全禁用 Nacos
+      config:
+        enabled: false
+      discovery:
+        enabled: false
+
+  # ============================================
+  # 本地数据库配置
+  # ============================================
+  datasource:
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    url: jdbc:mysql://localhost:3306/avatar_scaffold?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true
+    username: ${DB_USERNAME:root}
+    password: ${DB_PASSWORD:root}
+    type: com.zaxxer.hikari.HikariDataSource
+    hikari:
+      minimum-idle: 5
+      maximum-pool-size: 20
+      connection-timeout: 30000
+      idle-timeout: 600000
+      max-lifetime: 1800000
+
+  # ============================================
+  # 本地 Redis 配置
+  # ============================================
+  data:
+    redis:
+      host: ${REDIS_HOST:localhost}
+      port: ${REDIS_PORT:6379}
+      password: ${REDIS_PASSWORD:}
+      database: 0
+      timeout: 3000ms
+      lettuce:
+        pool:
+          max-active: 8
+          max-idle: 8
+          min-idle: 0
+          max-wait: -1ms
+
+# MyBatis Plus 配置
+mybatis-plus:
+  mapper-locations: classpath*:/mapper/**/*.xml
+  type-aliases-package: com.iflytek.avatar.scaffold.**.dao.beans
+  configuration:
+    map-underscore-to-camel-case: true
+    cache-enabled: false
+    log-impl: org.apache.ibatis.logging.slf4j.Slf4jImpl
+
+# 日志配置
+logging:
+  level:
+    com.iflytek.avatar: DEBUG
+    com.alibaba.nacos: ERROR
+    com.alibaba.cloud.nacos: ERROR

package/templates/avatar-scaffold-service/src/main/resources/application-prod.yaml

@@ -0,0 +1,28 @@
+spring:
+  config:
+    import:
+      - optional:nacos:${spring.application.name}.yaml?group=${NACOS_GROUP:AVATAR_PLATFORM}&refreshEnabled=true
+      - optional:nacos:common-database.yaml?group=SHARED_GROUP&refreshEnabled=true
+      - optional:nacos:common-redis.yaml?group=SHARED_GROUP&refreshEnabled=true
+
+  # nacos 配置
+  cloud:
+    nacos:
+      server-addr: ${NACOS_SERVER_ADDR:172.29.242.247:8848}
+      namespace: ${NACOS_NAMESPACE:prod}
+      username: ${NACOS_USERNAME:nacos}
+      password: ${NACOS_PASSWORD:nacos}
+
+      config:
+        enabled: true
+        file-extension: yaml
+        group: ${NACOS_GROUP:AVATAR_PLATFORM}
+
+      discovery:
+        enabled: true
+        register-enabled: true
+        ephemeral: true
+        group: ${NACOS_GROUP:AVATAR_PLATFORM}
+        metadata:
+          version: 1.0.0
+          environment: prod

package/templates/avatar-scaffold-service/src/main/resources/application-test.yaml

@@ -0,0 +1,28 @@
+spring:
+  config:
+    import:
+      - optional:nacos:${spring.application.name}.yaml?group=${NACOS_GROUP:AVATAR_PLATFORM}&refreshEnabled=true
+      - optional:nacos:common-database.yaml?group=SHARED_GROUP&refreshEnabled=true
+      - optional:nacos:common-redis.yaml?group=SHARED_GROUP&refreshEnabled=true
+
+  # nacos 配置
+  cloud:
+    nacos:
+      server-addr: ${NACOS_SERVER_ADDR:172.29.242.247:8848}
+      namespace: ${NACOS_NAMESPACE:test}
+      username: ${NACOS_USERNAME:nacos}
+      password: ${NACOS_PASSWORD:nacos}
+
+      config:
+        enabled: true
+        file-extension: yaml
+        group: ${NACOS_GROUP:AVATAR_PLATFORM}
+
+      discovery:
+        enabled: true
+        register-enabled: true
+        ephemeral: true
+        group: ${NACOS_GROUP:AVATAR_PLATFORM}
+        metadata:
+          version: 1.0.0
+          environment: test

package/templates/avatar-scaffold-service/src/main/resources/application.yaml

@@ -0,0 +1,12 @@
+spring:
+  application:
+    name: scaffold-template
+
+server:
+  port: 8888
+
+# 禁用 Nacos 客户端的文件日志输出
+logging:
+  level:
+    com.alibaba.nacos: ERROR
+    com.alibaba.cloud.nacos: ERROR