47 lines
6.3 KiB
Markdown
47 lines
6.3 KiB
Markdown
# 项目长期记忆（Project MEMORY.md）
|
||
|
||
## 模块策略（重要）
|
||
- 站点按模块逐个完善。当前只上线「发布会模块」：首页 index + 品牌索引 brands + 走秀列表 articles + 走秀详情 article。
|
||
- **所有走秀页 `/shows`**（新建 2026-08-08）：全局走秀档案（区别于 `/articles` 的品牌档案视图 ?brand_id）。基于 articles.astro，标题「All Runway」，保留系列/季节/品牌筛选 + 三视图(Grid/Magazine/Timeline)，新增分页 Load More（page/total/busy，append 模式，后端 `?page=&size=30&with_images=5`）。首页 sec-more「全部走秀 →」指向 /shows。
|
||
- 其余模块(Portfolio / Latest Projects / About / Contact / 登录注册)为「暂未上线」占位页：直接访问旧 URL 或点击导航旧链接均渲染 ComingSoon 占位；**导航(header)保持原样未改动**（用户 2026-08-07 明确「header 别动」），门禁完全靠占位页实现。
|
||
- **首页 tabbar**（index.astro, id="tabbar"）：仅「发布会(backstage)」上线（默认激活 + Live 徽标，承载 getShows(8) SSR 真实卡片）；「灵感(shows)/社媒(events)/街拍(street)」标 `data-soon="true"` + Soon 灰徽标，点击仅显示 ComingSoon 占位、不再请求后端；「品牌」tab 仍为指向 /brands 的有效链接（属已上线模块，未屏蔽）。
|
||
- 占位实现：src/components/ComingSoon.astro（编辑风，props: module / moduleZh / note；两个按钮「浏览走秀档案 →」「返回首页」）。6 个页面(portfolio / latest-projects / about / contact / login / register)改为 `<Layout><ComingSoon/></Layout>`。
|
||
- login/register 原 standalone 页（未 import global.css、字体变量未定义），已改为套 Layout + ComingSoon 占位页，顺带修复字体一致性；导航中 Login/Signup 链接保留，点击即见占位。
|
||
|
||
## 架构总览
|
||
- 前端：/d/project/test/test — Astro SSG + Tailwind v4。构建 `PUBLIC_API_BASE=http://localhost:8090 npm run build`；预览 `python -m http.server` 托管 dist/。
|
||
- 后端：/d/project/admin/backend — Go + Gin + GORM(MySQL)，:8090。路由分后台 /api/* 与公开只读 /api/public/*。
|
||
- 数据层：前端 src/lib/data.ts 统一从 /api/public/* 拉数据；后端不可达时回落内置示例。
|
||
|
||
## 关键约定
|
||
- 视觉语言：黑白极简编辑风（monospace + Georgia 衬线大标题 + 细线），HBX / 时尚档案调性。
|
||
- 字体：全站走 Tailwind 体系（font-sans / font-mono / font-serif），禁止自写截断字体栈。新增页面复用项目字体变量。
|
||
- CSS 写法：能用 @apply 就 @apply；`<style>` 顶部加 `@reference "tailwindcss";`。仅保留手写：@keyframes、渐变 shimmer、!important、双时长 transition。Tailwind v4 已移除零值类（mt-0 等），零值边距保持手写。
|
||
- 导航（Layout.astro）：**保持原样未改动**（Portfolio / Latest Projects / About / Contact / Login / Signup），含页脚 Categories + Color Studio Tools + About/Contact 链接。门禁仅由 6 个 ComingSoon 占位页承担，导航不删任何链接（用户要求 header 别动）。
|
||
|
||
## Layout 陷阱（重要，2026-08-12 踩坑）
|
||
- **Layout.astro** 把 `<slot />` 包裹在 `<div class="flex-1 flex flex-col">`（flex column 容器）。
|
||
- **禁用 `m-auto`** 作为页内根容器（`<div class="xxx m-auto">`）：它在 flex column 容器中作为 flex item 的 cross-axis `margin: auto`，会触发 **shrink-to-fit**（content 决定宽度），导致：
|
||
- 内容空/少时根容器收缩到极窄（骨架 24 张空 div → .showsroot 仅 626px / 主区 350px / 卡片 164px）。
|
||
- 内容多时根容器被撑大（真实卡片有 img/文字 → 1042px 「看起来正常」）。
|
||
- 同页面在不同内容状态下宽度剧烈变化 = 抖动。
|
||
- **正确做法**：用 `w-full`（强制 100% 父容器，常配 `max-w-[xxx]`），或 `w-full mx-auto`（保留大屏居中）。
|
||
- 适用范围：所有 Layout 内的页内根容器（包括 showsroot / blogs / about 等），**避免 `m-auto` 单独使用**。
|
||
|
||
## 部署（Docker + Gitea Actions）
|
||
- 仅 brands.astro 构建期 SSR 取数（用 API_SSR）；其余页面运行时相对 /api 拉取（nginx 反代 backend:8090）。
|
||
- 交付文件：前端 Dockerfile / nginx.conf / docker-compose.yml / deploy.sh / .gitea/workflows/deploy.yml / .env.example / DEPLOY.md；后端 Dockerfile。
|
||
|
||
## 走秀数据分类（brand_runway，已实现 2026-08-08）
|
||
- **三维分类字段**（已加，靠 title 解析回填，无需外部数据）：
|
||
- `collection_type`：rtw / menswear / couture / resort / pre_fall
|
||
- `season`：spring / fall / null（Resort/Pre-Fall 为单季，season=null）
|
||
- `season_code`：SS26 / FW25 / RES26 / PF25（派生，用于排序/展示）
|
||
- **回填**：main.go `backfillRunwayClassification()` 单条 `UPDATE ... CASE` 解析 title（Vogue 格式 `Spring/Fall 2016 Ready-to-Wear`、`Pre-Fall 2016`、`Resort 2017`、`Fall 2016 Couture`、`Spring 2005 Menswear`），仅处理 `collection_type=''` 行（幂等）。实测 25,206 行 ~338ms 完成。
|
||
- **接口筛选**：`GET /api/public/articles` 新增 `?collection_type=&season=&season_code=&year=`，响应含三字段。
|
||
- **前端筛选**：articles.astro 增加「系列类型 / 季节」两组 chips（`#typefilter` / `#seasonfilter`），点击经 `loadBackend()` 带参重拉。
|
||
- **首页 feat 改竖版编辑拼图**（index.astro, 2026-08-08）：原 4:3 横图 hero 改为「左侧大竖图(feat-main, aspect 3/4) + 右侧 3 张竖版 rail(feat-rail-item, grid-rows-3)」，**用同一场秀自己的 gallery(最多5张)做多图拼图**（避免横图裁切竖版），保留系列/季节 chip（feat-fill 渐变浮层）。`feat` 整块带 `data-ct` 供系列筛选隐藏。
|
||
- **首页「查看更多」内联加载**（index.astro, 2026-08-08）：网格下加 `#showmore` 按钮，JS 分页 `fetch ?page=2..&size=8&with_images=5` 追加到 `#showgrid`，带 `homeFType` 系列筛选参数；无更多显示「没有更多了」。系列筛选 IIFE 重构为 `seriesApply()` 暴露 `homeFType`。
|
||
- **地理/城市维度：用户明确暂不做**（爬 Vogue 页不可靠；城市方案后续可用「品牌→所属时装周城市」映射表，Resort/Pre-Fall 归巡演桶）。
|
||
- 分布实测：rtw 15203 / menswear 4061 / couture 672 / resort 2894 / pre_fall 2376；spring 9140 / fall 9049。
|