# 姜十三论坛 介绍

## 这是什么

**姜十三论坛（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