makea-cli 0.1.20__tar.gz → 0.1.22__tar.gz

{makea_cli-0.1.20 → makea_cli-0.1.22}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: makea-cli
-Version: 0.1.20
+Version: 0.1.22
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27
@@ -82,10 +82,16 @@ makea-cli auth --logout
 - `makea-cli create-quote-request -s <supplier_id> -p <product_reference_id> [--quote-type SAMPLING|PRODUCTION] [--message ...] [--due-date YYYY-MM-DD]` — 创建并发送 quote request（POST `/admin/supplier/create_quote_request`）  
 - `makea-cli get-quote-requests-by-supplier-id <supplier_id> [--status <status>] [-n <limit>]` — 直连后端按 supplier_id 查询 quote requests  
 - `makea-cli get-supplier-links-by-supplier-id <supplier_id> [--link-type SAMPLING|PRODUCTION]` — 直连后端按 supplier_id 查询 supplier links  
-- `makea-cli submit-supplier-quote <quote_request_id> --link-name ... --currency ... --sampling-price-amount ... --sampling-price-valid-until ... --production-price-tiers-json ... --sample-lead-time ... --lead-time ... --deliverables-json ... --customer-note ...` — 以供应商身份向指定 quote request 新增 quote（完整参数说明见 `--help`）  
+- `makea-cli submit-supplier-quote <quote_request_id> --link-name ... --currency ... --sampling-price-value ... --sampling-price-valid-until ... --sample-lead-time ... --deliverables-json ... --customer-note ...` — 以 admin 身份代供应商向指定 quote request 新增 quote。大货阶梯价（`--production-price-tiers-json`）和 `--lead-time` 现在是可选的；样衣加做费、MOQ 口径、寄料地址（CMT / full package 打样报价必填）、可选尺码颜色、规格行、typed link 等字段见 `--help`。pricing groups 提交时给不进去，提交完用 `update-supplier-quote` 补  
+- `makea-cli update-supplier-quote <product_id> <link_id> [--sampling-price-value ... --sampling-price-valid-until ...] [--production-price-tiers-json ...] [--pricing-groups-json ...] [...]` — 改一条已提交的 quote（supplier link）：只发你传的字段，没传的后端不动；pricing groups（多套阶梯价）只有这条命令能写（POST `/admin/product/edit_supplier_link_override_info`）  
 - `makea-cli list-product-orders` — 列出所有设计师产品订单（GET `/admin/designer/get_all_product_orders`）  
 - `makea-cli list-sampling-orders-by-product <id>` — 按产品 reference id 列打样单  
 - `makea-cli list-production-orders-by-product <id>` — 按产品 reference id 列大货单  
+- `makea-cli production-pricing-show <production_order_id>` — 看一张大货单的定价现状：币种、MOQ、阶梯价、尺码/颜色、pricing groups、购物车覆盖情况（加 `--json` 出原始字段）  
+- `makea-cli production-variants-set <production_order_id> --sizes S,M,L --color "Black:#000000"` — 改这张单的可选尺码和颜色（cart key 就是由它们拼出来的）  
+- `makea-cli production-tiers-set <production_order_id> --tier 100-199:7.50 --tier 500+:7.20 --moq 100` — 改整单口径的阶梯价 / MOQ / incoterm / 币种  
+- `makea-cli production-groups-generate <production_order_id> --by style|colour|variant|all` — 按某个轴生成 pricing groups，连带每组的阶梯价和 MOQ  
+- `makea-cli production-groups-set <production_order_id> --file groups.json | --from-quote | --clear` — 整体写入 pricing groups：文件回放、从供应商报价拷贝、或清空回退到整单阶梯价  
 - `makea-cli download-document <document_id> -u <user_id>` — 下载单个文件（GET `/admin/document/download`）  
 - `makea-cli download-product-document <product_reference_id> <document_id> -d <designer_user_id>` — 按产品行 + 文档 id 下载（内部用订单列表 JSON，不额外查 metadata）  
 - `makea-cli upload-product-document -u <designer_user_id> -p <product_id> -f <path>` — 通用产品文档上传（不限 quote 流程）：上传到 AWS S3 并挂到产品（POST `/admin/designer/upload_document`），返回 document domain 元数据供其它命令使用  
@@ -100,6 +106,47 @@ makea-cli auth --logout
 
 ---
 
