wangdequan/MeetPaprika
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
MeetPaprika/working/03-推进台账.md

12 KiB
Raw Permalink Blame History

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 - 标题

  • 日期：
  • 任务编号：
  • 做了什么：
  • 改了哪些文件：
  • 验证了什么：
  • 证据链接或编号：
  • 遗留问题：
  • 下一步：
Reference in New Issue View Git Blame Copy Permalink