@extends('layouts.app') @push('styles') @endpush @section('content')
M&E Office

Data Documentation

Reference page for M&E users: export documentation, data dictionary, and practical user guidance for routine reporting and data review.

Reception: Main Entrance Of The Clinic

Reception is the first point where clinic data becomes usable. The reception user checks whether the person already exists, registers new patients, records each visit, saves diagnosis and service data, and prepares appointment or follow-up lists for the next clinic action.

Patient Registration Visit Recording Diagnosis Data Next Appointment Export

Reception Workflow

Use this flow as the normal working order when a patient arrives at the clinic.

1. Identify Search General ID or Fuchia ID, or use the next available ID for a new patient.
2. Register Enter clinic, peer code, registration date, age, sex, address, and risk group.
3. Record Visit Save the visit date, current MD, online reach, migration, and service selections.
4. Add Diagnosis Use Diagnosis Data for visit diagnosis, next appointment, follow-up MD, and remarks.
5. Review Check follow-up history, next appointment list, patient lists, exports, or QR export.

Quick Start For Receptionists

For a new patient

Open Add New / Follow Up, use Next ID, complete registration fields, then save the registration and first visit.

For a returning patient

Search by General ID or Fuchia ID, confirm the displayed patient details, then save the follow-up visit.

For diagnosis entry

Open Diagnosis Data, search the patient, set visit date and next appointment, choose diagnosis/service data, then save.

For corrections

Use Search to Update or Follow Up History, open the target row, adjust the values, and press Update.

For patient appointment

Use Next Appointment List to find patients due on a selected date and review planned or unplanned visit status.

For data sharing

Use Export or QR Export only after checking patient identity, visit date, and required service fields.

Reception Overview

Add New / Follow Up Main working tab for registration and visit recording. Includes ID search, clinic code, peer code, current MD, demographics, risk group, and save buttons.
Diagnosis Data Records diagnosis and service details for a visit. Also manages next appointment date, next appointment time, follow-up MD, TB screening, migration, and remarks.
Follow Up History Shows previous visit records for one patient and lets the user open a specific row for update.
Next Appointment List Lists patients expected for a selected appointment date and visit type.
Consultation Records & Lab-STI-RDT's Data Displays related consultation and testing data so reception can confirm what has already been recorded.
New Patients Shows new patient records and supports checking recently registered clients.
Search By Name Helps find a patient when an ID is not immediately available.
Export / QR Export Produces reception data outputs for review, transfer, or reporting workflows.

Reception Data Dictionary

Field Where It Appears How Users Should Understand It
General ID / PID Add New / Follow Up, Diagnosis Data, Follow Up History Main patient ID used to search, register, save visits, and review history.
Fuchia ID ID search and diagnosis sections Alternative patient identifier. Useful when the General ID is not known.
Clinic Code Add New / Follow Up Clinic/site where the patient is registered or where the visit is recorded.
Peer Code Add New / Follow Up Peer or outreach code linked with the patient, when applicable.
Registration Date Patient registration fields Date the patient was first registered in reception data.
Visit Date Add New / Follow Up, Diagnosis Data, Update Date of the clinic contact. This is important for reports and follow-up history.
Current MD Add New / Follow Up and Diagnosis Data Current medical provider or MD initial connected with the visit.
Follow-up MD Diagnosis Data and Update Provider assigned for follow-up or next clinical action.
Main Risk / Sub Risk Patient registration fields Risk-category classification used for program reporting and data filtering.
Online Reach Add New / Follow Up Source/channel for online reach information, such as Prevent Yangon, SHE, Helping Hand, or other.
Next Appointment Date / Time Diagnosis Data and Update Planned return date and time. Use the days field when the system should calculate the appointment date.
Service Checkboxes Diagnosis Data and Update Service areas such as ART, PrEP, PMTCT, NCD, ANC, family planning, cervical cancer, feeding center, general, lab investigation, and related diagnosis fields.

Good Reception Practice

Do

  • Search existing patient IDs before creating a new record.
  • Check registration date, visit date, age, sex, clinic code, and risk group before saving.
  • Use Follow Up History before editing an old visit.
  • Set next appointment information before the patient leaves reception.

Be Careful

  • Do not reuse a new ID if the patient already exists under General ID or Fuchia ID.
  • Do not save a visit with the wrong clinic code or wrong visit date.
  • Do not leave required diagnosis/service fields blank when the visit was completed.
  • Do not export before checking duplicate and incomplete patient data.

Dispensing: Medicine Use And Stock Control

Dispensing connects the clinic visit to medicine use. The user searches the patient, records the medicine issued on the visit date, checks available stock, and maintains the medicine item list so consumption and stock reports stay reliable.

Patient Search by General ID or Fuchia ID and confirm the patient before recording medicine.
Medicine Select the medicine item, enter quantity, nurse name, clinic code, and visit date.
Stock Quantity is checked against stock so the medicine balance remains correct.

Dispensing Workflow

Use this working order when recording medicine for a clinic patient.

Search Patient Choose Medicine Enter Quantity Save Consumption
1. Daily Consumption Open the Daily Consumption tab and search by General ID or Fuchia ID.
2. Confirm Visit Set nurse name, visit date, clinic code, and confirm the patient summary.
3. Select Items Search medicine name, choose the required item, and enter the issued quantity.
4. Validate Stock Check that quantity is greater than zero and not more than available stock.
5. Save Or Update Save new consumption, or use To Edit and Search to Update for corrections.

Dispensing Overview

Daily Consumption Main dispensing entry area. It records patient ID, nurse name, visit date, clinic code, medicine item, and quantity issued.
Stock Searches medicine stock and shows remaining stock for the selected medicine item.
Medical Item Add Adds a new medicine item or edits an existing medicine item name in the dispensing item list.
To Edit Opens the correction area for a saved dispensing record. Search by patient ID and dispensing date before updating.

Dispensing Data Dictionary

Field Where It Appears How Users Should Understand It
General ID / Fuchia ID Daily Consumption and To Edit Patient identifier used to find the correct patient before saving or updating medicine consumption.
Nurse Name Daily Consumption Clinic staff name connected with the dispensing entry.
Visit Date Daily Consumption Date the patient received the medicine. This date drives consumption reporting.
Clinic Code Daily Consumption Clinic/site where the medicine was issued.
Medicine Name Daily Consumption, Stock, Medical Item Add Medicine item selected for issue, stock checking, or item-list maintenance.
Quantity Daily Consumption and Stock update controls Number of units issued or added. Quantity must be checked against available stock.
Stock Stock and medicine selection area Current remaining balance for the selected medicine item.
Expiry Date / Arrival Date Stock add controls Dates used when adding stock information for a medicine item.

Good Dispensing Practice

Do

  • Confirm the patient before choosing medicine items.
  • Check visit date, clinic code, nurse name, medicine name, and quantity before saving.
  • Use Stock to confirm available balance when quantity looks unusual.
  • Use To Edit only for real corrections and confirm the dispensing date first.

Be Careful

  • Do not save medicine for the wrong patient ID.
  • Do not enter quantity greater than available stock.
  • Do not add duplicate medicine names in Medical Item Add.
  • Do not update old records without checking the original visit date and medicine item.

Laboratory: Clinic Lab And Office Lab Data Entry

Lab documentation has two related entry points. Clinic Lab records the routine clinic test results for a patient visit. Office Lab records biochemistry and HIV confirmation testing, usually with clinic selection, specimen date, result entry, print, history, and export actions.

Clinic Lab

Use Clinic Lab when the clinic team records service-level laboratory results for a patient visit. Start with visit date and patient ID, confirm patient details, then enter the test result in the correct test tab.

HIV Test RPR Test STI Test Hepatitis B/C Urine OI Test General Test Stool AFB Covid-19 Viral Load

Office Lab

Use Office Lab for office-based Biochemistry and HIV Confirmation records. It includes clinic target, specimen collected date, General/NAP-ID, Fuchia ID, patient profile fields, requested doctor, counsellor, print, history, and export.

Biochemistry Test HIV Confirmation Test Update & Delete Test Records Export PrintAll
Set Date
Search Patient
Choose Test
Enter Result
Save / Update
Print / Export

Lab Workflow

The safest workflow is to identify the patient first, select the correct lab page, then enter only the test result for the selected test tab.

1. Choose Lab Page Use Clinic Lab for routine clinic tests. Use Office Lab for biochemistry or HIV confirmation tests.
2. Confirm Patient Enter patient ID, General/NAP-ID, or Fuchia ID and confirm the profile before result entry.
3. Set Date Use Visit Date for Clinic Lab and Specimen Collected Date for Office Lab.
4. Enter Result Open the correct test tab, enter result values, requested doctor, counsellor, and related fields.
5. Review Output Use PrintAll, Test Records, Update & Delete, or Export after checking the saved result.

Lab Overview

Clinic Lab: Test Tabs HIV, RPR, STI, Hepatitis B/C, Urine, OI, General, Stool, AFB, Covid-19, and Viral Load each have their own entry area and save/update action.
Clinic Lab: Patient Sidebar Contains visit date, patient ID search, requested doctor, counsellor, main risk, sub risk, and patient profile summary.
Clinic Lab: Update & Delete Searches the patient test history and lets the user open a saved test record for correction or deletion.
Clinic Lab: Test Records / Export Filters test records by test type and date, then supports exporting selected lab datasets.
Office Lab: Biochemistry Test Records office biochemistry values such as bilirubin, liver enzymes, renal tests, CD4, and related reference-value checks.
Office Lab: HIV Confirmation Test Records Determine, UNI-Gold, STAT-PAK, and final HIV confirmation result fields.
Office Lab: Print PrintAll produces the laboratory result form for the selected patient and date.
Office Lab: Test Records / Export Reviews saved office lab records and exports Bio Test or HIV Test data for reporting.

Lab Data Dictionary

Field Where It Appears How Users Should Understand It
Visit Date Clinic Lab Date the clinic test is connected to the patient visit.
Specimen Collected Date Office Lab Date the office lab specimen was collected. Use this for office lab result tracking.
Patient ID / General ID / NAP-ID Clinic Lab and Office Lab Main identifier used to search the patient and connect results to the correct record.
Fuchia ID Office Lab and print output Secondary identifier used for patient matching and printed laboratory result forms.
Requested Doctor Clinic Lab and Office Lab Doctor or MD initial requesting the test.
Counsellor Clinic Lab and Office Lab Counsellor connected with the test workflow, when applicable.
Test Type Test Records and Export Selected lab category used to search, review, or export records.
Result Fields Each test tab Specific result values, such as HIV rapid test results, RPR result, urine findings, AFB result, or biochemistry numeric results.
Reference Value Office Lab Biochemistry Normal-range guide displayed beside biochemistry results. Review it before finalizing values.
Print Type Clinic Lab print area Chooses Clinic or Office print format before printing all available lab results.

Good Lab Practice

Do

  • Search and confirm the patient before entering any lab result.
  • Use the correct date field for the page: Visit Date for Clinic Lab, Specimen Collected Date for Office Lab.
  • Choose the exact test tab before saving results.
  • Use Test Records to confirm saved data before printing or exporting.

