@llryiop/avatar-boot-cli 1.0.0 → 1.0.2

package/templates/.claude/skills/avatar-boot-starter-mysql/references//345/277/253/351/200/237/346/216/245/345/205/245/344/270/216/346/225/260/346/215/256/346/272/220.md

@@ -0,0 +1,91 @@
+# MySQL 快速接入与数据源配置
+
+## 1. 添加依赖
+
+```xml
+<dependency>
+    <groupId>com.iflytek.avatar.boot</groupId>
+    <artifactId>avatar-boot-starter-mysql</artifactId>
+</dependency>
+```
+
+## 2. 启用 MySQL 模块
+
+```java
+@SpringBootApplication
+@EnableMySQL
+public class Application {
+    public static void main(String[] args) {
+        SpringApplication.run(Application.class, args);
+    }
+}
+```
+
+## 3. 配置数据源
+
+```yaml
+spring:
+  datasource:
+    dynamic:
+      primary: master       # 默认数据源
+      strict: false         # false 时找不到指定数据源则使用默认
+      datasource:
+        master:
+          url: jdbc:mysql://localhost:3306/db_main?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
+          username: root
+          password: ${DB_PASSWORD}
+          driver-class-name: com.mysql.cj.jdbc.Driver
+          druid:
+            initial-size: 5
+            min-idle: 5
+            max-active: 20
+            max-wait: 60000
+            validation-query: SELECT 1
+            test-while-idle: true
+            filters: stat,wall
+        slave:
+          url: jdbc:mysql://localhost:3306/db_slave?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
+          username: root
+          password: ${DB_PASSWORD}
+          driver-class-name: com.mysql.cj.jdbc.Driver
+
+mybatis-plus:
+  mapper-scan-package: com.example.**.mapper
+  mapper-locations: classpath*:/mapper/**/*.xml
+  type-aliases-package: com.example.**.entity
+  configuration:
+    map-underscore-to-camel-case: true
+    log-impl: org.apache.ibatis.logging.slf4j.Slf4jImpl
+  global-config:
+    db-config:
+      id-type: ASSIGN_ID        # 雪花算法主键
+      logic-delete-field: deleted
+      logic-delete-value: 1
+      logic-not-delete-value: 0
+```
+
+## 4. 多数据源切换（@DS 注解）
+
+```java
+import com.baomidou.dynamic.datasource.annotation.DS;
+
+@Service
+public class UserService {
+
+    // 使用默认数据源（master）
+    public User getById(Long id) {
+        return userMapper.selectById(id);
+    }
+
+    // 切换到 slave 数据源（读操作推荐走从库）
+    @DS("slave")
+    public List<User> listAll() {
+        return userMapper.selectList(null);
+    }
+}
+
+// 也可以在 Mapper 上使用，该 Mapper 所有方法都走指定数据源
+@DS("slave")
+@Mapper
+public interface ReportMapper extends BaseMapper<Report> { }
+```

package/templates/.claude/skills/avatar-boot-starter-mysql/references//351/253/230/347/272/247/347/211/271/346/200/247/344/270/216/351/205/215/347/275/256.md

@@ -0,0 +1,59 @@
+# MySQL 高级特性与配置
+
+## 慢 SQL 监控
+
+```yaml
+mybatis-plus:
+  slow-sql-threshold: 1000  # 超过 1000ms 的 SQL 记录为慢 SQL
+```
+
+超过阈值的 SQL 会以 WARN 级别输出日志，便于排查性能问题。
+
+## 数据权限控制
+
+```yaml
+mybatis-plus:
+  enable-data-permission: true
+```
+
+```java
+import com.iflytek.avatar.boot.mysql.permission.DataPermission;
+
+@Service
+public class UserService {
+
+    @DataPermission(column = "dept_id", value = "#{deptId}")
+    public List<User> listByDept() {
+        return userMapper.selectList(null);
+    }
+}
+```
+
+## Druid 连接池配置说明
+
+| 配置项 | 说明 | 推荐值 |
+|:--|:--|:--|
+| `initial-size` | 初始化连接数 | `5` |
+| `min-idle` | 最小空闲连接数 | `5` |
+| `max-active` | 最大活跃连接数 | `20`（根据业务量调整） |
+| `max-wait` | 获取连接等待超时（ms） | `60000` |
+| `validation-query` | 检测连接有效性的 SQL | `SELECT 1` |
+| `test-while-idle` | 空闲时检测连接 | `true` |
+| `filters` | 监控统计拦截器 | `stat,wall` |
+
+## MyBatis-Plus 配置说明
+
+| 配置项 | 说明 | 默认值 |
+|:--|:--|:--|
+| `mapper-scan-package` | Mapper 扫描路径 | `com.iflytek.**.mapper` |
+| `mapper-locations` | Mapper XML 位置 | `classpath*:/mapper/**/*.xml` |
+| `global-config.db-config.id-type` | 主键类型 | `ASSIGN_ID`（雪花算法） |
+| `global-config.db-config.logic-delete-field` | 逻辑删除字段名 | `deleted` |
+
+## 注意事项
+
+1. **配置格式**：使用 `spring.datasource.dynamic.*`，不是 `avatar.mysql.*`
+2. **@DS 注解**：来自 `com.baomidou.dynamic.datasource.annotation.DS`
+3. **事务管理**：写操作建议添加 `@Transactional`，事务范围尽可能小
+4. **审计字段**：实体类需继承 `BaseEntity` 才能自动填充 createTime/updateTime
+5. **逻辑删除**：使用 `@TableLogic` 注解标记删除字段，MyBatis-Plus 自动处理