Skip to content

Reference data

This page covers the seven small lists under Reference Data in the Admin menu. They fill the dropdowns and tick-boxes used everywhere else. It is for SuperAdmin and GeneralAdmin users, who are the only ones who can change them.

List View Create, edit, delete
Regions, Districts, Local Levels Everyone signed in SuperAdmin, GeneralAdmin
Units, Ingredients Everyone signed in SuperAdmin, GeneralAdmin
Dose Rules, Exclusion Criteria Everyone signed in SuperAdmin, GeneralAdmin

A LocationAdmin sees the + New and Edit buttons on these screens, but the server refuses the save. GeneralUsers see the lists read-only under a menu called Core Data.

Each list works the same way: a searchable table with View, Edit and Delete on every row, a + New … button, and a page-size selector at the bottom. Deleting asks for confirmation. For places, units and ingredients the delete fails if the row is still used somewhere, for example a district that has camp sites or a unit used by an ingredient. Dose rules and exclusion criteria have no such guard (see the note at the end).

The Regions list Regions: Nepal’s provinces, with code, name, Nepali name and alternative name.

Admin → Regions. One row per province. Columns: Code, Name, Nepali Name, Alt Name.

To add one, click + New Region and fill Region Name and Code (Unique) (both required), plus Nepali Name, Alt Name and Remarks if wanted. If the save fails, the name or code already exists.

Regions are usually seeded at installation. You rarely add any.

The Districts list Districts, each belonging to one region.

Admin → Districts. A district belongs to one region. To add one, click + New District, pick the Region, fill District Name and Code (Unique), and optionally Nepali Name, Alt Name and Remarks.

Districts are used in the camp site form and in guardian addresses. Picking a region filters the district dropdown on those forms.

The Local Levels list Local Levels with their type and district.

Admin → Local Levels. The heading reads Local Levels (Palikas). Columns: Name, Type, District. Use Filter by District and Search (name or code) to find one.

To add one, click + New Local Level (Palika) and fill:

  • District (required).
  • Type (required): Metropolitan, Sub-Metropolitan, Municipality or Gaupalika. Municipality is a Nagarpalika; Gaupalika is a rural municipality.
  • Name (required), Nepali Name, Code (Unique).

Local levels appear as Palika on the camp site form and in addresses. Adding one makes it available to the public registration form straight away.

The Units list Units of measure used for quantities.

Admin → Units. The units used for a batch’s total quantity and for each ingredient line: ml, mg, KG, Drops and so on. Click + New Unit, type Unit Name and optional Remarks, and save.

Every ingredient also has a default unit, so create the unit before the ingredient.

The Ingredients list Ingredients that can go into a batch.

Admin → Ingredients. The substances a dose batch can contain, for example Swarna Bhasma, Vacha, Brahmi, honey, ghee. Click + New Ingredient, pick the Unit, fill Ingredient Name (required), and optionally Nepali Name and Remarks.

Ingredients appear in the Ingredients Used lines of a dose preparation. See Dose preparations.

The Dose Rules list Dose Rules: an age band in months and the number of drops for it.

Admin → Dose Rules. Each rule is an age band and a dose:

  • Min Age (Months) and Max Age (Months), both inclusive.
  • No. of Drops.
  • Remarks.

Click + New Dose Rule to add one. All three numbers are required.

How the rules are used on the Prashan page:

  • The dosing step shows a large Drops figure: the rule that matches the child’s age in months on the camp day. It also shows the whole table of rules for reference.
  • The server refuses to start a dose for a child whose age matches no rule. The health worker sees a message such as Prashan is allowed only for children between 0 and 16 years — this child is 16y 3m old. If no rules exist at all, the message asks them to contact an administrator.

Keep the bands continuous with no gaps and no overlaps, for example 0 to 11, 12 to 23, 24 to 59, and so on. A gap means children of that age are refused; an overlap means the first matching rule wins.

The Exclusion Criteria list Exclusion Criteria with English and Nepali labels.

Admin → Exclusion Criteria. Reasons a child must not be dosed today, such as fever, acute illness, or a recent medical procedure. Columns: Name, Nepali Name, Remarks.

Click + New Criterion, fill Criterion Name (required) and Nepali Name, and save. Fill the Nepali name: the Prashan page shows the label in English, Nepali or both depending on the health worker’s language toggle.

On the Prashan page each criterion is a tick-box under Medical History & Exclusion Criteria. Ticking one marks the child as excluded for the day and makes Exclusion Remarks mandatory. An Other option with a free-text reason is always present, so you do not need a catch-all criterion here. Excluded children are counted separately in the day’s reports.