华南理工大学校内二手交易平台。
当前实现为前后端分离开发、后端可托管前端构建产物的结构：
- 前端：React 19 + TypeScript + Vite + TanStack Router + TanStack Query
- 后端：Go + SQLite
更完整的产品设计和业务背景见 SCUTmarket.md。
- 校内邮箱注册 / 登录
- 商品发布、编辑、上下架、删除
- 市场商品支持按修改时间、价格升序/降序排序
- 首页展示出售、收购、已注册用户统计
- 公告管理
- 商品举报
- 审核队列与管理员审核
- 图片上传
- SQLite 本地存储
SCUTmarket/
├── backend/ # Go 后端
│ ├── cmd/server/ # 服务启动入口
│ └── config/ # 后端配置
├── frontend/ # React 前端
│ ├── src/ # 前端源码
│ └── dist/ # 前端构建产物
├── data/ # SQLite 数据库文件
├── uploads/ # 上传图片目录
└── SCUTmarket.md # 设计文档
- Go 1.22 或更高版本
- Node.js 20 或更高版本
- npm
默认读取 backend/config/server.json。
可以参考 backend/config/server.example.json 新建或修改实际配置。示例文件里已经带了 _comment_* 字段说明每个配置项的用途。
后端支持通过环境变量切换配置文件：
SCUTMARKET_CONFIG=/path/to/server.json go run ./cmd/server关键配置说明：
server：监听地址、数据库路径、静态文件目录、上传目录、Session 密钥auth：密码长度、验证码有效期、发送冷却、登录态有效期smtp：验证码邮件发送配置admin：管理员邮箱和初始密码audit.enable_rule：是否启用规则审核audit.enable_ai：是否启用 AI 审核
注意：
enable_rule和enable_ai可以任意组合，可以都开，也可以都关。- 服务启动时会自动确保
admin.email对应的管理员账号存在；如果该邮箱已存在，也会同步提升为管理员并更新密码。 server.json不应提交真实密钥、SMTP 密码或真实管理员密码。
前端本地配置文件是 frontend/src/config/app.json。
可参考 frontend/src/config/app.example.json。目前这里放纯前端展示相关配置，例如首页 Hero 文案、商品卡片宽度和配置驱动的页脚信息区。
首页相关配置说明：
home.hero.title：首页顶部主标题home.hero.description：首页顶部简介文案
页脚相关配置说明：
footer.eyebrow：页脚左上角小标签，可选footer.title/footer.description：页脚标题与简介footer.notices：页脚底部短提示footer.sections：页脚区块数组，可自由决定区块数量、顺序和标题footer.sections[].items：支持link和qr两种条目类型，可混排
如果要展示二维码，建议先把图片放到 frontend/public/qrcodes/，再在配置里写成 /qrcodes/文件名.png。
前端：
cd /home/xbohodx02/work/SCUTmarket/frontend
npm install后端：
cd /home/xbohodx02/work/SCUTmarket/backend
go mod download适合日常开发。前端和后端分开运行。
启动后端：
cd /home/xbohodx02/work/SCUTmarket/backend
go run ./cmd/server启动前端：
cd /home/xbohodx02/work/SCUTmarket/frontend
npm run dev通常访问地址：
- 前端开发服务器：
http://localhost:5173 - 后端接口：
http://localhost:8080
适合验证实际部署形态。前端先构建，再由后端统一托管静态文件。
构建前端：
cd /home/xbohodx02/work/SCUTmarket/frontend
npm run build启动后端：
cd /home/xbohodx02/work/SCUTmarket/backend
go run ./cmd/server然后访问：
http://localhost:8080
前端开发：
cd /home/xbohodx02/work/SCUTmarket/frontend
npm run dev前端构建：
cd /home/xbohodx02/work/SCUTmarket/frontend
npm run build前端预览构建产物：
cd /home/xbohodx02/work/SCUTmarket/frontend
npm run preview后端运行：
cd /home/xbohodx02/work/SCUTmarket/backend
go run ./cmd/server后端测试：
cd /home/xbohodx02/work/SCUTmarket/backend
go test ./...- SQLite 数据库默认在 data/scutmarket.db
- 上传图片默认保存在 uploads
- 前端构建产物默认输出到 frontend/dist
如果想重置本地数据，通常需要清理数据库文件和上传目录中的测试数据；执行前先确认不需要保留现有数据。
审核链路由后端配置决定：
- 只开
enable_rule - 只开
enable_ai - 两者同时开启
- 两者都关闭
当启用 AI 审核时，还需要在 audit.ai 中补齐可用的接口配置；如果 enable_ai=true 但 AI 配置不完整，系统会提示 AI 审核当前不会实际执行。
frontend/dist/assets里的文件是 Vite 构建产物，文件名带 hash 是正常现象，用于缓存失效。server.example.json和app.example.json中的注释以_comment_*字段形式存在，这是为了保持文件仍然是合法 JSON。