• 场景融合：商品交易 + 跑腿服务 + AI 互动推荐，覆盖校园高频需求
• 治理完善：包含后台管理、IAM 权限体系、风控链路、纠纷处理闭环
• 工程化完整：前后端分层清晰，后端多模块，支持中间件按需启用
• 学习价值高：适合作为课程设计、毕业设计或中大型全栈项目实践样板

• 商品链路：发布 → 风控 → AI 审核 →（必要时）人工复核 → 上架
• 订单链路：下单防超卖锁 → 托管阶段 → 退款/纠纷互斥 → 结算/结束
• 跑腿链路：发布与审核 → 接单互斥 → 履约 → 延迟自动确认
• 社交能力：关注 / 拉黑 / 私聊 / 消息中心
• AI 能力：AI 对话、在售商品推荐、智能审核辅助

• 多级权限：超管、学校级/校区级管理员、运营角色（IAM）
• 风控体系：黑白名单、阈值规则、关键词策略、高级信号、工单管理
• 搜索推荐：Elasticsearch 检索高亮 + Redis 热搜/历史 + 推荐在线融合
• 通知系统：消息落库 + WebSocket 推送 + bizType 业务跳转

• 前端：Vue 3 + TypeScript + Vite + Pinia
• 后端：Spring Boot 3 多模块（web / security / core / admin / search / recommend / ai / gateway）
• 中间件（按需启用）：MySQL、Redis、RocketMQ、Elasticsearch、XXL-JOB

仓库结构：

Nowl/
├── Nowl-front/     # Vue3 前端
├── Nowl-backend/   # Spring Boot 多模块后端
├── sql/            # 数据库初始化脚本（推荐执行这里）
└── docs/           # 设计说明书 / 中间件部署文档

• JDK 17+
• Maven 3.9+
• Node.js 18+（建议）与 npm

最低中间件要求：

• MySQL 8+
• Redis 6+

可选中间件（不启用则功能降级）：

• RocketMQ（异步审核、索引同步、延迟任务）
• Elasticsearch（检索与高亮）
• XXL-JOB（推荐离线任务）

推荐执行根目录初始化脚本（建库建表 + 角色权限 + 风控规则 + 分类/学校种子数据）：

mysql -u root -p < sql/nowl_init.sql

参考根目录 .env.example（请勿提交真实密钥）。

后端通过系统环境变量或 IDE 运行配置读取，.env 不会被 Spring Boot 自动加载。

必需项：

• DB_URL DB_USERNAME DB_PASSWORD
• REDIS_HOST REDIS_PORT（有密码再加 REDIS_PASSWORD）
• JWT_SECRET

可选项：

• AI：OPENAI_API_KEY OPENAI_BASE_URL OPENAI_MODEL
• COS：COS_SECRET_ID COS_SECRET_KEY COS_REGION COS_BUCKET_NAME COS_BASE_URL
• MQ：ROCKETMQ_NAME_SERVER
• ES：ES_HOST
• XXL：XXL_JOB_ADMIN_ADDRESSES
• 短信：SMS_ENABLED SMS_SPUG_URL

cd Nowl-backend
mvn -q -DskipTests -pl unimarket-web -am spring-boot:run

cd Nowl-backend
mvn -q -DskipTests -pl unimarket-gateway -am spring-boot:run

cd Nowl-front
npm install
npm run dev

开发环境访问：

• Frontend: http://localhost:5173
• Gateway: http://localhost:8090
• Backend: http://localhost:8080

初始化 SQL 会注入角色与权限点，但不会自动创建管理员账号。 可先注册普通账号，再在数据库绑定管理员角色与范围。

INSERT INTO iam_user_role(user_id, role_id, status)
SELECT 123, role_id, 1
FROM iam_role
WHERE role_code = 'SUPER_ADMIN'
ON DUPLICATE KEY UPDATE status = 1;

INSERT INTO iam_admin_scope_binding(user_id, scope_type, status)
VALUES (123, 'ALL', 1);

将 123 替换为你的实际用户 ID。

• 系统设计说明书：docs/Nowl系统设计说明书.md
• 中间件部署文档：docs/中间件部署文档.md
• 项目经历说明：docs/简历项目经历-Nowl.md
• 风控压测说明：docs/风控压测说明.md

• 想做毕业设计 / 课程设计的同学
• 想学习Vue + Spring Boot 全栈工程化实践的开发者
• 想了解校园交易 + 平台治理 + 风控体系落地方式的同学

如果这个项目对你有帮助，欢迎点个 Star ⭐

MIT License，详见 LICENSE。