Be Careful

  • Do not save Office Lab results under the wrong clinic target.
  • Do not mix Clinic Lab routine test entries with Office Lab biochemistry or confirmation entries.
  • Do not print before checking patient ID, date, and final result fields.
  • Do not update/delete a lab record without confirming the test type and original date.

STI Program: Male And Female Data Entry

STI Entry records male and female STI visit data in one page. The user searches General ID and Visit Date, confirms the patient's sex and risk profile, completes the gender-specific symptom and examination sections, records diagnosis and treatment, then reviews history or exports male/female datasets.

Search Patient
Set Visit Date
Male / Female Form
Symptoms & Exam
Diagnosis & Treatment
Export

STI Workflow

Use the STI page as one connected workflow. The page changes visible sections based on the patient's recorded sex, and the save/update script sends the mapped male or female fields to the controller.

1. Register Enter General ID and Visit Date, choose clinic, then search and confirm patient details.
2. History Record first/last visit, heard-about-clinic, reason for visit, and risk category.
3. Symptoms Complete the male or female symptom checklist and duration fields.
4. Exam Record physical examination, genital findings, drawing description, and risk-score sections.
5. Treatment Save presumptive diagnosis, treatment, allergies, counselling, follow-up, and clinician.

STI Overview

Register Main STI entry tab. Includes General ID, Visit Date, clinic, patient detail, first/last visit, heard-about-clinic, reason for visit, risk update, and gender-specific form sections.
Lab Results & Treatment Records diagnosis, linked lab/risk information, medicine treatment, allergies, counselling fields, treatment remarks, follow-up, and clinician.
Follow Up History Shows previous STI visits for the selected patient and supports review before saving another record.
RPR Test History Shows RPR testing history linked to the patient so users can check previous syphilis-related results.
Search and Update Loads an existing male or female STI record by patient/date so users can update the correct row.
Export Exports STI Male or STI Female datasets. Current exports contain more fields than the old reference workbook because the form and JavaScript maps have been updated.

STI Data Dictionary

STI Male

Field Where It Appears How Users Should Understand It
Clinic Code, General ID, Fuchia ID, Sex, Reg Year, Register Age, Current Age, Visit date Patient identity and visit Identifies the male STI record and links it to patient registration. Age and Fuchia ID are joined from patient configuration for export.
Data format: General ID: number, length 10/11/12. Sex: Male/Female. Reg Year: YYYY. Age: number; month: 1-11. Visit date: DD-MM-YYYY in export.
First Visit, last_vis_within, about_clinic, Reason for Visit, Main Risk, Sub Risk Visit history and source Explains whether this is a first or follow-up STI contact, how the client reached the clinic, why the visit occurred, and which risk group applies.
Data format: First Visit: 1=Yes, 2=No, 9=Missing. Last Visit: 1=Within 3 months, 2=>3 months ago, 9=Missing. About clinic: 1=From HE Team, 2=From Partner, 3=From Others, 4=Missing. Reason: 1=Symptomatic, 2=Screening/non-symptomatic, 3=Partner STI, 9=Missing. Risk: Code Book/list value.
urethral_disc, dysuria, genital_prut, genital_pain, genital_ulcer, pain, ulcer, prodromal_itch, vesicles, recurrent, last_episode, suspects_herpes, ing_lymph_node, unilateal, other_lymph_node, leg_ulcer, scrotal_swelling, td_ntd, gen_wart Male symptoms Patient-reported male symptoms and related duration/detail fields. These guide exam focus and presumptive diagnosis.
Data format: Most symptom flags: 1=Yes, 2=No, 9=Missing. Duration/how-long fields: number of days or text. Pain: 1=Painful, 2=Painless, 9=Missing. Ulcer: 1=Single, 2=Multiple, 9=Missing. Unilateral/bilateral and tender/non-tender are selected coded values.
physical_exam, physical_exam_no_reason, urinated_wit_1h, discharge, discharge_milk, colour, erythema, blisters, gen_ulcer, esti_size, sing_multi, pain_full_less, herpes_suspect, inguinal_bubo, fluctant, tendr_ntender, oth_leg_inf, phy_genital_wart, crab_lice, scabies, gscrotal_swelling, estimated_siz, unilateal_bilateral, gtender_ntender, erythem, des_size, drawing_description Male physical examination Clinician-observed findings. These fields document objective signs and support diagnosis, treatment, and drawing-based lesion description.
Data format: Exam done and findings: 1=Yes, 2=No, 9=Missing where coded. Colour: 1=Clear, 2=White, 3=Yellow, 4=Bloody, 5=Other, 9=Missing. Size/description/reason fields: free text or numeric size. Drawing description: free text.
tbl_treat_diagnosis_first_visit, epi_discharge, unprot_sex_new_part, genital_signs, previous_sti, previous_what, previous_when, prior_sti, prior_what, prior_when, prior_other_comment, presumptive_diag Male diagnosis triggers and prior STI Captures previous STI history and current diagnosis logic. New previous/prior fields are current app variables and are not fully represented in the old workbook.
Data format: Trigger questions: 1=Yes, 2=No, 9=Missing. Previous/prior STI: Yes/No plus what/when text or date detail. Presumptive diagnosis: free text/list selected from diagnosis workflow.
pri_syphillis, sec_syphillis, chancroid, gen_herpes, gen_scabies, gud_other, Gonorhoea, non_gono_urethritis, non_gono_procti, trichomonas, genital_candidiosis, congenial_syphillis, latent_syphillis, molluscum_contag, bubos, othstd_genital_warts, ostd_other Male STI diagnoses Diagnosis checklist used to count STI syndromes and diagnosed conditions in exports and reports.
Data format: Diagnosis flags: 1=Yes/selected, 2=No, 9=Missing where coded. Other diagnosis fields: free text when selected.
tre_azythro, acyclovir, clotrimazole, tre_podophyllin, tre_cefixim, tre_ciprofloxacin, tre_tinidazole, tre_fluconazole, tre_doxycycline, tre_ceftriaxone, tre_benz_pen, no_treat, al_Penicillin, al_sulfa, part_treat, condom_giv, counsel_disclosure, treatment_side_effect, tre_remarks, followup, clinician_name Male treatment and counselling Records medicines provided, contraindications/allergies, partner and condom counselling, side effects, remarks, follow-up plan, and clinician accountability.
Data format: Treatment medicines and counselling fields: checkbox/service flags saved as 1 when selected, 0/2 when not selected depending on control, 9 where missing applies. Allergy/partner treatment/condom: Yes/No-style flags. Remarks/follow-up: text. Clinician: staff name/text.
demo_remarks, visit_type, visit_time, followup_visit, episode, other(please specify), beterial_vaginosis Male legacy/export-only fields Kept for backward compatibility with older STI male data. Review carefully before using for new reporting logic.
Data format: Old data fields: mixed text or coded values. Some may be blank in the current UI.

STI Female

Field Where It Appears How Users Should Understand It
Clinic Code, General ID, Fuchia ID, Sex, Reg Year, Register Age, Current Age, Visit date Patient identity and visit Identifies the female STI record and connects it to patient registration data used in export.
Data format: General ID: number, length 10/11/12. Sex: Male/Female. Reg Year: YYYY. Age: number; month: 1-11. Visit date: DD-MM-YYYY in export.
first visit, last_vis_within, about_clinic, Reason for Visit, Main Risk, Sub Risk Visit history and source Describes the STI visit type, referral/source context, reason for visit, and risk classification.
Data format: First Visit: 1=Yes, 2=No, 9=Missing. Last Visit: 1=Within 3 months, 2=>3 months ago, 9=Missing. About clinic: 1=From HE Team, 2=From Partner, 3=From Others, 4=Missing. Reason: 1=Symptomatic, 2=Screening/non-symptomatic, 3=Partner STI, 9=Missing. Risk: Code Book/list value.
abn_vaginal_disc, abn_vaginal_disc_long, linked_menstru, amount, colour, colour_oth, abn_veginal_odour, l_abn_pain, l_abon_pain_hl, fever, rec_terminate_preg, dyspareunia, oth_GI_sympt, dysuria, dysuria_hl Female discharge and pain symptoms Patient-reported vaginal discharge, lower abdominal pain, fever, dysuria, and related symptoms used for STI syndrome assessment.
Data format: Most symptom flags: 1=Yes, 2=No, 9=Missing. Amount: 1=Abundant, 2/0=Normal where legacy data exists. Colour: 1=Clear, 2=White, 3=Yellow, 4=Bloody, 5=Other, 9=Missing. How-long fields: number of days/text.
gen_prutitus, gen_burn_pain, gen_ulcer, pain, ulcer, prodromal_itch, vesicles, recurrent, recurrent_last_episode, patient_suspects_herpes, inguinal_ln, unilateal_Bilateral, leg_ulcer_oth_inf, genital_warts Female genital symptoms Genital ulcer, itching, burning, herpes suspicion, lymph-node, and wart symptom set for female STI assessment.
Data format: Yes/No/Missing coded fields. Pain: 1=Painful, 2=Painless, 9=Missing. Ulcer: 1=Single, 2=Multiple, 9=Missing. Laterality/tenderness: selected coded list values. Duration fields: number of days/text.
phy_exam_done, physical_exam_no_reason, washed_inside, vulvar_erythema, vulvar_odema, vaginal_discharge, vag_dis_amount, homogeneous, homogeneous_col, smell_without_KOH, vaginal_wall_injury, endocervical_mucopus, endocervical_colour, cerv_motion_tenderness, adnexal_tenderness, adnexal_enlargement, genital_blisters, genital_blisters_Location, gential_ulcer, gential_ulcerl, gent_ulcer_sm, gential_ulcer_pain, susp_herpes, inguinal_bubo, fluctuant, fluctuant_tender, oth_leg_infection, genital_wart, crab_lice, scablices, KOH_smell_test, pH_vagina, des_size, drawing_description Female physical examination Clinician-observed female exam findings, including updated endocervical and cervical motion tenderness variables from the current form.
Data format: Exam/findings: Yes/No/Missing coded values where applicable. Colour/location/amount/tenderness: selected list values. pH: numeric/text. Location/size/drawing description: free text.
prev_STI, patient_genital_ulcer, patient_compl_low_abd, new_pat_past_3mont, part_compl_gential_sym, sworker, rg_score, risk, abn_yellow_disc, low_abd_pain, if_only_abnormal_abundant, unp_sex_new_clients, dysuria_risk_ass, partner_ulcer, high_rg_score, high_risk Female risk assessment Dynamic female risk-score section. The current JavaScript calculates risk values, so this group must be interpreted from the live form, not only the old Excel source.
Data format: Risk questions: 1=Yes, 2=No, 9=Missing. Risk score: numeric. Risk/high_risk: Low Risk or High Risk. JS assigns points and calculates Low/High Risk from current answers.
pri_syphillis, Gonorhoea, congenial_syphillis, sec_syphillis, non_gono_urethritis, latent_syphillis, chancroid, non_gono_cervities, latent_syphillis_preg, gen_herpes, trichomonas, molluscum_contag, gen_scabies, genital_candidiosis, bubos, ostd_other, beterial_vaginosis, othstd_genital_warts, other_STD Female STI diagnoses Female diagnosis checklist used for STI condition reporting. Female export includes cervicitis, bacterial vaginosis, latent syphilis in pregnancy, and other female-specific diagnoses.
Data format: Diagnosis flags: 1=Yes/selected, 2=No, 9=Missing where coded. Other diagnosis fields: free text when selected.
tre_azythro, acyclovir, tre_cefixim, tre_ciprofloxacin, tre_tinidazole, tre_fluconazole, tre_doxycycline, tre_ceftriaxone, tre_benz_pen, clotrimazole_vaginal_tab, clotrimazole, tre_podophyllin, no_treatment, al_Penicillin, al_sulfa, part_treat, condom_giv, counsel_disclosure, counsellor_sti_sign_symptom, counsel_vaginal, treatment_side_effect, tre_remarks, followup, clinician Female treatment and counselling Records medicines, allergies, partner treatment, condom provision, disclosure/sign-symptom/vaginal hygiene counselling, side effects, remarks, and follow-up plan.
Data format: Treatment medicines and counselling fields: checkbox/service flags saved as 1 when selected, 0/2 when not selected depending on control, 9 where missing applies. Allergy/partner treatment/condom: Yes/No-style flags. Remarks/follow-up: text. Clinician: staff name/text.
visit_type, demo_remarks, episode, risk_cal_remark, pain_dur_sexual, gud_other, other_plz_specify, tre_Other Female legacy/export-only fields Kept for compatibility with old female STI data and older reporting outputs.
Data format: Old data fields: mixed text or coded values. Some may be blank in the current UI.

