# U8 产品原型文档

本仓库用于归档 **U8** 相关的产品原型、交互设计稿与常见问题说明，供产品、设计、研发同学查阅与协作。

## 目录结构

| 路径 | 说明 |
| --- | --- |
| `文档/wireframes/` | 原型线框图 |
| `文档/常见问题/` | 常见问题配图与说明 |
| `文档/常见问题-上传说明.md` | 常见问题文档的上传规范 |
| `文档/快速建群/` | 快速建群功能原型 |
| `文档/密码登录/` | 密码登录流程原型 |
| `文档/修改手机号/` | 修改手机号流程原型 |
| `文档/发红包引导改版/` | 发红包引导改版原型 |
| `文档/搜索/`、`文档/搜索功能/` | 搜索相关原型 |
| `文档/文件夹/`、`文档/消息选择/` | 文件夹与消息选择交互 |
| `文档/用户姓名/`、`文档/群标签/`、`文档/表情回复/` | 资料、标签与表情回复相关 |
| `文档/设备管理/`、`文档/隐私设置/` | 账号安全与隐私设置 |
| `文档/虚拟卡/` | 虚拟卡（银行卡）客户端原型与 PRD；前身稿在 `_archive/` |
| `文档/虚拟卡后台/` | 虚拟卡运营 / 风控后台原型 |
| `文档/会话存档-*.md`、`文档/找回的会话-*.md` | 需求讨论与会议记录存档 |

> 目录会随迭代持续新增，以上仅为当前快照。

## 使用说明

1. **浏览文档**：直接进入 `文档/` 下对应功能目录，文件名即内容主题。
2. **补充新材料**：把文件放入对应的功能目录；新功能请新建一个以功能命名的目录。
3. **不要提交的内容**（已由 `.gitignore` 自动排除）：
   - macOS 系统文件：`.DS_Store`、`._*`
   - Reasonix 等工具的临时附件与缓存：`.reasonix/`
   - 编辑器配置与 Office 临时文件

## 产品原型站（远程浏览）

仓库里带了一个生成器，把功能原型编译成**纯静态网站**（输出到 `site/`），
可直接上传到 Nginx / Apache 等任意静态服务器，供**开发和老板**快速浏览
**可点击演示版**与**功能 PRD**。

```bash
python3 site_build/build_site.py     # 生成 site/
python3 site_build/verify_site.py    # 自检：编码 + 站内死链
cd site && bash preview.sh           # 本地预览 http://127.0.0.1:8080
```

| 路径 | 说明 |
| --- | --- |
| `site_build/build_site.py` | 站点生成器（仅用 Python 标准库，无需安装依赖） |
| `site_build/assets/` | 站点的样式、脚本源文件 |
| `site_build/deploy/` | 部署配置：`nginx.conf`、`.htaccess`、`preview.sh`、`DEPLOY.md` |
| `site_build/verify_site.py` | 上传前自检脚本 |
| `site/` | **生成产物**，整个目录就是可上传的网站 |

站点分两个页签，都是**后台风格的列表**（名称 / 分组 / 可点击演示 / 产品需求文档 / 更新时间），
**默认按更新时间倒序**，可切换按分组或按名称；带关键词搜索、分组与内容筛选；
顶栏按 `/` 可跨页面搜索。详细部署步骤见 `site/DEPLOY.md`。

| 页签 | 内容 | 数量 |
| --- | --- | --- |
| **功能演示列表** | 主要功能的演示与 PRD | 13 项 |
| **其他资料** | 非主要功能与过程资料（早期 PRD、查缺补漏、专题改版） | 2 项 |

### 收录规则：白名单

站点**不是全量收录**，只收录 `build_site.py` 里 `MODULES` 数组显式登记的功能模块：

- 要**新增**一个功能到站点 → 在 `MODULES` 里加一条（`dir` / `group` / `blurb` / `order`）。
- 要**从站点移除** → 删掉对应条目。
- 要在「功能演示列表」和「其他资料」之间挪动 → 改条目里的 `section`（`"main"` / `"other"`）。

首页顶部会公示**近期上传**（左）与**近期更新**（右），各最多 3 条。这份记录由
`site_build/activity.json` 台账按**内容指纹**维护，不依赖文件时间戳：
改了内容重跑生成器，面板就会自动反映出来，不需要手工维护列表。
- 线框图、会话存档、常见问题页、过程文档**都不在名单里**，不会被上传。

> 只有明确需要发布到「产品原型站」的产出物才登记进白名单；其余资料只留在仓库里。
> `site/` 是构建产物，可选择不入库；改完 `文档/` 里的原稿后重新运行生成器即可。

## 提交规范

提交信息建议使用以下前缀，便于回溯：

| 前缀 | 用途 | 示例 |
| --- | --- | --- |
| `feat:` | 新增原型或文档 | `feat: 补充快速建群交互稿` |
| `fix:` | 修正错误内容 | `fix: 更正密码登录流程图` |
| `docs:` | 文档文字调整 | `docs: 更新常见问题上传说明` |
| `chore:` | 仓库维护 | `chore: 整理目录结构` |

提交方式：使用 **GitHub Desktop** 提交并推送即可；也可在终端执行 `git push`（凭据已配置到本仓库）。