update

.workbuddy/memory/2026-08-29.md

@@ -0,0 +1,32 @@
+# 2026-08-29 工作日志
+
+## 前端列表页重构 + 详情路由统一（17:00–17:45）
+
+用户要求：① 所有文章详情集成到 `/item`（含 street 详情）；② 之前分析过的列表页抽象（共享 CSS / 共享 Alpine 工具 / 品牌弹窗组件）一并落地。
+
+### 现状核对（重要：大部分已提前落地）
+- 排查发现 RunwayLooks.astro 与 StreetSnaps.astro 的 `<script>` **已**抽成共享工具（import `@/lib/looks-grid`，`getCardSlots`→`makeCardSlots`、`pageList`→`buildPageList`、`SPIN_SVG` 从工具导入），且 RunwayLooks 的重复 `toggleBrand`（selectedBrands 数组误写）**已**删除；品牌弹窗**已**抽成 `src/components/BrandModal.astro`。
+- 详情路由：`cn/item/[id].astro` 与 `en/item/[id].astro` **已**实现「先 article 后 street 回落」统一渲染；RunwayLooks 卡片链接**已**用 `ROUTES.item` → `/item/`。
+
+### 本次实际改动
+- **共享 CSS**：新建 `src/styles/look-grid.css`，集中两列表页重复的卡片/网格/分页/侧栏/spinner/骨架/动画样式（类名保留 `.shows*`/`.snaps*`，keyframes 统一为 `looksProg`/`looksShim`）。用 node 脚本剥离两个组件内部 `<style>` 块，frontmatter 各 `import "@/styles/look-grid.css"`。
+- **路由统一**：`src/lib/routes.ts` 将 `article`/`streetSnap` 两个工厂函数都改为 `(id)=>/item/${id}`（原 `article` 还是旧的 `/article?id=` 死路径）。
+- **删遗留旧详情页**：`cn|en/street-snaps/[id].astro`、`cn|en/article.astro`（?id= 旧详情，全仓无任何内链）。`runway-looks/[id]` 早就被删。
+- 验证：`npm run build` 通过（BUILD_EXIT=0）；详情组件回链指向列表页 `/street-snaps`、`/runway-looks`（仍存在），api.ts 内 `/api/v1/public/...` 是后端地址未动；全仓无悬空引用。
+
+### 余留（已解决）
+- `src/components/pages/article.astro`（`Article` 组件）已删除（见下方清理）。
+- `ROUTES.article` 与 `ROUTES.item` 现为同义重复，保留 `article` 仅为语义兼容（暂未动）。
+
+## 清理孤儿代码（18:50）
+用户要求删除没用的页面/css/js。排查全仓引用后执行：
+- **删 9 个孤儿组件/资源**：`components/pages/` 下 8 个（`About`/`Contact`/`LatestProjects`/`Portfolio`/`Login`/`Register`/`AuthForm`/`article`，全是 ComingSoon 占位或旧详情组件，无任何页面 import、也不是真实路由）+ `components/LanguageDetector.astro`（Layout 里被注释掉的死 import）。并移除空的 `components/pages/` 目录 + `assets/astro.svg`、`assets/background.svg`（Astro 脚手架残留，全仓零引用）。
+- **修隐藏 bug**：`ComingSoon.astro` 引用了 `ROUTES.articles`（routes.ts 从未定义该 key）→ 改为 `ROUTES.runwayLooks`（真实路由），否则「浏览走秀档案」按钮指向 undefined。
+- **清 Layout 死引用**：删除 `import LanguageDetector` 与 `<!-- TODO <LanguageDetector /> -->`。
+- **本次保留（未动）**：`ComingSoon`（Index 在用）、`looks-grid.ts`（两列表页 import）、`global.css`（Layout 引用）、`Breadcrumb/BrandModal/Item/StreetSnap` 等都在用。
+- **未动 header 导航**：导航仍链到 `/about` `/contact` `/portfolio` `/latest-projects` `/login` `/register`，但这些路由**根本不存在**（占位组件已删、也从未有真实页面）→ 是死链。按用户「header 别动」旧约束未删导航项，待用户决定是否一并移除。
+- 验证：`npm run build` BUILD_EXIT=0；read_lints Layout/ComingSoon 均 0；全仓 grep `LanguageDetector|components/pages|ROUTES.articles|astro.svg|background.svg` 零命中。
+
+## 删冗余 ROUTES.article（19:00）
+- `ROUTES.article`（routes.ts 里 `(id)=>/item/${id}`）全仓只有定义、零引用（另几处 `article:` 是 Item.astro / api.ts 的数据字段，无关），与 `ROUTES.item` 完全同义 → 按用户要求删除。保留 `streetSnap`（同样指向 /item，暂未动）。
+- 验证：`npm run build` BUILD_EXIT=0；read_lints routes.ts 0。

.workbuddy/memory/MEMORY.md