Good STI Practice

Do

  • Search the patient and confirm sex before completing gender-specific STI fields.
  • Use the current form values and JS-driven risk results when reviewing data, especially for female risk scoring.
  • Check visit date, risk group, diagnosis, treatment, allergy, counselling, follow-up, and clinician before saving.
  • Review Follow Up History and RPR Test History before updating old STI data.

Be Careful

  • Do not rely only on the old Excel dictionary for current STI fields because the page has added variables.
  • Do not save male data in female sections or female data in male sections after patient search.
  • Do not leave diagnosis or treatment fields inconsistent with symptoms, exam, and lab history.
  • Do not export without checking legacy fields that may be blank in the current UI.

Cervical Cancer Screening: Test, Triage, Treat

Cervical Cancer Screening records one connected visit workflow: patient search, reproductive readiness checks, HPV and breast screening, VIA screening and result confirmation, thermal ablation eligibility or treatment, referral, biopsy, gynaecologist management, and next appointment.

Search Patient
Set Visit Date
HPV / UCG
Breast / VIA
Thermal Ablation
Referral / Follow-up

Cervical Cancer Workflow

Use this order when completing the screening page. Conditional fields appear only when the related answer needs more detail.

1. Identify Search General ID or Fuchia ID, confirm patient name, age, sex, and visit date.
2. Screen Record HIV status, parity, UCG, HPV done/not done, HPV result, and breast screening.
3. VIA Enter VIA done date and screening history, or choose postponed/not-done reasons.
4. Treat Record SCJ, VIA result confirmation, thermal ablation need, eligibility, treatment, and reasons if not treated.
5. Refer Complete referral, biopsy, gynaecologist management, next appointment, MD, and CSL fields.

Cervical Cancer Overview

Cervical Cancer Screening Main data-entry tab. It includes patient search, patient summary, visit date, HIV/UCG/HPV, breast screening, VIA screening, cervical map, thermal ablation, referral, gynaecologist management, and follow-up fields.
History Loads previous cervical cancer screening records for the selected patient. Use Detail before updating a saved record.
Go to STI Form Moves from the cervical screening workflow to the STI form for the same patient context when STI entry is also required.
Export Data Exports Cervical Cancer Screening data by date range. The documentation CSV follows the current page export with 70 variables.

Cervical Cancer Data Dictionary

Field Where It Appears How Users Should Understand It
Clinic Code, General ID, Fuchia ID, Main Risk, Sub Risk, Reg Year, Register Age, Current Age, Visit Date Patient identity and visit Identifies the patient, clinic, risk profile, age context, and exact screening visit used for export.
Data format: Clinic/risk list values, General ID number, Fuchia ID text, year YYYY, age number, date DD-MM-YYYY.
HIV Status, Parity, UCG test date/result, HPV test, HPV not done reason, HPV test result HIV, UCG, and HPV Captures clinical readiness and HPV screening outcome before VIA/treatment decisions.
Data format: HIV: Reactive, Non Reactive, Unknown, Inconclusive. UCG: Positive/Negative. HPV: Done/Not Done; result Negative, High risk type (16/18), Other genotype, Invalid. Dates DD-MM-YYYY.
Cancer History, Family's Cancer History, Breast examination, Breast abnormal Yes/No, Breast abnormal finding Breast screening Records personal/family cancer history and breast screening findings during the same visit.
Data format: Yes/No, Done/Not Done, and free text abnormal findings when enabled.
VIA screening, VIA Done Date, VIA if done, follow-up year, Very ill, Pregnancy, Less than 12 weeks after delivery, genital infection, cervical surgery history, abnormal growth, bleed on touch, Others, Other specify VIA screening and postponed reasons Explains whether VIA was completed and why screening was postponed when it could not be done.
Data format: VIA Done/Not Done. VIA history select list. Dates DD-MM-YYYY. Postponed reasons are checkbox flags, usually 1=selected and 0/blank=not selected.
SCJ, VIA test result, counselling/screening by, VIA(+) confirmation by, VIA confirmation result Cervical map and VIA result Documents visibility of SCJ, VIA result, confirmation, and responsible staff.
Data format: SCJ: Was clearly seen or Not all seen. VIA results: Negative/Positive. Staff fields are free text.
Thermal Ablation, Thermal Ablation Date, Eligible, not-eligible reasons, treatment done at MAM, result, counselling by, performed by, done date, not-treatment reasons, postpone date Thermal ablation Tracks treatment need, eligibility, treatment completion, reason for no treatment, and provider accountability.
Data format: Needed/Not needed, Yes/No, dates DD-MM-YYYY, checkbox reason flags, and free text result/staff/other reason fields.
Financial support, Refer to gynaecologist, Reason for referral, Other specify, Biopsy done/result, Gynaecologist management, Next appointment date, MD name, CSL name Referral, biopsy, and follow-up Records referral pathway, biopsy outcome, gynaecologist action, planned follow-up, and responsible clinical staff.
Data format: Yes/No, selected referral/management list values, free text other/staff fields, and DD-MM-YYYY next appointment date.

Good Cervical Cancer Screening Practice

Do

  • Search and confirm the patient before entering screening results.
  • Complete HPV, VIA, thermal ablation, referral, and follow-up fields in the clinical order of the page.
  • Fill the related reason or specify field when a test, treatment, or referral option is not completed.
  • Review History before updating a previous cervical screening record.

Be Careful

  • Do not leave VIA Done Date blank when VIA Screening is Done.
  • Do not save thermal ablation reason fields unless the eligibility or treatment answer needs them.
  • Do not use the older Excel sheet alone for HPV and thermal ablation interpretation because the current page has newer values.
  • Do not export before checking duplicate visits and missing next appointment details.

HBV Register: Mother, Treatment, Delivery, And Baby Follow-up

HBV Register records pregnant client HBV care from registration through risk assessment, HBV/HCV/HIV background, pregnancy history, laboratory investigation, treatment summary, delivery details, baby vaccination, and the baby's 9-month HBsAg result.

Search ID
Risk & Background
Pregnancy History
Investigations
Treatment
Baby Follow-up

HBV Register Workflow

Use the HBV page as a longitudinal register. Search first, review existing records, then create or update the correct registration record.

1. Search Enter General ID and Date of Registration, then search the patient and review existing HBV registration rows.
2. Register Record marital status, partner HIV/HBV/HCV status, HBV risk factors, and HBV/HCV/HIV background.
3. Pregnancy Complete gravida, parity, LMP, EDD, USG, child history, and gestational age at registration.
4. Monitor Enter baseline and post-delivery ALT, creatinine, CrCl, APRI, HBV VL, and HBeAg values.
5. Close Loop Record treatment, delivery, HBIG/vaccination doses, and baby's 9-month HBsAg status.

HBV Register Overview

Register Main data-entry tab. Includes search, HBV Registration Manage, patient demographics, risk assessment, background infection information, pregnancy history, investigations, treatment summary, delivery, baby vaccination, and 9-month baby HBsAg result.
HBV Registration Manage Shows saved HBV registration history for the searched General ID. Use New for a new registration date, Update for the selected row, and Delete only after confirming the selected record.
Conditional fields If PWID is Yes, the Active/Ex field opens. If PWID is Ex, OST opens. If complete treatment is No, the treatment reason opens. HBIG and vaccination dates open only when the related answer is Yes.
Export Exports HBV Register data by registration date range. The dictionary CSV follows the current M&E HBV export with 73 variables.

HBV Register Data Dictionary

Field Where It Appears How Users Should Understand It
General ID, Date of Registration, Current Age(y), Current Age(m) Patient identity and registration Identifies the HBV register row and patient age context for program review and follow-up.
Data format: General ID number; registration date DD-MM-YYYY; current age numeric years/months joined during M&E export.
Marital status, Partner HIV status, Partner HBV status, Partner HCV status Patient demographics Documents relationship and partner infection context for counselling, testing, and household follow-up.
Data format: Marital status list; partner status values Positive, Negative, or Unknown.
PWID, If PWID Yes, If Ex OST, PWUD, FSW, Partners of 3-KAP, Blood transfusion, General population, Other Hepatitis B risk assessment Captures HBV exposure risks and priority-population context used for program monitoring.
Data format: Yes/No select values, Active/Ex for PWID status, and free text for Other.
HBs Ag pos date, HCV Ab date/result, HIV test date/result HBV, HCV, HIV background information Records infection background and testing history at registration.
Data format: Dates DD-MM-YYYY. HCV/HIV result values Positive, Negative, or Unknown.
Gravida, Parity, LMP, LMP Date, EDD, USG Scan, USG date, EDD by scan, children alive, children with HBsAg Pos, gestational age Pregnancy and childbirth history Defines pregnancy timing and child history needed for maternal HBV and baby follow-up planning.
Data format: Numeric pregnancy/child counts, Known/Unknown and Yes/No select values, date fields DD-MM-YYYY, and text/numeric gestational age.
Baseline date, AST, Platelet, APRI, ALT, Creatinine, Cr CL, HBV VL, HBeAg, 3/6/9-month post-delivery ALT/Creatinine/Cr CL Investigations and post-delivery monitoring Supports treatment eligibility, safety monitoring, and post-delivery liver/renal follow-up.
Data format: Laboratory numeric values with decimals where allowed, date DD-MM-YYYY, HBeAg Positive/Negative/Unknown, HBV VL exported as value x 10 exponent.
Eligible for treatment, planned date, no reason, regimen/dose, treatment start/stop date, complete treatment, incomplete reason Treatment eligibility and summary Documents treatment decision, treatment timeline, completion, and reason when treatment was not completed.
Data format: Yes/No select values, dates DD-MM-YYYY, and free text regimen or reasons.
Delivery date/time, place of delivery, type of delivery, outcome of delivery baby Child delivery information Links maternal HBV care with delivery outcome and baby prevention follow-up.
Data format: Date DD-MM-YYYY, time HH:MM, free text place, type NSVD/OVD/LSCS, outcome Alive/Dead.
HBIG, HBIG date/time, HBV active vaccination at birth/8 weeks/16 weeks/24 weeks, vaccination dates, baby HBsAg date/result Baby vaccination and 9-month status Tracks prevention-of-transmission services and confirms baby HBV status at 9 months after delivery.
Data format: Yes/No select values, dates DD-MM-YYYY, time HH:MM, baby result Positive/Negative.

