Template Service 구성 가이드

Request (templateId + context + data)
  → fetch data-config.json sources  (FHIR / REST calls in parallel)
  → run compute.js  (receives resolved sources + request data, returns fields)
  → render template.html  (Nunjucks — uses {{ computed.* }}, {{ data.* }})
  → inline styles.css  (if present)
  → return HTML

print-templates/
├── templates.json              ← central registry of all templates
├── _i18n/
│   ├── en.json                 ← English translations
│   └── fr.json                 ← French translations (add more as needed)
├── _base/
│   ├── portrait.html           ← base layout for portrait pages
│   └── landscape.html          ← base layout for landscape pages
├── registration-card/
│   ├── template.html
│   ├── data-config.json
│   └── compute.js
└── prescriptions/
    ├── template.html
    ├── data-config.json
    ├── compute.js
    └── styles.css

{
  "templates": [
    {
      "id": "REG_CARD_V1",
      "name": "Registration Card",
      "folder": "registration-card"
    },
    {
      "id": "PRESCRIPTION_V1",
      "name": "Prescription",
      "folder": "prescriptions"
    }
  ]
}

{
  "sources": {
    "<sourceName>": {
      "api": "fhir" | "rest",
      "resource": "<path with {{contextVar}} placeholders>",
      "params": { "<key>": "<value>" | ["<value1>", "<value2>"] }
    }
  }
}

"_include": "MedicationRequest:encounter"
"_include": ["MedicationRequest:encounter", "MedicationRequest:medication"]

{
  "sources": {
    "patient": {
      "api": "fhir",
      "resource": "Patient",
      "params": { "_id": "{{patientUuid}}" }
    },
    "relatives": {
      "api": "fhir",
      "resource": "RelatedPerson",
      "params": { "patient": "{{patientUuid}}" }
    },
    "patientProfile": {
      "api": "rest",
      "resource": "/openmrs/ws/rest/v1/patientprofile/{{patientUuid}}",
      "params": { "v": "full" }
    },
    "medicationRequests": {
      "api": "fhir",
      "resource": "MedicationRequest",
      "params": {
        "patient": "{{patientUuid}}",
        "_include": ["MedicationRequest:encounter", "MedicationRequest:medication"],
        "_sort": "-_lastUpdated",
        "_count": "100"
      }
    }
  }
}

module.exports = {
  compute: async function ({ context, resolved, data, ValidationError, fhirPath, translate, locale }) {
    // validate required context
    if (!context?.patientUuid) throw new ValidationError('patientUuid is required');

    const patient = resolved?.patient?.entry?.[0]?.resource;

    // fhirPath — cleaner alternative to deep optional-chaining
    const patientName = fhirPath(patient, 'Patient.name.first().text') ?? '';
    const phone       = fhirPath(patient, "Patient.telecom.where(system='phone').value") ?? '';

    // use caller-supplied data if present
    const printedBy = data?.printedBy ?? '';

    // translate a key using the request locale
    const genderLabel = translate(patient?.gender ?? '');

    return { patientName, phone, printedBy, genderLabel };
  },
};

// produce a translated label based on a FHIR code
const gender = resolved?.patient?.entry?.[0]?.resource?.gender; // 'male' | 'female'
return {
  genderLabel: translate(gender),            // → 'Homme' when locale is 'fr'
  genderLabelEn: translate(gender, 'en'),    // → 'Male' always
};

{
  "sources": {
    "patient": { "api": "fhir", "resource": "Patient", "params": { "_id": "{{patientUuid}}" } }
  }
}

