73 lines
3.2 KiB
Markdown
73 lines
3.2 KiB
Markdown
# 慧愈科技官网一期
|
||
|
||
单体 Nuxt 4 全栈应用：公开官网、结构化内容管理后台、SQLite、服务器本地图片存储。
|
||
|
||
## 一期功能范围
|
||
|
||
- 一屏一屏滚动展示的品牌首页，含公司、卢慧老师、课程产品、官方信息、团队与品牌动态。
|
||
- 卢慧老师、课程列表与详情、动态列表与详情、官方声明、陪伴团队、隐私政策和服务条款独立页面。
|
||
- 后台首页编辑、课程产品/动态声明/团队增删改查、公司主体/人物资料/官方渠道/法律文本配置。
|
||
- 素材中心支持图片像素校验、原图保留、WebP/缩略图生成、来源与授权记录、引用保护和回收站恢复。
|
||
- 草稿与发布版本分离、发布版本记录、审计日志、管理员登录与上传图片校验。
|
||
- 最近 20 个发布版本可恢复为草稿，管理员可在后台修改高强度密码。
|
||
- `sitemap.xml`、`robots.txt`、canonical、Open Graph 和首页组织机构 JSON-LD。
|
||
|
||
## 本机直接运行
|
||
|
||
```bash
|
||
npm install --legacy-peer-deps
|
||
npm run dev
|
||
```
|
||
|
||
后台入口：`/admin/login`。开发环境初始账号为 `admin`，初始密码为 `DevOnly-ChangeMe-2026!`。
|
||
|
||
## Docker 测试环境
|
||
|
||
项目已附带仅供本机测试的 `.env.docker`。启动：
|
||
|
||
```bash
|
||
docker compose up -d --build
|
||
docker compose ps
|
||
```
|
||
|
||
本机测试后台账号为 `admin`，密码为 `LocalTest-Huiyu-2026!`。正式部署前必须替换 `.env.docker` 中的两个密码；该文件已被 Git 忽略。
|
||
|
||
```bash
|
||
docker compose logs -f web
|
||
docker compose down
|
||
```
|
||
|
||
数据库和上传图片保存在 Docker 命名卷 `huiyu_official_site_data`，重建容器不会丢失。不要使用 `docker compose down -v`，除非明确需要删除全部业务数据。
|
||
|
||
## 备份
|
||
|
||
容器运行时执行：
|
||
|
||
```bash
|
||
sh scripts/backup.sh
|
||
```
|
||
|
||
脚本使用 SQLite 在线备份 API，同时打包上传素材，加密后写入宿主机 `BACKUP_HOST_DIR`，并立即执行完整性校验。详细操作见 [部署与恢复手册](docs/部署与恢复手册.md)。
|
||
|
||
## 上线前最低检查
|
||
|
||
- 修改会话密钥和后台初始密码。
|
||
- 配置域名、HTTPS 和反向代理。
|
||
- 域名启用 HTTPS 后，把 `NUXT_SESSION_COOKIE_SECURE` 改为 `true`。
|
||
- 配置每日备份及恢复演练。
|
||
- 将 `.env.docker` 仅保存在服务器，不提交版本库。
|
||
- 验证后台发布、图片上传、首页移动端和桌面端展示。
|
||
- 在部署环境设置 `NUXT_PUBLIC_SITE_URL=https://正式域名`，用于 canonical、站点地图和 robots。
|
||
|
||
## 当前演示内容说明
|
||
|
||
数据库首次启动会写入清楚标注的演示课程、动态、声明和团队内容。正式上线前，请在后台逐项替换并由相关负责人核验；公司主体、联系方式、备案号和官方账号默认显示“待后台配置”。
|
||
|
||
需要重新写入完整演示数据时，在 Docker 测试环境启动后执行：
|
||
|
||
```bash
|
||
ADMIN_PASSWORD='本地后台密码' node scripts/seed-mock-content.mjs
|
||
```
|
||
|
||
脚本会通过后台 API 保存草稿并立即发布新版本。数据源在 `content/演示数据/一期官网演示数据.json`，人物资料依据已清洗的百度百科内容整理，其余公司、课程、团队、账号和联系信息均明确属于演示数据。
|