freefire
3e55b5d230
- 新增管理端板块管理页面与后端接口（admin_board） - 新增旧版数据导入：legacyimport 服务、导入面板、importusers 命令行工具 - 聊天用户卡片、板块图标等 UI 组件与界面优化 - 补充 about/公告/1Panel 部署等文档 - gitignore 排除 dist/ 构建产物与 .agents/ 本地工具目录
67 lines
2.9 KiB
Markdown
67 lines
2.9 KiB
Markdown
# 姜十三论坛 介绍
|
||
|
||
## 这是什么
|
||
|
||
**姜十三论坛（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
|