# 项目长期记忆（Project MEMORY.md） ## 模块策略 - 站点按模块逐个完善，当前主线为「发布会模块」：首页 index + 走秀档案（RunwayLooks）+ 街拍（StreetSnaps）。 - 品牌索引页已下线（2026-08-26）：`brands.astro` 与孤儿组件已删；品牌仅经走秀页侧栏 filter + 品牌弹窗呈现（热门 30 走 SSG，搜索/字母走运行时 `/api/v1/public/brands`）。 - 导航死链清理（2026-08-30）：删 `/latest-projects`、`/about`、`/contact` 三处（Layout/routes/dictionary 三处同步清）。**保留未动的死链**：`/portfolio`、`/login`、`/register`（用户未要求动）。 - 「header 别动」= 不擅自改导航结构/视觉；但用户主动批准的调整（Runway 下拉分类、Street Style 减城、删死链）均属已授权，不算违规。 ## 架构总览 - 前端：`d:/project/frontend_v2` — Astro SSG + Tailwind v4 + Alpine.js。构建 `npm run build`（SSG 取数走 ssgRequest，失败回落空/假数据不影响构建）。 - 后端：`d:/project/backend_v2` — Go + Gin + GORM(MySQL)。公开引擎 :8090（`/api/v1/public/*`、`/api/v1/auth/*`）；SSG 引擎 :8091（仅 127.0.0.1，`/api/v1/ssg/*`，SSGToken 中间件，nginx 不反代）。 - SSG 端点仅剩：`/api/v1/ssg/index/runway`（首页 runway 区块）与 `/api/v1/ssg/brands/hot`（走秀页热门品牌，固定 30 条）。 - 接口 i18n：后端按 `?locale=cn|en` 选列（pickLocale 缺翻译回落另一语言）；前端取数统一复用带 locale 原语（request/ssgRequest），**绝不裸写 fetch**；语言以 URL 前缀为准。 - 走秀标题 `title_cn` 已规则回填（幂等）；`description_cn` 空白属预期（中文页回落英文）。 - 后端连接池：已设 `conn_max_idle_time`（config.yml 默认 60s，须 < MySQL wait_timeout）主动回收空闲连接，避免空闲连接被 MySQL 回收后池子持死连接报 `invalid connection`。**本地后端若长时间空闲后接口报 invalid connection，先重启后端**（`cd d:/project/backend_v2 && go build -o server-bin ./cmd/server` 后杀旧进程重启）。 - 前端 dev server **不热加载 `.env`**：改 `BASE_API` 后必须 `astro dev stop` + `astro dev --background` 重启才生效。浏览器旧 bundle 仍用旧 `BASE_API`，需**硬刷新**（Ctrl+Shift+R）；旧 token 对新后端无效，需**重新登录**。改 BASE_API 指向本地/线上后端后，若历史/收藏/登录"没反应"，先查 dev server 是否重启、浏览器是否硬刷新+重登录。 ## 关键约定 - 视觉语言：黑白极简编辑风（monospace 小标签 + Georgia 衬线大标题 + 细线），HBX / 时尚档案调性。**纯黑白，禁用暖米色/柔和阴影**；字体全走 Tailwind 体系，禁止自写字体栈。 - 品牌名前端一律只显示英文（`display = nameEn`）；走秀标题/描述仍按 locale 选列。 - API 命名哲学（用户原则）：「一个功能一个接口」，查询参数仅限同资源列表筛选/分页；跨资源/独立功能一律独立路径（如 `brands/hot` 而非 `?featured=1`）。 - CSS：能 @apply 就 @apply；`