全局美化 v1

2026-10-19 11:08:30 +08:00
parent b9a8afb2ec
commit d47329d505
27 changed files with 10220 additions and 219 deletions
@@ -79,6 +79,15 @@
  `ErrDeactivatedEmail/Domain`；封禁 = 物理删用户行，邮箱释放。级联删除一律 `Unscoped()`。
 - ⚠️ GORM 链式对象 Count/Find 后带状态，统计/预览/更新必须各自重建 query。

+## 前端样式
+
+- 全站**无 .css 文件**，样式内联在模板；设计令牌在 `base/header.html` 顶部 `<style>`：`:root`（亮）+ `html[data-theme="dark"]`（暗）。
+  新样式一律用 `var(--tb-*)`，别再写死色值/圆角/阴影，也别为深色另写一套分支。
+- 主题属性在 head 内联脚本里打（cookie `theme`），**不能挪回 body**，否则深色用户白闪。
+- 页面级样式尽量用类，不用 `style=`（深色下内联写死色值会露白，`.tb-img-uploader` 踩过）。
+- 视觉自检：`TEST_PREVIEW=1 go test ./templates -run TestGenPreview` → `outputs/preview-*.html`；
+  截图必须 `chrome --headless=old`（新版 headless 在本机挂住），外部资源先落到 `outputs/preview-assets/`。
+
 ## 其它约定

 - 校验靠 `valid:"required;maxlen:N"` 标签（`internal/form/*.go`），别在 handler 手写。