{# access nested fields directly #}
<p>{{ patient.entry[0].resource.name[0].text }}</p>
<p>{{ patient.entry[0].resource.birthDate }}</p>
<p>{{ patient.entry[0].resource.gender }}</p>

{# loop over bundle entries #}
{% for entry in patient.entry %}
  <p>{{ entry.resource.name[0].text }}</p>
{% endfor %}

{# use fhirpathEvaluate for complex expressions #}
<p>{{ patient | fhirpathEvaluate("Bundle.entry.first().resource.name.first().text") }}</p>

"patientProfile": {
  "api": "rest",
  "resource": "/openmrs/ws/rest/v1/patientprofile/{{patientUuid}}",
  "params": { "v": "full" }
}

<p>{{ patientProfile.patient.auditInfo.dateCreated | dateFormat }}</p>

{% extends "_base/landscape.html" %}

{% block title %}{{ 'REGISTRATION_CARD' | t }}{% endblock %}

{% block styles %}
  /* your custom CSS here */
{% endblock %}

{% block content %}
  <!-- your content here -->
{% endblock %}

{{ computed.patientName | default('Unknown') }}

{% if computed.photoUrl %}
  <img src="{{ computed.photoUrl }}" style="width: 20mm; height: 20mm;" />
{% endif %}

{% if data.showWatermark %}
  <div class="watermark">DRAFT</div>
{% endif %}

{% for drug in computed.medications %}
  <tr>
    <td>{{ drug.drugName }}</td>
    <td>{{ drug.dose | default('—') }}</td>
  </tr>
{% else %}
  <tr><td colspan="2">No medications.</td></tr>
{% endfor %}

{% for item in computed.items %}
  <p>{{ loop.index }}. {{ item.name }}</p>
{% endfor %}

{{ 'PATIENT_NAME' | t }}
{{ 'WEIGHT' | t('fr') }}               {# force French regardless of request locale #}
{{ 'NAME' | t }} / {{ 'NAME' | t('en') }}  {# bilingual label #}

{{ computed.patientId | barcode('code128', 40) }}

{{ computed.patientId | qrcode(80) }}

<td>
  {{ computed.patientId | default('') }}<br>
  {{ computed.patientId | qrcode(80) }}
</td>

{{ computed.registrationDate | dateFormat }}    {# → "05 May 2026" #}

{{ computed.birthDate | age }}    {# → "33 years" / "4 months" / "14 days" #}

{{ computed.bmi | round(1) }}    {# → "24.3" #}

{% for entry in patient.entry %}
  <td>{{ entry.resource | fhirpathEvaluate("Patient.name.first().text") }}</td>
{% endfor %}

{
  "PATIENT_NAME": "Patient Name",
  "AGE":          "Age",
  "GENDER":       "Gender",
  "REGISTRATION": "Registration No.",
  "DATED":        "Date"
}

{
  "sources": {
    "patient": {
      "api": "fhir",
      "resource": "Patient",
      "params": { "_id": "{{patientUuid}}" }
    },
    "relatives": {
      "api": "fhir",
      "resource": "RelatedPerson",
      "params": { "patient": "{{patientUuid}}" }
    },
    "patientProfile": {
      "api": "rest",
      "resource": "/openmrs/ws/rest/v1/patientprofile/{{patientUuid}}",
      "params": { "v": "full" }
    }
  }
}

module.exports = {
  compute: async function ({ context, data, resolved, ValidationError }) {
    const patient  = resolved?.patient?.entry?.[0]?.resource;
    const relative = resolved?.relatives?.entry?.[0]?.resource;
    const profile  = resolved?.patientProfile;

    const officialId = patient?.identifier?.find((id) => id.use === 'official');

    return {
      patientId:             officialId?.value ?? '',
      patientName:           patient?.name?.[0]?.text ?? '',
      birthDate:             patient?.birthDate ?? '',
      age:                   computeAge(patient?.birthDate),
      gender:                patient?.gender ?? '',
      phone:                 patient?.telecom?.find((t) => t.system === 'phone')?.value ?? '',
      address:               patient?.address?.[0]?.text ?? '',
      village:               patient?.address?.[0]?.city ?? '',
      tehsil:                patient?.address?.[0]?.district ?? '',
      registrationDate:      profile?.patient?.auditInfo?.dateCreated ?? '',
      nextOfKinName:         relative?.name?.[0]?.text ?? '',
      nextOfKinRelationship: relative?.relationship?.[0]?.text ?? '',
      photoUrl:              `/openmrs/ws/rest/v1/patientImage?patientUuid=${context.patientUuid}`,
    };
  },
};

function computeAge(birthDate) {
  if (!birthDate) return '';
  const birth  = new Date(birthDate);
  const now    = new Date();
  const days   = Math.floor((now - birth) / (1000 * 60 * 60 * 24));
  if (days < 30)   return `${days} days`;
  const months = Math.floor(days / 30.44);
  if (months < 12) return `${months} months`;
  return `${Math.floor(months / 12)} years`;
}

{% extends "_base/landscape.html" %}
{% block content %}
<table class="registrationCard-details">
  <tr>
    <td>{{ 'DATED' | t }} :</td>
    <td>{{ computed.registrationDate | dateFormat | default('') }}</td>
  </tr>
  <tr>
    <td>{{ 'REGISTRATION' | t }} :</td>
    <td>{{ computed.patientId | default('') }}</td>
  </tr>
  <tr>
    <td>{{ 'NAME' | t }} :</td>
    <td>{{ computed.patientName | default('') }}</td>
  </tr>
  <tr>
    <td>{{ 'AGE' | t }} :</td>
    <td>{{ computed.age | default('') }}</td>
  </tr>
  <tr>
    <td>{{ 'GENDER' | t }} :</td>
    <td>{{ computed.gender | upper | first | default('') }}</td>
  </tr>
  <tr>
    <td>{{ 'ADDRESS' | t }} :</td>
    <td>{{ computed.address | default('') }}</td>
  </tr>
  <tr>
    <td>{{ 'VILLAGE' | t }} :</td>
    <td>{{ computed.village | default('') }}</td>
  </tr>
  <tr>
    <td>{{ 'TEHSIL' | t }} :</td>
    <td>{{ computed.tehsil | default('') }}</td>
  </tr>
</table>
{% if computed.photoUrl %}
  <img src="{{ computed.photoUrl }}" style="width:20mm;height:20mm;"
       onerror="this.style.display='none'" />
{% endif %}
{% endblock %}

{
  "sources": {
    "patient": {
      "api": "fhir",
      "resource": "Patient",
      "params": { "_id": "{{patientUuid}}" }
    },
    "medicationRequests": {
      "api": "fhir",
      "resource": "MedicationRequest",
      "params": {
        "patient": "{{patientUuid}}",
        "_include": ["MedicationRequest:encounter", "MedicationRequest:medication"],
        "_sort": "-_lastUpdated",
        "_count": "100"
      }
    }
  }
}

module.exports = {
  compute: async function ({ context, resolved, data, ValidationError }) {
    if (!context?.patientUuid) throw new ValidationError('patientUuid is required');
    if (!context?.visitUuid)   throw new ValidationError('visitUuid is required');

    const patient    = resolved?.patient?.entry?.[0]?.resource;
    const officialId = patient?.identifier?.find((id) => id.use === 'official');

    const entries = resolved?.medicationRequests?.entry ?? [];
    const byType  = (type) => entries.filter(e => e.resource?.resourceType === type).map(e => e.resource);

    const encounterResources = byType('Encounter');
    const visitRef           = `Encounter/${context.visitUuid}`;
    const visitEncounterIds  = new Set(
      encounterResources
        .filter(enc => enc.partOf?.reference === visitRef)
        .map(enc => enc.id),
    );
    const encounterMap = new Map(encounterResources.map(e => [e.id, e]));

    const byEncounter = new Map();
    for (const mr of byType('MedicationRequest')) {
      const encId = mr.encounter?.reference?.split('/')?.[1] ?? '';
      if (!visitEncounterIds.has(encId)) continue;
      if (!byEncounter.has(encId)) byEncounter.set(encId, []);
      byEncounter.get(encId).push(mr);
    }

    const firstStart = [...byEncounter.keys()]
      .map(id => encounterMap.get(id)?.period?.start)
      .find(Boolean);

    const encounters = [...byEncounter.entries()].map(([encId, meds]) => ({
      doctorName: encounterMap.get(encId)?.participant?.[0]?.individual?.display ?? '',
      drugOrders: meds.map(mr => {
        const stopped = ['stopped', 'cancelled'].includes(mr.status);
        return {
          drugName:           mr.medicationCodeableConcept?.text ?? '',
          dosageInstructions: buildDosageInstructions(mr.dosageInstruction),
          startDate:          formatDate(mr.authoredOn ?? ''),
          stopped,
          stoppedDate:        stopped ? formatDate(mr.dispenseRequest?.validityPeriod?.end ?? '') : '',
          treatmentNotes:     mr.note?.[0]?.text ?? '',
        };
      }),
    }));

    return {
      patientName: patient?.name?.[0]?.text ?? '',
      patientId:   officialId?.value ?? '',
      age:         computeAge(patient?.birthDate),
      gender:      patient?.gender ?? '',
      village:     patient?.address?.[0]?.city ?? '',
      district:    patient?.address?.[0]?.district ?? '',
      visitDate:   firstStart ? formatDate(firstStart) : '',
      encounters,
    };
  },
};

function computeAge(birthDate) {
  if (!birthDate) return '';
  const days = Math.floor((new Date() - new Date(birthDate)) / (1000 * 60 * 60 * 24));
  if (days < 30)   return `${days} days`;
  const months = Math.floor(days / 30.44);
  if (months < 12) return `${months} months`;
  return `${Math.floor(months / 12)} years`;
}

function buildDosageInstructions(dosageInstruction) {
  const d = dosageInstruction?.[0];
  if (!d) return '';
  const parts = [];
  const doseQty = d.doseAndRate?.[0]?.doseQuantity;
  if (doseQty?.value != null) parts.push(`${doseQty.value} ${doseQty.unit ?? ''}`.trim());
  const frequency = d.timing?.code?.text;
  if (frequency) parts.push(frequency);
  if (d.asNeededBoolean) parts.push('SOS');
  const route = d.route?.text;
  if (route) parts.push(route);
  const repeat = d.timing?.repeat;
  if (repeat?.duration != null) return `${parts.join(', ')} - ${repeat.duration} ${durationLabel(repeat.durationUnit)}`;
  return parts.join(', ');
}

function durationLabel(code) {
  const map = { s: 'Second(s)', min: 'Minute(s)', h: 'Hour(s)', d: 'Day(s)', wk: 'Week(s)', mo: 'Month(s)', a: 'Year(s)' };
  return map[code] ?? code ?? '';
}

function formatDate(value) {
  if (!value) return '';
  try {
    const date = new Date(value);
    if (isNaN(date.getTime())) return '';
    return `${String(date.getDate()).padStart(2, '0')} ${date.toLocaleDateString('en', { month: 'long' })} ${date.getFullYear()}`;
  } catch { return ''; }
}

{
  "templateId": "PRESCRIPTION_V1",
  "locale": "en",
  "context": { "patientUuid": "...", "visitUuid": "..." },
  "data": {
    "printedBy": "Dr. Smith",
    "showWatermark": true
  }
}

compute: async function ({ context, resolved, data, ValidationError }) {
  return {
    printedBy: data?.printedBy ?? '',
    // ...
  };
}

{% if data.showWatermark %}<div class="watermark">DRAFT</div>{% endif %}
<p>Printed by: {{ data.printedBy | default('') }}</p>

curl -s -X POST http://localhost:8080/template-service/api/render \
  -H "Content-Type: application/json" \
  -H "Cookie: JSESSIONID=<your-session-id>" \
  -d '{
    "templateId": "REG_CARD_V1",
    "format": "html",
    "locale": "en",
    "context": { "patientUuid": "<real-patient-uuid>" }
  }' > /tmp/rendered.html && open /tmp/rendered.html

grep -c 'data:image/png;base64' /tmp/rendered.html   # barcode count
grep -c '<svg' /tmp/rendered.html                     # qrcode count

docker logs bahmni-standard-template-service-1 --tail 30

curl -s http://localhost:8080/template-service/api/templates | jq .

// Wrong
{ "sources": { ... }, "computed": { ... } }

// Correct
{ "sources": { ... } }

// Wrong
{ "api": "rest", "resource": "patientprofile/{{patientUuid}}" }

// Correct
{ "api": "rest", "resource": "/openmrs/ws/rest/v1/patientprofile/{{patientUuid}}" }

// Unsafe
const patient = resolved.patient.entry[0].resource;

// Safe
const patient = resolved?.patient?.entry?.[0]?.resource;

// Wrong
return ['a', 'b'];

// Correct
return { items: ['a', 'b'] };

<!-- Wrong: extra column gets pushed off the visible card area -->
<td>{{ computed.patientId }}</td>
<td>{{ computed.patientId | qrcode(80) }}</td>

<!-- Correct: inline in the same cell -->
<td>
  {{ computed.patientId | default('') }}<br>
  {{ computed.patientId | qrcode(80) }}
</td>

<!-- Wrong -->
{{ computed.patientId | barcode('qrcode', 80) }}

<!-- Correct -->
{{ computed.patientId | qrcode(80) }}             {# QR code (SVG) #}
{{ computed.patientId | barcode('code128', 40) }} {# traditional barcode (PNG) #}

// Wrong — causes a 500 instead of 400
throw new Error('visitUuid is required');

// Correct
throw new ValidationError('visitUuid is required');

{
  "templateId": "PRESCRIPTION_V1",
  "format": "html",
  "locale": "en",
  "context": {
    "patientUuid": "ae94ad73-ac02-42ab-aa04-fe658fb7c091",
    "visitUuid": "14ee47a3-b093-4e0e-b718-d68fcf2666ab"
  },
  "data": {
    "printedBy": "Dr. Smith"
  }
}