fhir-migration

majiayu000 的头像作者 majiayu000

将患者/执业者存储迁移至HAPI FHIR。当用户请求实施FHIR混合架构、创建FHIR映射器或与HAPI FHIR集成时使用。

📖 中文导读:将患者/执业者存储迁移至HAPI FHIR。当用户请求实施FHIR混合架构、创建FHIR映射器或与HAPI FHIR集成时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: fhir-migration description: Migration du stockage Patient/Practitioner vers HAPI FHIR. Utiliser quand l'utilisateur demande d'implémenter l'architecture hybride FHIR, créer des mappers FHIR, ou intégrer avec HAPI FHIR. allowed-tools: Read, Glob, Grep, Edit, Write, Bash(poetry:), Bash(git:)

Migration HAPI FHIR - core-africare-identity

Ce skill guide la migration du service core-africare-identity vers une architecture hybride avec HAPI FHIR comme source de vérité pour les données démographiques.

Architecture Cible

Client → API (Pydantic) → Service Layer → HAPI FHIR (Patient/Practitioner)
                               ↓
                      PostgreSQL (métadonnées GDPR)
  • HAPI FHIR: Source de vérité pour données démographiques (Patient, Practitioner)
  • PostgreSQL: Métadonnées GDPR locales (soft_deleted_at, correlation_hash, etc.)
  • Keycloak: Authentification et gestion des utilisateurs

Composants à Implémenter

1. Infrastructure FHIR

Fichier Description
app/infrastructure/fhir/__init__.py Exports du module
app/infrastructure/fhir/client.py Client HTTP async pour HAPI FHIR
app/infrastructure/fhir/config.py Configuration FHIR (URL, timeout)
app/infrastructure/fhir/identifiers.py Systèmes d'identifiants FHIR
app/infrastructure/fhir/exceptions.py Exceptions FHIR typées

Voir CLIENT-SETUP.md pour les détails d'implémentation.

2. Mappers Pydantic ↔ FHIR

Fichier Description
app/infrastructure/fhir/mappers/__init__.py Exports des mappers
app/infrastructure/fhir/mappers/patient_mapper.py PatientCreate ↔ FHIR Patient
app/infrastructure/fhir/mappers/professional_mapper.py ProfessionalCreate ↔ FHIR Practitioner

Voir MAPPERS.md pour les templates de mappers.

3. Modèles GDPR Locaux

Fichier Description
app/models/gdpr_metadata.py PatientGdprMetadata, ProfessionalGdprMetadata

Voir GDPR-MODELS.md pour les modèles SQLAlchemy.

4. Service Layer Orchestration

Modifier les services existants pour orchestrer HAPI FHIR + PostgreSQL.

Voir SERVICE-LAYER.md pour le pattern d'orchestration.

Workflow de Migration

Phase 1: Infrastructure (Prérequis)

# 1. Ajouter dépendances
poetry add "fhir.resources>=7.0.0" "httpx>=0.27.0"

# 2. Créer structure répertoires
mkdir -p app/infrastructure/fhir/mappers
touch app/infrastructure/fhir/__init__.py
touch app/infrastructure/fhir/mappers/__init__.py

Phase 2: Client FHIR

  1. Créer app/infrastructure/fhir/config.py - Configuration
  2. Créer app/infrastructure/fhir/identifiers.py - Systèmes d'identifiants
  3. Créer app/infrastructure/fhir/exceptions.py - Exceptions
  4. Créer app/infrastructure/fhir/client.py - Client HTTP async

Phase 3: Mappers

  1. Créer app/infrastructure/fhir/mappers/patient_mapper.py
  2. Créer app/infrastructure/fhir/mappers/professional_mapper.py
  3. Ajouter tests dans tests/unit/test_fhir_mappers.py

Phase 4: Modèles GDPR

  1. Créer app/models/gdpr_metadata.py avec PatientGdprMetadata
  2. Créer migration Alembic: make migrate MESSAGE="Add GDPR metadata tables"
  3. Appliquer migration: make migrate-up

Phase 5: Orchestration Services

  1. Modifier app/services/patient_service.py pour utiliser FHIR + PostgreSQL
  2. Modifier app/services/professional_service.py
  3. Mettre à jour les endpoints API

Phase 6: Suppression Legacy

  1. Marquer tables patients/professionals comme deprecated
  2. Créer migration de suppression
  3. Nettoyer les imports

Variables d'Environnement

# HAPI FHIR
HAPI_FHIR_BASE_URL=http://localhost:8090/fhir
HAPI_FHIR_TIMEOUT=30

# Optionnel: Auth FHIR
HAPI_FHIR_AUTH_TOKEN=

Tests

# Tests unitaires mappers
poetry run pytest tests/unit/test_fhir_mappers.py -v

# Tests intégration FHIR (nécessite HAPI FHIR local)
make test-services-up
poetry run pytest tests/integration/test_fhir_client.py -v
make test-services-down

Ressources

Checklist Migration

  • Dépendances installées (fhir.resources, httpx)
  • Client FHIR créé et testé
  • Mappers Patient et Professional créés
  • Modèles GDPR créés avec migration
  • Services refactorisés pour orchestration
  • Tests unitaires et intégration passent
  • Tables legacy supprimées
  • Documentation mise à jour