feat: 固定创建真实采购任务 (#112)
This commit is contained in:
@@ -6,7 +6,7 @@
|
||||
需要突破其中任何一条时,**停下来问用户**,不要先给方案、不要先评估成本。
|
||||
|
||||
1. **Qt 绑定固定 PyQt5。** 不得改用 PyQt6 / PySide2 / PySide6,也不得安装其他绑定对应的 Fluent Widgets 包。
|
||||
2. **真实下单开关默认关闭。** 不得通过调试参数、默认配置或界面误操作打开;未通过采购安全门禁前一律走演练模式。
|
||||
2. **Admin 新建采购任务固定为真实下单(不支付)。** 创建时必须通过明确的风险确认,且只能分配给已授权并声明 live 能力的 Client;Client 仍须通过设备绑定、商品/规格/数量/价格复核、不可逆标记和单次提交门禁。
|
||||
3. **不绕过拼多多的验证码、风控和安全机制**,不自动注册登录,不自动付款。
|
||||
4. **凭据(token、Cookie、密码)不得写入** `data/`、日志、数据库、Gitea 工单和 `docs/task`。
|
||||
5. **任务一旦进入不可逆阶段**(`task_runs.irreversible_action_at` 有值),**只准核对订单,绝不重新下单**。
|
||||
|
||||
@@ -66,7 +66,7 @@ func (h *Handler) renderSybListWithLoginReason(c *gin.Context, keyword, pageRaw,
|
||||
"读取顺运宝同步记录失败,数据没有被改动。刷新页面重试;一直失败请把这句话报给维护者。")
|
||||
return
|
||||
}
|
||||
assignableClients, err := service.ListAssignableClients(h.db, currentUser(c), h.onlineThreshold)
|
||||
assignableClients, err := service.ListLivePurchaseClients(h.db, currentUser(c), h.onlineThreshold)
|
||||
if err != nil {
|
||||
fail(c, http.StatusInternalServerError, "读取可分配客户端失败,数据没有被改动。")
|
||||
return
|
||||
@@ -630,12 +630,10 @@ func (h *Handler) SybCreateTask(c *gin.Context) {
|
||||
}
|
||||
requests = append(requests, service.PurchaseTaskRequest{SybID: sybID, MaxPriceCent: cent})
|
||||
}
|
||||
result, err := service.CreatePurchaseTasksWithOptions(h.db, currentUser(c), requests, service.PurchaseTaskOptions{
|
||||
ClientID: c.PostForm("client_id"),
|
||||
ExecutionMode: model.TaskExecutionMode(c.PostForm("execution_mode")),
|
||||
LiveAcknowledged: c.PostForm("live_acknowledged") == "1",
|
||||
LiveConfirmation: c.PostForm("live_confirmation"),
|
||||
})
|
||||
result, err := service.CreatePurchaseTasksWithOptions(
|
||||
h.db, currentUser(c), requests,
|
||||
purchaseTaskOptionsFromForm(c, time.Now().UTC().Add(-h.onlineThreshold).Format(model.TimeLayout)),
|
||||
)
|
||||
if err != nil {
|
||||
h.sybRedirect(c, "采购任务没有创建:"+err.Error())
|
||||
return
|
||||
@@ -644,6 +642,18 @@ func (h *Handler) SybCreateTask(c *gin.Context) {
|
||||
h.sybRedirect(c, purchaseTaskResultMessage(result))
|
||||
}
|
||||
|
||||
func purchaseTaskOptionsFromForm(c *gin.Context, clientSeenAfter string) service.PurchaseTaskOptions {
|
||||
return service.PurchaseTaskOptions{
|
||||
ClientID: c.PostForm("client_id"),
|
||||
// Admin 新建采购任务固定为 live。不能相信浏览器提交的 execution_mode,
|
||||
// 否则篡改表单就能绕过真实采购确认和审计。
|
||||
ExecutionMode: model.TaskExecutionLive,
|
||||
LiveAcknowledged: c.PostForm("live_acknowledged") == "1",
|
||||
LiveConfirmation: c.PostForm("live_confirmation"),
|
||||
ClientSeenAfter: clientSeenAfter,
|
||||
}
|
||||
}
|
||||
|
||||
func purchaseTaskResultMessage(result service.PurchaseTaskResult) string {
|
||||
parts := []string{fmt.Sprintf("已创建 %d 个采购任务", result.Created)}
|
||||
if len(result.Failures) > 0 {
|
||||
|
||||
@@ -8,6 +8,8 @@ import (
|
||||
"testing"
|
||||
|
||||
"github.com/gin-gonic/gin"
|
||||
|
||||
"cmautobuy/admin/model"
|
||||
)
|
||||
|
||||
func sybPostContext(t *testing.T, values url.Values) (*gin.Context, *httptest.ResponseRecorder) {
|
||||
@@ -147,3 +149,23 @@ func TestSybHistoryPartialPagination_翻页继续使用片段路由(t *testing.T
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
func TestPurchaseTaskOptionsFromForm_忽略篡改模式并固定Live(t *testing.T) {
|
||||
context, _ := sybPostContext(t, url.Values{
|
||||
"client_id": {"CLIENT-LIVE"},
|
||||
"execution_mode": {"dry_run"},
|
||||
"live_acknowledged": {"1"},
|
||||
"live_confirmation": {"创建未付款订单"},
|
||||
})
|
||||
|
||||
options := purchaseTaskOptionsFromForm(context, "2026-08-10T09:00:00Z")
|
||||
if options.ExecutionMode != model.TaskExecutionLive {
|
||||
t.Fatalf("篡改 execution_mode 不得创建演练任务,实际 %q", options.ExecutionMode)
|
||||
}
|
||||
if options.ClientID != "CLIENT-LIVE" || !options.LiveAcknowledged || options.LiveConfirmation != "创建未付款订单" {
|
||||
t.Fatalf("真实采购确认字段读取错误: %+v", options)
|
||||
}
|
||||
if options.ClientSeenAfter != "2026-08-10T09:00:00Z" {
|
||||
t.Fatalf("在线截止时间未传给服务层: %+v", options)
|
||||
}
|
||||
}
|
||||
|
||||
@@ -139,6 +139,8 @@ func TestMainPagesReturnOK(t *testing.T) {
|
||||
`name="date_from"`, `name="date_to"`,
|
||||
`name="stage"`, "处理阶段", "下一步", `data-detail-url=`,
|
||||
"按顺运宝货运单创建日期(UTC+8)同步",
|
||||
"真实下单安全确认", "确认创建真实采购任务",
|
||||
`name="live_acknowledged"`, `name="live_confirmation"`,
|
||||
} {
|
||||
if !strings.Contains(sybResponse.Body.String(), want) {
|
||||
t.Errorf("顺运宝页面缺少 %q", want)
|
||||
@@ -147,6 +149,11 @@ func TestMainPagesReturnOK(t *testing.T) {
|
||||
if strings.Contains(sybResponse.Body.String(), "指定日期同步") {
|
||||
t.Error("顺运宝页面不应再显示旧的指定日期同步入口")
|
||||
}
|
||||
for _, removed := range []string{`name="execution_mode"`, "采购演练", "仅演练", "支持真实下单"} {
|
||||
if strings.Contains(sybResponse.Body.String(), removed) {
|
||||
t.Errorf("固定真实采购弹窗不应显示 %q", removed)
|
||||
}
|
||||
}
|
||||
|
||||
_, err = repository.UpsertSybOrder(db, model.SybOrder{
|
||||
SybID: "SYB-PDD-ID-INPUT", OrderNo: "ORDER-PDD-ID-INPUT", Title: "输入测试商品",
|
||||
|
||||
@@ -22,6 +22,18 @@ func ClientPurchaseMode(q Execer, clientID string) (string, error) {
|
||||
return ParseClientPurchaseMode(raw.String), nil
|
||||
}
|
||||
|
||||
// ClientSeenAfter 判断客户端是否在指定 UTC 时间之后上报过活动。
|
||||
func ClientSeenAfter(q Execer, clientID, cutoff string) (bool, error) {
|
||||
var online bool
|
||||
if err := q.QueryRow(
|
||||
`SELECT EXISTS(SELECT 1 FROM clients WHERE client_id = ? AND last_seen_at >= ?)`,
|
||||
clientID, cutoff,
|
||||
).Scan(&online); err != nil {
|
||||
return false, fmt.Errorf("检查客户端 %s 在线状态失败: %w", clientID, err)
|
||||
}
|
||||
return online, nil
|
||||
}
|
||||
|
||||
// ParseClientPurchaseMode 把登记能力转成安全的固定值,供列表和创建校验共用。
|
||||
func ParseClientPurchaseMode(raw string) string {
|
||||
var capabilities struct {
|
||||
|
||||
@@ -325,6 +325,36 @@ func TestClientAssignment_一人多客户端并按采购员隔离列表(t *testi
|
||||
}
|
||||
}
|
||||
|
||||
func TestListLivePurchaseClients_只返回可见在线且声明Live的客户端(t *testing.T) {
|
||||
db := newTestDB(t)
|
||||
admin, buyerA, _ := prepareClientAssignmentUsers(t, db)
|
||||
now := time.Now().UTC()
|
||||
clients := []model.Client{
|
||||
{ClientID: "live-online", Name: "真实在线", LastSeenAt: now.Format(model.TimeLayout), Capabilities: `{"purchase_mode":"live"}`},
|
||||
{ClientID: "dry-online", Name: "演练在线", LastSeenAt: now.Format(model.TimeLayout), Capabilities: `{"purchase_mode":"dry_run"}`},
|
||||
{ClientID: "live-offline", Name: "真实离线", LastSeenAt: now.Add(-time.Hour).Format(model.TimeLayout), Capabilities: `{"purchase_mode":"live"}`},
|
||||
}
|
||||
for _, client := range clients {
|
||||
if err := RegisterClient(db, client, true); err != nil {
|
||||
t.Fatalf("登记客户端失败: %v", err)
|
||||
}
|
||||
if _, _, err := AssignClient(db, admin, client.ClientID, buyerA.UserID, now); err != nil {
|
||||
t.Fatalf("绑定客户端失败: %v", err)
|
||||
}
|
||||
}
|
||||
if _, err := db.Exec(`UPDATE clients SET last_seen_at=? WHERE client_id=?`, now.Add(-time.Hour).Format(model.TimeLayout), "live-offline"); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
|
||||
rows, err := ListLivePurchaseClients(db, buyerA, time.Minute)
|
||||
if err != nil {
|
||||
t.Fatalf("读取真实采购客户端失败: %v", err)
|
||||
}
|
||||
if len(rows) != 1 || rows[0].ClientID != "live-online" {
|
||||
t.Fatalf("只应返回在线 live 客户端,实际 %+v", rows)
|
||||
}
|
||||
}
|
||||
|
||||
func TestClientAssignment_转交解绑保留审计且不改任务(t *testing.T) {
|
||||
db := newTestDB(t)
|
||||
admin, buyerA, buyerB := prepareClientAssignmentUsers(t, db)
|
||||
|
||||
@@ -170,6 +170,7 @@ type PurchaseTaskOptions struct {
|
||||
ExecutionMode model.TaskExecutionMode
|
||||
LiveAcknowledged bool
|
||||
LiveConfirmation string
|
||||
ClientSeenAfter string
|
||||
}
|
||||
|
||||
// PurchaseTaskResult 同时返回已创建数量和每条无法创建的原因。
|
||||
@@ -212,6 +213,15 @@ func CreatePurchaseTasksWithOptions(db *sql.DB, actor *model.User, requests []Pu
|
||||
if !visible {
|
||||
return result, fmt.Errorf("所选客户端不存在或不在当前账号可见范围")
|
||||
}
|
||||
if options.ClientSeenAfter != "" {
|
||||
online, err := repository.ClientSeenAfter(tx, clientID, options.ClientSeenAfter)
|
||||
if err != nil {
|
||||
return result, err
|
||||
}
|
||||
if !online {
|
||||
return result, fmt.Errorf("所选客户端已离线,请刷新页面后选择在线客户端")
|
||||
}
|
||||
}
|
||||
executionMode := options.ExecutionMode
|
||||
if executionMode == "" {
|
||||
executionMode = model.TaskExecutionDryRun
|
||||
|
||||
@@ -426,6 +426,26 @@ func TestCreatePurchaseTasksWithOptions_真实模式安全门禁(t *testing.T) {
|
||||
}
|
||||
}
|
||||
|
||||
func TestCreatePurchaseTasksWithOptions_页面打开后客户端离线会被拒绝(t *testing.T) {
|
||||
db := newTestDB(t)
|
||||
key := seedPurchasableWorkflow(t, db, "SYB-OFFLINE")
|
||||
SaveSybMapping(db, "SYB-OFFLINE", key, "USR-1")
|
||||
admin, _, _ := prepareClientAssignmentUsers(t, db)
|
||||
RegisterClient(db, model.Client{ClientID: "CLIENT-OFFLINE", Capabilities: `{"purchase_mode":"live"}`}, true)
|
||||
if _, err := db.Exec(`UPDATE clients SET last_seen_at=? WHERE client_id=?`, "2026-08-10T08:00:00Z", "CLIENT-OFFLINE"); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
|
||||
_, err := CreatePurchaseTasksWithOptions(db, admin,
|
||||
[]PurchaseTaskRequest{{SybID: "SYB-OFFLINE", MaxPriceCent: 4200}},
|
||||
PurchaseTaskOptions{ClientID: "CLIENT-OFFLINE", ExecutionMode: model.TaskExecutionLive,
|
||||
LiveAcknowledged: true, LiveConfirmation: LivePurchaseConfirmation,
|
||||
ClientSeenAfter: "2026-08-10T09:00:00Z"})
|
||||
if err == nil || !strings.Contains(err.Error(), "已离线") {
|
||||
t.Fatalf("离线客户端必须在创建事务内被拒绝: %v", err)
|
||||
}
|
||||
}
|
||||
|
||||
func TestParsePriceYuanToCent_精确转换(t *testing.T) {
|
||||
for raw, want := range map[string]int64{"39.90": 3990, "1": 100, "0.01": 1, "12.3": 1230} {
|
||||
got, err := ParsePriceYuanToCent(raw)
|
||||
|
||||
@@ -205,6 +205,24 @@ func ListAssignableClients(db *sql.DB, actor *model.User, threshold time.Duratio
|
||||
return ListClientViewsForUser(db, actor, "", threshold)
|
||||
}
|
||||
|
||||
// ListLivePurchaseClients 返回当前用户能分配真实采购任务的在线客户端。
|
||||
//
|
||||
// 页面过滤只用于减少误选;创建任务时仍会在事务内重新校验可见范围和 live 能力。
|
||||
func ListLivePurchaseClients(db *sql.DB, actor *model.User, threshold time.Duration) ([]ClientView, error) {
|
||||
clients, err := ListClientViewsForUser(db, actor, "", threshold)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
result := make([]ClientView, 0, len(clients))
|
||||
for _, client := range clients {
|
||||
if client.Status != "在线" || client.PurchaseMode != string(model.TaskExecutionLive) {
|
||||
continue
|
||||
}
|
||||
result = append(result, client)
|
||||
}
|
||||
return result, nil
|
||||
}
|
||||
|
||||
// ListActivePurchasers 返回管理员可选择的绑定目标。
|
||||
func ListActivePurchasers(db *sql.DB, actor *model.User) ([]model.User, error) {
|
||||
if actor == nil || !actor.IsAdmin() {
|
||||
|
||||
+8
-29
@@ -140,33 +140,9 @@
|
||||
var openButtons = document.querySelectorAll("[data-purchase-open]");
|
||||
var form = document.querySelector("[data-purchase-form]");
|
||||
if (!openButtons.length || !form) return;
|
||||
var modeInputs = form.querySelectorAll("[data-execution-mode]");
|
||||
var livePanel = form.querySelector("[data-live-confirm-panel]");
|
||||
var liveAcknowledged = form.querySelector("[data-live-acknowledged]");
|
||||
var liveConfirmation = form.querySelector("[data-live-confirmation]");
|
||||
var clientSelect = form.querySelector("select[name=client_id]");
|
||||
function updateExecutionMode() {
|
||||
var selected = form.querySelector("[data-execution-mode]:checked");
|
||||
var isLive = selected && selected.value === "live";
|
||||
if (livePanel) livePanel.hidden = !isLive;
|
||||
if (liveAcknowledged) liveAcknowledged.required = isLive;
|
||||
if (liveConfirmation) liveConfirmation.required = isLive;
|
||||
if (clientSelect) {
|
||||
clientSelect.querySelectorAll("option[data-purchase-mode]").forEach(function (option) {
|
||||
option.disabled = isLive && option.getAttribute("data-purchase-mode") !== "live";
|
||||
});
|
||||
if (clientSelect.selectedOptions.length && clientSelect.selectedOptions[0].disabled) {
|
||||
clientSelect.value = "";
|
||||
}
|
||||
}
|
||||
form.setAttribute("data-confirm-submit", isLive
|
||||
? "确认创建真实的未付款订单?系统不会自动支付。"
|
||||
: "确认创建采购演练任务?任务创建后将等待所选客户端领取。");
|
||||
}
|
||||
modeInputs.forEach(function (input) {
|
||||
input.addEventListener("change", updateExecutionMode);
|
||||
});
|
||||
updateExecutionMode();
|
||||
var submitButton = form.querySelector("[data-purchase-submit]");
|
||||
openButtons.forEach(function (openButton) {
|
||||
openButton.addEventListener("click", function () {
|
||||
var selected = {};
|
||||
@@ -190,14 +166,17 @@
|
||||
var empty = form.querySelector("[data-purchase-empty]");
|
||||
if (empty) empty.hidden = shown > 0;
|
||||
|
||||
/* 每次打开都回到演练模式,避免上次关闭弹窗后遗留 live 选择。 */
|
||||
var dryRun = form.querySelector("[data-execution-mode][value=dry_run]");
|
||||
if (dryRun) dryRun.checked = true;
|
||||
/* 每次打开都清空真实采购确认,不能沿用上一次未提交的确认。 */
|
||||
if (liveAcknowledged) liveAcknowledged.checked = false;
|
||||
if (liveConfirmation) liveConfirmation.value = "";
|
||||
updateExecutionMode();
|
||||
});
|
||||
});
|
||||
form.addEventListener("submit", function (event) {
|
||||
if (event.defaultPrevented || !submitButton) return;
|
||||
submitButton.disabled = true;
|
||||
submitButton.setAttribute("aria-busy", "true");
|
||||
submitButton.textContent = "创建中…";
|
||||
});
|
||||
}
|
||||
|
||||
/* PDD 批量采集弹窗只同步已选数量并提供提交反馈。
|
||||
|
||||
@@ -163,7 +163,7 @@
|
||||
<button type="button" class="modal-x" data-modal-close aria-label="关闭">×</button>
|
||||
</div>
|
||||
<form method="post" action="/syb/create-task" data-purchase-form
|
||||
data-confirm-submit="确认按下面的人民币价格上限创建采购任务?任务创建后将等待所选客户端领取。">
|
||||
data-confirm-submit="确认创建真实的未付款订单?系统不会自动支付。">
|
||||
<input type="hidden" name="csrf_token" value="{{.CSRFToken}}">
|
||||
<input type="hidden" name="order_no" value="{{.Keyword}}">
|
||||
<input type="hidden" name="stage" value="{{.StageFilter}}">
|
||||
@@ -172,32 +172,21 @@
|
||||
<div class="field">
|
||||
<label for="purchase-client">执行客户端</label>
|
||||
<select id="purchase-client" name="client_id" required autofocus>
|
||||
<option value="">请选择当前账号可见的客户端</option>
|
||||
{{range .AssignableClients}}<option value="{{.ClientID}}" data-purchase-mode="{{.PurchaseMode}}">{{.Name}}({{.ClientID}},{{.Status}},{{if eq .PurchaseMode "live"}}支持真实下单{{else}}仅演练{{end}})</option>{{end}}
|
||||
<option value="">请选择可执行真实采购的客户端</option>
|
||||
{{range .AssignableClients}}<option value="{{.ClientID}}">{{.Name}}({{.ClientID}})</option>{{end}}
|
||||
</select>
|
||||
{{if not .AssignableClients}}<small class="missing">当前账号没有可用客户端,请先让管理员完成客户端绑定。</small>{{end}}
|
||||
{{if not .AssignableClients}}<small class="missing">当前没有可执行真实采购的在线客户端。请检查客户端绑定、在线状态和真实采购授权。</small>{{end}}
|
||||
</div>
|
||||
<fieldset class="execution-mode-fieldset">
|
||||
<legend>执行模式</legend>
|
||||
<label class="choice-row">
|
||||
<input type="radio" name="execution_mode" value="dry_run" checked data-execution-mode>
|
||||
<span><strong>采购演练</strong><small>只验证采购流程,不在拼多多创建订单。</small></span>
|
||||
</label>
|
||||
<label class="choice-row">
|
||||
<input type="radio" name="execution_mode" value="live" data-execution-mode>
|
||||
<span><strong>真实下单(不支付)</strong><small>会在拼多多创建真实的未付款订单。</small></span>
|
||||
</label>
|
||||
</fieldset>
|
||||
<div class="live-confirm-panel" data-live-confirm-panel hidden>
|
||||
<div class="live-confirm-panel" data-live-confirm-panel>
|
||||
<strong>真实下单安全确认</strong>
|
||||
<p>这会产生真实未付款订单。必须选择声明 live 能力的客户端;系统不会自动支付。</p>
|
||||
<label class="choice-row">
|
||||
<input type="checkbox" name="live_acknowledged" value="1" data-live-acknowledged>
|
||||
<input type="checkbox" name="live_acknowledged" value="1" data-live-acknowledged required>
|
||||
<span>我确认本次操作会创建真实未付款订单</span>
|
||||
</label>
|
||||
<label for="live-confirmation">输入“创建未付款订单”继续</label>
|
||||
<input id="live-confirmation" name="live_confirmation" type="text"
|
||||
autocomplete="off" data-live-confirmation>
|
||||
autocomplete="off" data-live-confirmation required>
|
||||
</div>
|
||||
<p class="hint">价格上限单位是人民币元,默认取已映射 PDD 规格的采集价;不会使用顺运宝的台币售价。</p>
|
||||
{{range .Rows}}
|
||||
@@ -213,7 +202,7 @@
|
||||
</div>
|
||||
<div class="modal-foot">
|
||||
<button type="button" data-modal-close>取消</button>
|
||||
<button type="submit" class="primary" {{if not .AssignableClients}}disabled{{end}}>确认创建</button>
|
||||
<button type="submit" class="primary" data-purchase-submit {{if not .AssignableClients}}disabled{{end}}>确认创建真实采购任务</button>
|
||||
</div>
|
||||
</form>
|
||||
</div>
|
||||
|
||||
+1
-1
@@ -60,7 +60,7 @@
|
||||
|
||||
## 采购安全
|
||||
|
||||
- 真实下单开关默认关闭;未满足质量文档中的采购安全门禁不得启用。
|
||||
- Admin 新建采购任务固定下发 `live`;Client 本地真实采购授权仍默认关闭,未满足质量文档中的设备绑定和采购安全门禁不得声明 live 能力或领取任务。
|
||||
- 高风险点击前必须使用最新页面状态重新校验商品、规格、数量、价格和目标坐标。
|
||||
- 进入不可逆下单阶段前先持久化执行步骤。
|
||||
- 不可逆阶段发生崩溃或结果不确定时,只能核对订单或转人工处理,禁止自动重新下单。
|
||||
|
||||
@@ -234,8 +234,9 @@ PDD 商品之所以单独一个模块,是因为它在数据上就是**独立
|
||||
- 规则引擎只对可购买候选做 A/B/C/冲突分层和稳定排序;只有唯一、无额外维度歧义的 A 级才预选。
|
||||
- 预选不会自动保存或创建采购任务。页面必须显示推荐理由,采购员点击保存后才写映射和只追加的决策审计。
|
||||
|
||||
**创建采购任务:** 只有映射仍有效且没有进行中采购任务的行可勾选。确认弹窗要求
|
||||
选择当前账号可见的客户端,并逐行确认人民币价格上限;服务端仍按 §5 全量复核。
|
||||
**创建采购任务:** 只有映射仍有效且没有进行中采购任务的行可勾选。确认弹窗只列出
|
||||
当前账号可见、在线且声明 live 能力的客户端,并逐行确认人民币价格上限。新任务固定
|
||||
为真实下单(不支付),弹窗始终要求风险复选和确认短语;服务端仍按 §5 全量复核。
|
||||
|
||||
**底部状态条:** 最近同步时间、待匹配条数。
|
||||
|
||||
@@ -351,15 +352,16 @@ PDD 商品之所以单独一个模块,是因为它在数据上就是**独立
|
||||
4. 数量大于 0;
|
||||
5. **价格上限已填且大于 0** —— 默认从当前映射的 PDD 规格价格带出,操作员可改,但不允许为空;
|
||||
6. 已选择分配的客户端;
|
||||
7. 所选客户端存在且在当前账号可见范围内;
|
||||
8. 同一顺运宝明细没有 `pending` / `assigned` / `claimed` 的采购任务。
|
||||
7. 所选客户端存在、在线、在当前账号可见范围内,且声明 `purchase_mode=live`;
|
||||
8. 已勾选真实下单风险确认并输入“创建未付款订单”;
|
||||
9. 同一顺运宝明细没有 `pending` / `assigned` / `claimed` 的采购任务。
|
||||
|
||||
采购任务创建时必须选择不可变的执行模式:
|
||||
Admin 新建采购任务固定使用不可变的 `execution_mode=live`,不向采购员提供模式选择:
|
||||
|
||||
- `dry_run`(采购演练)是默认值,历史任务也按此处理;
|
||||
- `live` 会创建真实未付款订单,管理员和其他正常状态用户均可创建,但必须勾选风险确认并输入“创建未付款订单”;
|
||||
- `live` 必须显式指定当前账号可见、且最后登记能力为 `purchase_mode=live` 的 Client;
|
||||
- 必须显式指定当前账号可见、在线且最后登记能力为 `purchase_mode=live` 的 Client;
|
||||
- 创建时记录确认用户和确认时间。取消、重派和结果回传均不得修改执行模式。
|
||||
- 数据库和 API 继续保留 `dry_run/live`,历史任务和缺省兼容值仍按 `dry_run`,不得批量升级历史任务。
|
||||
|
||||
第 5 条是硬要求:Client 契约规定采购任务必须带明确的价格保护
|
||||
(见 [Client 契约](../client/04-admin-api-contract.md) §4),没有它 Client 会拒绝执行。
|
||||
|
||||
@@ -110,7 +110,7 @@ UPDATE tasks
|
||||
|
||||
`[必须]` **响应里不含租约**,也不含 Admin 侧状态。Client 不关心这些。
|
||||
|
||||
`execution_mode` 只允许 `dry_run` / `live`,历史任务默认 `dry_run`。领取查询必须按
|
||||
`execution_mode` 只允许 `dry_run` / `live`;Admin Web 新建采购任务固定为 `live`,历史任务和接口缺省兼容值仍为 `dry_run`。领取查询必须按
|
||||
Client 上报的 `capabilities.purchase_mode` 过滤:`dry_run` Client 只能看到演练任务,
|
||||
`live` Client 可以看到两种;过滤只决定能否领取,绝不改变任务自身模式。
|
||||
|
||||
|
||||
@@ -555,7 +555,9 @@ HTML 片段,只替换弹窗内部的表格、总数和分页。主货运单表
|
||||
### 6.4 创建采购任务
|
||||
|
||||
只有“可创建采购任务”的行可勾选。勾选后打开服务端渲染的确认弹窗:选择当前账号
|
||||
可见的客户端,并逐行确认人民币价格上限。默认值来自映射规格的 PDD 采集价;没有价格时留空强制填写。
|
||||
可见、在线且声明 live 能力的客户端,并逐行确认人民币价格上限。默认值来自映射规格
|
||||
的 PDD 采集价;没有价格时留空强制填写。新任务固定为真实下单(不支付),不显示执行
|
||||
模式选择;风险说明、复选确认和“创建未付款订单”确认短语始终显示。
|
||||
|
||||
`[必须]` 校验不过的**不要静默跳过**,要列出来告诉操作员缺什么:
|
||||
|
||||
@@ -569,14 +571,16 @@ HTML 片段,只替换弹窗内部的表格、总数和分页。主货运单表
|
||||
· SO-...-009 规格未匹配
|
||||
```
|
||||
|
||||
`[必须]` 创建前弹出确认框,让操作员选**分配给哪个客户端**,并确认价格上限。
|
||||
`[必须]` 创建前弹出确认框,让操作员选**分配给哪个 live 在线客户端**,并确认价格上限。
|
||||
价格上限默认从当前映射的 PDD 规格采集价带出,可改,**不允许为空**。
|
||||
|
||||
可采购行的“下一步”显示“创建采购任务”。点击后复用同一个确认弹窗并只带入当前明细,
|
||||
不改变表格复选框状态;顶部批量入口仍按已勾选明细打开。每次打开确认弹窗都默认回到
|
||||
“采购演练”,不得保留上一次未提交的真实下单选择。已有未结束任务的行显示
|
||||
“查看采购任务”并进入“采集采购”页,不得再次创建。服务端仍必须重新校验映射、数量、
|
||||
人民币价格上限、客户端权限、执行模式和重复任务,不能信任列表页的旧状态。
|
||||
不改变表格复选框状态;顶部批量入口仍按已勾选明细打开。每次打开确认弹窗都清空
|
||||
上一次未提交的风险复选和确认短语。客户端选项只显示名称和 Client ID,不显示“在线、
|
||||
仅演练/支持真实下单”等模式文字;没有符合条件的 Client 时禁用提交并说明原因。已有未
|
||||
结束任务的行显示“查看采购任务”并进入“采集采购”页,不得再次创建。服务端仍必须重新
|
||||
校验映射、数量、人民币价格上限、客户端权限、固定 live 模式、确认信息和重复任务,不能
|
||||
信任列表页的旧状态。
|
||||
|
||||
|
||||
## 7. 采集采购页
|
||||
|
||||
@@ -275,7 +275,6 @@ CMAutoBuy/ 整个文件夹拷到任何机器都能用
|
||||
| # | 待确认什么 | 临时默认值(先这么做) | 定下来之前会卡住什么 |
|
||||
|---|---|---|---|
|
||||
| 1 | Admin 的认证方式和 Client 注册方式 | Mock Gateway 不做认证;HTTP 实现预留 `Authorization: Bearer` 请求头,token 从设置读 | 只卡真实 HTTP 联调,不卡 MVP |
|
||||
| 2 | 真实采购启用条件和人工确认策略 | 真实下单开关**保持关闭**,一律走演练模式 | 卡真实下单,不卡 MVP |
|
||||
| 3 | 价格允许偏差 | 默认 0 分(即实际价格必须等于预期价格才继续),可在设置页改 | 不卡。先按最严的来 |
|
||||
| 4 | 是否存在颜色、尺码之外的第三个规格维度 | **按"可能有任意多个维度"实现**,用 `dimensions` 数组,不要写死两个 | 不卡。写死才会返工 |
|
||||
|
||||
@@ -283,6 +282,7 @@ CMAutoBuy/ 整个文件夹拷到任何机器都能用
|
||||
|
||||
**已定案(不再是待确认项):**
|
||||
|
||||
- Admin 新建采购任务固定为 `execution_mode=live`,不再提供演练选择;Client 本地授权仍默认关闭,只有绑定 Client ID、Android 设备且通过安全门禁后才声明 live 能力和领取任务。
|
||||
- Admin 只分配任务给指定 Client,Client 不读全局任务池。见 [04](04-admin-api-contract.md) §5.1。
|
||||
- **没有租约、没有心跳、没有状态回查。** 任务流程只有领取、提交结果、提交失败三个调用;设置页另有无任务副作用的幂等 Client 登记调用。见 [04](04-admin-api-contract.md) §1、§4.1。
|
||||
- 本地只存已领取任务,已完成任务**永久保留**。诊断产物(截图、XML、日志)仍按 `diagnostics.retention_days` 清理,两者不是一回事。见 [03](03-data-model.md) §3.1。
|
||||
|
||||
@@ -356,9 +356,9 @@ Client 与 Admin 的任务交互只有三种调用:领一个任务、提交结
|
||||
|
||||
`TaskDispatcher` 是能力声明的唯一入口。没有可用采购 Adapter、没有已保存
|
||||
Android 设备或本地持久化未准备好时,只声明 `collect`;条件满足时才声明
|
||||
`collect,purchase`。真实下单授权默认关闭;只有本地授权同时匹配当前 Client ID、
|
||||
已保存 Android 设备且 live Adapter 就绪时才声明 `purchase_mode=live`,否则声明
|
||||
`dry_run`。领取响应必须先完整校验并
|
||||
`collect,purchase`。Admin 新建采购任务固定为 live,但 Client 本地授权仍默认关闭;
|
||||
只有本地授权同时匹配当前 Client ID、已保存 Android 设备且 live Adapter 就绪时才声明
|
||||
`purchase_mode=live`,否则声明 `dry_run` 且不能领取新建的 live 采购任务。领取响应必须先完整校验并
|
||||
写入 SQLite,Repository 提交成功后才能分派,避免任务已在 Admin 领取却在本地丢失。
|
||||
|
||||
中途 Admin 是否取消了这个任务、是否重派给了别人,Client 不查也不管,做完照样提交——
|
||||
@@ -437,7 +437,7 @@ PDD 页面可能出现登录失效、验证码、控件树不完整、A/B 页面
|
||||
4. 使用 Outbox 保证结果最终提交,并隔离“提交重试”与“业务重做”。
|
||||
5. MVP 单设备串行执行,不并行控制多个设备。
|
||||
6. 采集规格采用通用维度和 SKU 组合结构,不把模型锁死为颜色与尺码两个数组。
|
||||
7. MVP 采购默认演练模式,真实下单必须通过独立安全验收。
|
||||
7. Admin 新建采购任务固定为真实下单(不支付);Client 只有通过独立安全验收和本地设备绑定后才声明 live 能力。
|
||||
|
||||
## 11. 相关文档
|
||||
|
||||
|
||||
@@ -233,7 +233,7 @@ Client 的 `HttpAdminGateway.claim_next` 已实现本接口,并原样序列化
|
||||
|
||||
- `[必须]` 领取必须在 Admin 内部原子完成,一次调用最多返回一个任务。
|
||||
- `[必须]` Admin 不得向只声明 `dry_run` 的 Client 分配要求真实下单的任务。
|
||||
- `[必须]` `execution_mode` 只允许 `dry_run`、`live`。历史任务和缺省值都是 `dry_run`;Client 不得自行把模式从演练提升为真实。
|
||||
- `[必须]` `execution_mode` 只允许 `dry_run`、`live`。Admin Web 新建采购任务固定为 `live`;历史任务和接口缺省兼容值仍是 `dry_run`,Client 不得自行把模式从演练提升为真实。
|
||||
- `[必须]` 声明 `dry_run` 的 Client 只能领取 `dry_run`;声明 `live` 的 Client 可以领取两种模式。能力只缩小可领取范围,不修改任务模式。
|
||||
- `[必须]` 响应**不包含**租约。Client 拿到任务就开始做,做完再来领下一个。
|
||||
|
||||
|
||||
@@ -293,12 +293,12 @@ class TaskTableModel(QAbstractTableModel):
|
||||
- 最大重试次数;
|
||||
- 演练模式开关。
|
||||
|
||||
### 真实下单(不支付)
|
||||
### 真实采购授权(不支付)
|
||||
|
||||
- 默认关闭,并明确显示当前状态、绑定 Client、绑定 Android 设备和确认时间;
|
||||
- Admin 新建采购任务固定为 live;Client 本地授权默认关闭,并明确显示当前状态、绑定 Client、绑定 Android 设备和确认时间;
|
||||
- 只有输入完整确认文字“创建未付款订单”后才能启用,不能通过环境变量或调试参数开启;
|
||||
- 启用和关闭在后台线程保存,执行期间禁用重复操作,失败时保留原状态并说明恢复办法;
|
||||
- 启用仅代表允许创建一笔未付款订单,不允许自动付款;设备或 Client 绑定变化后自动降级为演练;
|
||||
- 启用仅代表允许创建一笔未付款订单,不允许自动付款;设备或 Client 绑定变化后撤销 live 能力并停止领取新采购任务;
|
||||
- 关闭操作始终可见,状态不能只用颜色表达。
|
||||
|
||||
### 安全与诊断
|
||||
|
||||
@@ -70,7 +70,7 @@ PDD 解析测试优先使用脱敏的 XML 固件,不要求每次连接真实
|
||||
|
||||
## 3. 采购安全门禁
|
||||
|
||||
真实下单开关默认关闭。全部满足后才能通过独立工单启用:
|
||||
Admin 新建采购任务固定为真实下单(不支付);Client 本地 live 授权仍默认关闭。全部满足后才能声明 live 能力并领取真实采购任务:
|
||||
|
||||
1. Admin 原子领取和结果幂等已经通过联合测试。
|
||||
2. Outbox 断网和重启恢复测试通过。
|
||||
@@ -81,7 +81,7 @@ PDD 解析测试优先使用脱敏的 XML 固件,不要求每次连接真实
|
||||
7. 演练模式在代表性商品和设备上通过验收。
|
||||
8. 操作人员明确确认真实下单范围和安全设置。
|
||||
|
||||
真实下单不得通过调试参数、默认配置或界面误操作意外开启。当前版本仅在设置页
|
||||
Client 本地 live 授权不得通过调试参数、默认配置或界面误操作意外开启。当前版本仅在设置页
|
||||
精确输入确认文字后保存授权,并绑定 Client ID 和已保存 Android 设备;任一绑定
|
||||
不一致都降级为 `purchase_mode=dry_run`。演练 Adapter 不提供提交方法,live Adapter
|
||||
只提供一次性提交方法,两者都不提供付款或取消订单方法。开发者不能把自动化测试
|
||||
|
||||
Reference in New Issue
Block a user