@@ -3,7 +3,7 @@
 ## 模块策略（重要）
 - 站点按模块逐个完善。当前上线「发布会模块」：首页 index + 走秀列表/详情（RunwayLooks = 走秀档案页，articles/shows 页面已在 i18n 重构中重组）。
 - **品牌索引页已下线**（2026-08-26 确认）：`src/pages/brands.astro` 及孤儿组件 `src/components/pages/brands.astro` 均已删除；品牌数据现在只通过走秀页侧栏 filter + 品牌弹窗呈现（热门 30 条走 SSG 接口，搜索/字母走运行时 `/api/v1/public/brands`）。
-- 其余模块（Portfolio / Latest Projects / About / Contact / 根路径登录注册）为 ComingSoon 占位页；**导航(header)保持原样未改动**（用户 2026-08-07 明确「header 别动」），门禁完全靠占位页实现。`/en/login`、`/en/register` 已是真实页面（`AuthForm.astro`，mode login/register）。
+- **占位模块组件已清理（2026-08-29）**：`components/pages/` 下 `About`/`Contact`/`LatestProjects`/`Portfolio`/`Login`/`Register`/`AuthForm`/`article` 等占位/旧详情组件查无引用、也不是真实路由，已删除并移除空目录。**这些模块的导航链接（`/about` `/contact` `/portfolio` `/latest-projects` `/login` `/register`）仍是死链**——从未有对应页面，待用户决定是否移除导航项。**导航(header)本身保持原样未改动**（用户 2026-08-07 明确「header 别动」）。`/en/login`、`/en/register` 实际并非真实页面（旧 MEMORY 记录有误），AuthForm 组件已随清理删除。
 
 ## 架构总览
 - 前端：**d:/project/frontend_v2** — Astro SSG + Tailwind v4 + Alpine.js。`npm run build`（SSG 取数走 ssgRequest，失败回落空/假数据不影响构建）。
@@ -17,7 +17,7 @@
 - **品牌名前端一律只显示英文**（用户偏好 2026-08-26：「前端品牌不要展示中文名称，标题可以留着」）：api.ts 映射 `display = nameEn`；走秀标题/描述仍按 locale 选列。
 - **API 命名哲学（用户原则）**：「每一个地方尽可能不要通过参数来复用接口，尽量一个功能一个接口」。查询参数仅限「同一资源的列表筛选/分页」；跨资源/独立功能一律独立路径（如 `brands/hot` 而非 `?featured=1`）。待办：公开侧 `/api/v1/public/brands` 的 featured/keyword/letter 参数拆分、`/articles` 的 `brand_id` 拆 `brands/:id/shows`、资源命名 `shows` vs `articles`、`popular` vs `featured`（目标清单见 artifact `api_endpoints_catalog.md`）。
 - CSS：能 @apply 就 @apply；`<style>` 顶部 `@reference "tailwindcss";`。Tailwind v4 无零值类。
-- 导航（Layout.astro）保持原样，门禁仅由占位页承担。
+- 导航（Layout.astro）保持原样未改动（用户「header 别动」），但其部分链接（/about /contact /portfolio /latest-projects /login /register）指向不存在的路由，属待清理死链。
 
 ## Layout 陷阱（2026-08-12）
 - Layout 把 `<slot />` 包在 `flex-1 flex flex-col` 容器里；页内根容器**禁用 `m-auto`**（cross-axis margin:auto 触发 shrink-to-fit → 内容多少决定宽度、页面抖动）。用 `w-full`（可配 `max-w-[xxx]` + `mx-auto`）。
@@ -33,5 +33,9 @@
 - 地理/城市维度：用户明确暂不做。
 - 分布：rtw 15203 / menswear 4061 / couture 672 / resort 2894 / pre_fall 2376。
 
+## 前端组件复用（2026-08-29）
+- **详情页统一 `/item`**：走秀 lookbook 与街拍详情全部收口到 `src/pages/{locale}/item/[id].astro`，服务端按 `getSsrArticle(id)` → `getSsrStreetSnap(id)` 回落渲染（先 runway 后 street）。`ROUTES.article` 与 `ROUTES.streetSnap` 均指向 `/item/${id}`（`runway-looks/[id]`、`street-snaps/[id]`、`article.astro(?id=)` 等旧详情页均已删除）。列表页回链仍指向列表 `/runway-looks`、`/street-snaps`。
+- **列表页共享资源**：两个列表组件（RunwayLooks / StreetSnaps）同构，抽成 `src/styles/look-grid.css`（卡片/网格/分页/侧栏/spinner/骨架/动画）+ `src/lib/looks-grid.ts`（`SPIN_SVG`、`makeCardSlots(images,count,opts)`、`buildPageList(total,cur)`）；品牌筛选弹窗 `src/components/BrandModal.astro`（仅 RunwayLooks 用，`openBrandModal/confirmBrandModal` 等由页面脚本驱动）。卡片标记因在 Alpine `x-for` 内客户端渲染，**不能**提成 Astro 组件。
+
 ## 部署（Docker + Gitea Actions）
 - 交付文件：前端 Dockerfile / nginx.conf / docker-compose.yml / deploy.sh / .gitea/workflows/deploy.yml / .env.example / DEPLOY.md；后端 Dockerfile。nginx 拦截 `/api/v1/ssg/` 404；健康检查 `/api/v1/public/brands`。