MetaZone/mce
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
233 Commits 1 Branch 0 Tags
b997528badf61e272a1331707df04ab1ec4e7c61
Commit Graph

83 Commits

Author SHA1 Message Date
Victor_Jay
55c408d86c fix: 审计问题全量修复 + RateLimiter 原子化重构 + CDN 本地化收紧 
- 安全：移除 CSP 中 esm.sh/cdnjs.cloudflare.com，highlight.js 主题已本地化 73 个文件
- 安全：StatusBanned 分支补 dummy hash 防时序攻击
- 安全：手写 constantTimeEq 替换为 crypto/subtle.ConstantTimeCompare
- Bug：锁定操作消息已删除→已锁定
- YAGNI：删除 12 个空预留模板目录
- KISS：删除 common.CheckPassword 薄封装，统一用 bcrypt 调用
- KISS：删除 tokenCtrl 别名字段，api.go 统一用 authCtrl
- RateLimiter：check()+recordFail 闭包模式重构为 try() 原子操作，消除竞态
- RateLimiter：新增 ClearIP() 方法，注册成功时清除 IP 计数
- 文档：修正 audit_service.go 注释编号跳跃(3→5→4)
- 文档：修正 deps_core.go 过清理→过期清理
 2026-05-31 11:13:32 +08:00
Victor_Jay
4887093c3a feat: 头像上传选区限制 3840×3840 + 客户端裁剪压缩 
- 后端：3840×2160 限制改为 3840×3840（方形限制适应方形裁剪），并移到裁剪结果上检查而非原图
- 前端：原图短边超过 3840 时自动抬高最小缩放，确保选区永不超过 3840×3840
- 前端：裁剪确认后用 Canvas 预裁剪 + JPEG 压缩再上传，大幅节省带宽
- 前端：裁剪框标题栏新增实时像素尺寸提示
- 新增 .crop-info 样式
 2026-05-31 02:42:27 +08:00
Victor_Jay
e3853071d6 chore: 清理 JWT 向后兼容残留，移除全部死代码 
- 删除 5 个空壳占位文件：auth_token.go/auth_parser.go/repository.go(middleware)/token_service.go/provider.go
- 移除 Config.JWT 字段、JWTConfig 结构体、JWT_SECRET 环境变量绑定
- 移除 config.yaml 中的 jwt 配置段
- 移除 model.User.TokenVersion 字段（session DestroyByUID 替代）
- 移除 service/repository.go 中已废弃的 userTokenStore 接口
 2026-05-30 23:42:27 +08:00
Victor_Jay
d9ba1cdf28 refactor: 移除 Session 架构下已无用的 TokenVersion 即时吊销机制 
- 删除 UserRepo.IncrementTokenVersion/FindTokenVersion 方法
- 从 userAuthStore/userAdminStore 接口移除 IncrementTokenVersion
- 删除 middleware.tokenVersionStore 接口（中间件不再查询 token_version）
- auth_service: DeleteAccount/InvalidateSessions 仅调用 DestroyByUID
- admin_service: UpdateUserStatus/ResetUserToken 仅调用 DestroyByUID
- FindByIDForAuth/FindByIDUnscoped Select 移除 token_version 列
- 新架构下登出/改密/封禁统一走 sessionManager.DestroyByUID，无需 token_version
 2026-05-30 23:38:42 +08:00
Victor_Jay
daf87f895b refactor: JWT 无状态认证替换为服务端 Session，修复记住我掉线问题 
- 新增 internal/session 包：Session 结构体、Store 接口、MemoryStore（内存+后台清理）、RedisStore 预留
- Cookie 从 3 个精简为 1 个 mlb_sid（HttpOnly），移除 JWT access/refresh cookie
- 会话过期采用滑动窗口：每次请求自动续期，记住我 30 天无操作过期
- AuthMiddleware/AuthAdmin/Maintenance 中间件改用 SessionManager.Validate()
- AuthService Login/Register/ConfirmRestore 去除 token 生成，返回 *model.User
- Controller 层在登录/注册后调用 SessionManager.Create 创建会话
- AdminService UpdateUserStatus/ResetUserToken 同步销毁 session 实现即时退登
- 改密/注销时通过 DestroyByUID 删除所有 session（替换 TokenVersion 检查）
- config.yaml 新增 session 配置段（idle_timeout/remember_timeout/cleanup_interval）
- TokenService/auth_parser/auth_token 标记废弃，移除 JWT 到期字段依赖
 2026-05-30 23:36:52 +08:00
