cmautobuy/admin/handler/web/others.go

package web

import (
	"net/http"

	"github.com/gin-gonic/gin"
)

// ---------- 2. 顺运宝数据 ----------

// SybList 渲染货运单列表页。
// 「匹配状态」是算出来的（sku_mappings 里有没有记录），不是存的字段。
func (h *Handler) SybList(c *gin.Context) {
	keyword := c.Query("order_no")

	// TODO(骨架): 查货运单，并左联 sku_mappings 得出匹配状态
	var rows []gin.H

	c.HTML(http.StatusOK, "syb/list", page("syb", "顺运宝数据", gin.H{
		"Keyword": keyword,
		"Rows":    rows,
		"Status":  "尚未实现：同步或手工录入后这里显示货运单",
	}))
}

// SybSync 从顺运宝同步待处理货运单。
//
// MVP 阶段只做占位，见 docs/admin/01-requirements.md §11 待确认 #1。
func (h *Handler) SybSync(c *gin.Context) {
	// TODO(等待确认): 顺运宝的同步方式（接口？导出文件？）还没定。
	//   定了之后在这里实现，注意完整响应要原样存进 syb_data 字段。
	fail(c, http.StatusNotImplemented,
		"同步功能待接入。顺运宝的对接方式尚未确定，"+
			"当前可以先手工录入货运单用于联调。")
}

// SybMatch 保存规格匹配结果。
//
// 关键：保存的是**可复用的 SKU 映射**（写 sku_mappings），
// 不是这一张订单的临时数据。下次遇到同一个蝦皮 SKU 自动带出，
// 操作员只需确认。见 docs/admin/03-data-model.md §5。
func (h *Handler) SybMatch(c *gin.Context) {
	// TODO(骨架): upsert sku_mappings
	fail(c, http.StatusNotImplemented, "规格匹配尚未实现。")
}

// SybCreateTask 由勾选的货运单创建采购任务。
//
// 六条校验缺一不可，见 docs/admin/01-requirements.md §5：
//  1. 已填 PDD 链接
//  2. 已采集成功（pdd_data 非空）
//  3. 已有 SKU 映射
//  4. 数量 > 0
//  5. **价格上限已填且 > 0**（Client 的价格保护，没有它会拒绝执行）
//  6. 已选择分配的客户端
//
// 校验不过的**不要静默跳过**，要列出来告诉操作员缺什么。
func (h *Handler) SybCreateTask(c *gin.Context) {
	// TODO(骨架): 调 service.CreatePurchaseTasks(sybIDs, clientID)
	fail(c, http.StatusNotImplemented, "创建采购任务尚未实现。")
}

// SybDelete 批量删除货运单。
func (h *Handler) SybDelete(c *gin.Context) {
	// TODO(骨架)
	fail(c, http.StatusNotImplemented, "删除功能尚未实现。")
}

// ---------- 3. 采购任务 ----------

// TaskList 渲染采购任务列表页。
//
// 注意颜色尺码显示的是 **PDD 侧**的规格（实际要买的），不是蝦皮的。
// 价格上限显示成 ¥42.00，底层存的是整数分。
func (h *Handler) TaskList(c *gin.Context) {
	keyword := c.Query("order_no")

	// TODO(骨架): 查 tasks，task_type = 'purchase'
	var rows []gin.H

	c.HTML(http.StatusOK, "task/list", page("tasks", "采购任务", gin.H{
		"Keyword": keyword,
		"Rows":    rows,
		"Status":  "尚未实现：创建任务后这里显示执行进度",
	}))
}

// TaskDelete 批量删除任务。
func (h *Handler) TaskDelete(c *gin.Context) {
	// TODO(骨架)
	fail(c, http.StatusNotImplemented, "删除功能尚未实现。")
}

// ---------- 4. 客户端列表 ----------

// ClientList 渲染客户端列表页。
//
// 「状态」是**算出来的**：last_seen_at 在 N 分钟内为在线，否则离线。
// 数据库里没有 status 字段，存成字段会和真实情况不同步。
//
// 客户端执行长任务期间不调 claim，可能显示为离线，属正常现象
// （没有心跳是有意的，见 docs/admin/04-client-api.md §3）。
func (h *Handler) ClientList(c *gin.Context) {
	keyword := c.Query("name")

	// TODO(骨架): 查 clients，并按 last_seen_at 算在线状态
	var rows []gin.H

	c.HTML(http.StatusOK, "client/list", page("clients", "客户端列表", gin.H{
		"Keyword": keyword,
		"Rows":    rows,
		"Status":  "尚未实现：客户端第一次调领取接口后会自动出现在这里",
	}))
}

// ClientDelete 批量删除客户端。
func (h *Handler) ClientDelete(c *gin.Context) {
	// TODO(骨架)
	fail(c, http.StatusNotImplemented, "删除功能尚未实现。")
}