# PPT 自动更新模块总览

本目录用于管理服务月报 PPT 的自动更新脚本。当前已完成的是上海市整体服务月报；后续行政区服务月报会作为独立模块建设，避免模板、口径和脚本路径混淆。

## 模块划分

```text
ppt_update/
  README.md                         总入口
  shanghai_city/                    上海市整体服务月报
    README.md                       上海市整体服务月报使用指南
    page_updates/
      P1_update.py
      ...
      P9_update.py
  administrative_district/          行政区服务月报
    README.md
    page_updates/
      P1_update.py
      ...
      P6_update.py
```

## 模板对应关系

| 模块 | 模板 | 状态 |
| --- | --- | --- |
| `shanghai_city` | `ppt_templates/上海市服务月报.pptx` | 已完成 P1-P9 |
| `administrative_district` | `ppt_templates/行政区服务月报.pptx` | 已完成 P1-P7 |

## 上海市整体服务月报

上海市整体服务月报的脚本位于：

```text
ppt_update/shanghai_city/page_updates/
```

单页脚本示例：

```bash
python3 ppt_update/shanghai_city/page_updates/P1_update.py \
  --pptx ppt_templates/上海市服务月报.pptx \
  --output output/上海市服务月报-P1更新.pptx \
  --year 2026 \
  --month 4月 \
  --api-base http://127.0.0.1:8000
```

完整逻辑、页面口径、接口来源和验证方式见：

```text
ppt_update/shanghai_city/README.md
```

## 行政区服务月报

行政区服务月报的脚本位于：

```text
ppt_update/administrative_district/page_updates/
```

单页脚本示例：

```bash
python3 ppt_update/administrative_district/page_updates/P1_update.py \
  --pptx ppt_templates/行政区服务月报.pptx \
  --output output/浦东新区服务月报-P1更新.pptx \
  --year 2026 \
  --month 4月 \
  --district 浦东新区 \
  --api-base http://127.0.0.1:8000
```

完整逻辑、页面口径、接口来源和验证方式见：

```text
ppt_update/administrative_district/README.md
```