# nexus资源网站

**Repository Path**: SunYangSen/nexus-resource-website

## Basic Information

- **Project Name**: nexus资源网站
- **Description**: 较个性化的赛博朋克风，游戏、软件、资源分享，论坛社区互动网站。
- **Primary Language**: NodeJS
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://bbs-nexus.top/
- **GVP Project**: No

## Statistics

- **Stars**: 15
- **Forks**: 0
- **Created**: 2026-06-22
- **Last Updated**: 2026-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nexus BBS

> 在线体验：<https://bbs-nexus.top/>
>
> 一个面向资源分享、社区互动与后台治理的全栈网站项目。
交流QQ群：970727305

`Nexus BBS` 是一个以资源内容为核心、同时具备论坛互动、积分解锁、实时通信与后台管理能力的综合站点。项目采用前后端分离架构，前端基于 `Vue 3 + TypeScript + Vite`，后端基于 `NestJS + TypeORM`，并提供 `MySQL + Redis + Docker Compose` 的完整工程化落地方案。

如果你正在寻找一个适合继续迭代的资源站、社区站或内容平台项目骨架，这个仓库提供了相对完整的业务闭环与部署基础。

## 核心功能

### 资源内容

- 支持资源发布、编辑、详情展示与多维度浏览
- 提供分类、标签、属性筛选与详情页展示能力
- 支持资源封面、图片、网盘链接等内容管理
- 支持收藏、购买记录与已解锁状态识别

### 社区互动

- 支持主题帖、评论互动与用户资料展示
- 支持私信聊天、通知提醒与部分实时通信场景
- 提供举报、反馈等社区治理入口
- 包含悬赏相关模块，适合扩展任务协作类场景

### 交易闭环

- 提供积分余额、充值与交易记录相关能力
- 支持资源付费解锁与订单流转
- 支持资源推广、部分运营相关配置

### 后台治理

- 提供后台管理面板与多类业务管理页面
- 支持用户、资源、帖子、举报、反馈等后台管理
- 支持安全、日志、邮件、维护模式等系统设置
- 包含定时任务、审计与清理类运维能力

## 技术栈

- 前端：`Vue 3`、`TypeScript`、`Vite`、`Pinia`
- 后端：`NestJS`、`TypeORM`
- 数据层：`MySQL`、`Redis`
- 实时通信：`Socket.IO`
- 部署方式：`Docker Compose`、`Nginx` 同源代理

## 页面预览

### 首页 / 大厅

展示首页布局、资源流与社区入口。

![首页 / 大厅](./docs/images/homepage.png)

### 资源详情页

展示资源信息、价格、解锁与评论区域。

![资源详情页](./docs/images/resource-detail.png)

### 发布中心

展示资源发布与编辑表单。

![发布中心](./docs/images/publish-center.png)

### 个人中心

展示用户资料、记录与偏好设置。

![个人中心](./docs/images/profile-center.png)

### 后台控制台

展示后台管理与运营能力。

![后台控制台](./docs/images/admin-dashboard.png)

## 快速开始

### 环境要求

- `Node.js 20+`
- `MySQL 8+`
- `Redis 7+`
- `npm 10+` 或兼容版本

### 1. 启动后端

```bash
cd backend
npm install
```

准备本地数据库与 Redis 后，按项目实际需要配置后端环境变量，再启动开发服务：

```bash
npm run start:dev
```

默认情况下，后端服务监听：

```text
http://localhost:3000
```

### 2. 启动前端

```bash
cd frontend
npm install
```

前端开发环境默认通过 `frontend/.env.development` 与 Vite 代理访问本地后端，按需调整后启动：

```bash
npm run dev
```

默认情况下，前端开发服务监听：

```text
http://localhost:5173
```

### 3. 本地开发说明

- 前端默认通过 `VITE_API_BASE_URL` 或 Vite 代理访问后端接口
- 后端静态上传目录通过 `/uploads` 对外提供访问
- 若需跑通完整业务链路，建议优先准备好本地 `MySQL` 与 `Redis`
- 如果你只想快速了解结构，也可以先分别启动前后端查看页面与接口

## 项目结构

```text
bbs-a/
├─ frontend/        # Vue 3 前端主站
├─ backend/         # NestJS 后端服务
├─ docs/            # 设计文档、文章与补充资料
├─ mysql/           # MySQL 自定义配置
└─ docker-compose.yml
```

## 当前进度

当前仓库已经具备一套较完整的网站基础能力，包含但不限于：

- 用户认证、权限与个人中心
- 资源发布、详情、购买与收藏
- 评论、通知、私信与聊天相关能力
- 举报、反馈、审计、安全与维护相关能力
- 后台管理、分类标签、运营配置与日志能力
- Docker 化部署与同源代理方案