Build the application

## Build
Inspect research observation payloads against FHIR R5 StructureDefinition rules. Validate sequence annotation properties and generate conformance scorecards for multi-center registries.

## User
Health Informatics Specialist

## Workflow
1. Ingest FHIR JSON resources representing molecular and genomic observations.
2. Validate required element cardinality and terminology bindings against FHIR R5 specifications.
3. Detect missing data types, invalid code systems, or malformed narrative sections.
4. Produce an interoperability audit report with remediation instructions.

## Interface
Interactive browser portal presenting conformance issues with interactive schema diffs.

## Data
Create synthetic FHIR Observation and DiagnosticReport JSON documents containing both valid and intentionally invalid elements.
Starter examples below are synthetic. They are not downloaded records.

## Source
[HL7 FHIR overview](https://hl7.org/fhir/overview.html)
Adopts FHIR StructureDefinition rules governing element optionality, cardinality, datatypes, and narrative metadata.

## Tools
dspy, pydantic, fastapi.
DSPy compiles robust prompt programs to inspect ambiguous JSON conformance violations and generate structured fix instructions.
Local or hosted LLM with prompt evaluation support for strict validation rule synthesis.

## Deliverables
Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

## Acceptance
- Flags missing mandatory FHIR metadata elements including status and code.
- Verifies compliance with StructureDefinition cardinality constraints.
- Emits machine-readable validation scorecards and suggested corrections.

## Starter Examples
```json
[
  {
    "input": {
      "resourceType": "Observation",
      "id": "obs-001",
      "status": "final",
      "code": {
        "coding": [
          {
            "system": "http://loinc.org",
            "code": "48018-6"
          }
        ]
      }
    },
    "expected_output": {
      "valid": true,
      "errors": [],
      "conformance_score": 1,
      "human_review_required": false
    }
  },
  {
    "input": {
      "resourceType": "Observation",
      "id": "obs-002",
      "code": {}
    },
    "expected_output": {
      "valid": false,
      "errors": [
        "Missing required field: status",
        "Coding array is empty in code attribute"
      ],
      "conformance_score": 0.33,
      "human_review_required": true
    }
  }
]
```

## Safety
Research informatics conformance verification tool without live clinical EHR connections.
Use mock external writes. Require human review before any real deployment.