<p align="center">
  <img src="https://img.shields.io/badge/Go-1.26-00ADD8?style=flat-square&logo=go" alt="Go 1.26">
  <img src="https://img.shields.io/badge/Gin-1.12-0096D6?style=flat-square&logo=go" alt="Gin 1.12">
  <img src="https://img.shields.io/badge/GORM-1.31-7A6F5D?style=flat-square" alt="GORM 1.31">
  <img src="https://img.shields.io/badge/PostgreSQL-16-4169E1?style=flat-square&logo=postgresql&logoColor=white" alt="PostgreSQL">
  <img src="https://img.shields.io/badge/license-AGPL--3.0-blue?style=flat-square" alt="AGPL 3.0">
</p>

<h1 align="center">MetaLab</h1>

<p align="center"><em>下一代开源技术社区——为构建者准备的纯粹空间</em></p>

---

## 关于项目

MetaLab 是一个正在开发中的开源技术社区平台，旨在为开发者提供一个**平等、纯粹、开放**的技术交流空间。

**核心理念：**
- 🎯 **专注技术**——代码、架构、逻辑与可验证的事实
- 🤝 **平等交流**——没有特权，每个成员权利平等
- 🔓 **开放共享**——鼓励开源、协作与知识共享

## 技术栈

| 类别 | 技术 | 版本 |
|------|------|------|
| 语言 | **Go** | 1.26 |
| Web 框架 | **Gin** | 1.12 |
| ORM | **GORM** | 1.31 |
| 数据库 | **PostgreSQL** | 16+ |
| 认证 | **JWT** (HS256) | v5 |
| 密码加密 | **bcrypt** (cost=12) | — |
| 编辑器 | **Vditor** | 3.11 |
| 前端 | **SSR 模板** (Gin HTML) + 原生 JS/CSS | — |
| 架构 | 分层六边形架构 | — |

## 当前功能

- ✅ **用户系统**——注册、登录、登出
- ✅ **双 Token 认证**——Access Token（15min）+ Refresh Token（7d session / 30d "记住我"），token_version 实时吊销
- ✅ **CSRF 保护**——全站 CSRF Token，自动注入 state-changing 请求
- ✅ **速率限制**——API 调用频率控制（账户 + IP 双维度）
- ✅ **安全头**——Content-Security-Policy 等安全响应头 + 登录防时序攻击
- ✅ **管理后台**——用户管理、角色权限控制
- ✅ **账号注销**——用户自助注销（7 天冷却期，登录二次确认恢复），站长禁止自删
- ✅ **密码修改**——修改后强制所有设备退登
- ✅ **IP 审计**——记录注册 IP、最后登录 IP 及时间
- ✅ **用户设置页**——个人资料修改（用户名、个性签名、头像上传与裁切）
- ✅ **头像处理**——JPEG/PNG/WebP 上传，方形裁切，512×512 WebP 编码 ≤100KB
- ✅ **消息中心**——审核通知推送，SSR 消息页面，单条/全部标为已读，未读数角标（1/66/99+）
- ✅ **帖子系统**——Markdown 发布/编辑/删除，Vditor 所见即所得编辑器，图片粘贴/拖拽上传
- ✅ **代码高亮**——highlight.js 60+ 主题，支持 30+ 编程语言
- ✅ **Shortcode 卡片**——`[zone:event:ID]` 活动/游戏/投票/资源等可扩展卡片
- ✅ **草稿自动保存**——localStorage 草稿，每 2 秒自动保存
- ✅ **审核工作流**——帖子 draft → pending → approved/rejected，管理员审核面板
- ✅ **多主题支持**——可切换的前端主题系统

## 计划中

- 🔲 话题/分类导航
- 🔲 评论系统
- 🔲 邮箱验证
- 🔲 全文搜索
- 🔲 回收站（用户数据彻底清理）

## 快速开始

```bash
# 克隆仓库
git clone git@git.metazone.cc:MetaZone/MetaLab.git
cd MetaLab

# 创建 .env 文件
cat > .env << EOF
DATABASE_PASSWORD=your_db_password
JWT_SECRET=your_jwt_secret
EOF

# 确保 PostgreSQL 运行中
# 默认连接: 127.0.0.1:5432, 数据库: metalab_dev

# 运行
go run cmd/server/main.go
```

启动后访问 `http://localhost:8080`。

## 项目结构

```
MetaLab/
├── cmd/server/            # 入口：初始化 → 启动
├── internal/
│   ├── config/            # 配置加载（YAML + .env）
│   ├── router/            # 路由注册
│   ├── controller/        # 控制器（参数绑定 → 调服务 → 返回）
│   │   └── admin/         # 后台控制器
│   ├── service/           # 业务逻辑层
│   ├── repository/        # 数据访问层（DAO）
│   ├── model/             # 数据模型 + DTO
│   ├── middleware/        # 中间件（认证/CSRF/限流/安全）
│   ├── common/            # 公共工具（响应/分页/加密）
│   └── theme/             # 主题/模板管理
├── templates/             # 前端模板（多主题）
│   ├── MetaLab-2026/      # 前台主题
│   └── admin/             # 后台模板
└── docs/                  # 开发文档
```

## 许可

本项目采用 **[GNU Affero General Public License v3.0 (AGPL-3.0)](https://www.gnu.org/licenses/agpl-3.0.html)** 许可。

**社区版**（AGPL-3.0）：可自由使用、修改、分发，但修改后通过网络提供服务时必须公开源码。

**商业授权**：如需闭源部署、私有化修改或商业技术支持，请联系 [metazone@foxmail.com](mailto:metazone@foxmail.com) 获取商业授权。

---

<p align="center">
  <sub>&copy; 2024-2026 MetaZone | Built with ❤️ by <a href="https://metazone.cc">MetaZone</a> </sub>
</p>
