update

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

@@ -0,0 +1,43 @@
+# 2026-08-30 工作日志
+
+## 首页 Street Style 图片过大调整（11:33）
+- 用户反馈首页 Street Style 区块图片太大。定位到 `src/components/Index.astro` 的 `<style>`：
+  - `.ss-banner` 原 `aspect-ratio:16/9` + `w-full` → 桌面端整宽约 675px 高（巨型 hero）；
+  - `.ss-grid` 原仅 `sm:grid-cols-2` + `.ss-card` `aspect-ratio:3/4` → 桌面两列每张卡约 1000px 高，竖排 11 张占空间极大。
+- 调整（保守，不改图片比例、保持编辑风）：
+  - `.ss-banner` 加 `max-height: 440px;`（仅桌面端收窄 hero）。
+  - `.ss-grid` 改为 `grid-cols-1 sm:grid-cols-2 md:grid-cols-3`（中等屏起加第 3 列，单图立刻变小）。
+- 验证：`npm run build` BUILD_EXIT=0；read_lints Index.astro 0；dev 服务 http://localhost:4321 已起（HMR 生效）。
+- 待定：若用户仍嫌大，可进一步把 `.ss-card` 比例从 3/4 改为 4/5 或 1/1 直接缩高度。
+
+## Runway 头部下拉：方案 A 落地（16:26）
+- 用户拍板：header 的 Runway 下拉按「真实 collection_type」分 5 类（方案 A），不做婚纱等无数据类。
+- 关键发现：Layout.astro 早就有 `runways` 下拉数组，但里面 8 项全是占位垃圾（Spring/Summer 2026…Menswear FW25），且全指向死路由 `ROUTES.shows`(`/shows`)；下拉父链接 `<a>` 也错链到 `/shows`。
+- 改动：
+  - `src/i18n/dictionary.ts`：新增 5 个分类 cn 翻译（`ready-to-wear`→女装成衣、`menswear`→男装、`couture`→高级定制、`resort`→度假系列、`pre-fall`→早秋系列）。标签用 `t('Ready-to-Wear')` 等英文 key（英文环境回退显示英文，与列表页 COLLECTION 筛选项 label 一致）。
+  - `Layout.astro`：`runways` 数组换成 全部 + 5 类，href 用 `href(locale, ROUTES.runwayLooks) + '?collection=xxx'`；父链接 `ROUTES.shows`→`ROUTES.runwayLooks`（修死路由）。
+  - `RunwayLooks.astro`：`init()` 读 `URLSearchParams(window.location.search).get('collection')`，命中白名单(rtw/menswear/womenswear/couture/resort/pre_fall/bridal/swimwear)则赋值 `selectedCt`，从而深链自动选中筛选（复用现有 loadPage→getArticles({collection}) 链路）。
+- 关键事实：`getArticles`(api.ts) 把 `collection` 映射成后端查询参数 `?collection=`（不是 `collection_type`），故深链参数名用 `collection`。
+  - 验证：`npm run build` BUILD_EXIT=0；read_lints Layout/RunwayLooks 均 0。
+- 待用户预览确认；深链真实筛选需后端(:8090)在跑。
+
+## 街拍按地区分类（全链路，18:30 收尾）
+- 用户拍板「全链路做」：SQL 加 city 列 + 从 title/URL 回填 + 后端 city 筛选 + 前端 header 下拉 + 列表筛选。
+- 后端：model 加 `City` 字段；dto `StreetSnapQuery.City` + `Normalize`；repo `List` 加 `WHERE city = ?`（精确、大小写敏感）；handler `parseListQuery` 解析 `c.DefaultQuery("city","")`；SQL `scripts/sql/004_add_streetsnap_city.sql` + 幂等回填 `scripts/backfill_city/main.go`（首选 title 第一段 location 关键词匹配，兜底 URL slug）。
+- 前端：`Layout.astro` streets 下拉 18 城（全部 + Paris/New York/Milan/London/Copenhagen/Florence/Berlin/Tokyo/Seoul/Shanghai/Beijing/Rome/Madrid/Amsterdam/Antwerp/Los Angeles/Moscow/Mumbai），href 带 `?city=规范大写名`；`StreetSnaps.astro` 侧栏 City pills + `init()` 读 `?city` 深链自动选中；`api.ts.getStreetSnaps` 透传 `city`；`dictionary.ts` 有各城 cn 翻译（`t('Paris')` 经 `translate` 自动 `toLowerCase` 查到「巴黎」）。
+- 关键约定：**city 规范值首字母大写英文**（Paris / New York / Copenhagen…），前后端必须一致且大小写敏感。
+- DB+验证：dev 库 db_dev.street_snap 仅 12 行（Paris 8 / Copenhagen 4），其余城本地预览为空属预期（生产真实爬取数据才有完整覆盖）。重启后端 :8090 后 Node 直连验证：`?city=Paris`→8、`?city=Copenhagen`→4、`?city=London`→0、无参→12，全链路通过（client_sign 本地 enabled:false，无需签名）。
+- 复盘：标题实际格式为「Street Style 2027 Day 12」而非 `location\tseason\tevent`，city 由旧回填按 URL 预置；生产真实数据靠 title/URL 解析归类。dev 环境 `go run` 可正常编译（仅 `go build ./...` 全量链接会 OOM，非代码问题）。
+
+## Header 精简：移除死链 + street style 减为 3 下拉（18:57）
+- 用户要求：去掉 Latest Projects / About / Contact Us；street style 下拉只留三个。
+- 现状确认：`Layout.astro` 主导航早已无此三项（仅 Portfolio / Runway(下拉) / Street Style(下拉) / 语言 / Login / Signup）；`streets` 下拉当前已是 3 项（`全部 / Paris / New York`）。
+- 清理：`routes.ts` 删 `latestProjects`/`about`/`contact` 键；`dictionary.ts` 删 about/contact/latest projects 翻译键；全 src 搜索确认无 `latestProjects|about|contact` 残留引用。
+- 验证：`npm run build` exit 0（日志仅 npm warn 包装的 NativeCommandError，非构建错误）。
+
+## Header 下拉数量微调（19:00）
+- 用户：street style 下拉再加一个、runway 下拉去掉一个。
+- Street：加 **Milan** → `全部 / Paris / New York / Milan` = 4 项（时尚三都补齐；dictionary 已有 `milan→米兰`）。
+- Runway：去 **Pre-Fall**（早秋系列，过渡线、数据最少 2376 行），保留 `全部 / rtw / menswear / couture / resort` = 5 项。
+- 两个下拉均保留"全部"重置项（结构对称）；Runway 父链接仍指向无参列表。
+- 验证：待 build。