Good HBV Register Practice

Do

  • Search General ID first and review HBV Registration Manage before creating another row.
  • Use the correct registration date because export filtering is based on Date of Registration.
  • Complete date fields in DD-MM-YYYY format and check pregnancy, treatment, delivery, and baby follow-up dates carefully.
  • Fill reason fields when treatment is not eligible or treatment was not completed.

Be Careful

  • Do not create duplicate HBV registration rows for the same General ID and registration date.
  • Do not enter HBIG or vaccination dates unless the related Yes/No field is Yes.
  • Do not confuse HCV Result, HIV Result, and baby 9-month HBsAg Result because the export uses repeated column names.
  • Do not export before checking missing baby vaccination and 9-month HBsAg follow-up fields.

Mental Health Program: Screening, Register, And Follow-up

Mental Health Program documentation covers the screening workflow, baseline register, follow-up form, follow-up history, and export. Users first search and confirm the patient, complete baseline assessment and substance-use screening, record intervention and outcomes, then use follow-up to monitor symptoms, adherence, treatment changes, referral, and next appointments.

Search Patient
Screening
Register
Treatment Plan
Follow-up
Export

Mental Health Workflow

Use Mental Health Program as three connected records. Mental Health Screening is entered from the Counsellor page; Mental Health Register and Follow-up are entered from the separate MentalHealth page.

1. Identify In Counsellor, set the visit date, search General ID, and confirm the patient before opening Mental Health Screening.
2. Screen Record referral and basic assessment, Q1-Q4, Q5-Q7, GAD7, PASS, PHQ9, drug use, ASSIST, chemsex assessment, and BI.
3. Register On the MentalHealth page, create the baseline register with clinical risk, treatment, diagnosis, outcomes, staff initials, and next follow-up.
4. Follow-up Use To Follow Up for visit date, improvement, adherence problem, rescreening, drug-risk review, side effects, treatment changes, and referral.
5. Review Use Follow Up History before updating data, then export Register or Follow Up data for M&E review.

Mental Health Screening Recording

This screening record is inside the Counsellor page under Mental Health, Drug Use, Chem Sex Screening. It is a separate dataset from Mental Health Register and Follow-up.

Patient and visit Choose the counselling visit date, search the patient, and confirm the patient identity before entering screening data.
Initial assessment Record Referred by CF, Basic Assessment done by CF, Basic Mental Health Assessment by Counsellor, Q1 to 4, and Q5 to 7.
Screening tools For GAD7, PASS, and PHQ9, record whether the tool was completed, whether it is New or Follow up, and the score. Valid score ranges are GAD7 0-21, PASS 0-93, and PHQ9 0-27.
Drug use and ASSIST Record drug use within six months, then enter up to five drug names with their ASSIST scores. Each ASSIST score accepts 0-39.
Chemsex and BI Record sexual activity under drug effects, problematic chemsex in the last month, criteria A-E, whether BI was done, the reason when BI was not done, and remarks.
Save and review Use Save MentalHealth for a new screening record. Open the patient's counselling history before updating an existing record.

Mental Health Register And Follow-up Recording

Register and Follow-up records are entered on the separate MentalHealth page. Create the baseline Register once, then add a Follow-up record for each later review. Review existing history before saving or updating either record.

Register Recording Flow

1. Search Set the registration date, search General ID, and check whether a Mental Health Register already exists.
2. Confirm Confirm Fuchia ID, PrEP ID, age, sex, HIV status, main risk, PWID status, and OST context.
3. Assess Record screening scores, psychosis symptoms and duration, suicidal risk, drug use, sexualized drug use, injectable use, and ASSIST risk.
4. Plan Care Record BI goal and stage, psychosocial or pharmacological care, medicines, and psychiatrist referral.
5. Complete Record diagnosis, outcomes, MD and CSL initials, and next follow-up date; then save the Register.

Follow-up Recording Flow

1. Open Patient Search the registered patient, choose To Follow Up, and confirm the follow-up visit date and identity.
2. Review History Open Follow Up History and review previous symptoms, scores, intervention, medicines, and planned appointment.
3. Reassess Record symptom improvement, adherence problems, mental health rescreening, GAD7, PHQ9, PASS, drug use, and ASSIST results.
4. Review Care Record suicidal risk, MD consultation, side effects, treatment changes, BI changes, psychosocial care, and referral.
5. Close Visit Record current diagnosis, responsible staff initials, next MD and CSL follow-up dates, then save the Follow-up record.

Mental Health Overview

Counsellor: Mental Health Screening Visit-based screening record for initial assessment, GAD7, PASS, PHQ9, drug use, ASSIST, chemsex indicators, and brief intervention.
MentalHealth Separate program page for registration and follow-up. It changes between Register, To Follow Up, To Register, and Follow Up History controls.
Register Baseline record: patient identification, risk background, assessments, psychosis, suicidal risk, drug and sexualized drug screening, ASSIST drug risk, BI, treatment, diagnosis, outcomes, and next follow-up.
Follow-up Follow-up visit record: symptoms, adherence, mental rescreening, GAD7/PHQ9/PASS, problematic sexualized drug use, ASSIST rescreening, side effects, treatment changes, referral, diagnosis, and next dates.
Exports Counsellor exports Mental Health Screening by counselling visit date. The MentalHealth page separately exports Register or Follow-up data by date range.

Mental Health Screening Data Dictionary

The screening dictionary contains 48 variables and follows the current Mental Health export available from the Counsellor page.

Field Group HTML Label / Export Column How Users Should Understand It
Patient and visit identity Clinic Code, Visit Date, Pid, FuchiaID, Gender, registration and current age, Main Risk, Sub Risk, HIV status Connects the screening encounter to the correct patient, date, demographic profile, HIV status, and risk classification.
Initial assessment Referred by CF, Basic assessment, Basic MH assessment Shows the referral pathway and whether initial community-facilitator and counsellor assessments were completed.
Mental health screening tools Q1 to 4, Q5 to 7, GAD7, PASS, PHQ9, New/Follow up status, scores Records screening completion and severity. Check that scores remain within the limits shown on the page.
Drug use and ASSIST Drug use within six months, Name of Drug 1-5, ASSIST Score 1-5 Documents recent substance use and substance-specific ASSIST scores for risk review and intervention planning.
Sexualized drug use and chemsex Sexual activities under the drug effect, problematic chemsex assessment, A-E Records sexualized drug use and indicators of problematic chemsex during the assessment period.
Brief intervention and completion Brief intervention BI: Done, If not done BI, Remark Shows whether BI was delivered, the reason when it was not delivered, and any supporting note.

Mental Health Register And Follow-up Data Dictionary

Field Where It Appears How Users Should Understand It
Database, General ID, Fuchia ID, PrEP ID, Current Age, Sex, HIV status, Registration date, Risk factor, if PWID, OST Register identity Links the baseline register data to the correct patient and risk profile.
Data format: Text/database, General ID number, age numeric, sex/risk/list values, date DD-MM-YYYY, PWID Active/Ex and OST Yes/No.
Q1-Q4, Q5-Q7, GAD7, PHQ9, PASS Score Register screening scores Baseline severity and screening status used to decide care plan and follow-up need.
Data format: Selected screening summary and numeric scores. GAD7 0-21, PHQ9 0-27, PASS 0-93.
Psychosis, symptoms, duration, suicidal risk, drug use, sexualized drug use, injectable drug use, willingness to change, ASSIST Score, drug names and risks Psychosis, suicidal risk, and drug screening Documents clinical risk and substance-use context for counselling, BI, treatment, and referral.
Data format: Yes/No/list values, duration/timeframe values, free text drug names, and ASSIST risk categories.
Brief Intervention, planned goal, Stage of BI, treatment at MAM, Fluoxetine, Risperidone, psychiatrist referral, diagnosis, outcomes, initials, next follow-up date Register intervention and outcomes Records baseline care actions, treatment plan, outcome status, provider accountability, and planned next review.
Data format: Yes/No/NA, selected list values, checkbox flags, free text treatment/other fields, staff initials, date DD-MM-YYYY.
Visit Date, patient identity, improvement of symptoms, adherence problem, mental rescreening, GAD7, PHQ9, PASS, problematic sexualized drug use Follow-up assessment Measures change since baseline or last visit and identifies continuing support needs.
Data format: Date DD-MM-YYYY, ID/age/risk values, Yes/No/list values, numeric scores.
ASSIST rescreening, drug names, scores, risks, BI changes, new drug use, suicidal risk between visits, MD consultation, pharmacological side effects, treatment changes Follow-up ASSIST and treatment review Tracks substance-use changes, safety risk, medication effects, and treatment adjustments during follow-up.
Data format: Yes/No/list values, text drug names, numeric scores, risk categories, and treatment-change text.
Refer to psychiatrist, stopping drug, psychosocial intervention at MAM, depression, anxiety, psychosis, other symptoms, MD/CSL initials, next follow-up dates Follow-up referral, diagnosis, and next dates Closes the follow-up visit with referral, diagnosis/status, responsible staff, and next appointment planning.
Data format: Selected referral values, Yes/No/list or checkbox flags, staff initials, and DD-MM-YYYY next dates.

Good Mental Health Practice

Do

  • Search and confirm the patient before saving register or follow-up records.
  • Check GAD7, PHQ9, PASS, ASSIST, psychosis, and suicidal-risk fields before saving.
  • Use Follow Up History before editing or adding another follow-up visit.
  • Record MD/CSL initials and next follow-up dates for handover and tracking.

Be Careful

  • Do not mix Register and Follow-up dates in export review.
  • Do not leave conditional fields blank when the parent answer is Yes.
  • Do not ignore high scores, psychosis, or suicidal-risk fields during data quality review.
  • Do not export before checking missing follow-up dates and incomplete treatment-change fields.

CMV Service: Eye Screening, Diagnosis, And Treatment

CMV Service records eye screening and treatment information for patients at risk of CMV retinitis. The user searches the patient, confirms identity and visit date, records ART/CD4 context, checks visual symptoms and acuity, documents right/left eye diagnosis, records treatment, and saves doctor, organization, follow-up date, and remarks.

Search Patient
Visit Date
ART / CD4
Vision Acuity
Diagnosis
Treatment

CMV Workflow

Use the CMV page as a visit-based eye screening and treatment record. Always search first so previous CMV history can be reviewed before saving a new visit.

1. Identify Search General ID or Fuchia ID, then confirm sex, age, visit date, and patient type.
2. ART Context Record ART status, current ART regimen, ART start date, most recent CD4, CD4 date, and visual symptoms.
3. Vision Record right and left eye acuity. If value is 6 or CF, add the denominator/detail field shown by the page.
4. Diagnose Record right and left eye diagnosis and type of diagnosis: New, FU, Relapse, Most likely CMV, or UK.
5. Treat Record treatment for each eye, eye doctor, organization, follow-up date, remarks, then save or update the record.

