Integration des Menages au RSU

Ce guide explique comment integrer les menages collectes dans le pool du Registre Social Unifie.

Processus d'integration

┌─────────────────────────────────────────────────────────────────────────────┐
│                         FLUX D'INTEGRATION                                   │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  1. COLLECTE              2. STAGING              3. INTEGRATION             │
│  ┌──────────────┐        ┌──────────────┐        ┌──────────────┐           │
│  │ Kobo/SuSo/   │  ──►   │ MenageCollecte│  ──►  │   Menage     │           │
│  │ Excel/API    │        │ (brouillon)  │        │ (integre_rsu)│           │
│  └──────────────┘        └──────────────┘        └──────────────┘           │
│                                │                        │                    │
│                                ▼                        ▼                    │
│                          Validation             ID RSU genere                │
│                          + Qualite              GW-20260731-000001           │
│                                                                              │
└─────────────────────────────────────────────────────────────────────────────┘

Etape 1 : Donnees collectees (MenageCollecte)

Les donnees arrivent dans la table de staging MenageCollecte depuis plusieurs sources :

Source	Description
kobo	Formulaires KoboToolbox
survey_solutions	Survey Solutions (SUSO)
excel	Import fichier Excel
api	Integration API externe
manual	Saisie manuelle

Structure MenageCollecte

Champ	Description
codeTemporaire	Code provisoire de l'organisation (ex: ORG-2024-001)
donneesJson	Donnees brutes au format JSON
source	Origine des donnees
statut	Statut de validation
scoreQualite	Score de qualite des donnees (0-100)
alertesQualite	Liste des problemes detectes
doublon	Indicateur de doublon potentiel

Statuts MenageCollecte

Statut	Description
brouillon	Donnees recues, en attente de validation
en_validation	En cours de verification qualite
valide	Pret pour integration
integre	Integre au pool RSU (lie a Menage)
rejete	Rejete pour probleme qualite

Etape 2 : Validation qualite

Avant integration, les donnees sont verifiees :

Controles automatiques

Controle	Description
Completude	Champs obligatoires remplis
Coherence	Donnees logiquement coherentes
Doublons	Detection de menages similaires
Geolocalisation	Coordonnees GPS valides
Telephone	Format numero valide

Alertes qualite

{
  "alertes": [
    {"type": "completude", "champ": "telephone", "message": "Telephone manquant"},
    {"type": "doublon", "match": "GW-20260715-000123", "score": 85}
  ]
}

Etape 3 : Integration

Integration unitaire

1. Acceder a RSU > Menages en attente
2. Selectionner un menage valide
3. Verifier les informations
4. Cliquer sur Integrer au RSU

Integration en lot

1. Acceder a RSU > Menages en attente
2. Filtrer par statut valide
3. Selectionner plusieurs menages
4. Cliquer sur Integration en lot

Resultat de l'integration

Apres integration, le systeme :

1. Genere l'identifiant RSU : GW-20260731-000001
2. Cree le Menage dans le pool RSU
3. Met a jour le statut : integre
4. Lie MenageCollecte au Menage

Detection des doublons

Le systeme detecte les doublons potentiels sur plusieurs criteres :

Critere	Poids
Telephone identique	100% (doublon certain)
Nom + Date naissance	90%
Geolocalisation < 50m	80%
Nom similaire (Levenshtein)	60-80%

Gestion des doublons

Quand un doublon est detecte :

1. Alerte affichee avec le menage existant
2. Options disponibles :
   • Fusionner avec l'existant
   • Ignorer et integrer quand meme
   • Rejeter le nouveau

Identifiants RSU

Format

GW-YYYYMMDD-XXXXXX

GW       = Code pays (Guinee-Bissau)
YYYYMMDD = Date d'integration (20260731)
XXXXXX   = Sequence numerique (000001)

Caracteristiques

• Unique : Garanti unique dans le systeme
• Permanent : Ne change jamais apres attribution
• Tracable : Permet de retrouver la date d'integration

API Integration

Integrer un menage

POST /api/rsu/integrate/{collecteId}

Reponse :

{
  "success": true,
  "data": {
    "menageId": "550e8400-e29b-41d4-a716-446655440000",
    "identifiantRsu": "GW-20260731-000001",
    "message": "Menage integre avec succes"
  }
}

Integration en lot

POST /api/rsu/bulk-integrate

Corps de la requete :

{
  "collecteIds": [
    "550e8400-e29b-41d4-a716-446655440001",
    "550e8400-e29b-41d4-a716-446655440002"
  ]
}

Reponse :

{
  "success": true,
  "data": {
    "total": 2,
    "integres": 2,
    "erreurs": 0,
    "details": [
      {"collecteId": "...", "identifiantRsu": "GW-20260731-000001"},
      {"collecteId": "...", "identifiantRsu": "GW-20260731-000002"}
    ]
  }
}

Bonnes pratiques

:::tip Recommandations

1. Validez avant d'integrer : Assurez-vous que les donnees sont completes
2. Traitez les doublons : Ne les ignorez pas systematiquement
3. Integration par lots : Plus efficace pour de grands volumes
4. Tracabilite : Conservez le lien avec MenageCollecte :::

Permissions requises

Action	Permission
Voir les menages en attente	rsu.view
Integrer un menage	rsu.integrate
Integration en lot	rsu.integrate.bulk
Gerer les doublons	rsu.duplicates