# 启优学企业官网

启优学一对一品牌官网。项目基于 Astro 5 + Node standalone adapter，包含品牌首页、学科辅导详情、教学服务、常见问题、联系页面、学习资讯 CMS、SEO/AI 可发现性、响应式适配、原子构建与 GitLab/Nginx 部署配置。

## 本地运行（Node 20）

```bash
source ~/.nvm/nvm.sh
nvm use 20
npm install
npm run dev
```

- 官网开发地址：`http://localhost:4321/`
- 内容后台：`http://localhost:4321/admin/`

生产构建与本地服务：

```bash
npm run build
npm start
```

生产模式默认监听 `http://127.0.0.1:8793/`。

## 常用命令

```bash
npm run check
npm test
npm run build
npm start
```

## 内容管理

学习资讯使用 Markdown 存储，并由同端口 `/admin/` 后台管理。工作稿位于 `src/content/articles/`，线上稿位于 `src/content/published/`；生产环境通过 `CMS_DATA_DIR` 将内容持久化到仓库外。后台支持草稿、发布、下架、删除、分类管理、Markdown/Word 导入、图片上传、预览、修改密码与 Bearer API。

完整说明见 [CMS_README.md](./CMS_README.md)。

## SEO 与性能

- 页面级标题、描述、关键词、canonical、Open Graph 与 Twitter Card
- EducationalOrganization、WebSite、WebPage、Service、FAQ、Article 和 Breadcrumb 结构化数据
- sitemap、robots.txt、语义化页面、分类分页、`llms.txt` 与 `llms-full.txt`
- Astro 图片优化、响应式图片、移动端适配、减少动态效果偏好
- Astro standalone、原子构建、共享锁与 Nginx 反向代理

## 部署

- Nginx 配置：`deploy/nginx/qiyouxue.conf`
- 生产端口：`8793`
- 站点域名：`qiyouxueedu.com`
- 服务器目录：`/root/qiyouxue/current` 与 `/root/qiyouxue/shared`

生产部署前需在 `/root/qiyouxue/shared/.env` 配置独立的 `CMS_PASSWORD`、`CMS_SECRET`、`CMS_API_KEY`、`CMS_DATA_DIR` 和 `CMS_BUILD_LOCK`。