CMV Overview

CMV Main data-entry tab. Includes patient search, sex, age, visit date, patient type, ART status, ART regimen, CD4, visual symptoms, vision acuity, eye findings, treatment, doctor, organization, follow date, and remark.
History Shows prior CMV records for the searched patient. Use History to open a previous record before updating or deleting.
Vision acuity controls Right and left eye acuity values include No Eye, 6, CF, HM, LP, and NLP. The page opens an extra detail field when 6 or CF is selected.
CMV Export Exports CMV data by visit date range. The dictionary CSV follows the current M&E CMV export with 29 variables.

CMV Data Dictionary

Field Where It Appears How Users Should Understand It
Database, Clinic Code, General ID, Fuchia ID, Sex, registration/current age, Visit Date, Patient Type Patient identity and visit Identifies the patient and the CMV visit being reviewed or exported.
Data format: Database/clinic text, General ID number, Fuchia ID text, Male/Female, age numeric, date DD-MM-YYYY, Patient Type New/Old.
ART status, Current ART Regime, Art Start Date, Most Recent CD4, Recent CD4 Date ART and immune status Gives HIV treatment and immune-status context for CMV screening risk and clinical interpretation.
Data format: ART status Yes/No, regimen 1st/2nd, CD4 numeric, dates DD-MM-YYYY.
Symptoms flashes/floater/scotoma/sudden vision loss, Vision acuity Right Eye, Vision acuity Left Eye Symptoms and vision acuity Documents visual complaint and acuity before diagnosis and treatment decisions.
Data format: Symptoms Yes/No. Vision acuity values: No Eye, 6, CF, HM, LP, NLP; 6 and CF may include extra detail after a slash.
Right Eye Diagnosis, Type of Dx Right, Left Eye Diagnosis, Type of Dx Left Eye findings and diagnosis Records the right/left eye clinical finding and whether it is a new, follow-up, relapse, likely CMV, or unknown diagnosis.
Data format: Diagnosis values: Active_CMV, Inactive_CMV, Extensive_CMV, RD, TB_G, CWS, NAD, Other. Dx type: New, FU, Relapse, Most likely CMV, UK.
Right eye treatment, Left eye treatment, Eye Doctor, Organization, Remark Treatment and provider Captures treatment plan, provider accountability, service organization, and notes for review.
Data format: Treatment values: Injection only, Valgan only, Injection with valgan, Observation, No treatment. Doctor/organization/remark are free text.

Good CMV Practice

Do

  • Search General ID or Fuchia ID first and review CMV history before saving.
  • Complete visit date, ART/CD4 context, symptom status, right and left eye acuity, diagnosis, and treatment fields.
  • Use the extra acuity detail field when right or left eye acuity is 6 or CF.
  • Record eye doctor, organization, follow date, and remark for continuity of care.

Be Careful

  • Do not create a duplicate CMV record for the same General ID and visit date.
  • Do not mix right-eye and left-eye diagnosis or treatment values.
  • Do not leave ART start date or recent CD4 date unclear when the values are available.
  • Do not forget that Follow Date is recorded on the entry page, although it is not part of the current M&E CMV export columns.

ANC Register: Registration, Follow-up, And Export

ANC Register records antenatal registration and follow-up care. The user searches by General ID, creates or updates the ANC register, records relevant maternal history, family and patient risk history, immunization, previous obstetrical history, investigation results, clean delivery kit/referral data, and follow-up visit findings.

Search Patient
Register
History
Investigation
Follow Up
Export

ANC Workflow

Use the ANC page as one register episode with many follow-up visits. Register first, then add follow-up visits against that same ANC register record.

1. Search Enter General ID and registered date, then confirm the patient information shown by the page.
2. Register Record relevant history, G/P status, LMP/EDD, contraception history, family history, and patient history.
3. Add Detail Complete TT immunization, previous obstetrical history, investigation results, clean delivery kit, and referral fields.
4. Follow Up Record each visit with weight, BP, urine, gestational period, fundal height, fetal status, complaints, treatment, USG, and MD name.
5. Export Choose ANC Register or ANC Follow Up, set from/to dates, and export the selected dataset.

ANC Overview

Register Main ANC episode form. Includes General ID, registered date, relevant history, family history, patient history, immunization, previous obstetrical history, investigation, clean delivery kit, and referral data.
Register History Shows previous ANC register records for the searched patient so users can open, update, or delete the correct episode.
Follow Up History Lists ANC follow-up visits by admission/registered date and visit date. Use this before adding or editing follow-up records.
Export Exports either ANC Register or ANC Follow Up by date range. The dictionary CSV follows these two current M&E export datasets.
Conditional fields Clean Delivery Kit Distribution opens CDK Distributed Date when Yes. Refer opens Referral Date and Referral Place when Yes. Previous obstetrical history repeats according to G status.

ANC Data Dictionary

Field Where It Appears How Users Should Understand It
General ID, Registered Date, patient name/age, Husband's Name, Age of Marriage, Height, G, P, Contact Number, Address, Last Menstrual Period, LMP, EDD, contraception history Register identity and relevant history Identifies the ANC episode and captures maternal background, obstetric status, pregnancy dating, and contact context.
Data format: General ID number, age and clinical numeric values, date DD-MM-YYYY, LMP Known/Unknown, text for contact/address/history.
Family History Hypertension/Diabetes/Tuberculosis/Twins; Patient History Hypertension/Diabetes/Tuberculosis/Twins/Heart Disease/Allergy/Surgical Operation/Other Specify Family and patient history Marks family and personal risk factors that may change ANC monitoring, referral, or follow-up priority.
Data format: Yes/No selections for risk conditions, plus free text for Other Specify.
1st Dose, 2nd Dose, TA/Prem, Spont/Induced, 3rd stage complication, Condition of child, Remark Immunization and previous obstetrical history Tracks tetanus toxoid immunization and previous pregnancy/child outcomes. The export adds another 5 child-history columns for each extra child row.
Data format: Dates for TT doses. Child-history fields are repeatable; condition values are Stillbirth, Alive, or End, with text fields for other details.
HIV, HBsAg, Anti-HCV, Syphilis RDT/RPR, Blood Group/Rh, Blood Sugar test dates and results Investigation Records laboratory and screening evidence used for antenatal care, risk review, and referral decisions.
Data format: Dates DD-MM-YYYY. HIV/HBsAg/Anti-HCV results Positive, Negative, or Unknown/Unknow. Syphilis RDT Reactive/Non-reactive. Blood group/result fields are short clinical text.
Clean Delivery Kit Distribution, CDK Distributed Date, Refer, Date of referral, Referral place Delivery and referral Shows whether the mother received a clean delivery kit and whether referral was made, including when and where.
Data format: Yes/No selections, dates DD-MM-YYYY, and referral place values TBA, RHC/UHC, or Hospital.
Visit Date, Weight, BP systolic/diastolic, Pr, Glu, Other, Gestational period, Fundal Height, Presentation, Engagement, FHS, Oedema, RPR recheck Follow-up assessment Documents routine ANC follow-up findings and clinical status for each visit.
Data format: Date DD-MM-YYYY; numeric clinical values; urine Pr/Glu blank/0, 1+, 2+, 3+, or 4+; Oedema Yes/No; text for other findings.
Complaints, Treatment, USG result, Name of MD Follow-up care Records the care plan, ultrasound result, and responsible provider for continuity and review.
Data format: Free text or short clinical note according to the field label.

Good ANC Practice

Do

  • Search General ID first and confirm the patient before creating a register episode.
  • Check registered date, G/P status, LMP/EDD, risk history, investigations, CDK, and referral fields before saving.
  • Use Register History before updating an existing ANC register record.
  • Add follow-up visits under the correct registered episode and review Follow Up History before export.

Be Careful

  • Do not create duplicate ANC register records for the same patient and registered date.
  • Do not leave CDK date blank when Clean Delivery Kit Distribution is Yes.
  • Do not leave referral date or referral place blank when Refer is Yes.
  • Do not forget that previous obstetrical history columns can expand in the register export depending on child-history rows.

Feeding Center Register: Admission, Nutrition Follow-up, And Outcome

Feeding Center Register records nutrition admission, follow-up visits, and program outcomes. The user searches the patient, records Feeding Center ID and admission details, documents diagnosis, screening criteria, medical complications, nutrition measurements, transfer or discharge outcome, household context, and follow-up measurements.

Search Patient
Admission
Nutrition Status
Complications
Follow Up
Outcome

Feeding Center Workflow

Use the Feeding Center page as one admission episode with follow-up visits linked to the same admission date. A new register record also creates the first follow-up visit on admission date.

1. Identify Enter Date of admission and General ID, then search and confirm the patient information.
2. Register Record Feeding Center ID, patient type, diagnosis, entry source, distance, screening criteria, and admission type.
3. Assess Record medical complications, MUAC, final MUAC color, Z-score, weight, height, clinical status, and notes.
4. Follow Up Add follow-up visits with visit date, MUAC, Z-score, weight, height, clinical status, other findings, and remark.
5. Outcome Record transfer, outcome date, outcome, outcome nutrition values, hospital outcome, length of stay, parent/caretaker context, then export.

Feeding Center Overview

Register Main admission form. Includes Date of admission, General ID, Feeding Center ID, patient type, diagnosis, entry source, distance, screening criteria, admission type, medical complications, nutrition measures, outcome, parent status, caretaker, and remark.
Register History Shows previous Feeding Center admissions for the searched patient so users can open the correct admission episode before editing.
Follow Up History Shows follow-up visits grouped by admission date. Use this to review visit sequence and avoid duplicate follow-up dates.
Export Exports either Register or Follow Up records by date range. The dictionary CSV follows the current M&E Feeding Center export columns.
Linked follow-up behavior The page saves the first follow-up visit from admission values. If outcome date is entered, an outcome follow-up visit may also be created using the outcome nutrition values.

Feeding Center Data Dictionary

Field Where It Appears How Users Should Understand It
Database, Clinic Code, General ID, Sex, FC-Reg Age, FC-Reg Age(month), Feeding Center ID Register identity Identifies the admission record and links it to the patient, clinic, age, and Feeding Center episode.
Data format: Database/clinic text, General ID number, sex value, calculated age values, and Feeding Center ID text.
Patient Type, Diagnosis, Enter from, Distance to clinic, Screening Criteria, Admission Type, Medical Complication, Date of admission Admission profile Describes why and how the patient entered the Feeding Center program and identifies admission risk context.
Data format: Selected list values, multi-select complication text, and date DD-MM-YYYY.
FINAL MUAC, MUAC, Z-score, Weight, Clinical, Others Admission nutrition status Records baseline nutrition status at admission for monitoring and outcome comparison.
Data format: Numeric nutrition values, MUAC color category, Z-score category, clinical selection, and free text note.
Date of transfer to ATFP, Date of Outcome, Outcome, Hospital Outcome, Length of Stay in Day care, Total Length of Stay Outcome and discharge Shows transfer/discharge timing, final program result, and duration of care.
Data format: Dates DD-MM-YYYY, outcome selected lists, and numeric day counts.
MUAC1, Z_score1, Weight1, Clinical1, Others1, Parent's Status, Parent HIV status, Caretaker, Remark Outcome nutrition and care context Records nutrition status at outcome and household/caretaker context for care review.
Data format: Numeric outcome measurements, selected list values, and free text notes.
Date of Admission, Visitdate, MUAC, Z_score, Weight, Height, Clinical, Other, Remark Follow-up assessment Tracks nutrition and clinical progress across Feeding Center follow-up visits.
Data format: Date DD-MM-YYYY, numeric nutrition values, selected clinical status, and free text notes.

