初始化项目

This commit is contained in:
andy committed 2026-01-26 16:16:13 +08:00
1 parent ea8f8390da
commit 95ed45ffe0
3 files changed
+55 -90

No files matched your search

+1 -67
View File
@@ -15,38 +15,6 @@
- 构建工具:Maven(后端)、pnpm(前端)
- 代码规范:ESLint + Prettier(前端)、SpotBugs + Checkstyle(后端)
## 项目结构
```
by-crm/
├── backend/ # Spring Boot 工程
│ ├── src/main/com/bycrm/
│ │ ├── controller/ # Web 层,RESTful API
│ │ ├── service/ # 业务层
│ │ ├── mapper/ # MyBatis DAO
│ │ ├── entity/ # PO / DTO / VO
│ │ ├── config/ # 跨域、MyBatis、Swagger 等配置
│ │ └── ByCrmApplication.java
│ ├── src/main/resources/
│ │ ├── mapper/*.xml # SQL 映射
│ │ └── application.yml # 数据源、MyBatis、JWT、有效期等配置
│ └── pom.xml
├── frontend/ # Vue 3 工程
│ ├── src/
│ │ ├── api/ # 接口封装(axios)
│ │ ├── views/ # 页面级组件
│ │ ├── components/ # 通用组件
│ │ ├── router/ # Vue Router
│ │ ├── stores/ # Pinia 状态
│ │ ├── types/ # TypeScript 类型
│ │ └── utils/ # 权限、请求拦截、日期格式化
│ ├── vite.config.ts
│ └── package.json
├── sql/
│ └── init.sql # 客户表、报备表、经销商表、字典表
└── docs/
└── api.md # Swagger 导出文档
```
## 开发命令
### 后端
```bash
@@ -87,38 +55,4 @@
- 微信小程序端提交报备
- 客户公海池与主动分配
- 报备延期申请流程
- 报表:经销商活跃度、客户转化率
## API 接口说明
### 认证接口
- POST `/api/auth/login` - 用户登录
- GET `/api/auth/user/info` - 获取当前用户信息
- POST `/api/auth/logout` - 用户退出
### 客户接口
- GET `/api/customer/page` - 分页查询客户
- GET `/api/customer/{id}` - 获取客户详情
- POST `/api/customer` - 创建客户
- PUT `/api/customer/{id}` - 更新客户
- DELETE `/api/customer/{id}` - 删除客户
- GET `/api/customer/search` - 搜索客户(用于客户唯一性校验)
### 报备接口
- GET `/api/report/page` - 分页查询报备
- GET `/api/report/{id}` - 获取报备详情
- POST `/api/report` - 创建报备
- PUT `/api/report/{id}/audit` - 审核报备
- DELETE `/api/report/{id}` - 撤回报备
### 经销商接口(仅管理员)
- GET `/api/dealer/list` - 查询所有经销商
- GET `/api/dealer/{id}` - 获取经销商详情
- POST `/api/dealer` - 创建经销商
- PUT `/api/dealer/{id}` - 更新经销商
- DELETE `/api/dealer/{id}` - 删除经销商
## 默认测试账号
- 管理员:`admin` / `admin123`
- 经销商用户1:`user001` / `admin123`
- 经销商用户2:`user002` / `admin123`
- 经销商用户3:`user003` / `admin123`
- 报表:经销商活跃度、客户转化率`