makea-cli 0.1.19__tar.gz → 0.1.21__tar.gz

{makea_cli-0.1.19 → makea_cli-0.1.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: makea-cli
-Version: 0.1.19
+Version: 0.1.21
 Summary: Makea admin CLI (browser login + Makea admin HTTP API)
 Requires-Python: >=3.10
 Requires-Dist: httpx>=0.27
@@ -86,6 +86,11 @@ makea-cli auth --logout
 - `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 +105,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.19 → makea_cli-0.1.21}/README.md

@@ -75,6 +75,11 @@ makea-cli auth --logout
 - `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 +94,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.21/makea_cli/__init__.py

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

{makea_cli-0.1.19 → makea_cli-0.1.21}/makea_cli/api_client.py

@@ -652,6 +652,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.19 → makea_cli-0.1.21}/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.19 → makea_cli-0.1.21}/makea_cli/commands/directory/cmd.py

@@ -59,7 +59,7 @@ def register(app: typer.Typer) -> None:
     def create_user(
         email: str = typer.Argument(
             ...,
-            help="Email address; also the Cognito username unless --username is given.",
+            help="Email address the new account signs in with.",
         ),
         user_type: str = typer.Option(
             ...,
@@ -94,7 +94,11 @@ def register(app: typer.Typer) -> None:
         username: str | None = typer.Option(
             None,
             "--username",
-            help="Optional Cognito username when it should differ from the email.",
+            help=(
+                "Optional Cognito pool username. Defaults to the email local part "
+                "(the pool has email as an alias, so the username itself cannot be "
+                "an email address). Sign-in uses the email either way."
+            ),
         ),
     ) -> None:
         """

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

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