# 03-推进台账

本文件按轮次记录工作。每轮结束必须写清楚：做了什么、改了哪些文件、验证了什么、下一步是什么。

## R001 - 建立 working 文档体系

- 日期：2026-07-06
- 任务编号：T001、T002
- 做了什么：
  - 阅读 `doc/index.html` 的页面结构、导航、路由、表单 mockup、服务模块、FAQ、O-1A criteria、法务页面和渲染脚本。
  - 建立 `working` 目录下 6 份编号文档和 README 索引。
  - 初步记录当前项目是自包含静态 HTML mockup。
- 改了哪些文件：
  - `working/README.md`
  - `working/01-项目功能内容.md`
  - `working/02-项目程序开发详细步骤.md`
  - `working/03-推进台账.md`
  - `working/04-任务矩阵.md`
  - `working/05-验收证据.md`
  - `working/06-决策记录.md`
- 验证了什么：
  - 确认 `doc/index.html` 是自包含静态 HTML。
  - 确认页面通过 `?page=...` 查询参数切换。
  - 确认 Start Here 和 Ask a Question 当前是视觉 mockup，不是真实表单。
- 证据链接或编号：E001、E002、E003
- 遗留问题：
  - 未做浏览器截图验收。
  - 未做移动端回归。
  - 未实现表单和部署。
- 下一步：
  - 按 `04-任务矩阵.md` 从 `VERIFY` 与 `TODO` 任务继续推进。

## R002 - 完全对标 doc/index.html 补强 working 文档

- 日期：2026-07-06
- 任务编号：T028
- 做了什么：
  - 复读 `doc/index.html` 中 header、footer、`pageData`、页面组合函数、Press/Judging/Resources/FAQ/Legal/Form 模块。
  - 补充 `01-项目功能内容.md`，把页面路由、内容模块、表单字段、服务卡片、O-1A criteria、法律页面、已知缺陷和发布环境写完整。
  - 补充 `02-项目程序开发详细步骤.md`，形成阶段化路线：基线复现、静态修复、真实表单、工程化拆分、8082 端口部署、HTTPS、回归验收。
  - 补强任务矩阵，新增服务器部署、凭据处理、contact 死链、outlet/network 陈述风险、README 索引维护等任务。
  - 补强验收证据，记录本轮命令、源码发现和后续证据清单。
  - 补强决策记录，明确不在长期文档保存明文密码、服务默认走 8082、Services 的 `contact` 路由是缺陷。
- 改了哪些文件：
  - `working/README.md`
  - `working/01-项目功能内容.md`
  - `working/02-项目程序开发详细步骤.md`
  - `working/03-推进台账.md`
  - `working/04-任务矩阵.md`
  - `working/05-验收证据.md`
  - `working/06-决策记录.md`
- 验证了什么：
  - `rg --files` 确认项目当前主要文件为 `doc/index.html`、`doc/README.md` 和 `working/*.md`。
  - `rg -n` 确认公开路由、隐藏路由、表单 mockup、legal 页面、动态路由逻辑均在 `doc/index.html`。
  - `sed` 分段读取源文件，确认 Services 04/05/06 卡片指向不存在的 `contact` 页面。
  - `git status --short` 失败，确认当前目录不是 Git 仓库或未在 Git 工作树内。
- 证据链接或编号：E004、E005、E006、E007
- 遗留问题：
  - 尚未改 `doc/index.html`。
  - 尚未启动本地服务器或做截图。
  - 尚未登录远端服务器。
  - 用户提供了密码，但长期文档未写入明文密码。
- 下一步：
  - 优先处理 T029：修复 Services 页面不存在的 `contact` 路由。
  - 继续 T003-T011：对核心页面做浏览器截图验收。
  - 之后按产品选择推进 T012/T013 表单落地或 T022 工程化拆分。

## R003 - 源码级对标附录完善

- 日期：2026-07-06
- 任务编号：T034
- 做了什么：
  - 重新扫描 `doc/index.html` 的 CSS token、响应式断点、路由链接、函数列表、FAQ、Legal sections 和渲染逻辑。
  - 在 `01-项目功能内容.md` 增加视觉设计、组件 CSS 类、JavaScript 函数、CTA 全量映射、FAQ 完整编号、Legal 逐项结构和源码级结论。
  - 在 `02-项目程序开发详细步骤.md` 增加“完全对标核验清单”，规定以后如何证明文档与源 HTML 对齐。
  - 更新任务矩阵、验收证据和决策记录。
