前端
This commit is contained in:
zpc
parent
c282854736
commit
dcded0178f
495
.kiro/specs/frontend-api-refactor/design.md
Normal file
495
.kiro/specs/frontend-api-refactor/design.md
Normal file
|
|
@ -0,0 +1,495 @@
|
|||
# Design Document
|
||||
|
||||
## Overview
|
||||
|
||||
本设计文档描述前端 API 接口调用重构的技术方案。核心目标是将分散在页面和组件中的接口调用统一收敛到 `common/server/` 模块，实现接口集中管理、统一错误处理，并在改造过程中生成完整的 API 清单用于核对 C# 后端迁移完整性。
|
||||
|
||||
## Architecture
|
||||
|
||||
### 整体架构
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Pages / Components │
|
||||
│ (pages/shouye/*.vue, pages/user/*.vue, components/*.vue) │
|
||||
└─────────────────────────────┬───────────────────────────────┘
|
||||
│ import { funcName } from '@/common/server/xxx.js'
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Server Modules │
|
||||
│ common/server/ │
|
||||
│ ├── auth.js (登录、注册、绑定) │
|
||||
│ ├── user.js (用户信息、VIP) │
|
||||
│ ├── goods.js (商品列表、详情、奖品) │
|
||||
│ ├── order.js (订单、抽奖) │
|
||||
│ ├── warehouse.js (仓库、回收、发货) │
|
||||
│ ├── coupon.js (优惠券) │
|
||||
│ ├── welfare.js (福利屋、签到、任务) │
|
||||
│ ├── collection.js(收藏) │
|
||||
│ ├── address.js (收货地址) - 已有 userAddress.js │
|
||||
│ ├── config.js (系统配置) - 已有 │
|
||||
│ ├── rank.js (排行榜) │
|
||||
│ ├── invitation.js(邀请) │
|
||||
│ ├── redeem.js (兑换码) │
|
||||
│ └── pay.js (支付) │
|
||||
└─────────────────────────────┬───────────────────────────────┘
|
||||
│ RequestManager.get/post()
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ RequestManager │
|
||||
│ common/request.js │
|
||||
│ - 统一请求封装 │
|
||||
│ - 签名机制 │
|
||||
│ - 错误处理 │
|
||||
│ - Content-Type: application/json │
|
||||
└─────────────────────────────┬───────────────────────────────┘
|
||||
│ HTTP Request
|
||||
▼
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ C# Backend API │
|
||||
│ http://localhost:5238/api/* │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 调用流程
|
||||
|
||||
```mermaid
|
||||
sequenceDiagram
|
||||
participant P as Page/Component
|
||||
participant S as Server Module
|
||||
participant R as RequestManager
|
||||
participant B as Backend API
|
||||
|
||||
P->>S: import { getGoodsList } from '@/common/server/goods.js'
|
||||
P->>S: await getGoodsList({ page: 1, type: 0 })
|
||||
S->>R: RequestManager.post('/goods_list', data)
|
||||
R->>R: 添加签名参数 (timestamp, nonce, sign)
|
||||
R->>B: POST /api/goods_list (JSON)
|
||||
B-->>R: { status: 1, data: {...} }
|
||||
R-->>S: response
|
||||
S->>S: 统一错误处理
|
||||
S-->>P: 标准格式结果
|
||||
```
|
||||
|
||||
## Components and Interfaces
|
||||
|
||||
### 1. RequestManager (已有，需修改)
|
||||
|
||||
**文件**: `honey_box/common/request.js`
|
||||
|
||||
**修改内容**: POST 请求 Content-Type 改为 `application/json`
|
||||
|
||||
```javascript
|
||||
// 修改前
|
||||
if (method.toUpperCase() == 'POST') {
|
||||
header = {
|
||||
'content-type': 'application/x-www-form-urlencoded',
|
||||
// ...
|
||||
}
|
||||
}
|
||||
|
||||
// 修改后
|
||||
if (method.toUpperCase() == 'POST') {
|
||||
header = {
|
||||
'content-type': 'application/json',
|
||||
// ...
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**接口保持不变**:
|
||||
- `static get(url, data, showLoading)` - GET 请求
|
||||
- `static post(url, data, showLoading)` - POST 请求
|
||||
- `static getCache(url, data, showLoading)` - 带缓存的 GET 请求
|
||||
|
||||
### 2. Server Module 标准结构
|
||||
|
||||
每个 Server Module 遵循统一的结构：
|
||||
|
||||
```javascript
|
||||
// common/server/xxx.js
|
||||
import RequestManager from '../request';
|
||||
|
||||
/**
|
||||
* 函数名使用语义化命名
|
||||
* @param {Object} params 请求参数
|
||||
* @returns {Promise<Object>} 标准响应格式
|
||||
*/
|
||||
export const getFunctionName = async (params = {}) => {
|
||||
const res = await RequestManager.post('/api_endpoint', params);
|
||||
return res;
|
||||
};
|
||||
|
||||
// 如需数据处理
|
||||
export const getProcessedData = async (params = {}) => {
|
||||
const res = await RequestManager.post('/api_endpoint', params);
|
||||
if (res.status === 1 && res.data) {
|
||||
// 数据处理逻辑
|
||||
return res.data;
|
||||
}
|
||||
return null;
|
||||
};
|
||||
```
|
||||
|
||||
### 3. Server Modules 详细设计
|
||||
|
||||
#### 3.1 auth.js (认证模块)
|
||||
|
||||
```javascript
|
||||
// 微信登录
|
||||
export const wxLogin = async (code, userInfo) => {...}
|
||||
|
||||
// 手机号登录
|
||||
export const mobileLogin = async (mobile, code) => {...}
|
||||
|
||||
// 微信绑定手机号
|
||||
export const bindMobileByWx = async (encryptedData, iv) => {...}
|
||||
|
||||
// 验证码绑定手机号
|
||||
export const bindMobileByCode = async (mobile, code) => {...}
|
||||
|
||||
// 记录登录
|
||||
export const recordLogin = async () => {...}
|
||||
|
||||
// 账号注销
|
||||
export const logOff = async () => {...}
|
||||
```
|
||||
|
||||
#### 3.2 user.js (用户模块 - 扩展已有)
|
||||
|
||||
```javascript
|
||||
// 已有
|
||||
export const getUserInfo = async () => {...}
|
||||
|
||||
// 新增
|
||||
export const updateUserInfo = async (data) => {...}
|
||||
export const getVipList = async () => {...}
|
||||
export const getProfitMoney = async (page) => {...}
|
||||
export const getProfitIntegral = async (page) => {...}
|
||||
export const getProfitScore = async (page) => {...}
|
||||
export const getProfitPay = async (page) => {...}
|
||||
```
|
||||
|
||||
#### 3.3 goods.js (商品模块)
|
||||
|
||||
```javascript
|
||||
// 商品列表
|
||||
export const getGoodsList = async (params) => {...}
|
||||
|
||||
// 商品详情
|
||||
export const getGoodsDetail = async (goodsId) => {...}
|
||||
|
||||
// 子奖品列表
|
||||
export const getGoodsChildren = async (goodsId) => {...}
|
||||
|
||||
// 商品扩展配置
|
||||
export const getGoodsExtend = async (goodsId) => {...}
|
||||
|
||||
// 箱号列表
|
||||
export const getGoodsNumList = async (goodsId) => {...}
|
||||
|
||||
// 箱号详情
|
||||
export const getGoodsNumDetail = async (goodsId, goodsNum) => {...}
|
||||
|
||||
// 奖品数量统计
|
||||
export const getGoodsPrizeCount = async (goodsId) => {...}
|
||||
|
||||
// 奖品内容
|
||||
export const getGoodsPrizeContent = async (goodsId, shangId) => {...}
|
||||
|
||||
// 中奖记录
|
||||
export const getGoodsPrizeLogs = async (params) => {...}
|
||||
```
|
||||
|
||||
#### 3.4 order.js (订单模块 - 扩展已有)
|
||||
|
||||
```javascript
|
||||
// 一番赏金额计算
|
||||
export const calcOrderMoney = async (params) => {...}
|
||||
|
||||
// 一番赏下单
|
||||
export const createOrder = async (params) => {...}
|
||||
|
||||
// 无限赏金额计算
|
||||
export const calcInfiniteOrderMoney = async (params) => {...}
|
||||
|
||||
// 无限赏下单
|
||||
export const createInfiniteOrder = async (params) => {...}
|
||||
|
||||
// 商城金额计算
|
||||
export const calcMallOrderMoney = async (params) => {...}
|
||||
|
||||
// 订单列表
|
||||
export const getOrderList = async (page, pageSize) => {...}
|
||||
|
||||
// 订单详情
|
||||
export const getOrderDetail = async (orderId) => {...}
|
||||
|
||||
// 抽奖结果
|
||||
export const getPrizeOrderLog = async (orderId) => {...}
|
||||
|
||||
// 无限赏抽奖结果
|
||||
export const getInfinitePrizeOrderLog = async (orderId) => {...}
|
||||
|
||||
// 道具卡抽奖
|
||||
export const useItemCard = async (params) => {...}
|
||||
```
|
||||
|
||||
#### 3.5 warehouse.js (仓库模块)
|
||||
|
||||
```javascript
|
||||
// 仓库首页
|
||||
export const getWarehouseIndex = async (params) => {...}
|
||||
|
||||
// 回收奖品
|
||||
export const recoveryPrize = async (ids) => {...}
|
||||
|
||||
// 发货奖品
|
||||
export const sendPrize = async (params) => {...}
|
||||
|
||||
// 确认发货
|
||||
export const confirmSend = async (params) => {...}
|
||||
|
||||
// 发货记录
|
||||
export const getSendRecord = async (page) => {...}
|
||||
|
||||
// 发货详情
|
||||
export const getSendRecordDetail = async (id) => {...}
|
||||
|
||||
// 回收记录
|
||||
export const getRecoveryRecord = async (page) => {...}
|
||||
|
||||
// 物流信息
|
||||
export const getLogistics = async (orderId) => {...}
|
||||
```
|
||||
|
||||
#### 3.6 coupon.js (优惠券模块)
|
||||
|
||||
```javascript
|
||||
// 优惠券列表
|
||||
export const getCouponList = async (params) => {...}
|
||||
|
||||
// 优惠券详情
|
||||
export const getCouponDetail = async (couponId) => {...}
|
||||
|
||||
// 领取优惠券
|
||||
export const receiveCoupon = async (couponId) => {...}
|
||||
|
||||
// 分享优惠券
|
||||
export const shareCoupon = async (couponId) => {...}
|
||||
|
||||
// 合成优惠券
|
||||
export const synthesisCoupon = async (ids) => {...}
|
||||
|
||||
// 计算合成
|
||||
export const calcSynthesis = async (ids) => {...}
|
||||
```
|
||||
|
||||
#### 3.7 welfare.js (福利模块)
|
||||
|
||||
```javascript
|
||||
// 福利屋列表
|
||||
export const getWelfareHouseList = async () => {...}
|
||||
|
||||
// 福利屋详情
|
||||
export const getWelfareHouseDetail = async (goodsId) => {...}
|
||||
|
||||
// 福利屋下单
|
||||
export const buyWelfareHouse = async (params) => {...}
|
||||
|
||||
// 签到信息
|
||||
export const getSignInfo = async () => {...}
|
||||
|
||||
// 执行签到
|
||||
export const doSign = async () => {...}
|
||||
|
||||
// 任务列表
|
||||
export const getTaskList = async () => {...}
|
||||
|
||||
// 领取任务奖励
|
||||
export const receiveTaskReward = async (taskId) => {...}
|
||||
```
|
||||
|
||||
#### 3.8 collection.js (收藏模块)
|
||||
|
||||
```javascript
|
||||
// 收藏列表
|
||||
export const getCollectionList = async (page) => {...}
|
||||
|
||||
// 添加收藏
|
||||
export const addCollection = async (goodsId) => {...}
|
||||
|
||||
// 取消收藏
|
||||
export const cancelCollection = async (goodsId) => {...}
|
||||
|
||||
// 收藏状态
|
||||
export const getCollectionStatus = async (goodsId) => {...}
|
||||
```
|
||||
|
||||
#### 3.9 rank.js (排行榜模块)
|
||||
|
||||
```javascript
|
||||
// 排行榜列表
|
||||
export const getRankList = async (type, page) => {...}
|
||||
```
|
||||
|
||||
#### 3.10 invitation.js (邀请模块)
|
||||
|
||||
```javascript
|
||||
// 邀请信息
|
||||
export const getInvitationInfo = async () => {...}
|
||||
|
||||
// 邀请记录
|
||||
export const getInvitationRecord = async (page) => {...}
|
||||
```
|
||||
|
||||
#### 3.11 redeem.js (兑换码模块)
|
||||
|
||||
```javascript
|
||||
// 使用兑换码
|
||||
export const useRedeemCode = async (code) => {...}
|
||||
```
|
||||
|
||||
#### 3.12 pay.js (支付模块)
|
||||
|
||||
```javascript
|
||||
// 微信支付
|
||||
export const wxPay = async (orderId) => {...}
|
||||
|
||||
// 余额支付
|
||||
export const balancePay = async (orderId) => {...}
|
||||
|
||||
// 充值
|
||||
export const recharge = async (amount) => {...}
|
||||
```
|
||||
|
||||
## Data Models
|
||||
|
||||
### 标准响应格式
|
||||
|
||||
```typescript
|
||||
interface ApiResponse<T> {
|
||||
status: number; // 1=成功, 0=失败, -1=未登录, -9=需绑定手机号
|
||||
msg: string; // 提示信息
|
||||
data: T; // 业务数据
|
||||
}
|
||||
|
||||
interface PaginatedResponse<T> {
|
||||
status: number;
|
||||
msg: string;
|
||||
data: {
|
||||
data: T[]; // 列表数据
|
||||
total: number; // 总数
|
||||
currentPage: number;
|
||||
lastPage: number;
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
### 状态码定义
|
||||
|
||||
| 状态码 | 含义 | 处理方式 |
|
||||
|-------|------|---------|
|
||||
| 1 | 成功 | 返回数据 |
|
||||
| 0 | 业务失败 | 显示 msg 提示 |
|
||||
| -1 | 未登录 | 跳转登录页 |
|
||||
| -9 | 需绑定手机号 | 跳转绑定页 |
|
||||
| 2222 | 特殊状态 | 返回数据 |
|
||||
|
||||
## Correctness Properties
|
||||
|
||||
*A property is a characteristic or behavior that should hold true across all valid executions of a system-essentially, a formal statement about what the system should do. Properties serve as the bridge between human-readable specifications and machine-verifiable correctness guarantees.*
|
||||
|
||||
### Property 1: POST 请求使用 JSON 格式
|
||||
|
||||
*For any* POST 请求通过 RequestManager 发送, 请求头的 Content-Type 应为 `application/json`
|
||||
|
||||
**Validates: Requirements 1.1**
|
||||
|
||||
### Property 2: 签名机制一致性
|
||||
|
||||
*For any* 请求数据对象, 生成的签名应与原有算法保持一致：参数按键名排序 → 拼接为 key=value& 格式 → 添加密钥(host+timestamp) → MD5 加密
|
||||
|
||||
**Validates: Requirements 1.2**
|
||||
|
||||
### Property 3: 响应格式一致性
|
||||
|
||||
*For any* API 响应, 返回格式应包含 status、msg、data 三个字段，且 status 为数字类型
|
||||
|
||||
**Validates: Requirements 1.3**
|
||||
|
||||
### Property 4: 错误处理统一性
|
||||
|
||||
*For any* 接口调用返回 status !== 1 的响应, Server Module 应返回包含 status 和 msg 的标准格式对象
|
||||
|
||||
**Validates: Requirements 2.3, 6.2**
|
||||
|
||||
## Error Handling
|
||||
|
||||
### RequestManager 层错误处理
|
||||
|
||||
RequestManager 已实现以下错误处理逻辑（保持不变）：
|
||||
|
||||
1. **网络异常**: 显示 "网络连接异常，请检查网络"
|
||||
2. **status = 0**: 显示 msg 提示
|
||||
3. **status = -1**: 清除 token，跳转登录页
|
||||
4. **status = -9**: 显示 msg，跳转绑定手机号页面
|
||||
5. **请求失败**: 显示错误信息
|
||||
|
||||
### Server Module 层错误处理
|
||||
|
||||
Server Module 不额外处理错误，直接返回 RequestManager 的响应：
|
||||
|
||||
```javascript
|
||||
export const getGoodsList = async (params) => {
|
||||
// 直接返回，错误由 RequestManager 统一处理
|
||||
return await RequestManager.post('/goods_list', params);
|
||||
};
|
||||
```
|
||||
|
||||
如需数据转换，在成功时处理：
|
||||
|
||||
```javascript
|
||||
export const getUserInfo = async () => {
|
||||
const res = await RequestManager.post('/user');
|
||||
if (res.status === 1 && res.data) {
|
||||
// 数据处理
|
||||
res.data.money = common.removeTrailingZeros(res.data.money);
|
||||
return res.data;
|
||||
}
|
||||
return null;
|
||||
};
|
||||
```
|
||||
|
||||
## Testing Strategy
|
||||
|
||||
### 单元测试
|
||||
|
||||
由于前端 UniApp 项目的特殊性，主要通过以下方式验证：
|
||||
|
||||
1. **手动测试**: 在开发环境使用 eruda 调试工具检查请求
|
||||
2. **接口测试**: 使用 Postman/curl 验证接口响应格式
|
||||
|
||||
### 测试用例
|
||||
|
||||
| 测试项 | 预期结果 |
|
||||
|-------|---------|
|
||||
| POST 请求 Content-Type | application/json |
|
||||
| 签名参数存在 | timestamp, nonce, sign |
|
||||
| 成功响应格式 | { status: 1, msg: "...", data: {...} } |
|
||||
| 错误响应处理 | 显示 msg 提示 |
|
||||
| 未登录处理 | 跳转登录页 |
|
||||
| 需绑定手机号处理 | 跳转绑定页 |
|
||||
|
||||
### 集成测试清单
|
||||
|
||||
按模块逐一测试：
|
||||
|
||||
1. **认证模块**: 登录、绑定手机号
|
||||
2. **用户模块**: 获取用户信息、VIP 信息
|
||||
3. **商品模块**: 商品列表、详情、奖品
|
||||
4. **订单模块**: 下单、支付、抽奖结果
|
||||
5. **仓库模块**: 回收、发货
|
||||
6. **优惠券模块**: 列表、领取、合成
|
||||
7. **福利模块**: 签到、任务
|
||||
8. **其他模块**: 收藏、排行榜、邀请、兑换码
|
||||
81
.kiro/specs/frontend-api-refactor/requirements.md
Normal file
81
.kiro/specs/frontend-api-refactor/requirements.md
Normal file
|
|
@ -0,0 +1,81 @@
|
|||
# Requirements Document
|
||||
|
||||
## Introduction
|
||||
|
||||
本需求文档描述前端 API 接口调用重构工作。目标是将分散在页面和组件中的接口调用统一收敛到 `common/server/` 模块，实现接口集中管理，并在改造过程中记录所有 API 地址，用于核对 C# 后端迁移完整性。
|
||||
|
||||
## Glossary
|
||||
|
||||
- **Server_Module**: `honey_box/common/server/` 目录下的 API 接口封装模块
|
||||
- **RequestManager**: 现有的网络请求工具类 (`honey_box/common/request.js`)
|
||||
- **Page**: `honey_box/pages/` 目录下的页面文件
|
||||
- **Component**: `honey_box/components/` 目录下的组件文件
|
||||
- **API_Registry**: 接口清单文档，记录所有前端使用的 API 地址及迁移状态
|
||||
|
||||
## Requirements
|
||||
|
||||
### Requirement 1: 修改请求格式
|
||||
|
||||
**User Story:** As a 开发者, I want POST 请求使用 JSON 格式, so that 与 C# 后端兼容。
|
||||
|
||||
#### Acceptance Criteria
|
||||
|
||||
1. WHEN 发送 POST 请求 THEN RequestManager SHALL 使用 `application/json` 作为 Content-Type
|
||||
2. WHEN 发送请求 THEN RequestManager SHALL 保持现有签名机制不变
|
||||
3. WHEN 请求完成 THEN RequestManager SHALL 返回与 PHP 版本一致的响应格式
|
||||
|
||||
### Requirement 2: 创建 Server 模块
|
||||
|
||||
**User Story:** As a 开发者, I want 按业务域划分 API 模块, so that 接口集中管理便于维护。
|
||||
|
||||
#### Acceptance Criteria
|
||||
|
||||
1. THE Server_Module SHALL 按业务域划分为独立文件（auth、user、goods、order、warehouse、coupon、welfare、collection、address、config、rank、invitation、redeem、pay）
|
||||
2. WHEN 定义接口函数 THEN Server_Module SHALL 使用语义化的函数名（如 `getUserInfo`、`getGoodsList`）
|
||||
3. WHEN 接口调用失败 THEN Server_Module SHALL 统一处理错误并返回标准格式
|
||||
4. THE Server_Module SHALL 不使用 index.js 统一导出，各模块独立导入
|
||||
|
||||
### Requirement 3: 重构页面接口调用
|
||||
|
||||
**User Story:** As a 开发者, I want 页面通过 Server 模块调用接口, so that 接口路径不再硬编码在页面中。
|
||||
|
||||
#### Acceptance Criteria
|
||||
|
||||
1. WHEN 页面需要调用接口 THEN Page SHALL 从对应 Server_Module 导入函数
|
||||
2. WHEN 页面调用接口 THEN Page SHALL 使用 `await` 方式调用导入的函数
|
||||
3. THE Page SHALL 不再直接使用 `this.req()`、`RequestManager.post()` 等方式硬编码 URL
|
||||
4. WHEN 重构页面 THEN 开发者 SHALL 记录该页面使用的所有 API 地址到 API_Registry
|
||||
|
||||
### Requirement 4: 重构组件接口调用
|
||||
|
||||
**User Story:** As a 开发者, I want 组件通过 Server 模块调用接口, so that 组件中的接口也能集中管理。
|
||||
|
||||
#### Acceptance Criteria
|
||||
|
||||
1. WHEN 组件需要调用接口 THEN Component SHALL 从对应 Server_Module 导入函数
|
||||
2. WHEN 组件调用接口 THEN Component SHALL 使用 `await` 方式调用导入的函数
|
||||
3. THE Component SHALL 不再直接使用 `this.req()`、`RequestManager.post()` 等方式硬编码 URL
|
||||
4. WHEN 重构组件 THEN 开发者 SHALL 记录该组件使用的所有 API 地址到 API_Registry
|
||||
|
||||
### Requirement 5: 生成接口清单
|
||||
|
||||
**User Story:** As a 开发者, I want 记录所有前端使用的 API 地址, so that 能核对 C# 后端是否遗漏接口。
|
||||
|
||||
#### Acceptance Criteria
|
||||
|
||||
1. THE API_Registry SHALL 记录每个接口的 URL 路径
|
||||
2. THE API_Registry SHALL 记录每个接口所属的 Server_Module
|
||||
3. THE API_Registry SHALL 记录每个接口的请求方式（GET/POST）
|
||||
4. THE API_Registry SHALL 标注每个接口在 C# 后端的迁移状态（已迁移/未迁移/待确认）
|
||||
5. THE API_Registry SHALL 记录每个接口被哪些页面/组件使用
|
||||
|
||||
### Requirement 6: 保持功能兼容
|
||||
|
||||
**User Story:** As a 用户, I want 重构后功能正常, so that 不影响正常使用。
|
||||
|
||||
#### Acceptance Criteria
|
||||
|
||||
1. WHEN 重构完成 THEN 所有现有功能 SHALL 正常工作
|
||||
2. WHEN 接口返回错误 THEN 系统 SHALL 正确显示错误提示
|
||||
3. WHEN 用户未登录 THEN 系统 SHALL 正确跳转到登录页
|
||||
4. WHEN 需要绑定手机号 THEN 系统 SHALL 正确跳转到绑定页面
|
||||
180
.kiro/specs/frontend-api-refactor/tasks.md
Normal file
180
.kiro/specs/frontend-api-refactor/tasks.md
Normal file
|
|
@ -0,0 +1,180 @@
|
|||
# Implementation Plan: Frontend API Refactor
|
||||
|
||||
## Overview
|
||||
|
||||
将前端 API 调用从分散的 `this.req()` 和 `RequestManager.post()` 模式重构为集中的 Server Module 模式。改造过程中记录所有 API 地址，生成接口清单用于核对 C# 后端迁移完整性。
|
||||
|
||||
## Tasks
|
||||
|
||||
- [x] 1. 修改 RequestManager 请求格式
|
||||
- [x] 1.1 修改 POST 请求 Content-Type 为 application/json
|
||||
- 修改 `honey_box/common/request.js` 第 166 行
|
||||
- 将 `'content-type': 'application/x-www-form-urlencoded'` 改为 `'content-type': 'application/json'`
|
||||
- _Requirements: 1.1_
|
||||
|
||||
- [ ] 2. 创建 Server Modules
|
||||
- [ ] 2.1 创建 auth.js 认证模块
|
||||
- 创建 `honey_box/common/server/auth.js`
|
||||
- 实现: wxLogin, mobileLogin, bindMobileByWx, bindMobileByCode, recordLogin, logOff
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
- [ ] 2.2 扩展 user.js 用户模块
|
||||
- 修改 `honey_box/common/server/user.js`
|
||||
- 新增: updateUserInfo, getVipList, getProfitMoney, getProfitIntegral, getProfitScore, getProfitPay
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
- [ ] 2.3 创建 goods.js 商品模块
|
||||
- 创建 `honey_box/common/server/goods.js`
|
||||
- 实现: getGoodsList, getGoodsDetail, getGoodsChildren, getGoodsExtend, getGoodsNumList, getGoodsNumDetail, getGoodsPrizeCount, getGoodsPrizeContent, getGoodsPrizeLogs
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
- [ ] 2.4 扩展 order.js 订单模块
|
||||
- 修改 `honey_box/common/server/order.js`
|
||||
- 新增: calcOrderMoney, createOrder, calcInfiniteOrderMoney, createInfiniteOrder, calcMallOrderMoney, getOrderList, getOrderDetail, getPrizeOrderLog, getInfinitePrizeOrderLog, useItemCard
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
- [ ] 2.5 创建 warehouse.js 仓库模块
|
||||
- 创建 `honey_box/common/server/warehouse.js`
|
||||
- 实现: getWarehouseIndex, recoveryPrize, sendPrize, confirmSend, getSendRecord, getSendRecordDetail, getRecoveryRecord, getLogistics
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
- [ ] 2.6 创建 coupon.js 优惠券模块
|
||||
- 创建 `honey_box/common/server/coupon.js`
|
||||
- 实现: getCouponList, getCouponDetail, receiveCoupon, shareCoupon, synthesisCoupon, calcSynthesis
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
- [ ] 2.7 创建 welfare.js 福利模块
|
||||
- 创建 `honey_box/common/server/welfare.js`
|
||||
- 实现: getWelfareHouseList, getWelfareHouseDetail, buyWelfareHouse, getSignInfo, doSign, getTaskList, receiveTaskReward
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
- [ ] 2.8 创建 collection.js 收藏模块
|
||||
- 创建 `honey_box/common/server/collection.js`
|
||||
- 实现: getCollectionList, addCollection, cancelCollection, getCollectionStatus
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
- [ ] 2.9 创建 rank.js 排行榜模块
|
||||
- 创建 `honey_box/common/server/rank.js`
|
||||
- 实现: getRankList
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
- [ ] 2.10 创建 invitation.js 邀请模块
|
||||
- 创建 `honey_box/common/server/invitation.js`
|
||||
- 实现: getInvitationInfo, getInvitationRecord
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
- [ ] 2.11 创建 redeem.js 兑换码模块
|
||||
- 创建 `honey_box/common/server/redeem.js`
|
||||
- 实现: useRedeemCode
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
- [ ] 2.12 创建 pay.js 支付模块
|
||||
- 创建 `honey_box/common/server/pay.js`
|
||||
- 实现: wxPay, balancePay, recharge
|
||||
- _Requirements: 2.1, 2.2, 2.3_
|
||||
|
||||
- [ ] 3. Checkpoint - Server Modules 完成
|
||||
- 确保所有 Server Module 创建完成
|
||||
- 检查函数命名是否语义化
|
||||
- 确认错误处理逻辑一致
|
||||
|
||||
- [ ] 4. 重构页面接口调用 - shouye 模块
|
||||
- [ ] 4.1 重构 pages/shouye/index.vue
|
||||
- 替换 this.req() 调用为 Server Module 导入
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
- [ ] 4.2 重构 pages/shouye/detail.vue
|
||||
- 替换 this.req() 调用为 Server Module 导入
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
- [ ] 4.3 重构 pages/shouye/detail_wuxian.vue
|
||||
- 替换 this.req() 调用为 Server Module 导入
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
- [ ] 4.4 重构 pages/shouye 其他页面
|
||||
- 包括: bangdan.vue, ranking.vue, dada_ranking.vue, yaoqing_ranking.vue, rili.vue, danye.vue, huanxiang.vue, slots.vue
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
|
||||
- [ ] 5. 重构页面接口调用 - user 模块
|
||||
- [ ] 5.1 重构 pages/user/login.vue
|
||||
- 替换登录相关接口调用
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
- [ ] 5.2 重构 pages/user/index.vue
|
||||
- 替换用户信息相关接口调用
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
- [ ] 5.3 重构 pages/user 其他页面
|
||||
- 包括: bangding.vue, bangdingweb.vue, vip.vue, coupon.vue, my_coupon.vue, order.vue, myCa.vue, change.vue, bi_jl.vue, jf_jl.vue, xfjl.vue, fhjl.vue, hsjl.vue, tui-guang.vue, yetx.vue, recharge-page.vue, cancel-account-page.vue, wuliu_detail.vue
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
|
||||
- [ ] 6. 重构页面接口调用 - other 模块
|
||||
- [ ] 6.1 重构 pages/other 所有页面
|
||||
- 包括: about.vue, address_edit.vue, choose_address.vue, order_info.vue, order_list.vue, prize_draw.vue, web-detail-lucky.vue, web-pay-order.vue, web-pay-success.vue
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
|
||||
- [ ] 7. 重构页面接口调用 - 其他模块
|
||||
- [ ] 7.1 重构 pages/mall/index.vue
|
||||
- 替换商城相关接口调用
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
- [ ] 7.2 重构 pages/infinite 所有页面
|
||||
- 包括: index.vue, benefit.vue, bonus_house.vue, bonus_house_details.vue, daily_check_in.vue, reward_records.vue
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
- [ ] 7.3 重构 pages/hegui/hegui.vue
|
||||
- 替换盒柜相关接口调用
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
- [ ] 7.4 重构 pages/guize/guize.vue
|
||||
- 替换规则相关接口调用
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
|
||||
- [ ] 8. 重构 package 分包页面
|
||||
- [ ] 8.1 重构 package/index 所有页面
|
||||
- 包括: coupon-center.vue, leitai.vue, lian-ji.vue, sign.vue
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
- [ ] 8.2 重构 package/mine 所有页面
|
||||
- 包括: collect.vue, coupon-detail.vue, equity.vue, qy-rule.vue, skill-card.vue, ti-qu.vue
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 3.1, 3.2, 3.3, 3.4_
|
||||
|
||||
- [ ] 9. Checkpoint - 页面重构完成
|
||||
- 确保所有页面不再使用 this.req() 硬编码 URL
|
||||
- 检查 API 地址清单完整性
|
||||
|
||||
- [ ] 10. 重构组件接口调用
|
||||
- [ ] 10.1 重构 components/detail-lucky 组件
|
||||
- 包括: detail-lucky.vue, detail-lucky-canvas.vue, detail-lucky-web.vue, detail-bao-xiang.vue, detail-grand-prize.vue
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 4.1, 4.2, 4.3, 4.4_
|
||||
- [ ] 10.2 重构 components/pay-dialog/pay-dialog.vue
|
||||
- 替换支付相关接口调用
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 4.1, 4.2, 4.3, 4.4_
|
||||
- [ ] 10.3 重构 components/order-confirm-popup 组件
|
||||
- 包括: order-confirm-popup.vue, order-confirm-popup-flw.vue
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 4.1, 4.2, 4.3, 4.4_
|
||||
- [ ] 10.4 重构其他使用接口的组件
|
||||
- 检查并重构: collect-btn, coupon-pop, detail-toolbar, detail-wuxian-lingzhu, detail-wuxian-rage 等
|
||||
- 记录使用的 API 地址到清单
|
||||
- _Requirements: 4.1, 4.2, 4.3, 4.4_
|
||||
|
||||
- [ ] 11. 生成接口清单文档
|
||||
- [ ] 11.1 创建 API 接口清单文档
|
||||
- 创建 `docs/前端适配调整/API接口清单.md`
|
||||
- 记录所有 API URL、所属模块、请求方式、使用位置
|
||||
- _Requirements: 5.1, 5.2, 5.3, 5.5_
|
||||
- [ ] 11.2 标注 C# 后端迁移状态
|
||||
- 对照 C# 后端代码，标注每个接口的迁移状态
|
||||
- 列出未迁移的接口清单
|
||||
- _Requirements: 5.4_
|
||||
|
||||
- [ ] 12. Final Checkpoint - 功能验证
|
||||
- 确保所有功能正常工作
|
||||
- 验证错误提示正确显示
|
||||
- 验证登录跳转正常
|
||||
- 验证绑定手机号跳转正常
|
||||
- _Requirements: 6.1, 6.2, 6.3, 6.4_
|
||||
|
||||
## Notes
|
||||
|
||||
- 每个任务完成后需记录该文件使用的 API 地址
|
||||
- 重构时保持原有业务逻辑不变
|
||||
- 如发现未迁移的接口，记录到清单中
|
||||
- 建议按模块逐一测试，确保功能正常
|
||||
280
docs/前端适配调整/request.js修改方案.md
Normal file
280
docs/前端适配调整/request.js修改方案.md
Normal file
|
|
@ -0,0 +1,280 @@
|
|||
# request.js 修改方案
|
||||
|
||||
## 1. 核心修改
|
||||
|
||||
### 1.1 修改 Content-Type
|
||||
|
||||
将 POST 请求的 Content-Type 从 `application/x-www-form-urlencoded` 改为 `application/json`。
|
||||
|
||||
### 1.2 修改位置
|
||||
|
||||
文件：`honey_box/common/request.js`
|
||||
|
||||
找到以下代码块（约第 130-140 行）：
|
||||
|
||||
```javascript
|
||||
if (method.toUpperCase() == 'POST') {
|
||||
// ... 签名计算代码 ...
|
||||
|
||||
header = {
|
||||
'content-type': 'application/x-www-form-urlencoded',
|
||||
client: client,
|
||||
token: token,
|
||||
adid: uni.getStorageSync('_ad_id'),
|
||||
clickid: uni.getStorageSync('_click_id')
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 1.3 修改后代码
|
||||
|
||||
```javascript
|
||||
if (method.toUpperCase() == 'POST') {
|
||||
// ... 签名计算代码保持不变 ...
|
||||
|
||||
header = {
|
||||
'content-type': 'application/json', // 修改这一行
|
||||
client: client,
|
||||
token: token,
|
||||
adid: uni.getStorageSync('_ad_id'),
|
||||
clickid: uni.getStorageSync('_click_id')
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 2. 完整修改后的 request.js
|
||||
|
||||
```javascript
|
||||
/**
|
||||
* 网络请求工具类
|
||||
* 封装统一的网络请求方法
|
||||
*/
|
||||
|
||||
import EnvConfig from '@/common/env.js'
|
||||
import md5 from 'js-md5'
|
||||
|
||||
import { apiWhiteList } from '@/common/config.js'
|
||||
import RouterManager from '@/common/router.js'
|
||||
import { platform } from '@/common/platform/PlatformFactory'
|
||||
|
||||
class RequestManager {
|
||||
// 缓存对象
|
||||
static cache = {
|
||||
data: new Map(),
|
||||
expireTime: 5 * 60 * 1000,
|
||||
timestamps: new Map()
|
||||
};
|
||||
|
||||
static isCacheValid(cacheKey) {
|
||||
const now = Date.now();
|
||||
if (this.cache.data.has(cacheKey)) {
|
||||
const timestamp = this.cache.timestamps.get(cacheKey);
|
||||
return now - timestamp < this.cache.expireTime;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
static updateCache(cacheKey, data) {
|
||||
this.cache.data.set(cacheKey, data);
|
||||
this.cache.timestamps.set(cacheKey, Date.now());
|
||||
}
|
||||
|
||||
static getCache(url, data = {}, showLoading = false) {
|
||||
const cacheKey = url + JSON.stringify(data);
|
||||
if (this.isCacheValid(cacheKey)) {
|
||||
console.log(cacheKey + '缓存有效');
|
||||
return Promise.resolve(this.cache.data.get(cacheKey));
|
||||
}
|
||||
return this.get(url, data, showLoading).then(result => {
|
||||
this.updateCache(cacheKey, result);
|
||||
return result;
|
||||
});
|
||||
}
|
||||
|
||||
static isUrlInWhitelist(url) {
|
||||
return apiWhiteList.some(whiteItem => url.indexOf(whiteItem) > -1);
|
||||
}
|
||||
|
||||
static generateNonce() {
|
||||
return md5(Date.now() + Math.random().toString(36).substring(2, 15));
|
||||
}
|
||||
|
||||
static request(param, backpage, backtype) {
|
||||
return new Promise((resolve, reject) => {
|
||||
if (!param || typeof param !== 'object') {
|
||||
reject(new Error('请求参数错误'))
|
||||
return
|
||||
}
|
||||
|
||||
uni.getNetworkType({
|
||||
success: function (res) {
|
||||
if (res.networkType == 'none') {
|
||||
uni.showToast({
|
||||
title: '网络连接异常，请检查网络',
|
||||
icon: 'none'
|
||||
})
|
||||
reject(new Error('网络连接异常'))
|
||||
return
|
||||
}
|
||||
}
|
||||
})
|
||||
|
||||
const url = param.url || ''
|
||||
const method = param.method || 'POST'
|
||||
const data = param.data || {}
|
||||
const Loading = param.Loading || false
|
||||
const token = uni.getStorageSync('token')
|
||||
let client = platform.code
|
||||
const apiBaseUrl = EnvConfig.apiBaseUrl
|
||||
|
||||
let requestUrl = ''
|
||||
if (url.startsWith('http://') || url.startsWith('https://')) {
|
||||
requestUrl = url
|
||||
} else {
|
||||
const baseUrlWithSlash = apiBaseUrl.endsWith('/') ? apiBaseUrl : apiBaseUrl + '/'
|
||||
const path = url.startsWith('/') ? url.substring(1) : url
|
||||
requestUrl = baseUrlWithSlash + path
|
||||
}
|
||||
|
||||
const hostRegex = /^(?:https?:\/\/)?([^\/]+)/i
|
||||
const matches = requestUrl.match(hostRegex)
|
||||
const host = matches && matches[1] ? matches[1] : 'localhost'
|
||||
|
||||
let header = {}
|
||||
|
||||
// 添加签名参数
|
||||
data.timestamp = Math.floor(Date.now() / 1000)
|
||||
data.nonce = RequestManager.generateNonce()
|
||||
|
||||
// 统一签名计算逻辑
|
||||
const sortedParams = {}
|
||||
Object.keys(data).sort().forEach(key => {
|
||||
sortedParams[key] = data[key]
|
||||
})
|
||||
|
||||
let signStr = ''
|
||||
for (const key in sortedParams) {
|
||||
if (typeof sortedParams[key] === 'object') {
|
||||
signStr += key + '=' + JSON.stringify(sortedParams[key]) + '&'
|
||||
} else {
|
||||
signStr += key + '=' + sortedParams[key] + '&'
|
||||
}
|
||||
}
|
||||
|
||||
const timestamp = data.timestamp
|
||||
const appSecret = host + timestamp
|
||||
signStr = signStr.substring(0, signStr.length - 1) + appSecret
|
||||
const sign = md5(signStr)
|
||||
data.sign = sign
|
||||
|
||||
// 统一使用 JSON 格式的请求头
|
||||
header = {
|
||||
'content-type': 'application/json', // 关键修改：统一使用 JSON
|
||||
client: client,
|
||||
token: token,
|
||||
adid: uni.getStorageSync('_ad_id'),
|
||||
clickid: uni.getStorageSync('_click_id')
|
||||
}
|
||||
|
||||
if (!Loading) {
|
||||
uni.showLoading({
|
||||
title: '加载中...'
|
||||
})
|
||||
}
|
||||
|
||||
uni.request({
|
||||
url: requestUrl,
|
||||
method: method.toUpperCase(),
|
||||
header: header,
|
||||
data: data,
|
||||
success: res => {
|
||||
// ... 响应处理代码保持不变 ...
|
||||
},
|
||||
fail: e => {
|
||||
console.error('网络请求失败:', e)
|
||||
uni.showToast({
|
||||
title: e.errMsg || '请求失败',
|
||||
icon: 'none'
|
||||
})
|
||||
typeof param.fail == 'function' && param.fail(e)
|
||||
reject(e)
|
||||
},
|
||||
complete: () => {
|
||||
uni.hideLoading()
|
||||
typeof param.complete == 'function' && param.complete()
|
||||
}
|
||||
})
|
||||
})
|
||||
}
|
||||
|
||||
static get(url, data = {}, showLoading = true) {
|
||||
return this.request({
|
||||
url,
|
||||
data,
|
||||
method: 'GET',
|
||||
Loading: !showLoading
|
||||
})
|
||||
}
|
||||
|
||||
static post(url, data = {}, showLoading = true) {
|
||||
return this.request({
|
||||
url,
|
||||
data,
|
||||
method: 'POST',
|
||||
Loading: !showLoading
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
export default RequestManager;
|
||||
```
|
||||
|
||||
## 3. 签名机制说明
|
||||
|
||||
修改 Content-Type 后，签名机制保持不变：
|
||||
|
||||
1. 参数按键名排序
|
||||
2. 拼接为 `key=value&` 格式
|
||||
3. 添加密钥 `host + timestamp`
|
||||
4. MD5 加密生成签名
|
||||
|
||||
后端需要确保能正确解析 JSON 格式的请求体并验证签名。
|
||||
|
||||
## 4. 后端签名验证
|
||||
|
||||
C# 后端需要从 JSON 请求体中提取参数进行签名验证：
|
||||
|
||||
```csharp
|
||||
// 示例：签名验证中间件
|
||||
public class SignatureValidationMiddleware
|
||||
{
|
||||
public async Task InvokeAsync(HttpContext context)
|
||||
{
|
||||
if (context.Request.Method == "POST" &&
|
||||
context.Request.ContentType?.Contains("application/json") == true)
|
||||
{
|
||||
// 读取请求体
|
||||
context.Request.EnableBuffering();
|
||||
var body = await new StreamReader(context.Request.Body).ReadToEndAsync();
|
||||
context.Request.Body.Position = 0;
|
||||
|
||||
// 解析 JSON 并验证签名
|
||||
var data = JsonSerializer.Deserialize<Dictionary<string, object>>(body);
|
||||
// ... 签名验证逻辑 ...
|
||||
}
|
||||
|
||||
await _next(context);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 5. 测试验证
|
||||
|
||||
修改后需要测试以下场景：
|
||||
|
||||
1. **登录接口**：`POST /api/login`
|
||||
2. **获取用户信息**：`POST /api/user`
|
||||
3. **商品列表**：`POST /api/goods_list`
|
||||
4. **创建订单**：`POST /api/orderbuy`
|
||||
|
||||
确保签名验证通过，数据正确传递。
|
||||
301
docs/前端适配调整/前端API适配方案.md
Normal file
301
docs/前端适配调整/前端API适配方案.md
Normal file
|
|
@ -0,0 +1,301 @@
|
|||
# 前端API适配方案
|
||||
|
||||
## 1. 问题概述
|
||||
|
||||
在将后端从 PHP (ThinkPHP 6.0) 迁移到 .NET 10 的过程中，前端 UniApp 项目需要进行适配调整。主要问题包括：
|
||||
|
||||
1. **请求格式不兼容**：前端使用 `application/x-www-form-urlencoded`，后端期望 `application/json`
|
||||
2. **请求方式不一致**：同一接口在不同页面使用不同的请求方式（GET/POST）
|
||||
3. **部分接口遗漏**：如 `/api/goods_list`、`/api/coupon` 等接口未正确对接
|
||||
|
||||
## 2. 当前前端请求机制分析
|
||||
|
||||
### 2.1 请求封装 (`honey_box/common/request.js`)
|
||||
|
||||
当前请求封装的关键特点：
|
||||
|
||||
```javascript
|
||||
// POST 请求使用 form-urlencoded
|
||||
if (method.toUpperCase() == 'POST') {
|
||||
header = {
|
||||
'content-type': 'application/x-www-form-urlencoded',
|
||||
// ...
|
||||
}
|
||||
} else {
|
||||
// GET 请求使用 json
|
||||
header = {
|
||||
'content-type': 'application/json',
|
||||
// ...
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 2.2 签名机制
|
||||
|
||||
前端对所有请求都添加了签名参数：
|
||||
- `timestamp`: 时间戳
|
||||
- `nonce`: 随机字符串
|
||||
- `sign`: MD5签名
|
||||
|
||||
签名算法：
|
||||
1. 参数按键名排序
|
||||
2. 拼接为 `key=value&` 格式
|
||||
3. 添加密钥 `host + timestamp`
|
||||
4. MD5 加密
|
||||
|
||||
## 3. 适配方案
|
||||
|
||||
### 方案一：前端统一改为 JSON 格式（推荐）
|
||||
|
||||
#### 3.1 修改 `request.js`
|
||||
|
||||
将 POST 请求的 Content-Type 改为 `application/json`：
|
||||
|
||||
```javascript
|
||||
// 修改前
|
||||
if (method.toUpperCase() == 'POST') {
|
||||
header = {
|
||||
'content-type': 'application/x-www-form-urlencoded',
|
||||
// ...
|
||||
}
|
||||
}
|
||||
|
||||
// 修改后
|
||||
if (method.toUpperCase() == 'POST') {
|
||||
header = {
|
||||
'content-type': 'application/json',
|
||||
// ...
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 3.2 完整修改示例
|
||||
|
||||
```javascript
|
||||
static request(param, backpage, backtype) {
|
||||
return new Promise((resolve, reject) => {
|
||||
// ... 参数检查代码 ...
|
||||
|
||||
const url = param.url || ''
|
||||
const method = param.method || 'POST'
|
||||
const data = param.data || {}
|
||||
const Loading = param.Loading || false
|
||||
const token = uni.getStorageSync('token')
|
||||
let client = platform.code
|
||||
|
||||
// ... URL 拼接代码 ...
|
||||
|
||||
// 添加签名参数
|
||||
data.timestamp = Math.floor(Date.now() / 1000)
|
||||
data.nonce = RequestManager.generateNonce()
|
||||
|
||||
// 生成签名
|
||||
const sortedParams = {}
|
||||
Object.keys(data).sort().forEach(key => {
|
||||
sortedParams[key] = data[key]
|
||||
})
|
||||
|
||||
let signStr = ''
|
||||
for (const key in sortedParams) {
|
||||
if (typeof sortedParams[key] === 'object') {
|
||||
signStr += key + '=' + JSON.stringify(sortedParams[key]) + '&'
|
||||
} else {
|
||||
signStr += key + '=' + sortedParams[key] + '&'
|
||||
}
|
||||
}
|
||||
|
||||
const timestamp = data.timestamp
|
||||
const appSecret = host + timestamp
|
||||
signStr = signStr.substring(0, signStr.length - 1) + appSecret
|
||||
const sign = md5(signStr)
|
||||
data.sign = sign
|
||||
|
||||
// 统一使用 JSON 格式
|
||||
const header = {
|
||||
'content-type': 'application/json',
|
||||
client: client,
|
||||
token: token,
|
||||
adid: uni.getStorageSync('_ad_id'),
|
||||
clickid: uni.getStorageSync('_click_id')
|
||||
}
|
||||
|
||||
// ... 发起请求代码 ...
|
||||
})
|
||||
}
|
||||
```
|
||||
|
||||
### 方案二：后端兼容 form-urlencoded（备选）
|
||||
|
||||
如果不想修改前端，可以在后端添加中间件支持 form-urlencoded：
|
||||
|
||||
```csharp
|
||||
// 在 Program.cs 中添加
|
||||
builder.Services.AddControllers()
|
||||
.AddNewtonsoftJson()
|
||||
.ConfigureApiBehaviorOptions(options =>
|
||||
{
|
||||
// 支持 form-urlencoded
|
||||
});
|
||||
```
|
||||
|
||||
但这种方案不推荐，因为：
|
||||
1. 增加后端复杂度
|
||||
2. 不符合 RESTful API 规范
|
||||
3. 后续维护困难
|
||||
|
||||
## 4. 接口请求方式统一
|
||||
|
||||
### 4.1 当前接口请求方式对照表
|
||||
|
||||
| 接口路径 | PHP 旧版 | C# 新版 | 前端当前使用 | 需要调整 |
|
||||
|---------|---------|---------|-------------|---------|
|
||||
| `/api/config` | GET/POST | GET | GET | ✅ 无需调整 |
|
||||
| `/api/getPlatformConfig` | GET/POST | GET | GET | ✅ 无需调整 |
|
||||
| `/api/getAdvert` | GET/POST | GET/POST | GET | ✅ 无需调整 |
|
||||
| `/api/getDanye` | GET/POST | GET | GET | ✅ 无需调整 |
|
||||
| `/api/goods_list` | POST | POST | POST | ✅ 无需调整 |
|
||||
| `/api/goods_detail` | POST | POST | POST | ✅ 无需调整 |
|
||||
| `/api/user` | POST | POST | GET | ⚠️ 需要调整 |
|
||||
| `/api/login` | POST | POST | POST | ✅ 无需调整 |
|
||||
| `/api/mobileLogin` | POST | POST | POST | ✅ 无需调整 |
|
||||
| `/api/coupon_list` | POST | POST | POST | ✅ 无需调整 |
|
||||
| `/api/order_list` | POST | POST | POST | ✅ 无需调整 |
|
||||
|
||||
### 4.2 需要调整的接口
|
||||
|
||||
#### `/api/user` - 获取用户信息
|
||||
|
||||
**问题**：前端 `user.js` 使用 GET 请求，后端期望 POST
|
||||
|
||||
```javascript
|
||||
// honey_box/common/server/user.js
|
||||
// 修改前
|
||||
export const getUserInfo = async () => {
|
||||
const res = await RequestManager.get('/userInfo');
|
||||
// ...
|
||||
}
|
||||
|
||||
// 修改后
|
||||
export const getUserInfo = async () => {
|
||||
const res = await RequestManager.post('/user');
|
||||
// ...
|
||||
}
|
||||
```
|
||||
|
||||
## 5. 遗漏接口清单
|
||||
|
||||
根据分析，以下接口可能存在问题：
|
||||
|
||||
### 5.1 商品相关
|
||||
|
||||
| 接口 | 状态 | 说明 |
|
||||
|-----|------|-----|
|
||||
| `POST /api/goods_list` | ⚠️ 需检查 | 前端请求格式需改为 JSON |
|
||||
| `POST /api/goods_detail` | ⚠️ 需检查 | 前端请求格式需改为 JSON |
|
||||
|
||||
### 5.2 优惠券相关
|
||||
|
||||
| 接口 | 状态 | 说明 |
|
||||
|-----|------|-----|
|
||||
| `POST /api/coupon_list` | ⚠️ 需检查 | 前端请求格式需改为 JSON |
|
||||
| `POST /api/coupon_detail` | ⚠️ 需检查 | 前端请求格式需改为 JSON |
|
||||
| `POST /api/coupon_ling` | ⚠️ 需检查 | 前端请求格式需改为 JSON |
|
||||
|
||||
### 5.3 订单相关
|
||||
|
||||
| 接口 | 状态 | 说明 |
|
||||
|-----|------|-----|
|
||||
| `POST /api/ordermoney` | ⚠️ 需检查 | 前端请求格式需改为 JSON |
|
||||
| `POST /api/orderbuy` | ⚠️ 需检查 | 前端请求格式需改为 JSON |
|
||||
|
||||
## 6. 实施步骤
|
||||
|
||||
### 第一阶段：修改请求封装（核心）
|
||||
|
||||
1. 修改 `honey_box/common/request.js`
|
||||
2. 将 POST 请求的 Content-Type 改为 `application/json`
|
||||
3. 测试基础接口（登录、配置获取）
|
||||
|
||||
### 第二阶段：统一接口调用方式
|
||||
|
||||
1. 检查 `honey_box/common/server/` 下所有接口文件
|
||||
2. 统一使用正确的请求方式（GET/POST）
|
||||
3. 确保接口路径与后端一致
|
||||
|
||||
### 第三阶段：逐模块测试
|
||||
|
||||
1. 用户认证模块（登录、注册、绑定手机号）
|
||||
2. 商品模块（列表、详情、奖品）
|
||||
3. 订单模块（下单、支付、抽奖）
|
||||
4. 仓库模块（回收、发货）
|
||||
5. 福利模块（签到、任务）
|
||||
|
||||
## 7. 代码修改清单
|
||||
|
||||
### 7.1 `honey_box/common/request.js`
|
||||
|
||||
```diff
|
||||
- header = {
|
||||
- 'content-type': 'application/x-www-form-urlencoded',
|
||||
- client: client,
|
||||
- token: token,
|
||||
- adid: uni.getStorageSync('_ad_id'),
|
||||
- clickid: uni.getStorageSync('_click_id')
|
||||
- }
|
||||
+ header = {
|
||||
+ 'content-type': 'application/json',
|
||||
+ client: client,
|
||||
+ token: token,
|
||||
+ adid: uni.getStorageSync('_ad_id'),
|
||||
+ clickid: uni.getStorageSync('_click_id')
|
||||
+ }
|
||||
```
|
||||
|
||||
### 7.2 `honey_box/common/server/user.js`
|
||||
|
||||
```diff
|
||||
export const getUserInfo = async () => {
|
||||
- const res = await RequestManager.get('/userInfo');
|
||||
+ const res = await RequestManager.post('/user');
|
||||
if (res.status == 1) {
|
||||
res.data.money = common.removeTrailingZeros(res.data.money);
|
||||
res.data.integral = common.removeTrailingZeros(res.data.integral);
|
||||
res.data.money2 = common.removeTrailingZeros(res.data.money2);
|
||||
return res.data;
|
||||
} else {
|
||||
return null;
|
||||
}
|
||||
};
|
||||
```
|
||||
|
||||
## 8. 测试验证
|
||||
|
||||
### 8.1 测试用例
|
||||
|
||||
| 测试项 | 预期结果 | 实际结果 |
|
||||
|-------|---------|---------|
|
||||
| 获取系统配置 | 返回配置数据 | |
|
||||
| 手机号登录 | 返回 token | |
|
||||
| 获取用户信息 | 返回用户数据 | |
|
||||
| 获取商品列表 | 返回商品分页数据 | |
|
||||
| 获取优惠券列表 | 返回优惠券数据 | |
|
||||
| 创建订单 | 返回订单信息 | |
|
||||
|
||||
### 8.2 调试工具
|
||||
|
||||
前端已集成 eruda 调试工具，可在开发环境查看网络请求详情。
|
||||
|
||||
## 9. 注意事项
|
||||
|
||||
1. **签名机制保持不变**：修改 Content-Type 不影响签名计算
|
||||
2. **Token 传递方式不变**：继续通过 header 传递
|
||||
3. **响应格式不变**：后端返回格式与 PHP 版本保持一致
|
||||
4. **错误码保持一致**：status 码含义不变
|
||||
|
||||
## 10. 回滚方案
|
||||
|
||||
如果修改后出现问题，可以：
|
||||
|
||||
1. 恢复 `request.js` 中的 Content-Type 为 `application/x-www-form-urlencoded`
|
||||
2. 在后端添加 form-urlencoded 支持中间件
|
||||
3. 逐步排查问题接口
|
||||
194
docs/前端适配调整/实施检查清单.md
Normal file
194
docs/前端适配调整/实施检查清单.md
Normal file
|
|
@ -0,0 +1,194 @@
|
|||
# 前端适配实施检查清单
|
||||
|
||||
## 1. 修改前准备
|
||||
|
||||
- [ ] 备份当前前端代码
|
||||
- [ ] 确认后端 API 已部署并可访问
|
||||
- [ ] 准备测试账号和测试数据
|
||||
|
||||
## 2. 核心文件修改
|
||||
|
||||
### 2.1 request.js 修改
|
||||
|
||||
- [ ] 修改 `honey_box/common/request.js`
|
||||
- [ ] 将 POST 请求的 Content-Type 改为 `application/json`
|
||||
- [ ] 测试基础请求功能
|
||||
|
||||
### 2.2 接口文件修改
|
||||
|
||||
#### user.js
|
||||
- [ ] 修改 `honey_box/common/server/user.js`
|
||||
- [ ] 将 `/userInfo` 改为 `/user`
|
||||
- [ ] 将 GET 请求改为 POST 请求
|
||||
|
||||
```javascript
|
||||
// 修改前
|
||||
export const getUserInfo = async () => {
|
||||
const res = await RequestManager.get('/userInfo');
|
||||
// ...
|
||||
}
|
||||
|
||||
// 修改后
|
||||
export const getUserInfo = async () => {
|
||||
const res = await RequestManager.post('/user');
|
||||
// ...
|
||||
}
|
||||
```
|
||||
|
||||
#### config.js
|
||||
- [ ] 检查 `honey_box/common/server/config.js`
|
||||
- [ ] 确认接口路径正确
|
||||
|
||||
#### mall.js
|
||||
- [ ] 检查 `honey_box/common/server/mall.js`
|
||||
- [ ] 确认接口路径正确
|
||||
|
||||
#### order.js
|
||||
- [ ] 检查 `honey_box/common/server/order.js`
|
||||
- [ ] 确认接口路径正确
|
||||
|
||||
#### userAddress.js
|
||||
- [ ] 检查 `honey_box/common/server/userAddress.js`
|
||||
- [ ] 确认接口路径正确
|
||||
|
||||
## 3. 页面级别检查
|
||||
|
||||
### 3.1 用户模块 (`pages/user/`)
|
||||
|
||||
- [ ] 登录页面 - 微信登录
|
||||
- [ ] 登录页面 - 手机号登录
|
||||
- [ ] 用户中心 - 获取用户信息
|
||||
- [ ] 用户中心 - 更新用户信息
|
||||
- [ ] 绑定手机号页面
|
||||
- [ ] VIP 页面
|
||||
|
||||
### 3.2 首页模块 (`pages/shouye/`)
|
||||
|
||||
- [ ] 首页 - 商品列表
|
||||
- [ ] 商品详情页
|
||||
- [ ] 抽奖页面
|
||||
- [ ] 排行榜页面
|
||||
|
||||
### 3.3 商城模块 (`pages/mall/`)
|
||||
|
||||
- [ ] 商城首页
|
||||
- [ ] 商品详情
|
||||
- [ ] 购买流程
|
||||
|
||||
### 3.4 福利模块 (`pages/infinite/`)
|
||||
|
||||
- [ ] 签到页面
|
||||
- [ ] 任务列表
|
||||
- [ ] 福利屋
|
||||
|
||||
### 3.5 盒柜模块 (`pages/hegui/`)
|
||||
|
||||
- [ ] 仓库首页
|
||||
- [ ] 回收功能
|
||||
- [ ] 发货功能
|
||||
- [ ] 物流查询
|
||||
|
||||
### 3.6 其他页面 (`pages/other/`)
|
||||
|
||||
- [ ] 地址管理
|
||||
- [ ] 支付页面
|
||||
- [ ] 订单列表
|
||||
- [ ] 订单详情
|
||||
|
||||
## 4. 功能测试清单
|
||||
|
||||
### 4.1 用户认证
|
||||
|
||||
| 测试项 | 预期结果 | 测试结果 | 备注 |
|
||||
|-------|---------|---------|------|
|
||||
| 微信登录 | 返回 token | | |
|
||||
| 手机号登录 | 返回 token | | |
|
||||
| 获取用户信息 | 返回用户数据 | | |
|
||||
| 更新昵称 | 更新成功 | | |
|
||||
| 更新头像 | 更新成功 | | |
|
||||
| 绑定手机号 | 绑定成功 | | |
|
||||
|
||||
### 4.2 商品浏览
|
||||
|
||||
| 测试项 | 预期结果 | 测试结果 | 备注 |
|
||||
|-------|---------|---------|------|
|
||||
| 获取商品列表 | 返回分页数据 | | |
|
||||
| 获取商品详情 | 返回详情数据 | | |
|
||||
| 获取奖品列表 | 返回奖品数据 | | |
|
||||
| 获取箱号列表 | 返回箱号数据 | | |
|
||||
| 收藏商品 | 收藏成功 | | |
|
||||
| 取消收藏 | 取消成功 | | |
|
||||
|
||||
### 4.3 订单流程
|
||||
|
||||
| 测试项 | 预期结果 | 测试结果 | 备注 |
|
||||
|-------|---------|---------|------|
|
||||
| 计算订单金额 | 返回金额数据 | | |
|
||||
| 创建订单 | 返回订单号 | | |
|
||||
| 获取抽奖结果 | 返回中奖数据 | | |
|
||||
| 获取订单列表 | 返回订单列表 | | |
|
||||
| 获取订单详情 | 返回订单详情 | | |
|
||||
|
||||
### 4.4 仓库操作
|
||||
|
||||
| 测试项 | 预期结果 | 测试结果 | 备注 |
|
||||
|-------|---------|---------|------|
|
||||
| 获取仓库列表 | 返回奖品列表 | | |
|
||||
| 回收奖品 | 回收成功 | | |
|
||||
| 发货奖品 | 发货成功 | | |
|
||||
| 查看物流 | 返回物流信息 | | |
|
||||
|
||||
### 4.5 优惠券
|
||||
|
||||
| 测试项 | 预期结果 | 测试结果 | 备注 |
|
||||
|-------|---------|---------|------|
|
||||
| 获取优惠券列表 | 返回优惠券列表 | | |
|
||||
| 领取优惠券 | 领取成功 | | |
|
||||
| 分享优惠券 | 分享成功 | | |
|
||||
| 合成优惠券 | 合成成功 | | |
|
||||
|
||||
### 4.6 福利功能
|
||||
|
||||
| 测试项 | 预期结果 | 测试结果 | 备注 |
|
||||
|-------|---------|---------|------|
|
||||
| 获取签到信息 | 返回签到数据 | | |
|
||||
| 执行签到 | 签到成功 | | |
|
||||
| 获取任务列表 | 返回任务列表 | | |
|
||||
| 领取任务奖励 | 领取成功 | | |
|
||||
|
||||
## 5. 错误处理检查
|
||||
|
||||
- [ ] 网络错误提示正常
|
||||
- [ ] 未登录跳转正常
|
||||
- [ ] 需绑定手机号提示正常
|
||||
- [ ] 业务错误提示正常
|
||||
|
||||
## 6. 兼容性测试
|
||||
|
||||
- [ ] 微信小程序
|
||||
- [ ] H5 网页版
|
||||
- [ ] Android APP
|
||||
- [ ] iOS APP
|
||||
|
||||
## 7. 上线前确认
|
||||
|
||||
- [ ] 所有测试用例通过
|
||||
- [ ] 错误日志无异常
|
||||
- [ ] 性能无明显下降
|
||||
- [ ] 用户体验无影响
|
||||
|
||||
## 8. 回滚方案
|
||||
|
||||
如果出现问题：
|
||||
|
||||
1. 恢复 `request.js` 中的 Content-Type
|
||||
2. 在后端添加 form-urlencoded 支持
|
||||
3. 逐步排查问题接口
|
||||
|
||||
## 9. 问题记录
|
||||
|
||||
| 问题描述 | 影响范围 | 解决方案 | 状态 |
|
||||
|---------|---------|---------|------|
|
||||
| | | | |
|
||||
| | | | |
|
||||
| | | | |
|
||||
261
docs/前端适配调整/接口对照表.md
Normal file
261
docs/前端适配调整/接口对照表.md
Normal file
|
|
@ -0,0 +1,261 @@
|
|||
# 前端接口对照表
|
||||
|
||||
## 1. 接口完整对照
|
||||
|
||||
### 1.1 用户认证模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 微信登录 | `/login` | `/api/login` | POST | JSON | ✅ 已实现 |
|
||||
| 手机号登录 | `/mobileLogin` | `/api/mobileLogin` | POST | JSON | ✅ 已实现 |
|
||||
| 获取用户信息 | `/user` | `/api/user` | POST | JSON | ✅ 已实现 |
|
||||
| 更新用户信息 | `/update_userinfo` | `/api/update_userinfo` | POST | JSON | ✅ 已实现 |
|
||||
| 微信绑定手机号 | `/login_bind_mobile` | `/api/login_bind_mobile` | POST | JSON | ✅ 已实现 |
|
||||
| 验证码绑定手机号 | `/bindMobile` | `/api/bindMobile` | POST | JSON | ✅ 已实现 |
|
||||
| 记录登录 | `/login_record` | `/api/login_record` | GET/POST | JSON | ✅ 已实现 |
|
||||
| 账号注销 | `/user_log_off` | `/api/user_log_off` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.2 配置模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 系统配置 | `/config` | `/api/config` | GET | - | ✅ 已实现 |
|
||||
| 平台配置 | `/getPlatformConfig` | `/api/getPlatformConfig` | GET | - | ✅ 已实现 |
|
||||
| 广告列表 | `/getAdvert` | `/api/getAdvert` | GET/POST | Query | ✅ 已实现 |
|
||||
| 单页内容 | `/getDanye` | `/api/getDanye` | GET | Query | ✅ 已实现 |
|
||||
|
||||
### 1.3 商品模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 商品列表 | `/goods` | `/api/goods_list` | POST | JSON | ✅ 已实现 |
|
||||
| 商品详情 | `/goodsdetail` | `/api/goods_detail` | POST | JSON | ✅ 已实现 |
|
||||
| 子奖品列表 | `/goods_children` | `/api/goods_children` | POST | JSON | ✅ 已实现 |
|
||||
| 商品扩展配置 | `/goods_extend` | `/api/goods_extend` | POST | JSON | ✅ 已实现 |
|
||||
| 箱号列表 | `/goods_num_list` | `/api/goods_num_list` | POST | JSON | ✅ 已实现 |
|
||||
| 箱号详情 | `/goods_num_detail` | `/api/goods_num_detail` | POST | JSON | ✅ 已实现 |
|
||||
| 奖品数量统计 | `/goodslist_count` | `/api/goods_prize_count` | POST | JSON | ✅ 已实现 |
|
||||
| 奖品内容 | `/goodslist_content` | `/api/goods_prize_content` | POST | JSON | ✅ 已实现 |
|
||||
| 中奖记录 | `/shang_log` | `/api/goods_prize_logs` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.4 订单模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 一番赏金额计算 | `/ordermoney` | `/api/ordermoney` | POST | JSON | ✅ 已实现 |
|
||||
| 一番赏下单 | `/orderbuy` | `/api/orderbuy` | POST | JSON | ✅ 已实现 |
|
||||
| 无限赏金额计算 | `/infinite_ordermoney` | `/api/infinite_ordermoney` | POST | JSON | ✅ 已实现 |
|
||||
| 无限赏下单 | `/infinite_orderbuy` | `/api/infinite_orderbuy` | POST | JSON | ✅ 已实现 |
|
||||
| 商城金额计算 | `/mall_ordermoney` | `/api/mall_ordermoney` | POST | JSON | ✅ 已实现 |
|
||||
| 订单列表 | `/order_list` | `/api/order_list` | POST | JSON | ✅ 已实现 |
|
||||
| 订单详情 | `/order_detail` | `/api/order_detail` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.5 抽奖结果模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 一番赏抽奖结果 | `/prizeorderlog` | `/api/prizeorderlog` | POST | JSON | ✅ 已实现 |
|
||||
| 无限赏抽奖结果 | `/infinite_prizeorderlog` | `/api/infinite_prizeorderlog` | POST | JSON | ✅ 已实现 |
|
||||
| 无限赏中奖记录 | `/infinite_shang_log` | `/api/infinite_shang_log` | POST | JSON | ✅ 已实现 |
|
||||
| 无限赏用户记录 | `/infinite_prizerecords` | `/api/infinite_prizerecords` | POST | JSON | ✅ 已实现 |
|
||||
| 道具卡抽奖 | `/item_card_chou` | `/api/item_card_chou` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.6 仓库模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 仓库首页 | `/warehouse_index` | `/api/warehouse_index` | POST | JSON | ✅ 已实现 |
|
||||
| 回收奖品 | `/warehouse_recovery` | `/api/warehouse_recovery` | POST | JSON | ✅ 已实现 |
|
||||
| 发货奖品 | `/warehouse_send` | `/api/warehouse_send` | POST | JSON | ✅ 已实现 |
|
||||
| 确认发货 | `/warehouse_send_confirm` | `/api/warehouse_send_confirm` | POST | JSON | ✅ 已实现 |
|
||||
| 发货记录 | `/warehouse_send_record` | `/api/warehouse_send_record` | POST | JSON | ✅ 已实现 |
|
||||
| 发货详情 | `/warehouse_send_record_detail` | `/api/warehouse_send_record_detail` | POST | JSON | ✅ 已实现 |
|
||||
| 回收记录 | `/warehouse_recovery_record` | `/api/warehouse_recovery_record` | POST | JSON | ✅ 已实现 |
|
||||
| 物流信息 | `/warehouse_order_logistics` | `/api/warehouse_order_logistics` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.7 优惠券模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 优惠券列表 | `/coupon_list` | `/api/coupon_list` | POST | JSON | ✅ 已实现 |
|
||||
| 优惠券详情 | `/coupon_detail` | `/api/coupon_detail` | POST | JSON | ✅ 已实现 |
|
||||
| 领取优惠券 | `/coupon_ling` | `/api/coupon_ling` | POST | JSON | ✅ 已实现 |
|
||||
| 分享优惠券 | `/coupon_share` | `/api/coupon_share` | POST | JSON | ✅ 已实现 |
|
||||
| 合成优惠券 | `/coupon_synthesis` | `/api/coupon_synthesis` | POST | JSON | ✅ 已实现 |
|
||||
| 计算合成 | `/coupon_ji_suan` | `/api/coupon_ji_suan` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.8 资产模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 余额明细 | `/profitMoney` | `/api/profitMoney` | POST | JSON | ✅ 已实现 |
|
||||
| 吧唧币明细 | `/profitIntegral` | `/api/profitIntegral` | POST | JSON | ✅ 已实现 |
|
||||
| 积分明细 | `/profitScore` | `/api/profitScore` | POST | JSON | ✅ 已实现 |
|
||||
| 支付记录 | `/profitPay` | `/api/profitPay` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.9 VIP模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| VIP信息 | `/vip_list` | `/api/vip_list` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.10 福利模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 福利屋列表 | `/welfare_house_list` | `/api/welfare_house_list` | POST | JSON | ✅ 已实现 |
|
||||
| 福利屋详情 | `/welfare_house_detail` | `/api/welfare_house_detail` | POST | JSON | ✅ 已实现 |
|
||||
| 福利屋下单 | `/welfare_house_buy` | `/api/welfare_house_buy` | POST | JSON | ✅ 已实现 |
|
||||
| 签到信息 | `/sign_info` | `/api/sign_info` | POST | JSON | ✅ 已实现 |
|
||||
| 执行签到 | `/sign_do` | `/api/sign_do` | POST | JSON | ✅ 已实现 |
|
||||
| 任务列表 | `/task_list` | `/api/task_list` | POST | JSON | ✅ 已实现 |
|
||||
| 领取任务奖励 | `/task_receive` | `/api/task_receive` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.11 收藏模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 收藏列表 | `/collection_list` | `/api/collection_list` | POST | JSON | ✅ 已实现 |
|
||||
| 添加收藏 | `/collection_add` | `/api/collection_add` | POST | JSON | ✅ 已实现 |
|
||||
| 取消收藏 | `/collection_cancel` | `/api/collection_cancel` | POST | JSON | ✅ 已实现 |
|
||||
| 收藏状态 | `/goods_collection_status` | `/api/goods_collection_status` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.12 排行榜模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 排行榜列表 | `/rank_list` | `/api/rank_list` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.13 邀请模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 邀请信息 | `/invitation_info` | `/api/invitation_info` | POST | JSON | ✅ 已实现 |
|
||||
| 邀请记录 | `/invitation_record` | `/api/invitation_record` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
### 1.14 兑换码模块
|
||||
|
||||
| 功能 | PHP 旧接口 | C# 新接口 | 请求方式 | 请求格式 | 状态 |
|
||||
|-----|-----------|----------|---------|---------|------|
|
||||
| 兑换码使用 | `/redeem_code` | `/api/redeem_code` | POST | JSON | ✅ 已实现 |
|
||||
|
||||
## 2. 接口路径变更汇总
|
||||
|
||||
以下接口路径发生了变化，前端需要更新：
|
||||
|
||||
| 旧路径 | 新路径 | 说明 |
|
||||
|-------|-------|------|
|
||||
| `/goods` | `/api/goods_list` | 商品列表 |
|
||||
| `/goodsdetail` | `/api/goods_detail` | 商品详情 |
|
||||
| `/goodslist_count` | `/api/goods_prize_count` | 奖品统计 |
|
||||
| `/goodslist_content` | `/api/goods_prize_content` | 奖品内容 |
|
||||
| `/shang_log` | `/api/goods_prize_logs` | 中奖记录 |
|
||||
| `/userInfo` | `/api/user` | 用户信息（前端 user.js 中使用） |
|
||||
|
||||
## 3. 请求参数字段变更
|
||||
|
||||
### 3.1 商品列表
|
||||
|
||||
```javascript
|
||||
// 旧参数
|
||||
{
|
||||
page: 1,
|
||||
type: 0,
|
||||
keyword: ""
|
||||
}
|
||||
|
||||
// 新参数（保持一致）
|
||||
{
|
||||
page: 1,
|
||||
type: 0,
|
||||
keyword: "",
|
||||
pageSize: 15 // 新增可选参数
|
||||
}
|
||||
```
|
||||
|
||||
### 3.2 订单列表
|
||||
|
||||
```javascript
|
||||
// 旧参数
|
||||
{
|
||||
page: 1,
|
||||
page_size: 20
|
||||
}
|
||||
|
||||
// 新参数
|
||||
{
|
||||
page: 1,
|
||||
pageSize: 20 // 字段名变更：page_size -> pageSize
|
||||
}
|
||||
```
|
||||
|
||||
### 3.3 中奖记录
|
||||
|
||||
```javascript
|
||||
// 旧参数
|
||||
{
|
||||
goods_id: 1001,
|
||||
goods_num: 0,
|
||||
shang_id: 0,
|
||||
page: 1,
|
||||
page_size: 15
|
||||
}
|
||||
|
||||
// 新参数
|
||||
{
|
||||
goodsId: 1001, // 字段名变更
|
||||
goodsNum: 0, // 字段名变更
|
||||
shangId: 0, // 字段名变更
|
||||
page: 1,
|
||||
pageSize: 15 // 字段名变更
|
||||
}
|
||||
```
|
||||
|
||||
## 4. 响应格式对比
|
||||
|
||||
### 4.1 通用响应格式（保持一致）
|
||||
|
||||
```json
|
||||
{
|
||||
"status": 1,
|
||||
"msg": "success",
|
||||
"data": {}
|
||||
}
|
||||
```
|
||||
|
||||
### 4.2 分页响应格式
|
||||
|
||||
```json
|
||||
// PHP 旧版
|
||||
{
|
||||
"status": 1,
|
||||
"data": {
|
||||
"data": [],
|
||||
"total": 100,
|
||||
"current_page": 1,
|
||||
"last_page": 10
|
||||
}
|
||||
}
|
||||
|
||||
// C# 新版（保持一致）
|
||||
{
|
||||
"status": 1,
|
||||
"data": {
|
||||
"data": [],
|
||||
"total": 100,
|
||||
"currentPage": 1, // 字段名可能有变化
|
||||
"lastPage": 10
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 5. 前端文件修改清单
|
||||
|
||||
| 文件路径 | 修改内容 | 优先级 |
|
||||
|---------|---------|-------|
|
||||
| `common/request.js` | Content-Type 改为 JSON | 高 |
|
||||
| `common/server/user.js` | 接口路径和请求方式 | 高 |
|
||||
| `common/server/config.js` | 检查接口路径 | 中 |
|
||||
| `common/server/mall.js` | 检查接口路径 | 中 |
|
||||
| `common/server/order.js` | 检查接口路径 | 中 |
|
||||
| `pages/*/` 各页面文件 | 检查直接调用的接口 | 低 |
|
||||
|
|
@ -192,7 +192,7 @@ class RequestManager {
|
|||
data.sign = sign
|
||||
|
||||
header = {
|
||||
'content-type': 'application/x-www-form-urlencoded',
|
||||
'content-type': 'application/json',
|
||||
client: client,
|
||||
token: token,
|
||||
adid: uni.getStorageSync('_ad_id'),
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user