Victor_Jay
67444434b9 feat: 对接稿件审核通知系统 + 消息页面系统消息区域 
- 新增通知类型 post_approved / post_rejected
- PostService.Approve/Reject 完成后通知作者（通知失败不影响主流程）
- NotificationService 新增 NotifyPostApproved/NotifyPostRejected 方法
- 消息页面顶部增加系统消息标识和分隔线，之下为全部消息列表
- 稿件审核通过通知卡片点击跳转到 /posts/{id} 页面
- 稿件审核拒绝通知卡片点击跳转到 /studio/posts 创作中心
- 新增 postNotifier 接口遵循 ISP 原则
 2026-05-30 21:24:30 +08:00
Victor_Jay
fb94ce60ae fix: 维护期间登录一律返回统一提示，不泄露账号状态 
- 维护检查提前到 FindByEmail 之后、所有状态检查之前
- 非站长账号（不存在/已封禁/已锁定等）统一走模拟 bcrypt 防时序 → 返回维护提示
- 站长角色正常通过，走完整登录流程
- 旧实现：维护检查在 banned/locked/deleted 之后，会泄露账号状态
 2026-05-30 21:10:41 +08:00
Victor_Jay
6229c81f6e feat: 新增维护模式 + 修复注册关闭页面标题显示问题 
- 修复注册关闭时标题“创建账号”和副标题仍显示的问题，三态互斥（维护中 > 关闭注册 > 正常）
- 新增 maintenance.enabled 站点设置，默认关闭，仅 Owner 可见可调节
- 维护中间件：全局拦截，维护期间仅站长可访问，白名单放行登录相关路径
- 登录服务：维护期间仅 Owner 角色可登录，Register 优先检查维护状态
- Nav 模板新增维护通知条（黄色横幅）
- 管理后台站点设置新增“启用维护模式”开关
- BuildPageData 自动注入 IsMaintenance 到所有页面模板
 2026-05-30 20:54:23 +08:00
Victor_Jay
fb2eff5f23 feat: 注册关闭时页面隐藏表单并显示友好提示，保留登录入口 
- RegisterPage 传入 RegistrationEnabled 标志到模板
- 注册关闭时隐藏输入框和按钮，显示“当前暂不开放注册”提示
- 保留“已有账号？立即登录”链接
- API 层已有拦截（AuthService.Register 返回 403），无需修改
- authUseCase 接口新增 IsRegistrationEnabled 方法（ISP）
 2026-05-30 20:38:55 +08:00
Victor_Jay
eabc1e7d3d feat: 已发布帖子编辑后进修订审核，通过前保持展示旧内容 
- Post 模型新增 PendingTitle/PendingBody 字段，分离已发布内容与待审修订
- Update: approved 帖子编辑写入 Pending 字段，不覆盖正文，不改变发布状态
- Approve: 有 PendingBody 时复制到正式字段后清空，无 PendingBody 走首次审核
- Reject: 有 PendingBody 时仅清空待审修订（保持已发布），无 PendingBody 走普通退回
- 新增 ListPendingRevisions 查询，管理后台独立展示"修订待审核"区域
- 详情页展示"修订审核中"标识，编辑页加载待审内容
- 通过修订后直接覆盖，不保留历史版本
 2026-05-30 20:24:43 +08:00
