Appearance
获取项目列表 API
| Path | Method | Created At |
|---|---|---|
| /api/projects/paginate | POST | 2025-11-29 00:39:11 |
Request
| Key | Rule | Description |
|---|---|---|
| page | integer,min:1,max:100 | 页码必须为正整数 |
| page_size | integer,min:5,max:1000 | 每页数量必须为正整数 |
| is_archived | App\Rules\BoolRule | 是否归档字段错误 |
| sorts | array | 排序字段不正确 |
Response
| Key | Type | Example | Comment |
|---|---|---|---|
| id | string | 13da12 | 项目ID |
| name | string | 路由项目一期 | 项目名称 |
| customerId | string | 8d23a | 客户编号 |
| customerName | string | 金职院 | 客户名称 |
| agentId | string | 7d2aab | 渠道ID |
| agentName | string | 铁道游击队 | 渠道名称 |
| projectNo | string | PJ-101 | 项目编号 |
| contractId | string | 823da1 | 合同编号 |
| contractNumber | string | 5420 | 合同编号 |
| contractTitle | string | 路由项目一期合同 | 合同项目标题 |
| type | enum | ProjectType | 项目类型 |
| totalAmount | float | 78900024.32 | 项目总金额 |
| projectLevel | enum | ProjectLevel | 项目等级 |
| salesLeaderId | int | 1 | 销售经理ID |
| salesLeaderName | string | 张三丰 | 销售经理 |
| techLeaderId | string | 1 | 技术经理ID |
| techLeaderName | string | 李德善 | 技术经理 |
| projectLeaderId | int | 2 | 项目经理ID |
| projectLeaderName | string | 贾似道 | 项目经理名称 |
| projectStage | enum | ProjectStage | 项目阶段 |
| deliveryDate | string | 2025-02-22 21:30:23 | 发货时间 |
| isSigned | bool | true | 是否终验 |
| duration | string | 10天 | 项目用时 |
| workHours | string | 500小时 | 项目工时 |
| projectStatus | enum | ProjectStatus | 项目状态 |
| status | enum | ProjectStatus | 状态 |
| createdAt | string | 2021-12-31 | 创建时间 |
| deliveryReceiptTime | string | 2021-12-31 15:04:05 | 到货签收时间 |
| expectedCompletionTime | string | 2006-01-02 | 预计完成时间 |
| followers | array | [1, 2, 3] | 关注者 |
TypeScript Result Example:
TypeScript
interface Result {
/** 项目ID */
id: string;
/** 项目名称 */
name: string;
/** 客户编号 */
customerId: string;
/** 客户名称 */
customerName: string;
/** 渠道ID */
agentId: string;
/** 渠道名称 */
agentName: string;
/** 项目编号 */
projectNo: string;
/** 合同编号 */
contractId: string;
/** 合同编号 */
contractNumber: string;
/** 合同项目标题 */
contractTitle: string;
/** 项目类型 */
type: ResultType;
/** 项目总金额 */
totalAmount: any;
/** 项目等级 */
projectLevel: ResultProjectLevel;
/** 销售经理ID */
salesLeaderId: number;
/** 销售经理 */
salesLeaderName: string;
/** 技术经理ID */
techLeaderId: string;
/** 技术经理 */
techLeaderName: string;
/** 项目经理ID */
projectLeaderId: number;
/** 项目经理名称 */
projectLeaderName: string;
/** 项目阶段 */
projectStage: ResultProjectStage;
/** 发货时间 */
deliveryDate: string;
/** 是否终验 */
isSigned: any;
/** 项目用时 */
duration: string;
/** 项目工时 */
workHours: string;
/** 项目状态 */
projectStatus: ResultProjectStatus;
/** 状态 */
status: ResultStatus;
/** 创建时间 */
createdAt: string;
/** 到货签收时间 */
deliveryReceiptTime: string;
/** 预计完成时间 */
expectedCompletionTime: string;
/** 关注者 */
followers: any;
}
enum ResultType {
}
enum ResultProjectLevel {
/** 重大项目 */
MAJOR = "MAJOR",
/** 大项目 */
LARGE = "LARGE",
/** 中小项目 */
MEDIUM = "MEDIUM",
/** 微型项目 */
MICRO = "MICRO"
}
enum ResultProjectStage {
/** 项目启动 */
STARTED = "STARTED",
/** 部分到货 */
PARTIALLY_DELIVERED = "PARTIALLY_DELIVERED",
/** 全部到货 */
ALL_DELIVERED = "ALL_DELIVERED",
/** 实施 */
IMPLEMENTED = "IMPLEMENTED",
/** 初验 */
INITIAL_ACCEPTANCE = "INITIAL_ACCEPTANCE",
/** 终验 */
FINAL_ACCEPTANCE = "FINAL_ACCEPTANCE"
}
enum ResultProjectStatus {
/** 正常进行中 */
PROCESSING = "PROCESSING",
/** 问题异常 */
EXCEPTED = "EXCEPTED",
/** 项目完结 */
COMPLETED = "COMPLETED"
}
enum ResultStatus {
/** 正常进行中 */
PROCESSING = "PROCESSING",
/** 问题异常 */
EXCEPTED = "EXCEPTED",
/** 项目完结 */
COMPLETED = "COMPLETED"
}Enums
ProjectType
| Const | Description |
|---|
ProjectLevel
| Const | Description |
|---|---|
| MAJOR | 重大项目 |
| LARGE | 大项目 |
| MEDIUM | 中小项目 |
| MICRO | 微型项目 |
ProjectStage
| Const | Description |
|---|---|
| STARTED | 项目启动 |
| PARTIALLY_DELIVERED | 部分到货 |
| ALL_DELIVERED | 全部到货 |
| IMPLEMENTED | 实施 |
| INITIAL_ACCEPTANCE | 初验 |
| FINAL_ACCEPTANCE | 终验 |
ProjectStatus
| Const | Description |
|---|---|
| PROCESSING | 正常进行中 |
| EXCEPTED | 问题异常 |
| COMPLETED | 项目完结 |