Document production filament workflow

README.md

@@ -436,6 +436,64 @@ Then rebuild/restart:
 docker compose up -d --build
 ```
 
+## After Testing / Production Cutover
+
+Keep filament sync in dry-run until all three checks are clean:
+
+```powershell
+curl.exe -H "X-Service-Token: change-me" http://localhost:8088/filament/status
+curl.exe -X POST -H "X-Service-Token: change-me" "http://localhost:8088/sync/filament/assignments?dry_run=true"
+curl.exe -X POST -H "X-Service-Token: change-me" "http://localhost:8088/sync/filament/usage?dry_run=true"
+```
+
+Expected assignment check:
+
+```text
+would_create: []
+would_delete: []
+skipped: 0
+failed: 0
+```
+
+Expected usage check before any print has finished:
+
+```text
+seen: 0
+would_remove: []
+failed: 0
+```
+
+After a successful print, run usage dry-run again. Only switch to real automatic filament sync when `would_remove` contains the expected batch code and grams.
+
+Recommended final production settings:
+
+```env
+FILAMENT_TRACKING_ENABLED=true
+FILAMENT_DRY_RUN=false
+FILAMENT_SYNC_SPOOLS=true
+FILAMENT_SYNC_ASSIGNMENTS=true
+FILAMENT_UNASSIGN_MISSING_ASSIGNMENTS=true
+FILAMENT_SYNC_LOCATIONS=true
+FILAMENT_SYNC_USAGE=true
+FILAMENT_RETURN_UNASSIGNED_TO_STORAGE=false
+POLL_INTERVAL_SECONDS=300
+SYNC_ON_STARTUP=false
+```
+
+Apply the config:
+
+```powershell
+docker compose up -d
+```
+
+Production operating rule:
+
+- Move a spool to InvenTree location `93`, `94`, `95`, or `96` to mark it loaded in B1, B2, B3, or B4.
+- Move a spool back to InvenTree `Filament_Storage` to mark it unloaded.
+- The sync service creates or removes Bambuddy assignments from those InvenTree locations.
+- InvenTree remains the source of truth for spool location and remaining grams.
+- Bambuddy usage history is used only for subtracting printed grams after successful prints.
+
 For near-real-time syncing, also configure a Bambuddy webhook:
 
 ```text