Backend

What Backend Owns

Backend Repos

• livehealthapp: Contains model definitions, serializers, views, and URL configurations for Organism, Antibiotic, OrganismAntibiotics, and MolecularOrganismAntibiotics.
• crelio-app: Shares the core logic for report submission, organism/antibiotic caching, and microbiology report component processing for multi-centre use cases.

Core Backend Models

Organism

Table: Organism

Source: livehealthapp/reporting/models/organism.py

After save: Clears caches for the specific organism and the organism list. Model hooks: save_molecular_antibiotic_mappings handles the ordered Molecular tabs list on organism save.

Antibiotic

Table: Antibiotic

Source: livehealthapp/reporting/models/antibiotic.py

After save: Clears caches for the specific antibiotic and the list.

OrganismAntibiotics

Table: OrganismAntibiotics

Source: livehealthapp/reporting/models/organism_antibiotics.py

Bulk create (OrganismAntibiotics.bulk_create):

• Deletes all existing mappings matching the filters dict (e.g. \{"organism_id": self.pk\}).
• Re-creates all passed instances; validates each before save.
• Used during Organism.after_save(...) to replace the full antibiogram in a single atomic block.

MolecularOrganismAntibiotics

Table: MolecularOrganismAntibiotics

Source: livehealthapp/reporting/models/molecular_organism_antibiotics.py

Payload Reference

Organism Create/Update Payload

When creating or updating an organism, the frontend sends the mapping lists inside the organism payload:

{
  "name": "Escherichia coli",
  "category": "Bacteria",
  "code": "ECOLI",
  "sample_type": "blood",
  "antibiotic_mappings": [
    {
      "antibiotic_id": 42,
      "antibiotic_name": "Ciprofloxacin",
      "resistance_diameter_upper": 12,
      "resistance_diameter_lower": 0,
      "intermediate_diameter_upper": 19,
      "intermediate_diameter_lower": 13,
      "sensitive_diameter_upper": 40,
      "sensitive_diameter_lower": 20,
      "resistance_mic_upper": 8,
      "resistance_mic_lower": 0,
      "intermediate_mic_upper": 4,
      "intermediate_mic_lower": 2,
      "sensitive_mic_upper": 1,
      "sensitive_mic_lower": 0
    }
  ],
  "molecular_organism_antibiotics": [
    {
      "antibiotic_id": 42,
      "sequence": 1,
      "is_active": true
    }
  ]
}

API Endpoints

Organism Endpoints

Antibiotic Endpoints

Backend Data Flow for Microbiology Report Entry

1. Report entry values are submitted via the standard report submission API.
2. The payload contains an array of distinct objects for each organism and its matched antibiotics under the MICROBIOLOGY parameter type.
3. The MicrobiologyComponent proxy evaluates these records, builds the result, and stores it in the ReportData payload using standard structure.
4. The frontend performs all the intermediate/sensitive/resistant text derivation on the client side, then submits the final calculated values in the text fields (result_2).

Source File Reference