Clinic boards: live updates, duplicate and result guards, and CMID field names

[dadsena01]

Sits on top of #23, so the diff carries those commits too until that one merges.

This carries on from #23. It covers the three clinic boards, the dashboard, and a pass over field names against what CMID actually asked for in their scope document.

The screenshots below are from the running app, taken as the real CAD, doctor, nurse and programme manager users, so you can see the changes without setting up a camp yourself.

Boards update on their own

The CAD, doctor and nurse boards only changed when somebody pressed refresh, so staff worked off a stale queue for most of a camp. A camp change now reaches every open board and each one re-reads its own queues. The message carries the camp name and who made the change, nothing about the patient, because it goes to every logged-in user on the site.

The refresh waits half a second, is skipped for the person who made the change, and is held back while a dialog is open so nobody loses what they are typing. It never freezes the screen.

Things that were quietly wrong

Nothing stopped the same person being registered twice. Every duplicate burns a Clinic ID off the yearly series, prints a second card and splits that person's history in two, and none of it can be undone once the card is in their hand. There were already two such pairs in the data. Registration now checks ABHA, then mobile, then name and date of birth, and offers to queue the person it found. It warns rather than blocks, because brothers share one mobile and two people can have the same name and birth year.

Clearing a clinical note was silently ignored. The doctor endpoints only saved a note if it had text in it, so deleting a wrongly recorded allergy did nothing and the old allergy stayed on the record.

Nothing caught a repeated medicine, so the same drug could go on a prescription twice and be dispensed as a double dose.

A patient could go back to the doctor with no test result at all, marked reviewed and carrying no answer. Every ordered test now needs a result, and Not Done was added so a nurse who cannot run a test can say so.

The dispense list had every medicine ticked in advance, so tapping straight through recorded the whole prescription as handed over. That is the row the donor-fund and stock reporting will count.

Vitals had no upper limit, so an SpO2 of 150 or a pulse of 9999 saved fine.

Every Clinic ID issued so far said unknown location. The fallback was meant for a patient registered with no camp at all, but it had become the normal path, because only three of twenty-two locations had an LSG number. Registration now refuses a camp whose LSG has no number and names the record an admin has to fill.

The dashboard was broken for the people it was built for. A director or programme manager got a blocking permission error. A number card runs through the report engine, so read on the doctype is not enough. Both roles already had read, so nothing new is exposed. It had only ever been checked as Administrator, who skips every check.

Field names against the CMID scope

Mobile is now Mobile Number, Company Name is Name of Company, Occupation / Sector is Sector of Employment, Chief Complaint is Patient Complaints, and Clinical Notes is Observations and Notes on Examination. Labels only, no field name was renamed, because the Clinic IDs and every report point at the old names.

Patient had two fields both labelled Clinic ID. One holds all 33 issued IDs, the other was empty on every patient, so anything picking a column by label got the blank one half the time. The empty one is gone.

LSG, district and state on a visit all copy from a location link that nothing ever set, so three fields the scope asks the software to fill by itself were empty on all 33 visits. One line at registration fixes it, and a patch backfills 19 of 33. The other 14 sit on old demo camps that have no site at all.

Screenshots

CAD board after a search, showing the result count, the Clear button and the waiting time on each queue row:

The warning before a duplicate registration:

The registration form. The chosen answer in each row is one shade darker instead of a solid button, so the only filled button on the form is the one that submits it:

Doctor board with the allergy banner, the patient filter, and Call next patient as the one filled button:

The prescribe dialog. Medicines first with a row ready to type into, the allergy at the top, and the notes collapsed underneath:

Nurse board with the camp summary line, the ordered test or medicine on each row, and how long each patient has been in the camp:

The dispense dialog, now showing the dose the doctor wrote, with nothing ticked in advance:

Dashboard opened by a programme manager, with no permission error:

Testing

245 tests pass. New ones cover the duplicate check, the short search, the capped result list, blank and Not Done test results, impossible vitals, half a blood pressure, duplicate medicines, negative amounts, clearing a note, and a camp with no LSG number.

Every fixture camp now has a unit, since a camp without one can no longer issue a Clinic ID. Ten test modules were building camps that had none, and the suite passed anyway, which is a fair measure of how invisible that was.

Also checked by hand in the running app at 1280px and 420px as each of the real users.

Still open, needs CMID

The tick lists in the scope have no options listed anywhere, so Diagnosis category, Services provided and Other interventions are not built. Occupation is a separate field in their table and we only store the sector. Five of the eight reports do not exist yet, and the session and clinic reports are missing the age group, sex and native state breakdowns their own descriptions ask for. Pharmacist, Helpline Staff and Admin Officer roles do not exist, and neither does the helpline follow-up module.

The real LSG numbers are also still outstanding. The dev site is running on numbers we made up, and these end up printed on every patient card.

[dadsena01]

Replaced by #25 with a tidied history and description.