# 培训中心开发维护说明

本文档供站点维护使用, 不作为培训中心首页内容展示。

## 目录结构

```text
培训中心/
├── index.html
├── assets/
│   ├── training-center.css
│   └── ppt/                    # HTML 课件公共运行资源
├── docs/                       # 维护文档
└── projects/
    ├── _template/              # 新增培训项目模板
    └── 5s-5why/
        ├── index.html          # 项目首页
        ├── 课件/
        ├── 教案/
        ├── 案例/
        ├── 海报/
        ├── 考试/
        ├── 素材/
        └── docs/
```

## 新增培训项目

1. 复制 `projects/_template/` 为 `projects/{项目slug}/`。
2. 在项目内维护 `课件/`、`教案/`、`案例/`、`海报/`、`考试/`、`素材/`、`docs/`。
3. 项目素材必须放在本项目 `素材/` 目录内, 不跨项目引用图片。
4. 在 `index.html` 增加项目卡片和项目入口。
5. 部署时上传整个 `培训中心/` 目录; 如果只部署单个项目, 同时上传 `assets/` 和对应 `projects/{项目slug}/`。

## 制作原则

- 学员课件只放学员需要看到的内容: 逻辑、图片、对比、流程和现场动作。
- 讲师提示、逐字稿、控场提醒、提问方式、举例方式放在课件 notes 或讲师教案中。
- 案例页优先按“逻辑 -> 场景图 -> 做/不做对比 -> 引导问题 -> 落地动作”组织。
- 每个案例尽量配现场图和做/不做对比图, 让学员先看到差异, 再听讲师讲原因。
- 每个考试页应包含 10 到 30 道题, 优先使用可自动评分的单选、多选和对错题。
- 考试交互规则: 选择后确认本题作答, 确认后锁定并计分; 答案默认隐藏, 只允许已确认题显示答案。

## 版本维护

- 课件可保留多个版本, 例如 `V1 标准版` 和 `V2 目视化版`。
- 新版本不要覆盖旧版本, 项目首页提供清晰的版本入口。
- 若只调整命名、错别字、链接路径, 可同步修正旧版本; 若调整版式和讲解结构, 新建版本文件。

## 部署方式

- 整站部署: 上传 `培训中心/` 整个目录, 入口为 `index.html`。
- 单项目部署: 上传 `assets/` 和对应 `projects/{slug}/`。
- Nginx 一般不需要特殊规则, 作为静态目录托管即可; 只要服务器能直接访问 `.html`、`.css`、`.js`、图片资源即可。