Good Feeding Center Practice

Do

  • Search by General ID and admission date before saving a new Feeding Center register record.
  • Complete Feeding Center ID, diagnosis, screening criteria, admission type, MUAC, Z-score, weight, clinical status, and medical complications.
  • Review Register History and Follow Up History before updating an old admission episode.
  • Check outcome date, outcome, hospital outcome, length of stay, parent status, parent HIV status, and caretaker before export.

Be Careful

  • Do not create duplicate admissions for the same General ID and Date of admission.
  • Do not add a follow-up visit before the Date of admission.
  • Do not leave medical complication text unclear after selecting complication checkboxes.
  • Do not mix admission nutrition values with outcome or follow-up nutrition values during data review.

NCD: Register, Follow-up, Data Review, And Export

NCD records non-communicable disease registration and follow-up care. The user searches by General ID or Fuchia ID, records baseline hypertension/diabetes screening, current medications, patient and family history, follow-up visits, BP/blood sugar/lab monitoring, medication changes, adherence, drug supply, appointments, and outcomes.

Search Patient
Register
Diagnosis
Medication
Follow Up
Export

NCD Workflow

Use the NCD page as a long-term register with repeated follow-up visits. The Data tab helps users review clinical results, treatment history, and LTFU status before saving the next visit.

1. Identify Search General ID or Fuchia ID and confirm patient age, sex, residence, and township.
2. Register Record registration date, entry mode, height, weight, BMI, BP readings, blood sugar tests, diagnosis, symptoms, and smoking status.
3. Medication Record current NCD medicines, other medicines, dose, frequency, duration, duration unit, and other medication detail.
4. History Complete patient history, family history, chronic lung disease, recurrent infection, and poor-compliance date fields.
5. Follow Up Record visit date, visit type, next appointment, BP, lab results, diabetic foot/neuropathy, adherence, drug supply, treatment, and outcome.

NCD Overview

NCD Register Main registration and follow-up workspace. Includes patient search, register fields, medication table, patient/family history, follow-up history, and add follow-up form.
Data Reviews Register, Follow up, and Labs results by ID and date range. Shows dated results, chart, treatment history, and LTFU summary.
NCD Export Exports Register or Follow up data by date range. The CSV dictionary follows the current M&E NCD export class with one row per export variable.
Follow-up history Lists prior NCD follow-up visits for the searched patient so users can open, update, or delete the correct visit.
Conditional controls Late visit opens late duration fields. Follow-up required supports duration/unit and next appointment. Type 5 users can see appointment load by doctor, hour, AM/PM, and next follow-up date.

NCD Data Dictionary

Field Where It Appears How Users Should Understand It
Database, Clinic code, General ID, Fuchia ID, Current Age, Sex, Reg Date, Township, State, Height, Weight, Reg_BMI Register identity Identifies the NCD register record and baseline patient context.
Data format: Database/clinic text, ID values, age numeric, date DD-MM-YYYY, demographics, and numeric height/weight/BMI.
BP readings 1-3, BP read dates, Hypertension, Diabetes, diagnosis dates, staging, RBS tests, clinical symptoms, smoking status Register diagnosis and screening Classifies baseline hypertension/diabetes and related screening information at registration.
Data format: BP numeric pairs, dates DD-MM-YYYY, diagnosis/status selected values, RBS numeric values, symptom text, and smoking status list.
Amlodipine, Enalapril, Atorvastatin, Hydrochlorothiazide, Aspirin, Metformin, Gliclazide, Other NCD medication, Current med1-6 Register medications Documents treatment already being used at NCD registration.
Data format: Dose, frequency, duration, duration unit, selected medication values, and free text other-medication fields.
Diabetic foot, Hyperlipidemia, Gestational diabetes/HT, Neuropathy, CKD, CVD, Atrial fib, vision change, chronic lung disease, recurrent infection, family history, poor-compliance dates Patient and family history Captures risk history, comorbidities, family risk, and treatment-compliance warning dates.
Data format: Yes/No, NA or clinical selected values, free text comment, and dates DD-MM-YYYY.
Visit Date, Register Date, NCD Diagnosis, Clinical History, Type_current_visit, late duration/unit, follow-up required duration/unit, next follow-up date, time Follow-up visit planning Shows the visit context, whether the patient came late, and when the next visit is planned.
Data format: Dates DD-MM-YYYY, selected visit type, numeric duration, unit values, time text, and clinical history text.
BP MAM, BP state, FBS, 2HPP, RBS, HbA1C, ALT, urine ACR, glucose/protein/ketone, creatinine, CRCL, lipids, pulse, diabetic foot, diabetic neuropathy Follow-up clinical and lab monitoring Tracks disease control, complications, renal/lipid risk, and follow-up clinical status.
Data format: Numeric clinical/lab values, unit fields, dates DD-MM-YYYY, and selected clinical status fields.
Lifestyle advice, medication changed, patient adherence, drug supply, follow-up medicine doses, hypoglycemia, other medication, outcome, transfer out, death date, cause of death, doctor initial Follow-up medication, adherence, and outcome Records treatment plan, adherence, medicine supply, outcome, transfer/death information, and accountable clinician.
Data format: Selected values, medication dose/frequency/duration/unit fields, dates DD-MM-YYYY, and free text notes.

Good NCD Practice

Do

  • Search by General ID or Fuchia ID before creating or updating the NCD register.
  • Complete registration date, BP readings, blood sugar tests, diagnosis status, symptoms, smoking status, and baseline BMI.
  • Use the Data tab to review recent lab results, treatment history, and LTFU status before saving a follow-up visit.
  • Record next follow-up date, medication changes, adherence, drug supply, and doctor initial for every follow-up visit.

Be Careful

  • Do not create a duplicate register for a patient who already has an NCD register.
  • Do not save follow-up before the register exists.
  • Do not leave late-visit or follow-up-required duration fields unclear when those conditions apply.
  • Do not mix register medication fields with follow-up prescription fields during data review.

PrEP Program: Screening, Facility Record, And Follow-up

PrEP documentation covers eligibility screening, facility intake, initiation or restart, and follow-up care. The user records client information, standalone PrEP age and risk values, sexual/drug-use risk classification, substantial HIV risk, eligibility, service offer/decline, facility laboratory checks, STI and HBV services, PrEP regimen, family planning, FSW type, follow-up testing, adherence, side effects, discontinuation, prescription, delivery, and outcome.

Search Client
Screening
Risk Class
Facility
PrEP Use
Follow Up

PrEP Workflow

Use PrEP Screening first to decide substantial risk and eligibility, then use PrEP Facility to record initiation and follow-up. Age, Main Risk, and Sub Risk are recorded as PrEP program fields for this workflow and should not be interpreted as automatically drawn from patient configuration tables.

1. Screen Search General ID, record screening date, PrEP ID, tracker ID, phone, standalone age/risk values, demographics, and facility/navigator information.
2. Classify Record sex/gender, sex partner, sex work, injection-drug questions, key population flags, final classification, and substantial-risk criteria.
3. Decide Record recent exposure, HIV test, confirmation, substantial risk, acute-HIV suspicion, PrEP eligible, offered, accepted or declined, and referrals.
4. Facility Record partner HIV status, referral source, pregnancy/breastfeeding, baseline labs, HBV vaccination, STI care, initiation/restart, regimen, and next visit.
5. Follow Up Record visit date, active status, follow-up month, HIV/HBV/HCV/urine/CrCL/STI results, risk reduction, adherence, side effects, prescription, delivery, and outcome.

PrEP Overview

PrEP Screen Eligibility and substantial-risk screening page. Includes client identity, standalone PrEP age/risk data, key population classification, recent HIV exposure, eligibility, offer/accept/decline, decline reason, and referral fields.
Screening History Searches prior screening records for review, update, or deletion before creating another screening record.
PrEP Facility Facility intake and initiation page. Includes baseline lab tests, pregnancy/breastfeeding, HBV testing/vaccination, STI services, PrEP start/restart, regimen, family planning, and FSW type.
Facility Follow Up Follow-up visit form for PrEP active status, HIV confirmation, ART start, HBV/HCV/urine/CrCL, STI management, adherence, side effects, discontinuation, prescription, next date, delivery, interruption, and outcome.
Exports PrEP Screening Export, PrEP Facility Export, and PrEP Facility Follow-up Export are represented in the dictionary CSV as three separate datasets.

PrEP Data Dictionary

Field Where It Appears How Users Should Understand It
General ID, Visit Date, PrEP ID, Tracker ID, Sex, Age, DOB, birth region/town, phone, facility, navigator, person completing form Identity and demographics Identifies the PrEP client and visit/screening context for the program record.
Data format: ID/text values, dates DD-MM-YYYY, and standalone PrEP age fields recorded in the PrEP workflow.
Main Risk, Sub Risk, Consider Sex, Sex With, exchanged sex, injected drugs, key population flags, Final_class, Final_other Standalone risk classification Classifies PrEP risk and key population status without assuming these values come from pt_configs or patients.
Data format: Standalone PrEP risk categories, selected answers, checkbox values, and free text other specify.
Condomless sex, sex partner HIV risk, STI history, PEP history, shared injection material, recent 72-hour exposure, symptoms, HIV test, confirmation, substantial risk, eligible, offered/accepted/declined, decline reasons, referrals Screening risk, eligibility, and referrals Documents substantial-risk criteria, HIV testing/eligibility decision, client decision, and referral pathway.
Data format: Yes/No style selections, checkbox flags, test result lists, dates DD-MM-YYYY, and free text reasons.
Pregnancy, breastfeeding, HIV last test, creatinine, CrCL, HCV, urine, weight, HBsAg, HBV vaccination, STI screen/result/syndrome/treatment/lab investigation Facility baseline lab and HBV/STI Records clinical baseline checks and linked HBV/STI services before or during PrEP initiation.
Data format: Dates DD-MM-YYYY, numeric lab/weight values, selected result/status values, and STI text/code values.
Prep Initial Type, Prep Start Date, Prep ARV Prescribed, Next Visit Date, Prep Re-Start Date, Start-stop eligible, Prep Taking Type, Family Planning, method flags, last family planning date PrEP initiation, regimen, and family planning Tracks PrEP start/restart, ARV regimen, next appointment, daily/start-stop use, and reproductive health support.
Data format: Selected regimen/type values, checkbox flags, dates DD-MM-YYYY, and free text other values.
PrEP Active, Followup Month, HIV screen/confirmation, ART start, HBsAg, HCVAb, Urine RE, CrCL, STI/RDT/RPR, adherence, side effects, discontinuation, prescription, next date, outcome, delivery, interruption, condom usage Follow-up testing, adherence, and outcome Monitors PrEP continuation, safety, infection testing, risk reduction, adherence, supply, interruption, and final outcome.
Data format: Dates DD-MM-YYYY, selected result/status values, numeric month/weight/interruption values, and free text notes.

