# 项目长期记忆（Project MEMORY.md） ## 架构总览 - 前端 `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，nginx 不反代）。 - 接口 i18n：后端按 `?locale=cn|en` 选列；前端取数复用带 locale 原语（request/ssgRequest），**绝不裸写 fetch**；语言以 URL 前缀为准。 - **后端编译产物坑（Windows）**：`go build -o server-bin ./cmd/server` 实际产出无扩展名 `server-bin`，但运行的是 `server-bin.exe`（旧）。必须 `go build -o server-bin.exe` 显式覆盖 `.exe`，再 `Start-Process server-bin.exe`；杀进程用 `(Get-NetTCPConnection -LocalPort 8090).OwningProcess` 拿 PID。本地后端长时间空闲后报 `invalid connection` 先重启后端（连接池 `conn_max_idle_time` 已设，须 < MySQL wait_timeout）。 - 前端 dev server **不热加载 `.env`**：改 BASE_API 后需 `astro dev stop`+`astro dev --background` 重启；浏览器旧 bundle 需硬刷新、旧 token 失效需重登录。 ## 关键约定 - 视觉：黑白极简编辑风（monospace 小标签 + Georgia 衬线大标题 + 细线），HBX/时尚档案调性。**纯黑白，禁用暖米色/柔和阴影**；字体全走 Tailwind 体系。 - 品牌名前端只显英文（`display=nameEn`）；走秀标题/描述按 locale 选列。 - API 命名：一个功能一个接口，跨资源/独立功能独立路径（如 `brands/hot` 而非 `?featured=1`）。 - CSS：能 @apply 就 @apply；`