feat: 管理端板块管理与旧版数据导入,补充部署运营文档

- 新增管理端板块管理页面与后端接口(admin_board)
- 新增旧版数据导入:legacyimport 服务、导入面板、importusers 命令行工具
- 聊天用户卡片、板块图标等 UI 组件与界面优化
- 补充 about/公告/1Panel 部署等文档
- gitignore 排除 dist/ 构建产物与 .agents/ 本地工具目录
This commit is contained in:
2026-09-24 03:37:44 +08:00
parent c1f6a6636b
commit 3e55b5d230
53 changed files with 5078 additions and 409 deletions

66
docs/about.md Normal file
View File

@@ -0,0 +1,66 @@
# 姜十三论坛 介绍
## 这是什么
**姜十三论坛(jiang13-bbs)** 是一个现代化的社区论坛系统,致力于提供流畅、安全、高质量的在线讨论体验。它面向需要自建社区的个人与团队,开箱即用,同时具备完整的内容、互动、通知与管理能力。
## 核心特性
### 📝 内容创作与讨论
- **发帖 / 编辑 / 删除**:支持普通帖与问答帖两种类型,作者与管理员均可管理。
- **Markdown 渲染**:完整支持 Markdown 语法,包含代码高亮、引用、列表等,技术内容排版美观。
- **楼层化评论**:主评论占楼层、子评论不占楼层,最多 10 层嵌套,讨论层次分明。
- **点赞互动**:帖子点赞带防重复机制,让优质内容被看见。
- **置顶与推荐**:管理员可对帖子进行置顶、推荐,引导社区焦点。
### 🔔 实时通知
- 评论、回复、点赞等互动实时推送,未读红点随页面首屏直出。
- 基于 WebSocket 的实时通道,回前台自动校准,消息不遗漏。
- 支持单条 / 全部标记已读。
### 👤 会员体系
- 注册即登录,免二次跳转。
- 个人资料:昵称、头像、邮箱、个性签名自由编辑。
- 每日签到获取积分,连续签到有加成。
- 个人主页聚合你的发帖、评论与签到记录。
### 🛠️ 管理后台
- 仪表盘总览社区数据。
- 公告管理:支持草稿与发布,标签预设色,重要信息精准触达。
- 用户、内容、设置等全方位管理能力。
### 🔍 SEO 友好
- 全站 SSR / ISR,搜索引擎可见的关键内容都在初始 HTML 中。
- 帖子详情输出结构化数据(JSON-LD),利于搜索收录与展示。
- 自动生成 sitemap 与 robots。
### 🔒 安全可靠
- HttpOnly Cookie + Refresh Token 一次性轮转认证,令牌不落地浏览器存储。
- CSRF 双提交防护、速率限制(登录 / 注册 / 发帖冷静期)。
- 完备的安全响应头(CSP / HSTS 等)。
- 生产环境强制 HTTPS,使用 `__Host-` 前缀 Cookie。
## 技术架构
| 层级 | 技术选型 |
|------|----------|
| 后端 | Go 1.27 · Gin · GORM · PostgreSQL 17 |
| 前端 | Next.js 16 (App Router) · TypeScript · Tailwind CSS v4 |
| 认证 | JWT(HttpOnly Cookie)+ Refresh Token 轮转 + CSRF 双提交 + Token Version 撤销 |
| 实时 | WebSocket |
| 部署 | Docker(Next SSR + Go + Postgres,反代自备) |
系统采用前后端分离架构,前端负责服务端渲染与交互,后端负责业务逻辑与数据,二者职责清晰、可独立伸缩。
## 适用场景
- 个人 / 团队自建社区、技术论坛
- 产品用户交流与反馈社区
- 兴趣小组、垂直领域讨论站
- 需要高质量 SEO 与安全性的内容社区
## 许可与联系方式
本项目为**专有软件**,源码可见但不构成开源授权,未经书面许可不得使用、部署或分发。
联系方式:aarbbs@88.com