+## 大货定价（price tier / 颜色尺码 / pricing group）
+
+一张 production order 的价格由三部分组成：
+
+1. `available_sizes` / `available_colors` — 买家购物车的网格。cart key 是 `"{尺码},{颜色}"`，颜色段有 hex 就用 `hex_code`，没有才退回 `color_name`。所以颜色尽量都给 hex。
+2. `production_price_tiers` + `moq` — 整单一套阶梯价。**只在这张单没有 pricing group 时生效**。
+3. `pricing_groups` — 若干个各自计价的 cart key 分组。分组回答"谁共用一套价目表"，`tier_basis` / `moq_basis` 回答"按什么量去查这套表"（VARIANT 每个 cart key 各算各的，GROUP 按组内合计，ORDER 按全单合计）。
+
+MOQ 的几种配法就是这两个旋钮的组合：
+
+| 想要的效果 | 命令 |
+|---|---|
+| 每个 style 自己的阶梯价 + 自己的 MOQ | `--by style --moq-basis group` |
+| 每个颜色一个 MOQ，跨所有 style 累计 | `--by colour --moq-basis group` |
+| 每个颜色 × 尺码单独计价 | `--by variant --moq-basis group` |
+| 全单一套价，MOQ 看全单总量 | `--by all --moq-basis order` |
+
+阶梯写法：`--tier 100-199:7.50 --tier 200-499:7.40 --tier 500+:7.20`。结尾的 `+`（或只写下限）表示不封顶，存成 `max_qty=0`；后端从低到高选，最后一个够 `min_qty` 的档位胜出。
+
+单组覆盖：`--tier-for 'S=100-199:22.45'`、`--moq-for 'S=100'`，等号左边可以写组名、尺码、颜色名或 hex。
+
+例（参考 Lacati 毯子那张报价的形态：三个尺寸各一套价，MOQ 100/组）：
+
+```bash
+makea-cli production-variants-set <po_id> --sizes S,M,L --customized-color
+makea-cli production-groups-generate <po_id> --by style \
+  --tier-for 'S=100-199:7.50'  --tier-for 'S=300+:7.20' \
+  --tier-for 'M=100-199:22.45' --tier-for 'M=300+:21.85' \
+  --tier-for 'L=100-199:33.05' --tier-for 'L=300+:32.25' \
+  --moq 100 --moq-basis group --tier-basis VARIANT --dry-run
+```
+
+几条要记住的：
+
+- 写命令都先打印 plan 再问一次；`--dry-run` 只看不发，`--yes` 跳过确认。默认打的是**生产环境**。
+- 购物车里有、却没被任何组认领的 cart key，付款时会整单失败（不是按 0 计价）。plan 和保存结果都会把这些 key 列出来。
+- 重跑 `production-groups-generate` 会保留同名/同变体旧组的 `group_id` 和这次没指定的字段，所以"只改 MOQ"是安全的。
+- 已经付过款的单，改这里不会动已经收的钱（发票读冻结值），只影响之后的扣款。
+
+---
+
 ## Claude / Cursor skills（可选）
 
 仓库内 `.claude/skills/` 下放有面向 agent 的操作说明，例如：

{makea_cli-0.1.20 → makea_cli-0.1.22}/README.md

@@ -71,10 +71,16 @@ makea-cli auth --logout
 - `makea-cli create-quote-request -s <supplier_id> -p <product_reference_id> [--quote-type SAMPLING|PRODUCTION] [--message ...] [--due-date YYYY-MM-DD]` — 创建并发送 quote request（POST `/admin/supplier/create_quote_request`）  
 - `makea-cli get-quote-requests-by-supplier-id <supplier_id> [--status <status>] [-n <limit>]` — 直连后端按 supplier_id 查询 quote requests  
 - `makea-cli get-supplier-links-by-supplier-id <supplier_id> [--link-type SAMPLING|PRODUCTION]` — 直连后端按 supplier_id 查询 supplier links  