Good PrEP Practice

Do

  • Search the client before recording screening or facility data.
  • Record Age, Main Risk, and Sub Risk carefully as PrEP-specific standalone values.
  • Complete key population classification, substantial-risk criteria, HIV test/confirmation, eligibility, and service offer fields before moving to facility initiation.
  • Review facility and follow-up history before updating PrEP active status, prescription, delivery, discontinuation, or outcome.

Be Careful

  • Do not assume PrEP Age or Risk fields are automatically drawn from pt_configs or patients.
  • Do not leave confirmation fields blank when screening result is reactive.
  • Do not record PrEP start/restart without checking baseline HIV, renal, HBV/HCV, urine, and STI fields where applicable.
  • Do not mix Screening, Facility, and Follow-up export columns during data review.

Prevention: Logsheet, CBS, Outreach, And Service Provision

Prevention documentation covers confidential search, Logsheet data, CBS data, follow-up history, and export. Users identify the client through peer/clinic/year/serial information, record reach and risk status, service provision, commodities, HIV testing, mental health, OST/referral, drug-use and brief-intervention details, then export Logsheet or CBS data.

Confidential
Reach
Services
HIV / CBS
MH / DU
Export

Prevention Workflow

Use Confidential Facts first to find or confirm the client, then move into Log Sheet or CBS depending on source document and service modality.

1. Identify Use peer code, clinic, year, serial number, General ID, Fuchia ID, PrEP code, age, sex, and risk fields to confirm the client.
2. Logsheet Record visit date, reach new/old, meeting point, service provisions, commodities, HIV status, HTS, source document, and remarks.
3. CBS Record CBS visit date, meeting point, service provision, retesting, HIV determine/final result, counselling, referral, and confirmation date.
4. MH / DU Record mental health, PHQ4, OST, drug-use, problematic DU, brief intervention, MMT code, and MTD date where applicable.
5. Review Use follow-up history and export Logsheet or CBS by date range for M&E review.

Prevention Overview

Confidential Facts Search and confirm peer code, clinic, year, serial number, General ID, Fuchia ID, PrEP code, patient age/sex, and current or changed risk.
Log Sheet Main outreach/service log. Includes visit date, service provision 1-3, reach new/old, NS and condom distribution, HIV status, HTS, source document, mental health, OST, problematic DU, BI, and remarks.
CBS Community-based service record. Includes visit date, meeting point, service provision, retesting, HIV determine result, HIV sero-status, counselling, referral, confirmation date, modality, and mode of entry.
Follow up history Shows Log Sheet History and CBS History for the selected client so users can edit or delete the correct prevention record.
Export Exports active Prevention Logsheet, CBS, or Confidential data by date range. This documentation dictionary focuses on the active Logsheet and CBS export columns.

Prevention Data Dictionary

Field Where It Appears How Users Should Understand It
Database, HE Code, Clinic Code, Register Year, Pid, Fuchia ID, PrEP Code, register/visit dates, age, sex Record identity and demographics Identifies the prevention activity, patient, peer/clinic context, and reporting period.
Data format: ID/code values, dates DD-MM-YYYY, age numeric values, and sex value.
Initial Risk, Risk changed, Risk changed Date, Main Risk(Current), Sub Risk, Reach New_Old, Meeting Point, Reach_whom, Source_doc, Reached Township Reach and risk Shows who was reached, where, under which source document, and whether risk changed over time.
Data format: Risk categories, Yes/No or New/Old status, date DD-MM-YYYY, and location/text values.
Service Provision1-3, HE_Section, Ns_distribute, Condom_m, Condom_f, Ns_return, CBS Service Provision Service provision and commodities Tracks services delivered and prevention commodities distributed or returned.
Data format: Selected service values and numeric commodity counts.
HIV Status, Test_duration, HTS done, HIV results, date_confirm, Retesting, HIV_determine_result, HIV Sero-Status, Counselling_pretest, Counselling_posttest, Refer_to HIV testing and CBS counselling Documents HIV testing status, confirmation pathway, CBS counselling, and referral outcome.
Data format: HIV status/result selected values, Yes/No counselling fields, referral text, and date DD-MM-YYYY.
Mental_Health, PHQ4_Q1_Q2, PHQ4_Q3_Q4, OST_Done, OST_Accept, Decline_Reason, OST_Initial_Date, OST_Eligible, Referral_Coupon, MMT Code Mental health, OST, and referral Records mental-health screening and OST/referral activity linked to prevention outreach.
Data format: Selected screening/status values, referral/coupon text, and date DD-MM-YYYY.
Drug Use, Brief Intervention, problematic DU detail fields, Explain Harm Activity, Introduce Services, Discuss Reduce Risk, Explain OST Referral, BI_done, mtd_date Drug use and brief intervention Documents problematic drug-use risk details and brief-intervention components for follow-up and reporting.
Data format: Checkbox/status values, Yes/No style flags, free text where applicable, and date DD-MM-YYYY.

Good Prevention Practice

Do

  • Confirm the client in Confidential Facts before saving Logsheet or CBS data.
  • Check visit date, risk, meeting point, source document, service provision, and commodity counts before saving.
  • Use CBS fields when the source document or service modality is CBS/Mobile CBS.
  • Review history before editing or deleting a prevention record.

Be Careful

  • Do not mix Logsheet service provision fields with CBS service provision fields during export review.
  • Do not leave confirmation date or referral blank when a reactive result is referred.
  • Do not ignore risk changed date when the client risk category changes.
  • Do not export without checking whether Logsheet or CBS is the intended active table.

Pre TB Assessment: Screening, Diagnostics, And Treatment Decision

Pre TB Assessment records the first TB clinical assessment before confirmed TB registration. The page links a General ID to patient details, records symptoms and risk factors, captures X-ray and sputum/GeneXpert/Truenat/HIV diagnostics, then records diagnosis, treatment status, remark, and responsible MD.

General ID Lookup Symptoms Risk Factors Diagnostics Treatment Decision Export

Pre TB Assessment Workflow

1. Identify Enter General ID, confirm patient details, age, sex, phone, height, weight, BMI, assessment type, mode of entry, screening date, and next visit date.
2. Screen Record main presenting complaint, all symptom rows, duration in days for present symptoms, and risk factors such as alcohol, smoking, malnutrition, PWID, PWUD, DM, HIV, and TB history.
3. Investigate Capture chest X-ray, radiologist request/result, sputum AFB, GeneXpert, Truenat, and HIV determine test dates/results.
4. Decide Record MD diagnosis, CAD score, antibiotics, TB diagnosis, treatment status, other management details, remark, and MD name.
5. Export Use Export codes or labels for the current record variables; use analysis/counts exports for program summaries.

Pre TB Overview

Header actions Create, clear, manage, import, export codes, export labels, export analysis, and export counts.
Patient and visit General ID lookup, patient details, vitals, type of assessment, mode of entry, date of screening, next visit date, and phone number.
Symptoms/Risks Main presenting complaint, symptom presence/duration, symptom no-confirmation checkboxes, and risk-factor selections.
Diagnostics Chest X-ray, X-ray image, MD diagnosis, CAD score, comment, radiologist request/result, sputum AFB, GeneXpert, Truenat, and HIV determine.
Diagnosis and management Antibiotics, drug, TB diagnosis, treatment status, treatment-status other text, remark, and MD.

Pre TB Data Dictionary

Field Where It Appears How Users Should Understand It
clinic, cid, TB-03, name, age, sex, typ_of_scr, mode_of_entry, dofscrrening, dofnv, phone Record identity and visit Identifies the patient, assessment visit, route into care, and whether the client already appears in TB-03.
Data format: ID/text values, coded sex/type/mode values, and date values.
height, weight, bmi, main_presenting_complaint Vitals and complaint Documents clinical context for screening and nutrition or severity review.
Data format: Numeric height/weight/BMI and free text complaint.
fever, cough, hemoptysis, weight_loss, loss_of_appetite, chest_pain, night_sweats, neck_glands, fatigue and duration fields Symptoms Shows which TB symptoms were present and how long they lasted.
Data format: Yes/No coded values and symptom duration in days.
alcohol, smoking, malnutrition, PWID, PWUD, DM, dm_tx_status, hiv_status, hiv_tx, his_tb_self, his_tb_self_detail, his_tb_family Risk factors Captures clinical and exposure risks that influence assessment and follow-up priority.
Data format: Coded current/ex/no/unknown, Yes/No/Unknown, treatment status, and free text detail.
chest_x-ray, chest_x-ray_date, chest_x-ray_fac, md_diagnosis, cad_score, radio_request, radiologist_result, sputum_afb, genexpert, truenat, hiv_det and result/date fields Diagnostics Tracks investigations requested, results received, and evidence for diagnosis.
Data format: Yes/No flags, selected result codes, dates, numeric CAD score, specimen type, and comments.
antibiotics, antibiotic_date, drug, manage_oth, tb_diagnosis, treatment_status, treatment_status_other, xray_image_path, remark, md Management and outcome Records the final assessment decision, treatment or referral status, supporting notes, and accountability.
Data format: Yes/No flags, dates, selected diagnosis/status values, file path, text notes, and staff name.

Good Pre TB Practice

Do

  • Confirm the General ID lookup before entering clinical details.
  • Complete every symptom row: either mark the symptom and enter days, or confirm it was asked and not present.
  • Enter diagnostic dates and results together so export review can follow the investigation timeline.
  • Use labels export when reviewing readable values, and codes export when checking raw coded values.

Be Careful

  • Do not save duplicate records with the same General ID and date of screening.
  • Do not leave TB diagnosis or treatment status blank when a final assessment decision has been made.
  • Do not mix the main export dictionary with analysis/counts summaries; they answer different M&E questions.
  • Check X-ray image/file path only as supporting evidence, not as a replacement for recorded diagnostic result fields.

Counsellor: HTS, Counselling Service, TB Register, And IPT Register

Counsellor documentation covers four working parts. The counsellor starts from patient identification, records HIV testing service or counselling service data when needed, manages TB register records, records IPT, and exports or reviews data for follow-up.

HIV Testing Service HTS entry, HTS update, remaining HTS checks, and HTS export from the counselling page.
Counselling Service Counselling-only records, tele-counselling, patient record context, updates, and exports.
TB Register TB Register-03, patient search, treatment data, follow-up, export, and report.
IPT TB-IPT registration, start/discontinuation dates, regimen, outcome, history, and export.
Search ID
Confirm Patient
Choose Program
Enter Data
Plan Follow-up
Update History
Export

HIV Testing Service

The counselling page supports HTS data entry together with counselling data. The user can choose Counselling Only or HTS Entry and Counselling, then complete the HTS-related fields for the patient and visit.

Counselling facts and HTS data entry Main entry area. Search General ID or Fuchia ID, set counselling date, confirm patient details, and choose whether the visit is counselling only or HTS plus counselling.
HTS Data/Update Review and update saved HTS records. Use this when correcting HTS details after a record has already been saved.
HTS Remaining Checks incomplete or remaining HTS work so users can finish records that were not completed during first entry.
Export Exports counselling and HTS data for review and reporting.

Counselling Service

