# 本机数据库统一规则

> **强制**：本机（卡若工作机）上所有项目的数据库**统一使用同一套数据库实例**，不新增新的数据库实例或服务。  
> 维护：金仓；新项目接入数据库时须遵守本规则。

---

## 一、规则要点

| 规则 | 说明 |
|:---|:---|
| **一个 MongoDB 实例** | 本机开发/本地环境只使用**一个** MongoDB 实例（默认 `localhost:27017`），所有本地项目共用该实例。 |
| **不新增实例** | 不得为本机再起新的 MongoDB 进程、Docker 容器或远程库「仅给本机用」的独立实例；新项目只在该实例下建**库名**即可。 |
| **按项目分库** | 同一实例下，不同项目使用**不同库名**（如 玩值电竞 → `wanzhi_esports`），通过库名隔离，不混用。 |
| **连接串统一** | 本机 MongoDB 连接串以《00_账号与API索引》**二、数据库 · 本机 MongoDB（统一）** 为准；各项目通过环境变量 `MONGODB_URI` 指向该连接串，库名在代码或 URI 中指定。 |

---

## 二、本机统一 MongoDB 配置

- **连接串（无认证）**：`mongodb://localhost:27017`
- **连接串（有认证）**：见《00_账号与API索引》二、数据库 · 本机 MongoDB（统一）表中填写的主机、账号、密码，格式：`mongodb://用户名:密码@localhost:27017/库名?authSource=admin`
- **使用方式**：各项目在 `.env.local` 或环境变量中设置 `MONGODB_URI` 为上述连接串（不含库名时，代码内指定库名）；**不要**为本机单独再起一个 MongoDB（如 Docker 再开一个 27018 仅给某项目用），避免多实例分散。

---

## 三、已接入项目（本机统一实例下的库名）

### MongoDB（datacenter_mongodb，端口 27017）

| 项目 | 库名 | 说明 |
|:---|:---|:---|
| 玩值电竞App | `wanzhi_esports` | 玩值电竞业务库，集合与索引见《玩值电竞_数据库设计》；连接串用本机统一 MongoDB。 |
| 卡若ai网站 | `karuo_site` | 官网与控制台全量数据（技能、网关、工作流、任务、用户、frontend_config/backend_config 等）；连接串用本机统一 MongoDB。 |

### MySQL（datacenter_mysql，端口 3307，归入 datacenter 编排）

| 项目 | 库名 | 说明 |
|:---|:---|:---|
| 存客宝 | `cunkebao` | 存客宝业务库；数据目录宿主机 `/Users/karuo/数据库/mysql/cunkebao`；存客宝 Docker 编排通过 `datacenter_network` 连接 `datacenter_mysql`，见存客宝项目 `开发文档/8、部署/存客宝数据库位置与连接说明.md`。 |

后续新项目需要 MongoDB 时，在本表增加一行「项目名、库名、说明」；需要 MySQL 时归入 datacenter 编排并在此登记。

---

## 四、本机 MySQL（datacenter）

- **存客宝**：本机 MySQL 统一使用 **datacenter** 分组内的 **datacenter_mysql**（宿主机端口 3307），数据目录 `/Users/karuo/数据库/mysql/cunkebao`。存客宝编排内**不再自建 mysql**，后端通过 `datacenter_network` 连接 `datacenter_mysql`。首次使用前需先启动 datacenter（`docker compose -p datacenter up -d`），若从旧 cunkebao-mysql 迁移数据见存客宝项目《存客宝数据库位置与连接说明》中的迁移步骤。

## 五、例外说明

- **玩值电竞App Docker**：编排中**已不再包含** wanzhi-mongodb 容器；Docker 只跑 Web，通过 `host.docker.internal:27017` 使用本机统一 MongoDB。若曾存在旧容器 wanzhi-mongodb（端口 27018），迁移数据后删除即可，见玩值电竞App 项目内 `docker/README.md` 第三节。
- **生产/测试服**：生产或测试环境使用各自服务器上的数据库，不受「本机一个实例」限制；本规则仅约束**本机**。

---

## 六、版本记录

| 日期 | 变更 |
|:---|:---|
| 2026-02-26 | 初版；本机统一一个 MongoDB 实例；玩值电竞使用库名 wanzhi_esports |
| 2026-02-28 | 新增本机 MySQL：存客宝归入 datacenter_mysql（3307），数据目录 数据库/mysql/cunkebao |
| 2026-03-01 | 卡若ai网站接入唯一 MongoDB，库名 karuo_site；新生成数据一律只放唯一 MongoDB |