⾯向书画艺术爱好者、写⽣中国会员、艺术机构及商家的综合性艺术社交与电商平台,提供
会员服务、作品展⽰、活动报名、商品交易等功能;⽕咔艺术主要是⼀个电商平台,其次才
是写⽣中国的社交(会员管理系统)平台。
# FireKa 后端开发文档
## 1. 文档目标
本文档用于指导后端开发、测试和交付,覆盖:
- 架构与模块职责
- 接口开发流程
- 接口测试与文档配置
- 高风险领域开发约束
## 2. 项目结构
- `like-admin`: 平台管理端 API
- `like-front`: 用户端 API
- `like-shop`: 商家端 API
- `like-common`: 公共实体/Mapper/工具/插件
- `like-generator`: 代码生成
当前接口规模(按 Controller 映射注解统计):
- admin: 431
- front: 173
- shop: 391
- total: 995
## 3. 启动入口
- `like-admin/src/main/java/com/mdd/admin/LikeAdminApplication.java`
- `like-front/src/main/java/com/mdd/front/LikeFrontApplication.java`
- `like-shop/src/main/java/com/mdd/shop/LikeShopApplication.java`
## 4. 请求链路
1. WebMvc 拦截器鉴权(admin/front/shop)。
2. Controller 参数校验。
3. Service 业务执行。
4. Mapper 数据访问。
5. `AjaxResult` 统一返回。
6. 全局异常处理统一出口。
## 5. 接口开发标准流程
1. 在对应模块新增 Controller 路由。
2. 在 `validate` 定义入参对象并加校验注解。
3. 在 Service 层实现业务,事务放 Service。
4. 复用 `like-common` 的实体/Mapper。
5. 返回结构统一 `AjaxResult` / `PageResult`。
6. 增加接口测试与 Swagger 注释。
## 6. Swagger 接口文档配置
### 6.1 配置位置
- `like-admin/src/main/java/com/mdd/admin/config/SwaggerConfig.java`
- `like-front/src/main/java/com/mdd/front/config/SwaggerConfig.java`
- `like-shop/src/main/java/com/mdd/shop/config/SwaggerConfig.java`
### 6.2 分组规范
- admin: `groupName("admin-api")`
- front: `groupName("front-api")