chore(release): freeze v0.2.0
版本冻结 v0.2.0，固化 2026-09-24 本轮全部变更。 admin-web： - 修复旧物善用管理页缺失样式类 .workspace-view / .view-header / .table-wrap， 此前页面无内边距导致内容被侧边栏遮挡、窄屏表格无横向滚动 - 修复服务统计页缺失样式类 .dashboard-grid / .dashboard-card / .stat-row， 此前 8 个指标卡退化为裸文本堆叠 - 补齐未定义的 --shadow-card 变量（财务编辑面板阴影此前失效） - 侧边栏 13 项导航由手写重复改为 NAV_ITEMS 数据驱动，并按业务顺序重排 - AdminIcon 补齐 coins / phone / volunteer / flag / calendar / recycle 语义图标 - 侧边栏行高与间距压缩使 13 项一屏放下，滚动条隐藏 - 小于等于 760px 断点导航由 display:none 改为横向滚动，移动端恢复可切换 api： - prisma.config.ts 显式加载仓库根 .env，修复 prisma generate / migrate 取不到 DATABASE_URL - dev / bootstrap:admin / test:integration 增加 tsx --env-file-if-exists=../../.env miniprogram： - custom-tab-bar 选中态与申请表单分步流程抽为可测纯函数并补充单测 - 页面完整性门禁脚本增强 工程： - 版本统一升位 0.1.0 到 0.2.0（根与 4 个 workspace 包） - .gitignore 增加 .pnpm-store/、.workbuddy/、微信开发者工具私人配置 与仓库根目录误生成的工程配置，避免本地产物与机器相关信息入库 验证：pnpm lint 通过、pnpm test:unit 19 个用例通过、miniprogram typecheck 通过、 admin-web typecheck 与 build 通过、pnpm install --frozen-lockfile 未改写 lockfile、 无头浏览器端到端登录复验通过、待提交内容密钥扫描无命中。 说明：本轮定位并排除了一起 Prisma 生成目录残缺事故——API 开发进程与并发的 prisma generate 争抢同一输出目录，Windows 文件锁导致只生成 34/56 个模型文件， 使 TS 全量类型解析失败并产生数千条 lint 报错；停止竞争进程后干净重新生成即恢复。 该生成目录已被 .gitignore 忽略，不进入版本库。
This commit is contained in:
@@ -4,6 +4,124 @@
|
||||
|
||||
## 当前阶段
|
||||
|
||||
2026-09-24
|
||||
|
||||
任务：冻结 v0.2.0 版本并推送至 GitHub（origin/main）。
|
||||
|
||||
完成：① 版本统一升位 `0.1.0` → `0.2.0`（根、`@lehuo/api`、`@lehuo/admin-web`、`@lehuo/miniprogram`、`@lehuo/contracts` 五个 package.json），并打附注标签 `v0.2.0`；② `.gitignore` 增加 `.pnpm-store/`、`.workbuddy/`、仓库根目录的 `project.config.json` / `project.private.config.json`（微信开发者工具在仓库根误生成的本地产物）与 `apps/miniprogram/project.private.config.json`（含本机路径与调试开关），避免本地产物与机器相关信息入库；③ 固化本轮全部代码变更（管理后台 UI 修复与滚动条隐藏、API 开发脚本 env 加载、Prisma 配置、小程序 tab-state 与申请表单流程及配套单测与页面门禁脚本）；④ 对待提交内容做密钥扫描（私钥、token、数据库连接串、管理员口令等关键词），无命中。
|
||||
|
||||
范围：仅版本元数据、忽略规则与既有代码变更的固化，未改动业务逻辑、API 契约、数据库 schema 或鉴权方案；`pnpm-lock.yaml` 未因版本升位改写（lockfile 内不含 workspace 包 version 字段，`pnpm install --frozen-lockfile` 判定 Already up to date）。
|
||||
|
||||
验证：`pnpm lint` exit 0、`pnpm test:unit` 19 个用例 exit 0、`@lehuo/miniprogram` typecheck exit 0、`@lehuo/admin-web` typecheck 与 build exit 0、无头浏览器端到端登录复验通过。
|
||||
|
||||
事故与排除：冻结前门禁出现 `pnpm lint` 4386 条报错（`Unsafe call of a type that could not be resolved`）。根因不是代码缺陷，而是 `apps/api/src/generated/prisma` 生成目录残缺——API 开发进程（`tsx watch`）与并发执行的 `prisma generate`（由 typecheck 脚本链式触发）争抢同一输出目录，Windows 文件锁使生成在 34/56 个模型文件处中断，`models/User.ts` 等缺失导致 TS 全量类型解析失败。停止竞争进程后删除并干净重新生成（56/56 模型齐全），lint 立即恢复 exit 0。该目录已被 `.gitignore:20` 忽略，不进入版本库。
|
||||
|
||||
遗留（本次冻结不等于生产发布）：`docs/14_RELEASE_CHECKLIST.md` 中 UAT 全项、E2E P0、真机测试、Ubuntu 26.04 主机预检、TLS 与离站备份均未验证，仍保持未勾选，未做假绿勾选。集成测试依赖 `docker compose --profile test up -d mysql-test`，本轮未执行。`prisma generate` 与 `pnpm build` 必须在不运行 API 开发服务的前提下执行，否则必因 Windows 文件锁产生残缺生成物。
|
||||
|
||||
---
|
||||
|
||||
2026-09-24
|
||||
|
||||
任务：管理后台界面（apps/admin-web）视觉与可用性巡检修复。
|
||||
|
||||
完成：① 补齐 OldItemsView 使用的缺失样式类 `.workspace-view` / `.view-header` / `.table-wrap`——此前三者在 styles.css 中零定义，页面无内边距导致内容被 240px 侧边栏遮挡（标题被裁掉一半），表格在窄屏无横向滚动；② 补齐 StatisticsView 使用的缺失样式类 `.dashboard-grid` / `.dashboard-card` / `.stat-row`——此前 8 个统计指标卡退化为裸文本堆叠；③ 在 `:root` 补定义 `--shadow-card`（此前财务编辑面板引用了未定义变量，阴影失效）；④ 侧边栏 13 项导航由手写重复改为 `NAV_ITEMS` 数据驱动渲染，并按业务逻辑重排（工作概览 → 服务申请 → 服务工单 → 回访工作台 → 服务对象 → 志愿者审核 → 公益项目 → 活动与报名 → 内容发布 → 财务公开 → 通知投递 → 服务统计 → 旧物善用管理，旧物管理不再插队第一）；⑤ AdminIcon 补充 coins/phone/volunteer/flag/calendar/recycle 图标，消除 4 个无图标项与 3 项共用 content 图标的语义错误，13 项图标齐全、文字左缘对齐；⑥ 侧边栏 nav 行高 48→42、gap 6→4 并允许 flex 收缩 + 细滚动条，phase-note 设 flex-shrink:0，消除 100vh 内溢出与末项被遮挡；⑦ ≤760px 断点下导航不再 `display:none`（此前移动端完全无法切换页面），改为横向滚动条，nav-item 设 white-space:nowrap、激活态改为底部指示条。
|
||||
|
||||
范围：仅前端样式与 App.vue 导航渲染方式，未改动任何视图的业务逻辑、API 调用、权限判断、路由结构或登录流程；StatisticsView 显式分支化（原为 v-else 兜底），行为等价。
|
||||
|
||||
验证：无头 Edge + CDP 对 13 个页面逐一真实点击截图取证（1440×900 与 720×900 两档），对比修复前后：统计页指标卡由裸文本变为 4×2 卡片网格、旧物页标题完整可见、移动端 navVisibleCount 由 0 恢复为 13、`--shadow-card` 由 undefined 变为已定义；`consoleErrors` 与 `networkFailures` 全程为空。`pnpm lint` exit 0、`pnpm --filter @lehuo/admin-web typecheck` exit 0、`pnpm test:unit` 13 用例 exit 0、`pnpm --filter @lehuo/admin-web build` exit 0。完整 `pnpm typecheck` 中 apps/api 的失败为运行中的 API 进程锁定 `src/generated/prisma/models`（Windows EPERM，既有约束，与本次前端改动无关）。
|
||||
|
||||
---
|
||||
|
||||
2026-09-24
|
||||
|
||||
任务：将本机工具链升级到 Node 24 与 pnpm 11，使仓库声明的 `engines` 与质量门禁命令真正可用。
|
||||
|
||||
完成：安装 Node 24.21.0 LTS 到 `C:\Users\13070\.workbuddy\binaries\node\versions\24.21.0`（与既有 Node 22 并存，未覆盖 hermes 与 WorkBuddy 托管运行时），在该目录内安装 pnpm 11.13.1（与仓库 `packageManager: pnpm@11.13.1` 一致），并把该目录前置到用户级 PATH，使新开终端 `node` 为 v24.21.0、`pnpm` 为 11.13.1。修复 `apps/api/prisma.config.ts`：Prisma CLI 工作目录为 `apps/api`，根目录 `.env` 不在 dotenv 默认查找路径内，改为显式加载 `../../.env`，使 `prisma generate` / `migrate` 与 API 运行时读取同一份配置。为 `apps/api` 的 `dev`、`bootstrap:admin`、`test:integration` 增加 `tsx --env-file-if-exists=../../.env`，消除「文档第 6/7 步在干净终端必然失败」的缺陷。
|
||||
|
||||
范围：只改本地工具链与开发脚本的环境加载方式，未改动技术栈、运行时依赖版本、数据库 schema、API 契约、权限或业务状态机；`pnpm-lock.yaml` 未被改写（`pnpm install --frozen-lockfile` 直接判定 Already up to date）。
|
||||
|
||||
验证：在 `Node v24.21.0 + pnpm 11.13.1` 下，`pnpm install --frozen-lockfile`、`pnpm lint`、`pnpm typecheck`、`pnpm test:unit`（19 个用例）、`pnpm build` 全部退出码 0；`prisma generate` 日志确认 `injected env (43) from ..\..\.env`。停止旧开发进程后 `pnpm build` 不再受文件锁干扰。以新工具链重启 API 后 `GET /health` 返回 200 且监听进程为 Node 24.21.0；无头浏览器真实登录复验通过（`POST /api/v1/admin/auth/login` 201、进入后台布局、13 个导航项、`consoleErrors` 与 `networkFailures` 均为空）。
|
||||
|
||||
遗留：`pnpm build` 与 `prisma generate` 在开发服务器运行时必然因 Windows 文件锁（`EPERM: rmdir src/generated/prisma/models`）失败，属既有运行约束，需先停止 API 再执行，未通过改脚本规避。集成测试仍依赖 `docker compose --profile test up -d mysql-test`（该容器当前为 Exited），本轮未执行。本机 `pnpm` 旧版本 9.15.9 仍位于 WorkBuddy 托管目录，仅在新会话 PATH 中被 Node 24 目录覆盖，未删除。生产仍被 staging、UAT、真实域名与微信配置阻断，工具链升级不等于可发布。
|
||||
|
||||
---
|
||||
|
||||
2026-09-24
|
||||
|
||||
任务：修复管理后台登录页「管理后台尚未配置服务地址」并完成首次管理员初始化。
|
||||
|
||||
根因：`apps/admin-web` 只有 `.env.example`，缺少 `.env.local`，`VITE_API_BASE_URL` 未定义，`src/api/api-client.ts` 与 `StatisticsView.vue` 读取该变量时直接抛出配置类错误；同时业务库 `lehuo` 中 `admin_credentials` 与 `users` 均为 0 行，说明首次管理员从未引导，任何账号密码都无法登录。
|
||||
|
||||
完成：新建 `apps/admin-web/.env.local`（`VITE_API_BASE_URL=http://localhost:3000`，与根 `.env` 的 `ADMIN_WEB_ORIGIN=http://localhost:5173` 配套，已被 `.gitignore` 的 `.env.*` 规则忽略）。以显式环境变量执行 `bootstrap:admin`，创建 `SUPER_ADMIN` 管理员（本地开发专用凭据，不入库文档、不提交仓库；生产仍须使用 `infra/ubuntu/scripts/bootstrap-admin.sh` 交互式隐藏输入）。
|
||||
|
||||
范围：仅补齐本地开发的环境配置与首次管理员数据，未修改技术栈、认证方案、数据库 schema、API 契约、权限或业务状态机；未用测试值冒充生产配置。
|
||||
|
||||
验证：Vite 自动加载新 env 后，`GET /src/api/api-client.ts` 的转换结果包含 `"VITE_API_BASE_URL": "http://localhost:3000"`。无头浏览器真实登录通过：登录卡片消失、进入 `.admin-layout`、13 个导航项、顶栏显示已安全登录，`consoleErrors` 与 `networkFailures` 均为空，`POST /api/v1/admin/auth/login` 返回 201 且 `GET /api/v1/admin/statistics/overview` 返回 200，证明 HttpOnly Cookie 会话在浏览器端真实生效。概览指标为 0 属业务库为空，非缺陷。数据库复核：`admin_credentials` 1 行、角色 `SUPER_ADMIN`、状态 `ACTIVE`。
|
||||
|
||||
遗留：本次未修复三处环境缺口，另行报告。①`tsx` 不会自动加载根 `.env`（已实测），而根 README 第 6/7 步直接写 `pnpm --filter @lehuo/api bootstrap:admin` 与 `dev`，实际必须显式注入环境变量或改用 `--env-file-if-exists`；②本机 PATH 上 `pnpm` 为 9.15.9、Node 为 v22.23.2，与仓库 `engines`（`pnpm >=11 <12`、`node >=24 <25`）不符，`pnpm <script>` 直接报 `ERR_PNPM_UNSUPPORTED_ENGINE`；③Vite 实际仅监听 `::1:5173`，浏览器须用 `http://localhost:5173`，用 `127.0.0.1` 既不监听也会因 Origin 不匹配被 `AdminOriginGuard` 拒绝。
|
||||
|
||||
---
|
||||
|
||||
2026-09-24
|
||||
|
||||
任务：启动本地完整程序，进入微信小程序验收测试。
|
||||
|
||||
完成：启动并确认 MySQL、Redis、MinIO 均为 healthy，确认 12 个 migration 无待部署项；以后台开发进程启动 API 与管理端，并启动已安装的微信开发者工具。管理端已在 Codex 浏览器面板排队打开。
|
||||
|
||||
验证：API `http://localhost:3000/health`、Swagger `http://localhost:3000/api/docs` 和管理端 `http://localhost:5173/` 均返回 HTTP 200。本轮仅执行环境启动，代码沿用上一任务已通过的全仓 Lint、类型检查、33 个单元测试、生产构建与 38 个集成测试结果。
|
||||
|
||||
遗留：微信开发者工具的 CLI 服务端口处于关闭状态，已直接启动工具且未修改安全设置；如工具未自动恢复项目，需要从最近项目打开或导入 `E:\develop\lehuo\apps\miniprogram` 后清缓存重新编译。
|
||||
|
||||
---
|
||||
|
||||
2026-09-24
|
||||
|
||||
任务：清理服务页与帮扶申请表单之间重复的服务类型选择页，并重排申请步骤编号。
|
||||
|
||||
完成：服务页六个服务类型按钮继续携带已选类型进入申请表单，表单识别预选类型后跳过原“选择服务”步骤和类型接口等待，直接显示原第 2 步“申请关系”。正式申请流程由 5 步调整为 4 步：申请关系、联系方式、描述需求、确认提交，进度条比例同步调整。对于“我需要帮助”“帮家人申请”等未预选类型入口，保留不计入步骤的服务类型选择页，选择后进入正式第 1 步，避免丢失服务类型必填信息。
|
||||
|
||||
验证：新增流程回归测试先因实现缺失失败，修复后小程序 8 个单元测试通过；全仓 Lint、类型检查、33 个单元测试和生产构建全部通过；小程序 28 个页面完整性与运行时依赖门禁通过；专用 MySQL 上的 38 个真实集成测试通过。
|
||||
|
||||
遗留：需在微信开发者工具清缓存后，分别验证服务类型按钮直达第 1 步，以及“我需要帮助/帮家人申请”先选类型再进入第 1 步的两条入口。
|
||||
|
||||
---
|
||||
|
||||
2026-09-24
|
||||
|
||||
任务：统一修复小程序自定义底部导航选中态及首页、个人中心微信登录失败。
|
||||
|
||||
完成：确认登录 502 的根因是微信开发者工具项目 AppID 与 API AppID 不一致；微信官方 `jscode2session` 使用后台凭据和无效测试 code 返回 40029，证明凭据有效且问题来自 code 所属 AppID。将根目录和小程序目录的本地项目配置统一到后台 AppID。自定义底部导航新增独立路由选中计算，在组件 attached、页面 show 和点击切换三个时点同步 selected，解决 Tab 实例恢复后图标不变色。
|
||||
|
||||
验证：修复前两个项目配置均与 API AppID 不匹配，修复后均匹配；导航路由回归测试先因实现缺失失败，修复后小程序 5 个单元测试通过。全仓 Lint、类型检查、28 个单元测试、生产构建以及专用 MySQL 上的 38 个真实集成测试全部通过；小程序 28 个页面完整性和运行时依赖门禁通过。真实登录仍需微信开发者工具重载项目配置后使用新的实时 code 验证。
|
||||
|
||||
遗留：微信开发者工具需关闭当前项目后重新打开 `apps/miniprogram`，清除缓存并重新编译，确保新 AppID 生效；此前旧 AppID 生成的 code 不能复用。
|
||||
|
||||
---
|
||||
|
||||
2026-09-24
|
||||
|
||||
任务：部署本地开发依赖与 API，修复微信开发者工具请求 `localhost:3000` 被拒绝。
|
||||
|
||||
完成：定位 Docker Desktop 实际安装目录并使用其 Docker 29.8.0 / Compose 5.5.1 CLI；生成 Git 忽略的本地 `.env` 和随机开发密钥，启动 MySQL 8.4、Redis 7.4、MinIO，执行全部 12 个 migration，在 MinIO 创建私有 `lehuo-private` bucket，并以隐藏后台进程启动 API。未将本地密钥、密码或运行日志提交到仓库。
|
||||
|
||||
验证：MySQL、Redis、MinIO 容器均为 healthy；`GET /health` 返回 200，公开项目、公开活动和服务分类接口均返回 200，原 `ERR_CONNECTION_REFUSED` 根因已消除。配置本地微信 AppID/AppSecret 并重启 API 后，使用无效测试 code 请求登录接口返回 502 而非“未配置”的 503，确认请求已进入微信 code 换取阶段。
|
||||
|
||||
遗留：仍需由微信开发者工具使用实时 `wx.login` code 完成端到端登录验证。API 当前为本地隐藏开发进程，不是生产服务。
|
||||
|
||||
---
|
||||
|
||||
2026-09-24
|
||||
|
||||
任务：修复微信开发者工具编译“我的协作任务”页面时的 `wx:else` 错误。
|
||||
|
||||
完成：将协作任务列表的条件分支改为外层 `wx:else` block 包裹内部 `wx:for` 按钮，避免条件指令与循环指令位于同一节点导致 WXML 编译器无法关联前序 `wx:if/wx:elif`。同步扩展小程序页面完整性检查，遇到 `wx:elif/wx:else` 与 `wx:for` 共用节点时提前失败并给出修复提示。
|
||||
|
||||
验证：新增门禁在修复前稳定报出 `pages/assigned-cases/assigned-cases.wxml` 的指令冲突，修复后 28 个小程序页面完整性检查通过；本次修改文件的 Prettier 检查、全仓 Lint、类型检查、28 个单元测试和生产构建通过。全仓 Prettier 检查仍被仓库现有 331 个文件的格式/行尾差异阻断；集成测试启动后因本机 `127.0.0.1:3307` 的 `lehuo_test` MySQL schema engine 不可用而未进入用例执行。
|
||||
|
||||
遗留：仍需在微信开发者工具清除缓存后重新编译，并人工确认协作任务的加载、失败、空状态和列表状态切换。
|
||||
|
||||
---
|
||||
|
||||
2026-08-15
|
||||
|
||||
任务：将 Ubuntu 26.04 部署版本重新同步到 GitHub 仓库。
|
||||
|
||||
Reference in New Issue
Block a user