-- `makea-cli submit-supplier-quote <quote_request_id> --link-name ... --currency ... --sampling-price-amount ... --sampling-price-valid-until ... --production-price-tiers-json ... --sample-lead-time ... --lead-time ... --deliverables-json ... --customer-note ...` — 以供应商身份向指定 quote request 新增 quote（完整参数说明见 `--help`）  
+- `makea-cli submit-supplier-quote <quote_request_id> --link-name ... --currency ... --sampling-price-value ... --sampling-price-valid-until ... --sample-lead-time ... --deliverables-json ... --customer-note ...` — 以 admin 身份代供应商向指定 quote request 新增 quote。大货阶梯价（`--production-price-tiers-json`）和 `--lead-time` 现在是可选的；样衣加做费、MOQ 口径、寄料地址（CMT / full package 打样报价必填）、可选尺码颜色、规格行、typed link 等字段见 `--help`。pricing groups 提交时给不进去，提交完用 `update-supplier-quote` 补  
+- `makea-cli update-supplier-quote <product_id> <link_id> [--sampling-price-value ... --sampling-price-valid-until ...] [--production-price-tiers-json ...] [--pricing-groups-json ...] [...]` — 改一条已提交的 quote（supplier link）：只发你传的字段，没传的后端不动；pricing groups（多套阶梯价）只有这条命令能写（POST `/admin/product/edit_supplier_link_override_info`）  
 - `makea-cli list-product-orders` — 列出所有设计师产品订单（GET `/admin/designer/get_all_product_orders`）  
 - `makea-cli list-sampling-orders-by-product <id>` — 按产品 reference id 列打样单  
 - `makea-cli list-production-orders-by-product <id>` — 按产品 reference id 列大货单  
+- `makea-cli production-pricing-show <production_order_id>` — 看一张大货单的定价现状：币种、MOQ、阶梯价、尺码/颜色、pricing groups、购物车覆盖情况（加 `--json` 出原始字段）  
+- `makea-cli production-variants-set <production_order_id> --sizes S,M,L --color "Black:#000000"` — 改这张单的可选尺码和颜色（cart key 就是由它们拼出来的）  
+- `makea-cli production-tiers-set <production_order_id> --tier 100-199:7.50 --tier 500+:7.20 --moq 100` — 改整单口径的阶梯价 / MOQ / incoterm / 币种  
+- `makea-cli production-groups-generate <production_order_id> --by style|colour|variant|all` — 按某个轴生成 pricing groups，连带每组的阶梯价和 MOQ  
+- `makea-cli production-groups-set <production_order_id> --file groups.json | --from-quote | --clear` — 整体写入 pricing groups：文件回放、从供应商报价拷贝、或清空回退到整单阶梯价  
 - `makea-cli download-document <document_id> -u <user_id>` — 下载单个文件（GET `/admin/document/download`）  
 - `makea-cli download-product-document <product_reference_id> <document_id> -d <designer_user_id>` — 按产品行 + 文档 id 下载（内部用订单列表 JSON，不额外查 metadata）  
 - `makea-cli upload-product-document -u <designer_user_id> -p <product_id> -f <path>` — 通用产品文档上传（不限 quote 流程）：上传到 AWS S3 并挂到产品（POST `/admin/designer/upload_document`），返回 document domain 元数据供其它命令使用  
@@ -89,6 +95,47 @@ makea-cli auth --logout
 
 ---
 
+## 大货定价（price tier / 颜色尺码 / pricing group）
+
+一张 production order 的价格由三部分组成：
+
+1. `available_sizes` / `available_colors` — 买家购物车的网格。cart key 是 `"{尺码},{颜色}"`，颜色段有 hex 就用 `hex_code`，没有才退回 `color_name`。所以颜色尽量都给 hex。
+2. `production_price_tiers` + `moq` — 整单一套阶梯价。**只在这张单没有 pricing group 时生效**。
+3. `pricing_groups` — 若干个各自计价的 cart key 分组。分组回答"谁共用一套价目表"，`tier_basis` / `moq_basis` 回答"按什么量去查这套表"（VARIANT 每个 cart key 各算各的，GROUP 按组内合计，ORDER 按全单合计）。
+
+MOQ 的几种配法就是这两个旋钮的组合：
+
+| 想要的效果 | 命令 |
+|---|---|
+| 每个 style 自己的阶梯价 + 自己的 MOQ | `--by style --moq-basis group` |
+| 每个颜色一个 MOQ，跨所有 style 累计 | `--by colour --moq-basis group` |
+| 每个颜色 × 尺码单独计价 | `--by variant --moq-basis group` |
+| 全单一套价，MOQ 看全单总量 | `--by all --moq-basis order` |
+
+阶梯写法：`--tier 100-199:7.50 --tier 200-499:7.40 --tier 500+:7.20`。结尾的 `+`（或只写下限）表示不封顶，存成 `max_qty=0`；后端从低到高选，最后一个够 `min_qty` 的档位胜出。
+
+单组覆盖：`--tier-for 'S=100-199:22.45'`、`--moq-for 'S=100'`，等号左边可以写组名、尺码、颜色名或 hex。
+
+例（参考 Lacati 毯子那张报价的形态：三个尺寸各一套价，MOQ 100/组）：
+
+```bash
+makea-cli production-variants-set <po_id> --sizes S,M,L --customized-color
+makea-cli production-groups-generate <po_id> --by style \
+  --tier-for 'S=100-199:7.50'  --tier-for 'S=300+:7.20' \
+  --tier-for 'M=100-199:22.45' --tier-for 'M=300+:21.85' \
+  --tier-for 'L=100-199:33.05' --tier-for 'L=300+:32.25' \
+  --moq 100 --moq-basis group --tier-basis VARIANT --dry-run
+```
+
+几条要记住的：
+
+- 写命令都先打印 plan 再问一次；`--dry-run` 只看不发，`--yes` 跳过确认。默认打的是**生产环境**。
+- 购物车里有、却没被任何组认领的 cart key，付款时会整单失败（不是按 0 计价）。plan 和保存结果都会把这些 key 列出来。
+- 重跑 `production-groups-generate` 会保留同名/同变体旧组的 `group_id` 和这次没指定的字段，所以"只改 MOQ"是安全的。
+- 已经付过款的单，改这里不会动已经收的钱（发票读冻结值），只影响之后的扣款。
+
+---
+
 ## Claude / Cursor skills（可选）
 
 仓库内 `.claude/skills/` 下放有面向 agent 的操作说明，例如：