Victor_Jay
89fa50a013 fix: 锁定机制不再改变帖子状态，锁定与退回独立 
- Post 模型新增 IsLocked 字段，与 Status 解耦
- Lock 仅设 IsLocked=true（不改 Status），已通过帖子锁定后仍公开可见
- Unlock 仅设 IsLocked=false（不改 Status）
- Update/EditPage 编辑检查改用 IsLocked 而非 Status==locked
- Reject 与 Lock 独立，可单独退回或锁定+退回组合使用
- 新增 ErrPostCannotLock 错误哨兵
- 前端模板编辑按钮/锁定标识基于 IsLocked 渲染
 2026-05-30 20:08:41 +08:00
Victor_Jay
7659aee468 feat: 新增创作中心（/studio），支持数据概览、内容管理、草稿箱、写文章 
- 新增 StudioController，依赖 studioUseCase 接口，遵循 ISP 接口隔离
- PostRepo 新增 FindByUserIDAndStatus 方法，按用户+状态分页查询
- PostService 新增 ListByUser、GetOverview 及 StudioOverview 统计
- /studio 页面路由（概览/管理/草稿箱/写文章/数据分析）+ /api/studio API
- 复用 Vditor 编辑器，studio-editor.js 对接 /api/studio/posts 端点
- 新增 studio.css（B站风格三栏布局+统计卡片+状态筛选tabs）
- 模板引擎注册 add/subtract 函数，分页模板中直接使用
 2026-05-30 19:55:29 +08:00
Victor_Jay
bacfd4945d feat: 编辑器与帖子展示布局优化 + 新增个人空间 
- 编辑器投稿页布局优化：标题与编辑器高度动态适配，工具栏与内容区视觉对齐
- 稿件展示页布局优化：MD 渲染区与评论区视觉分离，代码块主题微调
- CSRF 中间件：图像上传端点豁免，解决 Vditor 拖拽/粘贴上传 403
- Post 状态映射、GetGinUser、SaveUploadedFile 提取至 common 包，遵循审计建议
- 新增个人空间功能：/space（需登录）重定向到 /space/:uid，/space/:uid 公开访问
- 空间页模板：参考 B 站布局，展示头像、用户名、个性签名、UID、加入时间及稿件列表
- 导航栏：用户名链接指向 /space，新增「设置」入口
- 分层实现：SpaceController → SpaceService → PostRepo.FindByUserID，严格 ISP 接口隔离
 2026-05-30 19:06:10 +08:00
Victor_Jay
6ec12010f3 feat: Tiptap替换为Vditor + MD存储重构 + Shortcode卡片扩展 
- 编辑器：Tiptap 替换为 Vditor 3.11.2（wysiwyg 模式，本地托管 5.8MB，去 CDN）
- 存储：Body 字段从 HTML 改为 Markdown，去除 BodyHTML，新增 Excerpt 列表摘要
- 安全：去除 bluemonday 依赖（MD 纯文本无 XSS 风险），go.mod 已清理
- Shortcode：新增 [zone:type:params] 扩展语法，支持活动/游戏/投票/资源卡片
- 图片上传：POST /api/posts/upload-image 直接返回 Vditor 原生响应格式
- 草稿：localStorage 键名改为 draft_post_body_md，与旧 HTML 草稿隔离
- 详情页：Vditor.method.min.js 客户端 MD → HTML 渲染，去 highlight.js CDN
- 样式：去 Tiptap 样式 ~190 行，精简工具栏 CSS，新增卡片样式
- 文档：vditor-migration-plan.md 完整记录迁移决策、架构、用法
 2026-05-30 15:56:22 +08:00
Victor_Jay
fe81c879b0 fix: 修复代码块语法高亮丢失 + 语言标签注入 + 安全性增强 
- 新增 cdnjs.cloudflare.com CSP 白名单，允许加载 highlight.js
- 消毒策略放行 span 元素，保留 highlight.js 高亮 class
- 详情页和新帖子页引入 highlight.js 库和 GitHub 主题
- 代码块语言选择器默认 text，支持 prev/next 循环切换语言
- 代码块语言标签注入兼容 data-language 和 code class 双来源
- 修复 utils.js defer 导致 common.js 执行时 getCSRFToken 未定义
 2026-05-28 15:21:44 +08:00