- 改了哪些文件：
  - `working/01-项目功能内容.md`
  - `working/02-项目程序开发详细步骤.md`
  - `working/03-推进台账.md`
  - `working/04-任务矩阵.md`
  - `working/05-验收证据.md`
  - `working/06-决策记录.md`
- 验证了什么：
  - `doc/index.html` 共 3423 行。
  - CSS 只有一个显式响应式断点：`@media (max-width: 1080px)`。
  - `pageData` 包含公开路由、隐藏路由和 legal 页面。
  - FAQ 共 4 组 20 个问题。
  - Terms 编号缺少 17，Legal 日期均为 `July 10, 2026`。
  - 多个函数和 CSS 模块存在但当前未调用。
- 证据链接或编号：E016
- 遗留问题：
  - 仍未修改 `doc/index.html` 源码。
  - 仍未做浏览器截图和真实部署验收。
- 下一步：
  - 按 T029 修复 `contact` 缺陷，或按 T003-T011 做页面截图验收。

## R004 - 明确正式开发技术架构

- 日期：2026-07-06
- 任务编号：T035
- 做了什么：
  - 根据用户确认，将正式开发路线从候选方案收敛为 Next.js + React + PostgreSQL。
  - 将默认数据访问层定为 Prisma ORM。
  - 补充 Next.js 路由迁移表、PostgreSQL 数据模型初稿、表单 API、环境变量、8082 启动方式和部署验收标准。
  - 更新任务矩阵和决策记录。
- 改了哪些文件：
  - `working/01-项目功能内容.md`
  - `working/02-项目程序开发详细步骤.md`
  - `working/03-推进台账.md`
  - `working/04-任务矩阵.md`
  - `working/05-验收证据.md`
  - `working/06-决策记录.md`
  - `working/README.md`
- 验证了什么：
  - 文档已不再把 Vite/静态拆分作为推荐路线。
  - 部署命令已调整为 Next.js `npm run start -- -p 8082`。
  - 数据库任务已进入矩阵。
- 证据链接或编号：E017
- 遗留问题：
  - 尚未实际创建 Next.js 工程。
  - 尚未创建 PostgreSQL 数据库或 Prisma migration。
  - 文件上传存储方案仍需单独确认。
- 下一步：
  - 执行 T036 初始化 Next.js 工程。
  - 执行 T037 设计并迁移 PostgreSQL schema。

## R005 - 记录服务器 PostgreSQL 安装状态

- 日期：2026-07-06
- 任务编号：T040
- 做了什么：
  - 根据用户反馈，记录 PostgreSQL 已在服务器 `170.106.192.152` 安装完成。
  - 补充服务器 PostgreSQL 验证命令、应用数据库和受限用户创建建议。
  - 保持凭据安全规则：不把明文 SSH 密码写入长期文档。
- 改了哪些文件：
  - `working/01-项目功能内容.md`
  - `working/02-项目程序开发详细步骤.md`
  - `working/03-推进台账.md`
  - `working/04-任务矩阵.md`
  - `working/05-验收证据.md`
  - `working/06-决策记录.md`
- 验证了什么：
  - 本轮未登录服务器验证，仅记录用户确认。
- 证据链接或编号：E018
- 遗留问题：
  - 需要远程执行 `systemctl status postgresql`、`psql --version`、数据库列表检查。
  - 需要创建或确认 `paprika` 数据库和 `paprika_app` 应用用户。
- 下一步：
  - 执行 T040 远程验证 PostgreSQL。
  - 执行 T037 接入 Prisma schema 和 migration。

## R006 - 记录邮箱系统账号需求

- 日期：2026-07-06
- 任务编号：T041
- 做了什么：
  - 记录普通用户 webmail 入口、管理员入口和 `admin@paprikalaw.com` 管理员账号。
  - 记录 10 个普通公司邮箱账号清单。
  - 补充邮件 DNS、收发验证、表单通知接入和凭据安全要求。
  - 明确用户提供的统一初始密码不写入长期文档。
- 改了哪些文件：
  - `working/01-项目功能内容.md`
  - `working/02-项目程序开发详细步骤.md`
  - `working/03-推进台账.md`
  - `working/04-任务矩阵.md`
  - `working/05-验收证据.md`
  - `working/06-决策记录.md`
  - `working/README.md`
- 验证了什么：
  - 本轮只记录需求，未登录邮件后台，未验证 DNS/MX/SPF/DKIM/DMARC。
