Skip to content

AGENTS.md

Latest commit

 

History

History
60 lines (46 loc) · 2.09 KB

AGENTS.md

File metadata and controls

60 lines (46 loc) · 2.09 KB
Raw

AGENTS.md — aiscream-jpa

Operations

Restart normally (preserves data)

docker compose down && docker compose up -d

Restart fresh (wipes database, clean slate)

Avoid doing this unless you are on a repeated error, or if the changes necessitate starting from scratch

docker compose down -v && rm -rf hapi.postgress.data && docker compose up -d

Debugging

Check Docker logs

docker compose logs --tail=2000 | grep -i "error\|exception\|FAILED\"

Verify remote terminology service

# Check if tx.fhirlab.net has a CodeSystem
curl -s "https://tx.fhirlab.net/fhir/CodeSystem?url=<CODESYSTEM_URL>" | python3 -m json.tool

# List all CodeSystems
curl -s "https://tx.fhirlab.net/fhir/CodeSystem?_count=5&_summary=true" | python3 -m json.tool

# Delete a resource from tx.fhirlab.net
curl -s -X DELETE "https://tx.fhirlab.net/fhir/CodeSystem/<ID>" -H "Content-Type: application/fhir+json"

Test local FHIR server

curl -s http://localhost:8080/fhir/metadata | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('software',{}).get('name'), d.get('software',{}).get('version'))"

Configuration lookups

HAPI FHIR JPA starter — reference application.yaml

Always check the canonical starter config for property structure:

https://raw.githubusercontent.com/hapifhir/hapi-fhir-jpaserver-starter/refs/heads/master/src/main/resources/application.yaml

Consider gh cli to navigate.

HAPI FHIR docs

  • Root: https://hapifhir.io/hapi-fhir/docs/
  • JPA config: https://hapifhir.io/hapi-fhir/docs/server_jpa/configuration.html
  • Lucene/Elasticsearch: https://hapifhir.io/hapi-fhir/docs/server_jpa/elastic.html
  • Terminology: https://hapifhir.io/hapi-fhir/docs/server_jpa/terminology.html
  • Validation support: https://hapifhir.io/hapi-fhir/docs/validation/validation_support_modules.html
  • Package registry: https://hapifhir.io/hapi-fhir/docs/server_jpa/packages.html

GitHub repos (use gh CLI or raw.githubusercontent.com)

  • HAPI FHIR core: hapifhir/hapi-fhir
  • HAPI JPA starter: hapifhir/hapi-fhir-jpaserver-starter