Turn a CCK merchant's iMessage about misaligned prints into a tracker, a customer confirmation PDF, a factory review PDF, and a paste-ready cover note — all in one pass.
Owner
Vicente
Status
Stable
Slug
cck-kiosk-alignment
Location
~/Downloads/cck-kiosk-alignment
End-to-end workflow for handling CCK kiosk print-alignment reports. When a kiosk merchant sends a list of cases with print-alignment issues — usually short location notes like “15 pro right side” alongside photos — this skill produces four coordinated deliverables off a single cases.json input. The deliverables share ticket IDs, finish vocabulary (Smoke Frost / Clear Frost), and brand voice so nothing drifts between the merchant copy and the factory copy.
| Field | Required | Example |
|---|---|---|
| kiosk_id | Yes | CCK008 |
| date | Yes | April 29, 2026 |
| cases[] (model, finish, print, reported_location, customer_quote, photo) | Yes | { "model": "iPhone 15 Pro", "finish": "Smoke Frost", "print": "Carbon Fiber (Gray/Silver)", "reported_location": "right side", "customer_quote": "15 pro right side", "photo": "case_01.jpg" } |
| merchant_name (optional, used in customer PDF greeting) | Optional | Alfonso |
Internal alignment tracker
<KIOSK>_Alignment_Tracker.xlsxExcel sheet with one row per case, embedded reference photo, and the customer’s verbatim quote. Notes tab carries the SM/CL legend and the workflow context.
Customer / merchant confirmation PDF
<KIOSK>_Ticket_Confirmation.pdfBranded one-pager confirming tickets are open. Custom Case Kiosk header, ticket table mapping each case to a placeholder ID (CCK<kiosk>-NNN), next steps, footer.
Factory review request PDF
<KIOSK>_Factory_Review_Request.pdfMulti-page document for the factory. Page 1 is a summary table + a two-line ask; pages 2+ are per-case detail blocks with the embedded photo and a verbatim customer quote (no interpretation).
Factory cover note
<KIOSK>_Factory_Cover_Note.txtShort paste-ready text (4-6 sentences) to send alongside the factory PDF. References the kiosk ID and the ticket ID range, no merchant name.
What if the merchant adds a case after the initial report?
Update cases.json with the new case in array order and rerun `build_all.py`. The four scripts overwrite their outputs, so the tracker, customer PDF, factory PDF, and cover note all get refreshed in one shot.
What if a photo is missing for one of the cases?
Set `"photo": null` on that case. The Excel tracker shows a yellow “Photo file pending” cell, and the factory PDF shows a yellow “Reference photo to follow” card. Drop the file in and rerun once it arrives.
Why is the factory PDF deliberately so plain?
Two reasons. First, the factory needs unambiguous evidence — the customer’s exact words plus the photo, not our interpretation of either. Second, proposing fixes pre-judges the cause; a calibration tweak might be the right answer, but it might be a print-head problem or a mold tolerance instead. Letting the factory diagnose keeps the workflow honest.