.workbuddy/memory/MEMORY.md

@@ -3,7 +3,9 @@
 ## 模块策略（重要）
 - 站点按模块逐个完善。当前上线「发布会模块」：首页 index + 走秀列表/详情（RunwayLooks = 走秀档案页，articles/shows 页面已在 i18n 重构中重组）。
 - **品牌索引页已下线**（2026-08-26 确认）：`src/pages/brands.astro` 及孤儿组件 `src/components/pages/brands.astro` 均已删除；品牌数据现在只通过走秀页侧栏 filter + 品牌弹窗呈现（热门 30 条走 SSG 接口，搜索/字母走运行时 `/api/v1/public/brands`）。
-- **占位模块组件已清理（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 组件已随清理删除。
+- **占位模块组件已清理（2026-08-29）**：`components/pages/` 下 `About`/`Contact`/`LatestProjects`/`Portfolio`/`Login`/`Register`/`AuthForm`/`article` 等占位/旧详情组件查无引用、也不是真实路由，已删除并移除空目录。
+- **导航死链清理（2026-08-30）**：用户决定移除 `/latest-projects`、`/about`、`/contact` 三个死链——已从 `Layout.astro` 主导航（早已不在）、`routes.ts`（`latestProjects`/`about`/`contact` 键）、`dictionary.ts`（about/contact/latest projects 翻译键）三处清除，全 src 扫描零残留引用。**剩余死链 `/portfolio`、`/login`、`/register` 保留未动**（Portfolio 导航项、Login/Signup 链接仍展示，用户未要求移除）。
+- **「header 别动」解读（2026-08-30 明确）**：用户「header 别动」指不要擅自改导航结构与视觉；但用户**主动批准**的导航调整（Runway 下拉改 5 个 collection 分类、Street Style 下拉减为 3 城、删除死链项）均属于已授权变更，不算违规。`/en/login`、`/en/register` 实际并非真实页面（旧 MEMORY 记录有误），AuthForm 组件已随清理删除。
 
 ## 架构总览
 - 前端：**d:/project/frontend_v2** — Astro SSG + Tailwind v4 + Alpine.js。`npm run build`（SSG 取数走 ssgRequest，失败回落空/假数据不影响构建）。