Victor_Jay
e45d66fb77 fix: 修复帖子相关逻辑的严重安全与错误处理问题 
- 修复 Service 层所有 FindByID 错误均返回 ErrUserNotFound 的严重 bug，新增 findPost/findPostWithAuthor 正确区分 gorm.ErrRecordNotFound 和数据库错误
- 新增帖子相关错误哨兵：ErrPostNotFound/ErrPostCannotEdit/ErrPostCannotSubmit/ErrPostCannotApprove/ErrPostCannotReject/ErrPostCannotUnlock
- 修复 ShowAPI 缺少权限控制，非 approved 帖子可被任意用户通过 API 获取
- 修复 EditPage 缺少权限检查，非作者可访问编辑页面
- 修复 Update/Delete API 中 uid 断言未做 ok 检查
- Controller 层区分业务错误和内部错误，避免透传 Service 层错误信息给客户端
- 将 postStore 接口从 post_service.go 移至 repository.go，与其他仓储接口保持一致
- 移除 new.html 中孤立的 </template> 标签
 2026-05-28 14:44:22 +08:00
Victor_Jay
36b18c0ffe feat: 代码块语法高亮 + 语言选择 + 样式统一 
- 引入 @tiptap/extension-code-block-lowlight + lowlight 实现代码语法高亮
- 工具栏新增语言下拉选择器，光标在代码块内时显示，支持 27 种常用语言
- 默认语言 text，高亮主题适配 MetaLab 深蓝背景 (#1a2332)
- 代码块语言标签用 JS 动态注入 DOM 元素（避免 ::before 在 overflow 容器中失效）
- 详情页同步代码块高亮和语言标签显示
- 编辑器与详情页样式统一：代码块暗色背景、引用蓝色边框、链接 accent 蓝
- sanitizePolicy 放行 data-language 属性和 hljs-* class
- 修复 import map 避免 keyed plugin 重复实例
- 修复详情页代码块开头空白行（移除多余的 padding-top）
- 修复语法错误（多余的闭合括号）
 2026-05-28 14:34:58 +08:00
Victor_Jay
69ba2fb01b refactor: ByteMD 迁移至 Tiptap WYSIWYG 编辑器 + Token 刷新优化 
- 移除 ByteMD CDN 资源和 goldmark 依赖，替换为 Tiptap ESM 模块
- 编辑器从源码编辑模式改为 WYSIWYG 所见即所得
- 移除 /api/posts/preview 预览接口（Tiptap 直接输出 HTML 无需后端渲染）
- 保留 UploadImage 图片上传接口和 bluemonday HTML 消毒
- 工具栏支持加粗、斜体、删除线、代码、标题、列表、引用、代码块、分割线、撤销/重做
- 支持图片粘贴/拖拽上传，Ctrl+S 快捷提交，F11 全屏，字数统计
- 优化 common.js：自动 401 拦截 Token 刷新，修复刷新死循环
- 草稿 localStorage 键名更新为 draft_post_body_html
 2026-05-28 11:21:53 +08:00
Victor_Jay
22a302315a feat: wangEditor 替换为 ByteMD Markdown 编辑器 
- 移除 wangEditor 5 库文件（1.27MB JS + 14KB CSS，含手动 hack）
- 集成 ByteMD 1.22.0（基于 CodeMirror 5，不依赖 contentEditable）
- 编辑器输出 Markdown 原文，后端 goldmark + bluemonday 双重防护渲染 HTML
- 删除 editor.js 中 scrollIntoView hack、code-lang-label DOM 注入、PreviewAPI 调用
- 清理 posts.css 中 ~200 行 wangEditor 样式覆盖（w-e-* 类名）
- 清理 show.html 中 code-lang-label JS 注入（goldmark 自带 language-xxx class）
- 更新 CSP 安全策略：移除 CodeMirror 注释，保留 esm.sh CDN
- go.mod：bluemonday 和 goldmark 均保留为直接依赖（纵深防御）
 2026-05-28 02:16:50 +08:00
Victor_Jay
2917562bf0 fix: 修复编辑器代码块样式不一致 + 提交 HTML 保留格式 + 详情页布局优化 
- 编辑器 pre code 移除 wangEditor 内置 border，与预览区样式统一
- 代码块语言标签 padding 加大并用 !important 对抗 wangEditor 全局重置
- 编辑器 ::before 伪元素仅作降级方案，避免与 JS 注入的 .code-lang-label 冲突
- 编辑器 pre padding-top 统一为 36px，font-size/line-height 对齐预览区
- 提交改用 editor.getHtml()，后端 sanitizeHTML 替代 renderMarkdown，保留富文本格式
- 详情页 post-detail-header 覆盖 common.css sticky，固定在文章卡片内
- 详情页增加白色卡片背景、圆角、阴影和内边距
- 详情页添加代码块语言标签 JS 注入
- 详情页用户名移除括号 UID 显示，移除管理按钮
 2026-05-28 00:53:02 +08:00
Victor_Jay
8a8d801187 fix: 修复帖子系统5项缺陷 + 代码块插入位置/language-class/分割线占位 
- 作者显示 用户名(UID): 修正Post.AuthorName GORM标签从 -:all 改为 -:migration;<-:false;column:author_name
- 审核流程: 帖子详情页新增"提交审核"按钮(draft/rejected时作者可见)
- 图片上传: 新增 POST /api/posts/upload-image 端点,限制5MB/jpg/png/gif/webp
- 代码块语言标注: 工具栏插入代码块时弹出语言输入框,生成 language-xxx class
- 状态中文显示: 管理后台/帖子详情页状态改为 PostStatusDisplayNames 映射
- 修复代码块插入位置错误: init时调用switchMode同步DOM; 无选区时appendChild; 防<pre>嵌套
- 修复 bluemonday.UGCPolicy() 剥离 code/pre 的 class 属性,显式 AllowAttrs("class")
- 修复分割线工具栏插入多余text占位符: hr/link/image以外不强制填占位文本
 2026-05-27 19:22:47 +08:00
Victor_Jay
1830f10e24 fix: 修复 WYSIWYG 清空内容 + 分屏工具栏 + XSS 防御(bulemondy消毒) 2026-05-27 18:45:15 +08:00
Victor_Jay
03a01a09be feat: 实现内容系统 MVC（Post CRUD + 审核流转） 
按 content-system.md 设计文档，实现帖子内容系统的最小可行 MVC。

新增：
- Model: Post 模型，含 5 种状态（draft/pending/approved/rejected/locked）
- Repository: post_repo.go，分页查询（前台 approved 列表 + 后台全状态筛选）
- Service: post_service.go，核心业务逻辑（状态流转、Markdown 渲染 Goldmark）
- Controller: post_controller + admin_post_controller，SSR 页面 6 个 + API 13 个
- Template: 列表/详情/编辑器/404 + 管理员列表，各配 CSS/JS
- 路由: /posts, /posts/:id, /posts/new, /posts/:id/edit, REST API, Admin API
- gomod: + github.com/yuin/goldmark v1.8.2

修改：
- Main: AutoMigrate Post 表
- Router: deps 注册 PostService/Controller，路由注册
- Nav: 新增“帖子”导航链接
- Admin Sidebar: 新增“内容管理”入口

设计：
- 审核开关复用 audit.enabled，开启时帖子为 draft，关闭后直接 approved
- 仅 approved 公开可见，作者/admin 可预览非公开状态帖子
- 严格分层 ISP 接口: Controller → postUseCase, Service → postStore, Repo → *PostRepo
- 状态保护: pending/locked 禁止编辑，rejected 编辑后自动重置为 draft
 2026-05-27 18:22:48 +08:00
Victor_Jay
0b948cf70f feat(admin): 站点信息 + 注册开关可后台设置，模板动态渲染 
新增 4 项可配置站点设置（DB持久化+内存缓存，即时生效）：
- site.brand          品牌名（页面标题/页脚/管理面板，默认 MetaLab）
- site.framework      框架名（页脚标识，默认 MetaZone）
- site.copyright_start 版权起始年（页脚，默认 2024）
- registration.enabled 注册开关（关闭后禁止新用户注册，默认 true）

实现方式：
- InjectSiteInfo 中间件：全局注入 Brand/Framework/CopyrightStart 到 gin.Context
- BuildPageData 读取 context，所有 SSR 页面自动获取站点信息
- AuthService.Register 最先检查 IsRegistrationEnabled()
- 管理后台新增「基本设置」+「注册设置」区块，文本输入手动保存 + Toggle 即时生效
 2026-05-27 15:12:28 +08:00
Victor_Jay
0cc903b44a refactor: 修复DRY分页 + LoD违规(RefreshToken业务逻辑下沉) 
- audit_service.List()使用common.Pagination替代手动分页计算
- RefreshToken封禁状态检查从控制器移至TokenService.RefreshAccessToken
- 消除控制器层业务逻辑，符合瘦控制器铁律
 2026-05-27 13:53:51 +08:00
Victor_Jay
f26da8f06e refactor: 清理死代码 + 修复ISP接口注释 
- 移除未使用的DTO类型(ChangePasswordRequest/DeleteAccountRequest)
- 移除service层未引用的错误重导出(auth_service/audit_service)
- 删除未使用的SiteSettingRepo(数据访问由config.SiteSettings直接处理)
- 删除未使用的FindByStatus方法(user_repo)
- 删除未使用的AutoMigrate方法(audit_repo/notification_repo)
- 删除未使用的PaginatedResult/NewPaginatedResult(pagination.go)
- 修复接口注释：notifProvider(5→4)、auditUseCase(4→3)、siteSettingUseCase(3→4)
- 移除auditStatusProvider未使用的FindByUsername方法
- 统一使用common.ErrXxx直接引用，消除跨service错误重导出耦合
 2026-05-27 13:52:42 +08:00
Victor_Jay
0800ee2f3e feat: 消息通知中心 + 账号安全体系 + Bug修复 
## 新增功能

### 消息通知中心 (全新模块)
- 新增 MessageController / NotificationService / NotificationRepo
- SSR 消息页面 (/messages)：左侧边栏 + 右侧卡片列表，noindex 元标签
- 通知能力：列表分页、单条标为已读、一键全部标为已读
- 未读数角标 (1/66/99+)：侧边栏 + 导航栏铃铛图标
- 导航栏轮询 /api/messages/unread 每 60 秒刷新未读数
- 审核通过/驳回时自动 fire-and-forget 推送通知

### 密码修改
- ChangePassword：验证当前密码 → 新密码强度校验(8位+字母+数字) → 哈希更新
- 修改后递增 token_version 强制所有设备退登

### 账号自助注销
- DeleteAccount：验证密码 → 设置 deleted 状态 → 记录原因 → 吊销 JWT
- 注销后登录二次确认：Login 检测 deleted → 返回 confirm_restore
- ConfirmRestore 恢复账号，重新签发 token
- 注销页文案："账号将在 7 天后正式注销，期间可随时重新登录恢复"

### IP 审计记录
- 注册时记录 RegIP，登录时记录 LastLoginIP + LastLoginAt
- clientIP() 支持 X-Forwarded-For / X-Real-IP 反向代理

### 安全加固
- Login 防时序攻击：用户不存在时仍执行完整 bcrypt 比对
- FindByEmail 改用 Unscoped() 覆盖软删除用户
- 站长 (owner) 不允许自主注销，避免权限体系死锁

## Bug 修复

1. 注销按钮不触发：JS IIFE 中 profile 代码 return 阻塞了 account 标签页处理器注册
   → 拆分为两层 IIFE，profile 放在内层
2. label 缺少 for 属性导致控制台警告 → 全部补充 for 属性
3. 注销后未自动退登：DeleteAccount 只设状态未吊销 JWT → 末尾加 InvalidateSessions
4. 退登后重定向 500 panic：authenticateToken 中 err||versionMismatch 合并判断
   在 err=nil 但版本不匹配时返回 (nil,nil) → 拆为两个独立判断
   injectUserContext 增加 claims==nil / 类型断言空安全守卫
5. 注销后登录直接提示"登录成功"：FindByEmail 默认 scope 排除软删除记录
   → 改用 Unscoped()

## 文件变更
- 新建 17 个文件 (消息/审核/站点设置完整模块)
- 修改 25 个文件 (认证/设置/中间件/前端)
- 统计：+3229 / -161，42 files changed
 2026-05-27 13:32:45 +08:00
Victor_Jay
053ca32a14 fix(avatar): WebP 解码未生效 — image.Decode 不支持 WebP，改用 webp.Decode 2026-05-27 01:10:29 +08:00
Victor_Jay
c3dec09dae feat(settings): 个人资料编辑 + 头像上传/裁切 + 自定义裁切弹窗 
**新增功能：**

用户名编辑：输入框替换静态文本，白名单验证(中文/英文/数字/下划线/连字符)，前端计数器(n/16)，utf8对齐PG VARCHAR，XSS防控。

个性签名编辑：Textarea，128字符上限，实时计数器。

头像上传管线：校验→解码→裁切→CatmullRom缩放→WebP二分编码≤100KB→原子写入(.tmp→os.Rename)。限制5MB,128-3840px,JPEG/PNG/WebP。输出512x512 WebP。文件名 {uid}_{timestamp}.webp。清理旧头像。

自定义裁切弹窗：浅色主题，固定裁切框+图片平移/缩放(1×-3×滚轮)，box-shadow遮罩,三等分网格。坐标映射pan/zoom→原图像素→subImage。

CSP修复：img-src允许data:URI(FileReader预览)。

**文件变更：**
修改: README, docs/{development,structure}.md, go.{mod,sum}, cmd/server/main.go, controller/settings, middleware/security, router, templates/settings/{index.html,css}
新增: internal/service/avatar_service.go, docs/settings.md
 2026-05-27 01:03:16 +08:00
Victor_Jay
debaa17127 feat(settings): 用户名校验强化、个性签名编辑、字符计数器及提示优化 
- 用户名校验改用白名单正则（中英文/数字/下划线/连字符），字符数计法统一
- 简介→个性签名，新增 textarea 可编辑，上限 128 字符
- 用户名+签名各增加实时字符计数器（x/16、x/128）
- API 合并为 PUT /api/settings/profile，一次提交两字段，按变更写入
- Toast 移至 NAV 下方，独立样式，5 秒自动消失
- 移除用户 ID 灰色底色，提示改为「个人资料已更新」
- 纯文本存储 + Go 模板自动转义防 XSS
 2026-05-27 00:03:09 +08:00
Victor_Jay
3937945b43 feat(admin): 管理首页标题修正、角色中文显示及用户总数补全 
- 修正 admin layout title 后缀为「MetaLab 管理面板」
- 当前角色从原始字符串改为中文显示（注入 RoleDisplayName）
- 补全管理首页「用户总数」统计，新增 CountUsers 方法
- 遵循 ISP 最小接口，Service 复用已有 CountSearchUsers
 2026-05-26 23:21:32 +08:00
Victor_Jay
39d13993ba fix: 设计原则审查修复 — DIP/ISP, LoD, DRY, OCP, URL, 301缓存 
- P0 DIP+ISP: 全链路注入接口，消除零接口紧耦合
- P0 URL: auth 301→302，修复登出后浏览器缓存陷阱
- P1 DRY: JWT 认证逻辑收敛至 TokenService+中间件
- P2 DRY: 前后端角色/状态映射统一为 model 常量
- P2 LoD: 新增 SettingsController，router 不再跨层调 repo
- P2 URL: settings ?tab= → /settings/:tab 伪静态
- P3 OCP: 角色权限 map 化，告别硬编码 switch
 2026-05-26 21:12:19 +08:00
Victor_Jay
483fdd919f 初始化项目：基础设施 + 用户认证 + 后台管理系统 + AGPL 3.0 许可 2026-05-26 13:46:33 +08:00