103 lines
3.9 KiB
Go
103 lines
3.9 KiB
Go
|
package v1
|
|||
|
|
|
|||
|
|
import "github.com/gogf/gf/v2/frame/g"
|
|||
|
|
|
|||
|
|
// ============================================================================
|
|||
|
|
// C 端软件开发服务二期契约（迭代-2026-09-30）：介绍页模块 / 作品案例 / 报价申请
|
|||
|
|
//
|
|||
|
|
// - 介绍页模块（service_blocks）由管理端逐块编辑（预设排版布局），C 端按 sort 输出；
|
|||
|
|
// - 图片字段库内只存相对路径，输出统一为绝对 URL（同 goods 封面约定）；
|
|||
|
|
// - 报价申请提交后写站内信回执；处理结果（已报价/成交/关闭）再推站内信。
|
|||
|
|
// ============================================================================
|
|||
|
|
|
|||
|
|
// ServiceBlockOut 介绍页模块（响应 snake_case）
|
|||
|
|
type ServiceBlockOut struct {
|
|||
|
|
Id int64 `json:"id"`
|
|||
|
|
Kind string `json:"kind"` // hero/rich/image_text/image_list/developer/works/goods
|
|||
|
|
Title string `json:"title"`
|
|||
|
|
Subtitle string `json:"subtitle"`
|
|||
|
|
ImageUrl string `json:"image_url"` // 主图绝对 URL（可能为空）
|
|||
|
|
Images []string `json:"images"` // 图集绝对 URL（image_list）
|
|||
|
|
Content string `json:"content"` // Markdown 原文，前端解析渲染
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// ServicePageReq 服务介绍页模块列表（仅启用，sort 升序）
|
|||
|
|
type ServicePageReq struct {
|
|||
|
|
g.Meta `path:"/service/page" method:"get" tags:"service" summary:"软件开发服务介绍页"`
|
|||
|
|
}
|
|||
|
|
type ServicePageRes struct {
|
|||
|
|
List []ServiceBlockOut `json:"list"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// WorkItem 作品列表项
|
|||
|
|
type WorkItem struct {
|
|||
|
|
Id int64 `json:"id"`
|
|||
|
|
Category int `json:"category"`
|
|||
|
|
CategoryName string `json:"category_name"`
|
|||
|
|
Title string `json:"title"`
|
|||
|
|
Summary string `json:"summary"`
|
|||
|
|
CoverUrl string `json:"cover_url"`
|
|||
|
|
PriceCents int64 `json:"price_cents"` // 0 = 面议
|
|||
|
|
PriceNote string `json:"price_note"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// WorksListReq 作品列表（仅上架）
|
|||
|
|
type WorksListReq struct {
|
|||
|
|
g.Meta `path:"/service/works" method:"get" tags:"service" summary:"软件开发作品列表"`
|
|||
|
|
Category int `json:"category"` // 0=全部
|
|||
|
|
Page int `json:"page"`
|
|||
|
|
PageSize int `json:"pageSize"`
|
|||
|
|
}
|
|||
|
|
type WorksListRes struct {
|
|||
|
|
List []WorkItem `json:"list"`
|
|||
|
|
Total int `json:"total"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// WorkDetailReq 作品详情（含图集与 Markdown 详情）
|
|||
|
|
type WorkDetailReq struct {
|
|||
|
|
g.Meta `path:"/service/works/detail" method:"get" tags:"service" summary:"软件开发作品详情"`
|
|||
|
|
Id int64 `v:"required" json:"id"`
|
|||
|
|
}
|
|||
|
|
type WorkDetailRes struct {
|
|||
|
|
WorkItem
|
|||
|
|
Images []string `json:"images"` // 详情图集（绝对 URL）
|
|||
|
|
ContentMd string `json:"content_md"`
|
|||
|
|
UpdatedAt string `json:"updated_at"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// QuoteSubmitReq 提交报价申请（需求 → 站内信回执）
|
|||
|
|
type QuoteSubmitReq struct {
|
|||
|
|
g.Meta `path:"/service/quote/submit" method:"post" tags:"service" summary:"提交软件开发报价申请"`
|
|||
|
|
WorkId int64 `json:"work_id"` // 0 = 通用申请（不关联作品）
|
|||
|
|
Contact string `v:"required#请填写联系方式" json:"contact"`
|
|||
|
|
Requirement string `v:"required#请描述您的需求" json:"requirement"`
|
|||
|
|
Budget string `json:"budget"` // 预算范围文案，可空
|
|||
|
|
}
|
|||
|
|
type QuoteSubmitRes struct {
|
|||
|
|
Id int64 `json:"id"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// QuoteMineItem 我的报价申请条目（含处理结果）
|
|||
|
|
type QuoteMineItem struct {
|
|||
|
|
Id int64 `json:"id"`
|
|||
|
|
WorkId int64 `json:"work_id"`
|
|||
|
|
WorkTitle string `json:"work_title"`
|
|||
|
|
Requirement string `json:"requirement"`
|
|||
|
|
Budget string `json:"budget"`
|
|||
|
|
Status int `json:"status"`
|
|||
|
|
StatusText string `json:"status_text"`
|
|||
|
|
QuoteCents int64 `json:"quote_cents"` // 0=面议/未填
|
|||
|
|
QuoteNote string `json:"quote_note"`
|
|||
|
|
HandledAt string `json:"handled_at"`
|
|||
|
|
CreatedAt string `json:"created_at"`
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
// QuoteMineReq 我的报价申请（最近 N 条）
|
|||
|
|
type QuoteMineReq struct {
|
|||
|
|
g.Meta `path:"/service/quote/mine" method:"get" tags:"service" summary:"我的报价申请"`
|
|||
|
|
Limit int `json:"limit"`
|
|||
|
|
}
|
|||
|
|
type QuoteMineRes struct {
|
|||
|
|
List []QuoteMineItem `json:"list"`
|
|||
|
|
}
|