feat: 管理端板块管理与旧版数据导入,补充部署运营文档
- 新增管理端板块管理页面与后端接口(admin_board) - 新增旧版数据导入:legacyimport 服务、导入面板、importusers 命令行工具 - 聊天用户卡片、板块图标等 UI 组件与界面优化 - 补充 about/公告/1Panel 部署等文档 - gitignore 排除 dist/ 构建产物与 .agents/ 本地工具目录
This commit is contained in:
66
docs/about.md
Normal file
66
docs/about.md
Normal 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
|
||||
Reference in New Issue
Block a user