# 工程题 A：文章管理系统（数据层）

> **本题为扩展题内容，二选一完成即可。** 选做一道，不强制。
> 请在功能分支上开发，完成后通过 Pull Request 合并回 main。

## 项目背景

实现一个文章管理系统的**数据层**：文章模型、附件管理、操作审计、并发安全。核心挑战：合理的模型设计、Django 信号驱动的审计日志、文件附件管理、并发安全的计数器。

## 功能需求

### 必须实现

1. **数据模型**
   - `Article`：标题、正文、作者（外键 → 用户，`CASCADE`）、状态（`draft` / `published` / `archived`）、浏览量（默认 0）、`created_at` / `updated_at`（自动记录）
   - `Attachment`：文件名、文件（`FileField`）、关联文章（外键 → `Article`，`CASCADE`，`related_name="attachments"`）、上传时间
   - `AuditLog`：操作类型（`create` / `update` / `publish` / `archive` / `delete`）、关联文章（外键 → `Article`，`SET_NULL`，`null=True`）、操作人（外键 → 用户，`SET_NULL`，`null=True`）、时间戳、变更摘要（`JSONField`）
   - 合理设置 `__str__`、`Meta` 排序、`verbose_name`

2. **附件管理**
   - 登录用户可为自己的文章上传附件（`FileField`，存到 `MEDIA_ROOT/attachments/`）
   - 文章详情页展示附件列表
   - 作者可删除自己的附件
   - `settings.py` 配置 `MEDIA_URL` / `MEDIA_ROOT`，开发服务器能访问静态文件

3. **操作审计（信号驱动）**
   - 每次文章创建、状态变更、删除，自动写入 `AuditLog`
   - **必须用 Django 信号**（`post_save` / `pre_delete`）实现，禁止在视图里手动 `AuditLog.objects.create`
   - 变更摘要用 `JSONField` 记录变更前后字段差异，如 `{"status": {"old": "draft", "new": "published"}}`
   - 文章详情页底部展示该文章的审计日志（按时间倒序）

4. **并发安全浏览量**
   - 文章详情页每次访问浏览量 +1
   - **必须用 `F("views") + 1` 原子更新**
   - 写注释说明：为什么 `article.views += 1; article.save()` 在并发下会丢更新

### 加分项

1. **封面图缩略图**：上传时自动生成 200px 宽缩略图（用 `Pillow`，存到 `MEDIA_ROOT/thumbnails/`）
2. **文章统计视图**：`/stats/` 展示总文章数、总浏览量、各状态文章数、最近 10 条审计日志
3. **软删除**：文章删除时不真删，设 `is_deleted=True`，审计日志保留；列表页过滤已删除文章
4. **附件下载计数**：每次下载附件 +1（`F("downloads") + 1`），展示在附件列表

## 技术要求

- Python 3 + Django
- 必须包含：
  - `README.md`：项目说明、功能列表、依赖安装、运行方式
  - `requirements.txt`（含 `Pillow`）
  - 可运行的 `manage.py`
- 密码存储必须用 Django 内置哈希（`set_password`），禁止明文
- 审计日志必须用信号实现，禁止在视图里手动 `create`
- 代码遵循 PEP 8

## 评分标准

| 维度 | 权重 | 说明 |
| --- | --- | --- |
| 必须功能完成度 | 40% | 模型 + 附件 + 信号审计 + 并发浏览量 |
| 代码质量 | 25% | 模型设计、信号设计、无冗余、有注释 |
| 加分项 | 20% | 实现了多少可选功能 |
| 工程规范 | 15% | git 提交历史、分支管理、PR 流程、README 完整性 |

## 提交要求

- 项目代码放在本目录 `project-a/` 下
- 在功能分支上开发，完成后通过 Pull Request 合并回 main
- 保持过程性提交，提交信息应说明改动内容
- 截止前（10月7日 23:59）仓库状态为准