Counselling data captures counselling-only visits, counselling connected to HTS, and tele-counselling records. It is the counsellor's main work record and should match the patient, counselling date, counsellor, risk context, and service outcome.

Counselling Only Use when the patient receives counselling without HTS entry. Search patient, set counselling date, choose counsellor, and save counselling facts.
HTS Entry and Counselling Use when HIV testing service data and counselling data are recorded in the same workflow.
Tele Counselling Records or reviews counselling work completed by phone or remote contact.
Patient Record Uses patient context from the registration system so counselling data remains connected to the right client.

TB Register

TB Register-03 records TB treatment registration and reporting data. It supports searching by General ID, Fuchia ID, or Township TB Register Number, then saving treatment details and follow-up information.

TB Register-03 Main TB register form. Search patient, confirm age/sex/state/township, then enter treatment date, nationality, facility, reporting period, transfer status, referral, and TB treatment details.
Follow Up Opens TB follow-up history for the selected patient or TB register record.
Export Exports TB register data for reporting and program review.
Report Builds TB reporting outputs from the saved register data.

IPT Register

The TB-IPT page records IPT registration and outcomes. Users search the patient, confirm patient details, enter counsellor, registration/start/discontinuation dates, choose regimen, record outcome, and export IPT data.

Patient search

Search General ID or Fuchia ID before creating or updating the IPT record.

Core dates

Record IPT Register Date, IPT Start Date, and IPT Discontinuation Date where applicable.

Regimen

Use the 6H or 3HP checkbox to mark the IPT regimen.

Outcome

Choose Completed, Incomplete, or TB disease while on TPT.

History

Use History before editing an existing IPT record.

Export

Use Export for IPT reporting after checking date and outcome fields.

Counsellor Data Dictionary

HIV Testing Service

Field Where It Appears How Users Should Understand It
Clinic Code, Pid, FuchiaID, Gender, Register Year, Register Age, Current Age Patient identity Identifies the client and links HTS data to reception, lab, and counselling history. The Excel source defines General ID/Fuchia ID and registration/current age as shared EMR variables.
Data format: General ID: number, length 10/11/12. Gender: Male/Female. Register Year: YYYY. Age: number; month: 1-11.
Counselling Date, Counselor, Pre, Post Visit context Date and staff responsible for the HTS counselling contact. Pre and Post show whether pre-test and post-test counselling were provided.
Data format: Date: DD-MM-YYYY in export. Counselor: staff name/text. Pre/Post: Yes/No-style service flags.
Service Modality, Mode of Entry, New_Old, Test Location Service classification Classifies where and how the client entered HTS. Use these fields for service-delivery reporting and to separate new and returning HTS clients.
Data format: Select/list values from the HTS form. New_Old supports New/Old and imported coded forms such as 1/N for new and 0/R for old.
Main Risk, Sub Risk Risk classification Client risk group. Use the Excel code-book categories, such as TB Patient, FSW, MSM, TGW, PWID, PWUD, partner groups, pregnant mother, exposed children, youth, and other low-risk categories.
Data format: Coded/list value. Format reference: Code Book sheet for Main Risk and Sub Risk.
HIV Test Date, HIV Test Determine, HIV Test UNI, HIV Test STAT, HIV Final Result HIV testing Records the HIV testing algorithm and final interpretation. Use Final Result for reporting; the individual test columns explain the testing path. The Excel code book includes result values such as reactive/non-reactive/invalid and positive/negative/inconclusive/nil.
Data format: Date: DD-MM-YYYY in export. Test results: Reactive, Non Reactive, Invalid. Final result: Positive, Negative, Inconclusive, Nil/blank when not done.
Syphillis Test Date, Syphillis RDT, Syphillis RPR, Syphillis VDRL, HepB/C Test Date, Hepatitis B, Hepatitis C, Request MD Linked lab tests Related STI/hepatitis results and requesting doctor, usually linked from lab data. These fields support complete HTS-linked screening review.
Data format: Date: DD-MM-YYYY in export. Syphilis RDT: Reactive/Non Reactive. RPR/VDRL/Hepatitis: Positive/Negative-style result values. Request MD: staff name/text.

TB Register

Field Where It Appears How Users Should Understand It
General ID, Fuchia ID, TB Code / Township TB Reg Number, State/Region Name, Township Name, Facility Name, Reporting Period TB identity Identifies the TB register record and the reporting unit. TB Code is the township TB register number used for TB tracking.
Data format: General ID: number, length 10/11/12. TB Code: text/number from township register. State/Township/Facility: text/list. Reporting Period: 1st, 2nd, 3rd, or 4th Qtr.
Treatment Registar Date, Nationality, Sex, Reg Year, Register Age, Current Age Patient context Demographic and time context for the TB record. Registration/current age should match the shared EMR interpretation from the Excel dictionary.
Data format: Date: DD-MM-YYYY in export. Nationality: N/NN. Sex: Male/Female. Reg Year: YYYY. Age: number; month: 1-11.
Refered from, Type of Patient's, Type of Disease, Specify Site of EPTB, Transfer in, Treatment Regimens Case classification Defines TB case type, referral source, disease site, transfer-in status, and regimen. Complete EPTB site when the case is extra-pulmonary.
Data format: Select/list values from TB03 form. Transfer in: Y/N. EPTB Site: text/list required when disease type is EPTB.
Treatment Start Date, Smoking Status, DM Status, HIV Status, CPT Start Date, ART Start Date Clinical status Clinical background and linked HIV/TB treatment dates. HIV Status should be interpreted with the Excel HIV status reference where coded values are used.
Data format: Dates: DD-MM-YYYY in export. Smoking/DM/HIV: selected status values. HIV status reference: Unknown, Known Negative, Known Positive, ART where coded.
Microscope Result, X-Ray Result, Xpert Result, Culture Result Baseline test results Initial diagnostic result set. The Excel code book gives common result encodings, including reactive/non-reactive/invalid and positive/negative/inconclusive/nil.
Data format: Result values from form/code book, commonly P/N or Positive/Negative, plus applicable blank/missing values.
2nd month, 3rd month, 5th month, End of Tx, 1st line DST result Follow-up test results Monitoring tests across treatment. They support bacteriological follow-up and should be updated at the correct treatment month.
Data format: Result values from form/code book, commonly P/N or Positive/Negative. Month fields should be filled only for the correct treatment follow-up point.
Treatment Outcome, Initial Regimen Started Date, Outcome Date, bacteriological/clinical, Consular Name, Remark Treatment outcome Final TB treatment status and interpretation basis. Outcome and outcome date should be completed when treatment status is known.
Data format: Outcome and bacteriological/clinical: selected list values. Dates: DD-MM-YYYY in export. Counsellor: staff name/text. Remark: free text.

IPT Register

Field Where It Appears How Users Should Understand It
Clinic Code, General ID, Clinic Reg No. (ART No.), Register Age, Current Age, Sex Patient identity Identifies the patient for IPT reporting. Export uses the patient registration context for age, sex, and clinic registration number.
Data format: General ID: number, length 10/11/12. Clinic/Fuchia ID: text. Age: number. Sex: Male/Female.
IPT Registration date, Really IPT Start date, IPT Discontinuation date IPT timeline Shows enrolment, real treatment start, and stop date. These dates are the core timeline for IPT completion or discontinuation review.
Data format: Date fields, exported as DD-MM-YYYY. Discontinuation date may be blank when IPT is continuing or completed without stopping.
Outcome, Remarks, Counsellor, 6H, 3HP Outcome and regimen Outcome values include Completed, Incomplete, and TB disease while on TPT. The 6H/3HP fields identify the preventive treatment regimen used.
Data format: Outcome select values: Completed, Incomplete, TB disease while on TPT. 6H/3HP: regimen flag/selection. Remark: free text. Counsellor: staff name/text.

Counselling Service

Field Where It Appears How Users Should Understand It
Clinic Code, Pid, FuchiaID, PrEP_ID, Gender, Reg Year, Register Age, Current Age Patient identity Identifies the counselling client and links the record to reception demographics. The Excel dictionary is the reference for shared General ID/Fuchia ID and age definitions.
Data format: General ID: number, length 10/11/12. Fuchia/PrEP ID: text. Gender: Male/Female. Reg Year: YYYY. Age: number; month: 1-11.
Main Risk, Sub Risk, Counselling Date, Counselor Risk and visit Defines client risk group, visit date, and responsible staff. Main Risk/Sub Risk should follow the Excel code book.
Data format: Main/Sub Risk: Code Book reference. Date: DD-MM-YYYY in export. Counselor: staff name/text.
HTS done, Reason, Status, Pre, Post HTS counselling status Shows whether HTS was completed and whether pre/post counselling occurred. Reason and Status explain incomplete or special HTS situations.
Data format: HTS done, Pre, Post: Yes/No-style service flags. Reason/Status: selected list or short explanatory text depending on the form choice.
PrEP, PrEP Status, C1, C2, C2_Done, C3, ADH, Stable PrEP and routine counselling Tracks PrEP-related counselling, standard counselling contacts, adherence work, and stable-client status.
Data format: Service flags and status values from the form. C1/C2/C3/ADH/Stable are Yes/No-style flags; PrEP Status is a selected status/list value.
<15 Disclosure, <15 Disclosure Define, <5 ADH Child/adolescent and disclosure Records child/adolescent disclosure and adherence counselling. Definition text should explain the disclosure situation when selected.
Data format: Disclosure/adherence: Yes/No-style flags. Define field: free text explanation.
OST, ART+TB, ART+TB Define, Only IPT, Only TB, Only TB_Define, ART+OST TB, IPT, and HIV care support Shows counselling support linked to OST/MMT, ART+TB, TB-only, IPT-only, and ART+OST services. Definition fields add needed clinical or service details.
Data format: Service flags: Yes/No-style values. Define fields: free text. OST/MMT and ART/TB/IPT support values come from the counselling form selections.
NCD, ANC, PFA, PHQ9, PHQ9_Define, Other, EAC, FHT, C P case, PMTCT, Case_Presention Other counselling services Additional counselling services and presentations. Fill definition fields when the selected service requires explanation for review or export.
Data format: Mostly Yes/No-style service flags. PHQ9_Define, Other, and Case Presentation: free text/detail fields.
PHQ4, GAD7, GAD7_Define, Brest Cancer, Hep C, D1, D2, D3, D4, CAGE Additional screening flags Screening flags recorded during counselling. Use the definition field to explain positive GAD7 screening or other flagged findings.
Data format: Screening flags: Yes/No-style values. Definition field: free text. CAGE/D1-D4: screening item flags or coded answers from counselling form.

Good Counsellor Practice

Do

  • Search and confirm the patient before entering any counsellor program data.
  • Use the correct date for each program: counselling date, TB treatment date, or IPT date.
  • Check required service, outcome, and follow-up fields before saving counsellor data.
  • Review history before updating HTS, counselling service, TB, or IPT records.

Be Careful

  • Do not create duplicate records when the patient already exists under another identifier.
  • Do not mix counselling-only visits with HTS entry when no HIV testing service was provided.
  • Do not save TB or IPT outcomes without confirming dates and patient identity.
  • Do not export before checking incomplete HTS and blank counselling, TB, or IPT outcome fields.
@endsection