Milk Passbook (check milk slips, home milk diary)

About the Milk Passbook (check milk slips, home milk diary)

A passbook for a dairy farmer and a milk diary for a home, kept in your browser on your own device. Farmers: scan the QR code on each slip from a centre that uses the Milk Collection Register — with the phone’s camera, from a photo, or by opening the code’s link — or type the slip in. Add the centre’s price chart (a chart file from the Milk Rate Chart Maker, or a CSV or Excel grid) and every slip is checked: its rate against the rate the chart gives for its FAT and SNF (or CLR), and its amount against quantity × rate.

Each billing cycle — 10 days, 15 days, a week or a month — adds up your milk, your average FAT and SNF and the amount, lists the shifts with no slip, and compares the total with the centre’s bill. Households: set the usual morning and evening milk and the rate, mark the days with no milk, more milk or extras, and record payments: the home diary gives each month’s total, what was paid and what is owed. With a Pro pass, print or download a passbook page or a month’s statement, with headings in an Indian language beside the English if you like. In the free preview every slip is kept, the newest slips show their check against the chart, and the printed pages are marked “not for use” with the worked-out amounts hidden.

Common uses

• A dairy farmer who wants their own record of every pour and to know whether each slip was paid at the chart’s rate.
• A farmer checking the centre’s 10-day bill against the slips before collecting the payment.
• A family that buys milk from a milkman and wants each month’s total, the days skipped and what is still owed.
• Anyone who keeps a milk diary on paper and would rather have the sums done for them.

How a slip is checked

• The rate on the slip is compared with the rate the centre’s chart gives for the slip’s FAT and SNF — or CLR, turned into SNF with the chart’s own formula — using the chart in force on the slip’s date. The slip is marked when they differ, with the difference a litre (or kg) and on the pour.
• The amount is compared with quantity × rate when the quantity and the rate are in the same unit (litres and a rate a litre, or kg and a rate a kg).
• A slip read from a QR code carries a check code that catches a code read wrongly or changed by hand: such a slip is refused. It is a check, not a signature: it cannot prove which centre printed the slip. The figures stay as the slip gives them; you can add your own note.
• Without a chart the passbook still keeps and adds up your slips, and checks the amounts.

Cycles and the centre’s bill

• A cycle follows your centre’s payments: 1–10, 11–20 and 21 to the end of the month, 1–15 and 16 to the end, a week, or a month.
• For each cycle the passbook adds up the milk in litres (and kg, if some slips are in kg), the FAT and SNF averaged over the quantity, and the amount, and lists the shifts you usually pour in that have no slip — a slip you may have lost, or a pour missing from the centre’s records.
• Type the milk amount from the centre’s bill (before deductions such as cattle feed or advances) and the passbook shows whether it pays more or less than your slips add up to.

The home milk diary

• Every day from the diary’s first day counts your usual milk, morning and evening, unless you mark it: a day with no milk, a day with more or less, or extras such as curd or paneer, in rupees.
• Rates from a date: when the milkman’s rate changes, add the new rate from its first day; earlier days keep the old rate.
• A month’s statement shows a calendar of the month, the milk and its amount, the extras, the balance carried from before, the payments and what is owed — or paid ahead.

Your data stays on this device

• Slips, charts, bills and the diary are kept in this browser on this device (IndexedDB). Nothing is uploaded, and you don’t need an account. The camera picture is read on the device and never leaves it.
• A slip’s link carries the slip after the “#” of the address, a part the browser keeps to itself and does not send to the website (MDN).
• Set a passcode under Data & backup to keep the passbook encrypted (AES-256) and locked. Download an encrypted backup now and then, and restore it on a new phone to move the passbook there. Your slips, the diary’s marked days and its payments also download as CSV, also without a pass.

Limitations

• Only slips from centres that use the Milk Collection Register carry a QR code it can read; other slips are typed in.
• One device: the passbook does not sync between devices. To move to another device, restore a backup there.
• Screens are in English; printed pages can add headings in Hindi, Marathi, Gujarati, Punjabi, Telugu or Kannada.
• The check uses the chart you add: if the centre pays by a different or newer chart, add that one from the day it starts.
• The camera needs a browser that allows it on this page; a photo of the slip works everywhere.
• In the free preview the check against the chart shows on the newest slips (half of them, up to 10), and the differences, the diary’s amounts and the spreadsheets show after an unlock.

Privacy

Slips, charts, bills and the diary are kept in this browser on this device and never uploaded. Camera pictures are read on the device and not kept.