Uniform stock management for healthcare linen rooms: the coordinator app, the phone counter and the staff app, for your own server. Built from 38e16eb on 2026-09-15. Licensed under the Functional Source License (FSL-1.1-ALv2).
6.3 KiB
title, section, order, summary, screen, role, keywords
| title | section | order | summary | screen | role | keywords |
|---|---|---|---|---|---|---|
| Issue a garment | counter | 1 | Choose the person, add the garments, pick where each comes from, record it. What is written, and what the counter refuses. | Counter | Admin or Issuer | issue, issue stock, counter, scan, barcode, badge, six sets, ceiling, override, pre-loved, order in, usual sizes, repeat last, refusal, slip, hand out uniform |
Counter serves one person at a time. You choose the person first, then the mode: Issue, Return, Hand in or Swap a size. This page covers Issue; the other three are on Exchanges and returns. The server repeats every check the screen makes.
At the counter
- Find the person. Type a name or staff number into
Find a person, or scan their badge. Up to 8 active people are listed, each withTopsandPantsmeters. Enter picks an exact staff-number match, or else the first row. A badge scanned anywhere in the portal opens the counter with that person. - Check the person panel. It shows their group, ward, cost centre, cut and usual sizes, then how they get uniform:
FTE table,Starting kitorManager approval, and what the manager has signed. - Add garments. Scan into
Scan a garment, or type a name, useScan with the camera, or tap one of the usual chips. Typing 2 or more characters lists matching garments with a size strip; ones outside the person's group or cut are listed underOther garments. Tap a size again for one more. - Choose a source for each line in
This pickup:Shelf,Pre-loved(shown when the pool holds some) orOrder in. A line that could come from the shelf or the pool readsPick a sourceuntil you choose. - Read the line under the pickup. It says
After this she holds 4 of 6 sets, and names each reason the pickup needs an override. - Set
Sets off the signed formwhen the person has a manager's approval with sets left. It starts at the larger of the tops and the pants in the pickup, not counting pre-loved lines. - Print the
Collection slipif you need one, then pressRecord issue, or Ctrl+Enter (Cmd+Enter on a Mac).
Repeat last · <date> refills the pickup with every unreturned line from the person's most recent issue date, as shelf lines. Change person or Esc starts again; Esc does nothing while the pickup has lines in it.
An unknown barcode opens Unknown barcode for an Admin (Barcodes). An Issuer sees No garment has <code>.
What is written
| Record | Change | Undo |
|---|---|---|
| Issue, from the shelf | One row per line: today's date, condition New, today's catalogue cost |
Record a return |
| Issue, pre-loved | Condition Pre-loved, cost 0; the pool goes down |
Return it as Returned – Good |
| Replenishment draft | Shelf lines added to the supplier's draft order | Edit the draft on Orders |
Order, for Order in |
One order per supplier, status Ordered, for this person |
Received lines join the pickup call list |
| Manager's approval | Sets used go up, oldest approval first | A credited hand-in gives sets back |
An override is stamped only on the rows it applies to: override for the ceiling, offGroup for a garment outside the staff group, offStyle for the wrong cut. For Order in lines it is written into the order's note.
What the counter refuses
Record issue stays disabled while a line has no source, a line asks for more than the shelf or pool holds (Not enough on the shelf, Not enough pre-loved), the person is inactive, or a reason needs the override tick. The server refuses the same cases:
| Refusal | Why |
|---|---|
This staff member is inactive — reactivate them on their profile first |
The record is inactive |
Not enough on the shelf for <garment> <size> |
Shelf below the pickup |
Not enough pre-loved <garment> <size> in the pool |
Pool below the pickup |
<garment> is discontinued |
The garment is archived |
A. Hassan is holding 6 tops and 5 pairs. That would be 7 tops and 5 pairs, and the most anyone holds is 6 sets — 6 tops and 6 pairs. Hand a top in to make room, or a coordinator can record an override. |
Past the ceiling |
<garment> is for <groups> — <name> is in <group>. Tick the coordinator override to issue it anyway. |
Outside their staff group |
<garment> is the <cut> cut — <name> is set to <style>. Tick the coordinator override to issue it anyway. |
Not their cut |
A refusal ending refresh and try again means somebody changed the shelf, the pool, the approval or the person's holdings while you were serving. Refresh and record again.
The ceiling and the override
The ceiling is sets held at any time: 6 unless the facility has set its own figure under Settings › Issuing rules. Tops and pants are counted separately. Garments outside a set have a ceiling of the same number, counted in garments. Holdings include garments on order, waiting to collect, and in approved request bags. Pre-loved garments count. See The entitlement rule.
One tick, Record as an override, answers the ceiling, the staff group and the cut together. It clears when you change the person or anything in the pickup.
In plain terms A hand-in makes room; an override records that somebody chose to go past the rule.
On a phone
In the counter app, open the person and stay on Issue.
- Add the lines. Tap
+on a size card, orScan a garment. The meters fill as you add. - Answer each flag. A line past the ceiling, outside their group or outside their cut is flagged
Over 6 sets,Not for <group>orNot for <cut>. Pick one reason for each:Soiled on shift,Replacing damaged,Manager askedorOther. - Press
Review and sign. For a group whose raises need a manager, set how many sets come off the approval. - Have them sign, and leave
Send the slip to their staff appon if they have a staff app sign-in. - Press
Issue.
The server runs the same checks again and refuses a flagged line with no reason. Each flagged line's row stores its reason in overrideReason, beside override, offGroup and offStyle. The signature sets the signed tick on every row and files a slip; a slip sent to the staff app lists garments, sizes, the date and the signature only.