# NEON ATELIER 部署链接文档

部署服务器：`121.196.35.138`（16G 测试服务器）  
部署日期：2026-11-20  
实现：RuoYi 兼容本地联调服务 + 五个独立 Web 应用 + 统一管理后台

> 本部署是联调/演示环境，不是正式若依生产系统。真实 AI、图生 3D、CAD、CDR/AI/PSD 与若依 Java 接入仍待实施。

## 1. 访问入口

### 前台（`wzsjfz.haoxueonline.cn`）

| 入口 | 地址 | 说明 |
|---|---|---|
| 应用门户 | https://wzsjfz.haoxueonline.cn/ | 五个独立应用与后台入口 |
| 统一登录 | https://wzsjfz.haoxueonline.cn/login/ | 学生/教师登录 |
| D01 设计灵感 | https://wzsjfz.haoxueonline.cn/design/ | 作品、配色、面料、候选与版本 |
| D02 三维成衣 | https://wzsjfz.haoxueonline.cn/garment/ | 2–7 图上传、视角、三维查看、OBJ 包 |
| D03 教学复核 | https://wzsjfz.haoxueonline.cn/review/ | 作业标准、提交、分析、裁定、发布 |
| D04 智能放码 | https://wzsjfz.haoxueonline.cn/grading/ | 锁定继承、指定尺寸、新图、导出 |
| D05 作品展厅 | https://wzsjfz.haoxueonline.cn/gallery/ | 学生/教师登录后的展厅 |
| 访客展厅 | https://wzsjfz.haoxueonline.cn/gallery/?guest=1 | 无需登录，只读、不可下载 |
| 部署链接页 | https://wzsjfz.haoxueonline.cn/links/ | 本页面的网页版 |
| 健康检查 | https://wzsjfz.haoxueonline.cn/healthz | 返回服务时间 |
| 合并原型 | https://wzsjfz.haoxueonline.cn/prototype/index.html | 历史合并工作台，不替代独立验收 |

### 管理后台（`wzsjfzadmin.haoxueonline.cn`）

| 入口 | 地址 | 说明 |
|---|---|---|
| 管理后台 | https://wzsjfzadmin.haoxueonline.cn/ | 根路径跳转 `/admin/` |
| 管理员登录 | https://wzsjfzadmin.haoxueonline.cn/login/?app=admin | 仅平台管理员 |
| 健康检查 | https://wzsjfzadmin.haoxueonline.cn/healthz | 同一后端 |

### 文档

- 在线 PRD：https://wzsjfz.haoxueonline.cn/docs/PRD.md
- 实现说明：https://wzsjfz.haoxueonline.cn/docs/IMPLEMENTATION.md
- 本页 Markdown：https://wzsjfz.haoxueonline.cn/docs/DEPLOYMENT_LINKS.md

## 2. 账号

初始账号由部署脚本生成强随机密码，**不在公开文档中展示**。服务器 root 可读：

```bash
cat /opt/neon-atelier/INITIAL_CREDENTIALS.txt
```

账号名：

| 账号 | 角色 | 可用入口 |
|---|---|---|
| `admin` | 平台管理员 | 统一管理后台 |
| `teacher1` | 教师 | 五个应用（课程范围内） |
| `student1` | 学生 | 设计、三维、复核、放码、展厅 |
| `student2` | 学生 | 同上 |

密码保存在 `/opt/neon-atelier/seed.env`（root 600，systemd EnvironmentFile）与上述只读文件。若要重置演示数据并重新生成账号：停止服务，移动 `data/` 与 `storage/` 为备份，重新生成 seed 环境并启动；不要直接删除正在使用的数据。

## 3. 部署结构

```text
/opt/neon-atelier/
  app/                代码（server/ web/ prototype/ docs/）
  data/               SQLite 数据库与 secret.key（服务用户 neon）
  storage/            上传与演示素材（服务用户 neon）
  node/               Node.js 22.20.0（独立安装，不替换系统 Node）
  seed.env            初始账号环境变量（root 600）
  INITIAL_CREDENTIALS.txt  初始账号（root 600）
/etc/systemd/system/neon-atelier.service
/etc/nginx/sites-available/neon-atelier.conf
/etc/nginx/sites-enabled/neon-atelier.conf -> ../sites-available/neon-atelier.conf
/etc/letsencrypt/live/neon-atelier/fullchain.pem   Let's Encrypt 证书
```

- Node 服务只监听 `127.0.0.1:8787`，由 Nginx 反代；不直接暴露端口。
- 数据独立于代码目录，更新代码不会覆盖 `data/`、`storage/`。
- 现有 `uat.book.haoxueonline.cn`（Docker + 127.0.0.1:3000）及其 Nginx `default` 站点未修改；本次只新增独立 server block 和 systemd 服务。

## 4. 常用运维

```bash
systemctl status neon-atelier
systemctl restart neon-atelier
journalctl -u neon-atelier -n 100 --no-pager
nginx -t
systemctl reload nginx
```

更新代码（保留数据）：

```bash
# 本地打包并上传后，在服务器执行
systemctl stop neon-atelier
tar -xzf /tmp/neon-app.tar.gz -C /opt/neon-atelier/app
chown -R root:root /opt/neon-atelier/app
systemctl start neon-atelier
curl -fsS http://127.0.0.1:8787/healthz
```

证书续期：

```bash
certbot renew --dry-run
certbot renew
systemctl reload nginx
```

## 5. 验证记录（2026-11-20）

- `curl http://127.0.0.1:8787/healthz` 返回 `ok`；systemd `neon-atelier` active。
- 公网 HTTPS：门户、`/links/`、`/design/`、`/garment/`、`/review/`、`/grading/`、`/gallery/` 均返回 `200`；管理后台根路径 `302 → /admin/`，后台与登录页返回 `200`。
- 管理员 API 登录返回 `code=200`，返回 5 个应用（使用服务器 root-only 初始密码验证，未在日志中输出密码）。
- `nginx -t` 通过；`systemctl reload nginx` 为平滑重载。
- 既有 `uat.book.haoxueonline.cn` 与 `127.0.0.1:3000` 仍返回 `200`，Docker 与 `default` 站点未修改。
- Let's Encrypt 证书覆盖两个域名，有效期至 2027-02-17；`certbot renew --dry-run` 成功，`certbot.timer` enabled/active。
- 本地 API 冒烟 27 项、浏览器冒烟 10 步在隔离环境通过；部署后未重复执行会写入数据的完整冒烟，避免污染演示数据。
- 未执行真实若依接入、真实 Provider、CAD/GLB、并发压力与备份恢复演练。

## 6. 边界与安全提醒

1. 当前账号是**本地应用账号**，不是若依 `sys_user`；正式接入后必须替换。
2. 管理后台公开在 `wzsjfzadmin` 域名，仅靠应用登录保护；正式环境建议增加 VPN/IP 白名单/零信任接入。
3. 演示 Provider、固定复核问题与参数放码不能作为真实教学结论或生产版型。
4. 数据在 SQLite；正式系统应迁移到若依现有数据库/对象存储，并配置备份、监控、审计留存。
5. 更新或重置前先备份 `data/` 与 `storage/`；不要把 `seed.env` 或 `data/secret.key` 提交到仓库或公开分享。
