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.

Who may edit

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

Only SuperAdmin and GeneralAdmin see the + New, Edit and Delete buttons. Everyone else gets View only. GeneralUsers find the lists under a menu called Core Data.

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

Regions

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.

Districts

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.

Local Levels (Palikas)

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.

Units

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.

Ingredients

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.

Dose Rules

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, and the server checks them when you save:

• Max Age (Months) must be at least 1. A rule must cover at least one month of age.
• No. of Drops must be at least 1.
• Min Age cannot be more than Max Age, and neither can be negative.
• The band cannot overlap another rule. The save is refused with This age range overlaps an existing rule. Each age can belong to only one rule.

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 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 youngest and oldest years — this child is age old. If no rules exist at all, the message asks them to contact an administrator.
• The youngest rule’s Min Age is the programme’s starting age (12 months). A younger child can never be dosed, and there is no override.
• A child older than the oldest rule’s Max Age can still be dosed if the health worker ticks Dose this child anyway (above the programme age) and writes a reason. They receive the highest number of drops in the table. See Step 1: Screening.

Keep the bands continuous with no gaps, for example 12 to 23, 24 to 35, 36 to 60, and so on. A gap means children of that age are refused. Overlaps are refused when you save.

Exclusion Criteria

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 Criteria, fill Criterion Name (required) and Nepali Name, and click Save Criterion. Every criterion now has a Nepali name. The Prashan page shows the label in English, Nepali or both, following the health worker’s language toggle; a criterion with no Nepali name shows its English name instead. To change the wording in either language, click Edit on the row, change Criterion Name or Nepali Name, and click Update Criterion.

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.

Changing a criterion changes how old records read

Past sessions store which criterion was ticked by its identity, not its text. Renaming a criterion changes how old records display, so fix spelling and wording, but do not turn a criterion into a different reason. A criterion that has been ticked on any screening cannot be deleted; if it is no longer wanted, leave it in place and tell staff not to use it. Dose rules are not protected this way: deleting a rule that has been used is allowed, so change rules with care.