makea_cli-0.1.22/makea_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.22"

{makea_cli-0.1.20 → makea_cli-0.1.22}/makea_cli/api_client.py

@@ -390,6 +390,27 @@ def submit_admin_quote_for_quote_request(
     return post_json(f"/admin/quote_requests/{quote_request_id}/submit_quote", body)
 
 
+def edit_supplier_link_override_info(
+    *,
+    product_id: str,
+    link_id: str,
+    override_info: dict[str, Any],
+) -> Any:
+    """
+    POST /admin/product/edit_supplier_link_override_info — admin updates an existing
+    supplier link (a submitted quote) in place. Only the keys present in
+    ``override_info`` are applied; the rest of the link is left alone.
+    """
+    return post_json(
+        "/admin/product/edit_supplier_link_override_info",
+        {
+            "product_id": product_id,
+            "link_id": link_id,
+            "override_info": override_info,
+        },
+    )
+
+
 def upload_admin_link_document(
     *,
     file_path: Path,
@@ -652,6 +673,40 @@ def get_production_orders_by_product(
     )
 
 
+def get_production_order_details(production_order_id: str, *, timeout: float = 60.0) -> Any:
+    """
+    GET /admin/production_orders/{id}/details — one production (or restock) order in full.
+
+    Carries the pricing configuration the pricing commands read and write back:
+    currency, moq, production_price_tiers, pricing_groups, available_sizes,
+    available_colors, cart_items.
+    """
+    return get_json(f"/admin/production_orders/{production_order_id}/details", timeout=timeout)
+
+
+def update_production_order_details(
+    production_order_id: str,
+    body: dict[str, Any],
+    *,
+    timeout: float = 60.0,
+) -> Any:
+    """
+    POST /admin/production_orders/{id}/details/update — patch-style admin update.
+
+    Only the keys present in ``body`` are touched (moq, production_price_tiers,
+    pricing_groups, production_price_incoterm, production_price_valid_until,
+    available_sizes, available_colors, currency, lead_time, payment_term,
+    one_time_production_fees, sizechart, component_specifications). The response
+    may carry a ``warning`` plus ``uncovered_cart_keys`` when the saved pricing
+    groups do not price the whole cart.
+    """
+    return post_json(
+        f"/admin/production_orders/{production_order_id}/details/update",
+        body,
+        timeout=timeout,
+    )
+
+
 def get_cumulative_payment_and_platform_revenue(
     *,
     start_date: str,

{makea_cli-0.1.20 → makea_cli-0.1.22}/makea_cli/commands/__init__.py

@@ -12,6 +12,7 @@ from makea_cli.commands.library.cmd import register as register_library
 from makea_cli.commands.metrics.cmd import register as register_metrics
 from makea_cli.commands.orders.cmd import register as register_orders
 from makea_cli.commands.product.cmd import register as register_product
+from makea_cli.commands.production.cmd import register as register_production
 from makea_cli.commands.supplier.cmd import register as register_supplier
 
 
@@ -22,6 +23,7 @@ def register_all(app: typer.Typer) -> None:
     register_supplier(app)
     register_orders(app)
     register_product(app)
+    register_production(app)
     register_designer(app)
     register_metrics(app)
     register_analytics(app)

makea_cli-0.1.22/makea_cli/commands/production/__init__.py

@@ -0,0 +1,3 @@
+from makea_cli.commands.production.cmd import register
+
+__all__ = ["register"]