guanwang/README.md

慧愈科技官网一期

单体 Nuxt 4 全栈应用：公开官网、结构化内容管理后台、SQLite、服务器本地图片存储。

一期功能范围

• 一屏一屏滚动展示的品牌首页，含公司、卢慧老师、课程产品、官方信息、团队与品牌动态。
• 卢慧老师、课程列表与详情、动态列表与详情、官方声明、陪伴团队、隐私政策和服务条款独立页面。
• 后台首页编辑、课程产品/动态声明/团队增删改查、公司主体/人物资料/官方渠道/法律文本配置。
• 素材中心支持图片像素校验、原图保留、WebP/缩略图生成、来源与授权记录、引用保护和回收站恢复。
• 草稿与发布版本分离、发布版本记录、审计日志、管理员登录与上传图片校验。
• 最近 20 个发布版本可恢复为草稿，管理员可在后台修改高强度密码。
• sitemap.xml、robots.txt、canonical、Open Graph 和首页组织机构 JSON-LD。

本机直接运行

npm install --legacy-peer-deps
npm run dev

后台入口：/admin/login。开发环境初始账号为 admin，初始密码为 DevOnly-ChangeMe-2026!。

Docker 测试环境

项目已附带仅供本机测试的 .env.docker。启动：

docker compose up -d --build
docker compose ps

本机测试后台账号为 admin，密码为 LocalTest-Huiyu-2026!。正式部署前必须替换 .env.docker 中的两个密码；该文件已被 Git 忽略。

docker compose logs -f web
docker compose down

数据库和上传图片保存在 Docker 命名卷 huiyu_official_site_data，重建容器不会丢失。不要使用 docker compose down -v，除非明确需要删除全部业务数据。

备份

容器运行时执行：

sh scripts/backup.sh

脚本使用 SQLite 在线备份 API，同时打包上传素材，加密后写入宿主机 BACKUP_HOST_DIR，并立即执行完整性校验。详细操作见 部署与恢复手册。

上线前最低检查

• 修改会话密钥和后台初始密码。
• 配置域名、HTTPS 和反向代理。
• 反向代理的请求体上限至少设置为 20m，否则高清图片会在到达应用前被代理拒绝。
• 域名启用 HTTPS 后，把 NUXT_SESSION_COOKIE_SECURE 改为 true。
• 配置每日备份及恢复演练。
• 将 .env.docker 仅保存在服务器，不提交版本库。
• 验证后台发布、图片上传、首页移动端和桌面端展示。
• 在部署环境设置 NUXT_PUBLIC_SITE_URL=https://正式域名，用于 canonical、站点地图和 robots。

当前演示内容说明

数据库首次启动会写入清楚标注的演示课程、动态、声明和团队内容。正式上线前，请在后台逐项替换并由相关负责人核验；公司主体、联系方式、备案号和官方账号默认显示“待后台配置”。

需要重新写入完整演示数据时，在 Docker 测试环境启动后执行：

ADMIN_PASSWORD='本地后台密码' node scripts/seed-mock-content.mjs

脚本会通过后台 API 保存草稿并立即发布新版本。数据源在 content/演示数据/一期官网演示数据.json，人物资料依据已清洗的百度百科内容整理，其余公司、课程、团队、账号和联系信息均明确属于演示数据。