# 新联会本地启动说明

真实项目根目录固定为：

```bash
cd /Volumes/UFD@Guolin/新联会/xlh-full-project
```

不要从 `/Users/wangguolin/Desktop/新联会` 直接启动旧副本或空目录。

唯一启动方式：

```bash
cp .env.example .env
docker compose up -d --build
```

默认端口：

- 统一入口：http://localhost:8082
- 用户端：http://localhost:8082/
- 管理端：http://localhost:8082/manage/
- 后端接口：http://localhost:8082/api/
- MinIO 控制台：默认不对宿主机暴露，仅 Docker 内部使用

本项目本地正式版只走这一套 Compose 服务。不要单独启动 `xlh-web`、`admin-web` 或后端；不要使用 `3001`、`3002`、`18080`、`18082` 作为项目入口。

当前正式数据库是 Docker Compose 内的 PostgreSQL：

```bash
docker compose exec -T postgres psql -U elianxin -d elianxin_real
```

本机 Homebrew PostgreSQL 里如果存在 `elianxin`、`elianxin_real` 等历史库，只当旧调试/备份数据看待，正式服务不会连接它们。

首次部署或默认管理员已禁用时，用邮箱和本地临时密码创建/重置平台管理员。不要把真实密码写进仓库：

```bash
export XLH_BOOTSTRAP_PLATFORM_ADMIN_EMAIL='你的邮箱'
export XLH_BOOTSTRAP_PLATFORM_ADMIN_PASSWORD='本地输入的强密码'
bash scripts/bootstrap-platform-admin.sh
unset XLH_BOOTSTRAP_PLATFORM_ADMIN_PASSWORD
```

生产部署交接请看：

```bash
docs/PRODUCTION_DEPLOYMENT_RUNBOOK.md
```