@@ -17,7 +19,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）保持原样未改动（用户「header 别动」），但其部分链接（/about /contact /portfolio /latest-projects /login /register）指向不存在的路由，属待清理死链。
+- 导航（Layout.astro）：「header 别动」指不擅自改结构/视觉，但用户**主动批准**的导航调整有效（Runway 下拉改 4 个 collection 分类 rtw/menswear/couture/resort、Street Style 下拉减为「全部/Paris/New York/Milan」4 项、移除 latest-projects/about/contact 死链）。剩余死链 /portfolio、/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`）。
@@ -30,9 +32,16 @@
 ## 走秀数据分类（brand_runway）
 - 三维分类字段：`collection_type`（rtw/menswear/couture/resort/pre_fall）、`season`（spring/fall/null）、`season_code`（SS26/FW25…派生）。靠 title 规则回填（幂等，25,206 行）。
 - 公开列表 `?collection_type=&season=&season_code=&year=` 筛选；前端走秀页有系列/季节/年份 chips。
-- 地理/城市维度：用户明确暂不做。
+- 地理/城市维度（runway）：用户明确暂不做。
 - 分布：rtw 15203 / menswear 4061 / couture 672 / resort 2894 / pre_fall 2376。
 
+## 街拍地区分类（street_snap.city，2026-08-30）
+- 全链路已落地：DB 加 `city` 列（VARCHAR(128)，脚本 `scripts/sql/004_add_streetsnap_city.sql` + 幂等回填 `scripts/backfill_city/main.go`，无 AutoMigrate）+ 后端 `StreetSnapQuery.City` 精确匹配 `WHERE city = ?` + 前端 header 下拉 `?city=` + 列表侧栏 City pills + 深链自动选中。
+- **规范值约定（重要）**：city 列存「首字母大写英文规范名」（Paris / New York / Copenhagen …），前端 header 下拉与列表 `cityOptions` 的 value 用**同一大写值**，后端做精确匹配、大小写敏感，必须前后一致。backfill 首选从 title 第一段（location，`\t` 分隔）按城市关键词匹配，兜底从 source_url/cover 的 URL slug 解析。
+- 前端 `t('Paris')` 经 `translate()` 自动 `key.toLowerCase()` 查字典，中文回落「巴黎」，i18n 正常。
+- dev 库 db_dev.street_snap 仅 12 行样本（Paris 8 / Copenhagen 4），其余下拉城市（London/Milan…）本地预览为空属预期；生产真实爬取数据才有完整覆盖。
+- 验证：重启后端 :8090 后，`?city=Paris`→8、`?city=Copenhagen`→4、`?city=London`→0、无参→12，全链路通过。client_sign 本地 `enabled:false`，可直接 curl/Node 验证。
+
 ## 前端组件复用（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 组件。