refactor(ssw): 集中 MapperConfig 到 ssw-common 共享 (BS-14 v2)

背景: 2026-06-23 jxcj E2E BS-14 闭环后, 每个 ssw-{app_code} 都要自己写 MapperConfig
       仍重复且易遗漏。集中到 ssw-common 后, 业务包零配置。

修改:
- 新增 boot/ssw-common/ssw-common-biz/.../config/SswMapperConfig.java
  * @Configuration @MapperScan(basePackages = "ssw.**.mapper")
  * 一处配置覆盖所有 ssw-{app_code}/ssw-{app_code}.mapper

- 删除 boot/ssw-jxcj/.../config/JxcjMapperConfig.java
  * jxcj 不再自己写 MapperConfig

- 修改 boot/ssw-jxcj/ssw-jxcj-biz/pom.xml
  * 加 ssw-common-biz 依赖 (传递包含 SswMapperConfig)

配套已更新:
- .claude/skills/{no-spa-page,backend-dev,ssw-pack-init} 文档统一指向 ssw-common
- .claude/skills/ssw-pack-init/scripts/check_ssw_pack.py BS-14 检测改成共享版
- dacli/src/commands/_blindspot_guards.ts BS-14 guard 同改

验证:
- python3 .claude/skills/ssw-pack-init/scripts/check_ssw_pack.py jxcj
  ✓ BS-14: 共享 SswMapperConfig @MapperScan('ssw.**.mapper') + 业务包依赖 ssw-common-biz

Co-Authored-By: Claude <[email protected]>
This commit is contained in:
sswandClaude committed 2026-06-23 18:24:26 +08:00
1 parent b55fd281da
commit e9170e4b16
3 files changed
+27 -13

No files matched your search

@@ -0,0 +1,26 @@
package ssw.common.config;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Configuration;
/**
* ssw 共享 MapperConfig — 所有 ssw.*.mapper 由这一个配置统一注册
*
* ⚠️ 根因: JNPF MybatisPlusConfig @MapperScan 只扫 "jnpf.*.mapper" / "jnpf.mapper" / "com.xxl.job.admin.dao",
* 不扫 ssw.**.mapper, 导致所有 ssw-{app_code} 的 Mapper 接口无法被 Spring 注册为 bean.
* ⚠️ 现象: java.lang.NoSuchBeanDefinitionException: No qualifying bean of type 'ssw.{app_code}.mapper.XxxMapper'
*
* ✅ 单一解决方案: 本文件统一处理 ssw.**.mapper (覆盖所有 ssw-jxcj/ssw-tds/ssw-tdr/...)
* — 任何新加 ssw-{app_code} 包都无需再单独写 MapperConfig.
*
* 路径: ssw-common/ssw-common-biz/src/main/java/ssw/common/config/SswMapperConfig.java
* 加载: ssw-common-controller 被 jnpf-admin pom 依赖 → ssw-common-biz 传递依赖 → SswMapperConfig 自动注册.
* @SpringBootApplication(scanBasePackages = {"jnpf","ssw"}) 自动扫描 ssw.common.config 包.
*
* 历史: 2026-06-23 之前, 每个 ssw-{app_code} 都要在 ssw-{app_code}-biz 自己写 {AppCode}MapperConfig,
* 重复 + 易遗漏. 2026-06-23 集中到 ssw-common 共享 (BS-14 闭环).
*/
@Configuration
@MapperScan(basePackages = "ssw.**.mapper")
public class SswMapperConfig {
}
+1
View File
@@ -11,6 +11,7 @@
<artifactId>ssw-jxcj-biz</artifactId>
<dependencies>
<dependency><groupId>com.jnpf</groupId><artifactId>ssw-jxcj-entity</artifactId><version>${project.version}</version></dependency>
<dependency><groupId>com.jnpf</groupId><artifactId>ssw-common-biz</artifactId><version>${project.version}</version></dependency>
<dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId></dependency>
<dependency><groupId>org.apache.commons</groupId><artifactId>commons-lang3</artifactId><version>3.12.0</version></dependency>
<dependency><groupId>com.jnpf</groupId><artifactId>jnpf-common-all</artifactId></dependency>
@@ -1,13 +0,0 @@
package ssw.jxcj.config;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Configuration;
/**
* JNPF main @MapperScan only includes "jnpf.*.mapper", so ssw.jxcj mappers
* are not auto-scanned. This config adds the ssw.jxcj.mapper package.
*/
@Configuration
@MapperScan(basePackages = "ssw.jxcj.mapper")
public class JxcjMapperConfig {
}