Help & Guide

Setup

1. Change admin password — /_/, login with admin@rfl.local, Settings → Admin.
2. Add categories & zones — on the Intake page, tap the + button next to Category or Zone dropdown. Prompts for name/color/label. Also available at /categories.html and /zones.html.
3. Operator name — first action asks "Who is operating?" once. Saved in your browser for the session. All audit entries stamped with this name.

QR Label Workflow

1. Pregenerate — SSH in and run node generate-labels.js --pregenerate 30. Creates placeholder items in DB + prints labels PDF to /tmp/.
2. Print & stick — 15 labels per letter sheet (3×5 layout). Each shows RFL ID + QR code.
3. Fill in later — scan QR on label with phone camera (or tap Scan on home page). Opens item page. Tap Edit to fill in name, category, zone, etc.
4. Manage — QR page shows all items with QR codes, pending vs. filled, paginated grid.

Adding Items (Intake)

1. Tap + Intake in nav.
2. RFL ID auto-assigned. Override it to match a pre-printed label.
3. Fill in name, kind, category, zone.
4. Kind: Asset = single, Bin = container, Lot = bulk.
5. Optional: qty, unit, condition, value tier, parent container, manifest, return-to, notes.
6. Category/zone can be added inline via the + buttons.
7. Tap Save.

Finding Items

• Search — type name, RFL ID, or keyword. Searches names, IDs, manifests, and notes.
• QR Scan — tap Scan on home page. Point camera at label. Auto-navigates to item.
• QR page — browse items as QR code grid, with pagination and filters.

Item Actions

• Edit — change item fields.
• Move — reassign to a different zone.
• Check Out — record who took the item and when.
• Return — check the item back in.
• Damage — update condition (worn/damaged/repair/retired).
• Reconcile — mark item as seen this season.

Label CLI Reference

--pregenerate N	Create N placeholder items + print labels
--all	Print labels for all existing items
--item RFL-005	Single item label
--blanks N	Print only, no DB records

Output: /tmp/labels-*.pdf. 15 labels per letter sheet (3 columns × 5 rows).

URLs

• Home: /
• Intake: /intake.html
• QR codes: /qrcodes.html
• Categories: /categories.html
• Zones: /zones.html
• Admin: /_/
• Help: /help.html