# 共性能力平台 · 测试环境数据导入说明

只需要 2 个 SQL 文件即可完成共性能力模块的部署。

---

## 文件清单

| # | 文件路径 | 作用 | 大小（约） |
|---|---|---|---|
| 1 | `txw-mhzc/sql/txw_mhzc_gxnl_slxxb_gxscb.sql` | 建表 DDL（2 张表） | ~3KB |
| 2 | `txw-mhzc/sql/gxnl_wzxx_import_from_excel.sql` | 200 条共性能力数据导入 | ~25KB |

> ⚠️ **不需要** `fix_gxnl_slxxb_comments.sql` —— 该文件是早期排查 PowerShell 显示"乱码"时临时生成（实际是 PowerShell UTF-8 显示问题，数据库存储完全正常）。建表 DDL 已经用 `utf8mb4` + 中文 COMMENT，无需再修复。

---

## 导入步骤

### 1. 连接测试环境 MySQL

```bash
# 假设测试库 = txw_mhzc
mysql -h <host> -P 3306 -u root -p txw_mhzc
```

### 2. 执行 DDL 建表

```bash
mysql --default-character-set=utf8mb4 -h <host> -P 3306 -u root -p txw_mhzc \
  < txw-mhzc/sql/txw_mhzc_gxnl_slxxb_gxscb.sql
```

会创建 2 张表：
- `txw_mhzc_gxnl_slxxb` — 共性能力收录信息表（30+ 字段）
- `txw_mhzc_gxnl_gxscb` — 共性能力收藏表（6 字段）

### 3. 导入 200 条数据

```bash
mysql --default-character-set=utf8mb4 -h <host> -P 3306 -u root -p txw_mhzc \
  < txw-mhzc/sql/gxnl_wzxx_import_from_excel.sql
```

---

## 验证

```sql
-- 1. 数据量
SELECT COUNT(*) FROM txw_mhzc_gxnl_slxxb;       -- 期望 200
SELECT COUNT(*) FROM txw_mhzc_gxnl_gxscb;       -- 期望 0（收藏表由用户行为产生）

-- 2. 各分类数量
SELECT gxnl_fl_mc, COUNT(*) AS cnt
FROM txw_mhzc_gxnl_slxxb
GROUP BY gxnl_fl_mc
ORDER BY cnt DESC;

-- 3. 全部已上架可访问
SELECT COUNT(*) FROM txw_mhzc_gxnl_slxxb
WHERE sjzt='Y' AND zt='2' AND yxbz='Y';          -- 期望 200
```

---

## 数据字段说明

`txw_mhzc_gxnl_slxxb` 关键字段（导入时已设置）：

| 字段 | 含义 | 导入值 |
|---|---|---|
| `wz_uuid` | 唯一 UUID | 32 位 hex |
| `bt` | 网站名称 | 来自 Excel |
| `wz_lj` | 链接 URL | 来自 Excel（http/https） |
| `jj` | 简介（子类型） | 产品碳足迹/企业碳管理平台/CBAM/国家部委 等 |
| `gxnl_fl_dm` / `gxnl_fl_mc` | 分类代码 / 名称 | 01 碳核算平台 / 02 碳认证机构 / 03 碳交易平台 / 04 碳金融服务 / 05 碳技术咨询 |
| `bqjh` | 标签合集 | 英文逗号分隔 |
| `zt` | 业务状态 | `2` = 审核通过 |
| `sjzt` | 上架状态 | `Y` |
| `lyqd_dm` | 来源渠道 | `import` |
| `pxh` | 排序号 | 999 ~ 800（倒序，越大越靠前） |
| `yxbz` | 有效标志 | `Y` |

---

## 注意事项

1. **字符集**：执行 SQL 时务必加 `--default-character-set=utf8mb4`，避免历史乱码问题。
2. **重复导入**：所有 `wz_uuid` 是固定 UUID，重复导入会因主键冲突报错（`INSERT` 而非 `REPLACE`），符合预期；如需重导先 `TRUNCATE` 再导入。
3. **分类代码**：固定 5 个 (`01`~`05`)，与前端 `CATEGORY_META` 严格对应。
4. **收藏表** `txw_mhzc_gxnl_gxscb` 不需要预置数据，由用户登录后的收藏行为产生。