David/WFDASH-WEBAPP
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: register stock_purchases.add_attachment in feature backlog + API reference

Browse source 
Co-authored-by: Orca <help@stably.ai>
This commit is contained in:
SJCoetz 2026-08-06 23:29:55 +02:00
parent dd57d29de3
commit bbfe20ec2d
3 changed files with 32 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

9
docs/AGENT_INSTRUCTIONS.md
View file

@ -124,7 +124,14 @@ specific** tool that fits the task.
| `collection_pool.list` | Inspect what drivers need to collect. |
| `order_items.update_status` | Move an item through the operational pipeline. |
### 4.4 CRM maintenance
### 4.4 Stock purchase + PO attachments
| Tool | Use it for |
| --- | --- |
| `purchase_orders.add_attachment` | Attach a supplier quote PDF or proof-of-delivery to a PO (base64, ≤25 MB). |
| `stock_purchases.add_attachment` | Attach a supplier invoice, packing slip, or damaged-stock photo to a stock purchase (base64, ≤25 MB). Appends to `additional_attachments`; does NOT touch the versioned-PDF `documents` ledger. |
### 4.5 CRM maintenance
| Tool | Use it for |
| --- | --- |

18
docs/api-mcp-layer.md
View file

@ -141,8 +141,17 @@ noted. Pagination defaults to `page=1`, `perPage=50` where relevant.
| `GET` | `/api/v1/purchase-orders/{id}/send-email/outcome` | — | Outcome of last send. |
| `GET` | `/api/v1/purchase-orders/{id}/pdf` | — | Render PO PDF. |
| `GET` | `/api/v1/purchase-orders/stale` | `?days=...` | List POs untouched for N days. |
| `POST` | `/api/v1/purchase-orders/{id}/attachments/upload` | `multipart/form-data` field `file` | Append a free-form attachment to `additional_attachments`. Max 25 MB. |
| `DELETE` | `/api/v1/purchase-orders/{id}/attachments/{filename}` | — | Remove a single additional-attachment token. |
### 2.12 Users / file proxy
### 2.12 Stock purchases
| Method | Path | Body | Notes |
| --- | --- | --- | --- |
| `POST` | `/api/v1/stock-purchases/{id}/attachments/upload` | `multipart/form-data` field `file` | Append a free-form attachment (supplier invoice, packing slip) to `stock_purchases.additional_attachments`. Max 25 MB. |
| `DELETE` | `/api/v1/stock-purchases/{id}/attachments/{filename}` | — | Remove a single additional-attachment token. |
### 2.13 Users / file proxy
| Method | Path | Body | Notes |
| --- | --- | --- | --- |
@ -189,6 +198,13 @@ JSON-RPC over HTTP. Same `Authorization` bearer as `/api/v1/*`.
| `customers.list` / `.get` / `.create` / `.update` / `.delete` | Full CRUD. `company` / `rep` accept id or name. |
| `suppliers.list` / `.get` / `.create` / `.update` / `.delete` | Full CRUD. |
#### Stock purchases / POs (attachments)
| Tool | Purpose |
| --- | --- |
| `purchase_orders.add_attachment` | Upload one free-form attachment to a PO (base64, ≤25 MB). |
| `stock_purchases.add_attachment` | Upload one free-form attachment (supplier invoice, packing slip, photo of damaged stock) to a stock purchase (base64, ≤25 MB). Appends to `additional_attachments`; does NOT touch the versioned-PDF `documents` ledger. |
### 3.3 Tool input shapes (condensed)
`quotes.create_from_email` (required: `subject`):

8
src/app/api/mcp/FEATURE-REQUESTS.md
View file

@ -95,6 +95,12 @@ When one ships, move it to **Implemented** with a one-line commit/PR reference.
- **Schema needs:** none — the `stock_purchase` + `stock_purchase_item` collections already exist
- **Open questions:** which PDF format(s) does the user want supported? Many SA suppliers send bespoke PO PDFs — a generic parser would need supplier-specific extraction rules. Probably needs an LLM-driven extraction step rather than layout heuristics. Worth scoping before implementation.
### Stock purchases: paperclip badge on list table
- **Surfaced:** 2026-08-06 — surfaced during the attachments-card PR (UI ships the detail-page affordance but the list table still shows no document indicator)
- **Severity:** nice-to-have
- **Suggested tool:** add a `count_additional_attachments` field to `stock_purchases.list` (or a separate `/api/v1/stock-purchases/attachment-counts` endpoint mirroring `/api/v1/sprint/attachment-counts`), render the sprint-style `<Paperclip>` chip in `StockOrdersTable` per row
- **Schema needs:** none — derived from `additional_attachments.length`
### Drivers: no MCP visibility or assignment
- **Surfaced:** 2026-08-06 — "can you see the driver stops and assign stops to drivers?"
- **Workaround:** "driver" data lives only as three fields on `order_items` (`drv_id`, `drv_assigned_at`, `drv_collected_at`). There is no separate `drivers` collection, no MCP tool to list drivers, no tool to see today's stops for one driver, no tool to bulk-assign stops to a driver. Operators can call `orders.list` and manually click through. Effectively the driver flow is invisible to the agent.
@ -121,4 +127,4 @@ These came up but need a human answer before code changes:
## Implemented
_(move entries here with a PR / commit link when they ship)_
- 2026-08-06 — `stock_purchases.add_attachment` shipped (commits `f89bbb3`, `dd57d29`). Adds a sibling to `purchase_orders.additional_attachments` plus the matching REST upload/delete routes and a UI card on `/stock-orders/[id]`. PB schema: new `stock_purchases.additional_attachments` file field (multi, maxSelect 10, any MIME).