# Nacos 配置说明（erp-api）

与 Yunxi 工程（如 `yundt-boot-center-maindata-aggboot`）对齐：**命名空间 `hbxhzt-test`**、共享 **`yundt-cube-common.yaml`**、**服务注册名 `erp-api`**（供 maindata Feign 调用）。

## 本地 / 默认启动（当前仓库约定）

**`bootstrap.yml` 中已将 Nacos Config 与 Discovery 固定为 `enabled: false`**，不连 Nacos，仅使用 **`application.yml`**（及 classpath 下其它本地配置）。

注意：若进程环境中存在 **`SPRING_CLOUD_NACOS_CONFIG_ENABLED=true`** 或 **`SPRING_CLOUD_NACOS_DISCOVERY_ENABLED=true`**（Spring 标准绑定），会**覆盖** yml 仍为开启；本地纯配置时请删除上述变量或设为 `false`。旧版脚本若曾使用 `NACOS_CONFIG_ENABLED`，请改为不再导出或对齐 Spring 变量名。

## UAT / K8s 启用 Nacos

在启动命令中**显式打开**（覆盖 bootstrap 中的 false），例如：

```text
--spring.cloud.nacos.config.enabled=true
--spring.cloud.nacos.discovery.enabled=true
```

并设置：

| 变量 / 配置 | 说明 |
|-------------|------|
| `NACOS_SERVER_ADDR` | 如 `nacos-headless.hbxhzt-test.svc:8848` |
| `NACOS_NAMESPACE` | 与控制台一致，默认 `hbxhzt-test` |
| `NACOS_CONFIG_FAIL_FAST` | UAT 建议 `true` |
| `NACOS_USERNAME` / `NACOS_PASSWORD` | Nacos 开启鉴权时 |

可选：`NACOS_REGISTER_ENABLED=false` 仅拉配置不注册。

## 上传 `erp-api.yaml`

1. Nacos 控制台 → **hbxhzt-test** 命名空间 → **配置管理**。
2. 新建：
   - **Data ID**：`erp-api.yaml`
   - **Group**：`DEFAULT_GROUP`
   - **格式**：YAML  
   - **内容**：复制本目录 **`erp-api.yaml`**，按环境改库、Redis、`external.auth`（须与 maindata `ErpOpenProperties` 一致）。
3. 同一命名空间下需已存在 **`yundt-cube-common.yaml`**（与兄弟工程共用）。

## maindata 调用说明

- **注册服务名**：`erp-api`（即 `spring.application.name`）。
- **端口**：`38083`（在 `erp-api.yaml` 的 `server.port` 中配置）。
- **HTTP 路径**：例如 `/external/goods/upsert`；若经网关，按网关路由配置。
- **鉴权**：`/external/**` 仍为 AK/SK 签名，与 `external.auth` 及 maindata 侧密钥一致。