- 证据链接或编号：E019
- 遗留问题：
  - 需要登录 `https://mail.paprikalaw.com/admin/` 确认账号是否已创建。
  - 需要测试 webmail 登录、内外部收发和 DNS 记录。
  - 需要决定网站表单通知使用哪个邮箱。
- 下一步：
  - 执行 T041 邮箱账号创建/确认。
  - 执行 T042 邮件 DNS 和收发测试。
  - 执行 T043 Next.js 表单邮件通知配置。

## R007 - 落地 Next.js 工程、Prisma 和真实表单

- 日期：2026-07-06
- 任务编号：T012、T013、T017、T020、T022、T029、T036、T037、T038、T039、T044
- 做了什么：
  - 修复 `doc/index.html` 中 Services 04/05/06 CTA 指向不存在 `contact` 的缺陷，统一改为 `start`。
  - 将 legal 页面日期从未来日期 `July 10, 2026` 改为当前工作日期 `July 6, 2026`。
  - 在项目根目录初始化 Next.js + React + TypeScript App Router 工程。
  - 编写 `scripts/extract-legacy-pages.mjs`，从 `doc/index.html` 抽取 CSS 和静态页面 HTML，生成 `app/globals.css` 与 `lib/legacy-pages.ts`。
  - 建立 `app/[page]/page.tsx` 静态路由，迁移公开页面到 `/press`、`/judging`、`/services` 等路径路由。
  - 建立 `/start`、`/ask` 真实 React 表单，提交到 `POST /api/submissions`。
  - 建立 Prisma schema、初始化 migration、`.env.example`、数据库访问层和 Zod 校验。
  - 增加基础 SEO metadata、`robots.txt` 和 `sitemap.xml`。
  - 升级到 Next `16.2.10`、React `19.2.7`，并配置 ESLint 9 flat config。
- 改了哪些文件：
  - `doc/index.html`
  - `.env.example`
  - `.gitignore`
  - `package.json`
  - `package-lock.json`
  - `tsconfig.json`
  - `next-env.d.ts`
  - `next.config.mjs`
  - `eslint.config.mjs`
  - `scripts/extract-legacy-pages.mjs`
  - `app/*`
  - `components/*`
  - `lib/*`
  - `prisma/schema.prisma`
  - `prisma/migrations/20260706120000_init/migration.sql`
  - `working/README.md`
  - `working/01-项目功能内容.md`
  - `working/02-项目程序开发详细步骤.md`
  - `working/03-推进台账.md`
  - `working/04-任务矩阵.md`
  - `working/05-验收证据.md`
  - `working/06-决策记录.md`
- 验证了什么：
  - `npm run generate:legacy` 成功生成 12 个旧页面数据。
  - `npm run prisma:generate` 成功生成 Prisma Client。
  - `npm run lint` 通过。
  - `npx tsc --noEmit` 通过。
  - `npm run build` 通过，生成 19 个 app route。
  - `npm run start -- -p 8082` 本地生产服务可启动。
  - `/`、`/press`、`/judging`、`/scholarly`、`/services`、`/why`、`/resources`、`/faq`、`/start`、`/ask`、`/thanks`、`/terms`、`/privacy`、`/disclaimer`、`/robots.txt`、`/sitemap.xml` 本地生产服务均返回 200。
  - `/api/submissions` 对缺失必填字段和错误 email 返回 400 校验错误。
  - 有效提交在未配置 `DATABASE_URL` 时返回 500，确认入库成功仍需真实 PostgreSQL。
- 证据链接或编号：E022、E023、E024、E025、E026
- 遗留问题：
  - 本地未配置 PostgreSQL `DATABASE_URL`，尚不能完成真实入库验收。
  - 远程 PostgreSQL、应用数据库、应用用户、migration deploy 尚未验证。
  - 邮箱后台、DNS、SMTP 通知未验证。
  - 法务内容审核、outlet/network 名称确认、文件上传策略仍需外部确认。
  - 尚未做浏览器截图/PDF 归档。
- 下一步：
  - 执行 T040/T044：远程验证 PostgreSQL，配置生产 `DATABASE_URL`，执行 migration，并提交 Start/Ask 获取 `submission_id`。
  - 执行 T039/T024：部署 Next.js 到服务器 `8082` 并配置 systemd。
  - 执行 T041-T043：验证邮箱和 SMTP 通知。
  - 执行 T018/T026：补桌面和移动端截图证据。

## 后续轮次模板

### RXXX - 标题

- 日期：
- 任务编号：
- 做了什么：
- 改了哪些文件：
- 验证了什么：
- 证据链接或编号：
- 遗留问题：
- 下一步：