Sovereign OS DIM - Station PMSI

Application desktop pour la station DIM du GHT Psy Sud Paris (Fondation Vallée

• Paul Guiraud, FINESS 940140049). Traite les fichiers ATIH PMSI, résout les collisions d'identito-vigilance, produit les exports e-PMSI. 100 % local, RGPD-safe, aucune donnée patient n'est transmise.

Architecture

flowchart TB
    UI["Frontend WebView2<br/>frontend/ - HTML - Tailwind - Chart.js"]
    HOST["Hôte desktop<br/>main.py pywebview - .exe C# .NET 8"]
    BR["Bridge<br/>backend/bridge.py - REST 127.0.0.1 - token Bearer"]
    API["backend/api.py<br/>FastAPI - endpoints métier"]
    PROC["data_processor - structure<br/>parsing 23 formats ATIH - MPI"]
    AUDIT["audit - workflow<br/>preflight DRUIDES - 15 validateurs"]
    ML["backend/ml/<br/>XGBoost - LightGBM - 3 modèles"]
    DB["SQLite<br/>Master Patient Index - persistance"]
    PHP["php/<br/>SovereignClient - dashboards BIQuery"]

    UI --> HOST --> BR --> API
    API --> PROC --> DB
    API --> AUDIT
    API --> ML
    PHP --> BR

Loading

Fonctionnalités

• 23 formats ATIH - PSY (RPS, RAA, RPSA, R3A, EDGAR, FICHSUP-PSY…), MCO (RSS, RSFA, RSFB, RSFC), SSR/SMR (RHS, SSRHA, RAPSS), HAD (RPSS, RAPSS-HAD), transversal (VID-HOSP, ANO-HOSP).
• Master Patient Index - croisement IPP/DDN, persistance SQLite, reprise batch interrompu.
• Identitovigilance - détection collisions, résolution automatique par fréquence majoritaire ou manuelle.
• Preflight DRUIDES - 15 validateurs avant upload e-PMSI - FINESS, IPP, DDN, CIM-10, mode légal, secteur ARS, chaînage, duplicatas, orphelins.
• CimSuggester IA - suggestion de code CIM-10 quand le DP est absent - fournisseur LLM configurable (API cloud ou Ollama local).
• Module ML XGBoost (V36) - 3 modèles entraînés sur dataset synthétique ATIH 2000-2026 (PSY ~80 %) - format_detector (58 classes, acc 0.77), collision_risk (AUC 1.0), ddn_validity (AUC 0.86). Benchmark 4 algos par tâche (XGB default + tuned, LightGBM, RF), garde le meilleur. Voir backend/ml/.
• Structure polaire - arborescence Pôle/Secteur/UM avec organigramme vectoriel + export PDF multi-pages.
• Analyse d'activité par UM (V35) - drop-zone HTML5 accessible clavier, parsing RPS/RAA asynchrone en chunks 5000 lignes, détection des UM dormantes, export CSV UTF-8 BOM, badges rouges clignotants sur l'arbre.
• Dashboard Live - 4 graphiques Chart.js + 6 KPI dérivés du MPI, export PDF paysage.
• Inspector Terminal - décomposition ligne par ligne avec 15 validations, pseudonymisation auto.
• Bridge HTTP REST - endpoints sécurisés 127.0.0.1 + token Bearer pour intégration PHP.
• Export PDF - organigrammes, rapports preflight, dashboards BIQuery (HTML→PDF).
• Guide utilisateur (V36) - Sovereign_OS_DIM_Guide.pdf (38 pages, polices Unicode, orientation métier, page Roadmap, références ATIH/ARS vérifiées).

Formats ATIH supportés

Champ	Formats	Depuis
PSY	RPS, RAA, RPSA, R3A, FICHSUP-PSY, EDGAR, FICUM-PSY, RSF-ACE-PSY	2007
MCO	RSS/RUM, RSFA, RSFB, RSFC	1991
SSR/SMR	RHS, SSRHA, RAPSS, FICHCOMP-SMR	2003
HAD	RPSS, RAPSS-HAD, FICHCOMP-HAD, SSRHA-HAD	2005
Transversal	VID-HOSP, ANO-HOSP, FICHCOMP	2009

Installation

Version portable (recommandée)

Double-cliquez sur SovereignOS.Desktop.exe. Aucune installation, aucun droit administrateur requis.

Version code source

git clone https://github.com/Adam-Blf/sovereign_os_dim.git
cd sovereign_os_dim
python -m venv .venv
.venv/Scripts/activate
pip install -r requirements.txt
python main.py

Build d'un exe portable

python build.py

Tests

# Python - 233 tests unitaires + intégration
python -m pytest tests/ -q

# Frontend - 30 tests Node.js (helpers JS sans navigateur)
node tests/frontend/test_activity_analysis.mjs

Couverture - identification des 23 formats ATIH, validation ligne par ligne, normalisation IPP (cohérence BIQuery 2022-2025), auto-détection des variantes 2021, collisions MPI et résolution, exports CSV et .txt, parser de structure client-side, détection des UM sans activité.

Développement

Commandes courantes pour contribuer au projet -

# Lint (config dans pyproject.toml - rules E/W/F)
ruff check backend/ tests/ tools/ scripts/

# Auto-fix (imports unused, trailing whitespace, etc.)
ruff check backend/ tests/ tools/ scripts/ --fix

# Format check
ruff format backend/ tests/ tools/ scripts/ --check

# Security scan
python -m bandit -r backend/ -ll

# CVE audit sur les dépendances
pip-audit -r requirements.txt

# Smoke test backend sur un vrai lot ATIH (nécessite D:/Adam/ monté)
python scripts/analyze_real_data.py

# Rebuild .exe C# (nécessite .NET 8 SDK, source dans dev/hospitalier/SovereignOS.DIM.CSharp)
dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true

Toutes ces commandes tournent aussi dans la CI GitHub Actions à chaque push sur main et PR. Config partagée - pyproject.toml pour ruff/pytest, .github/workflows/test.yml pour les 4 jobs parallèles (python, frontend, deps, lint).

Raccourcis clavier

Touche	Action
Ctrl+1	Dashboard
Ctrl+2	Modo Files
Ctrl+3	Identitovigilance
Ctrl+4	PMSI Pilot CSV
Ctrl+5	Import CSV
Ctrl+6	Structure - arborescence + analyse activité UM
Ctrl+7	Tutoriel
F1	Manuel HTML
F2	Inspector Terminal
F3	Preflight DRUIDES
F4	Dashboard Live

Architecture

sovereign_os_dim/
├── main.py                 - Point d'entrée pywebview (desktop)
├── bridge.py               - Point d'entrée bridge HTTP (PHP)
├── backend/
│   ├── api.py              - API exposée au frontend
│   ├── bridge.py           - Serveur Flask REST
│   ├── data_processor.py   - Moteur ATIH (scan, MPI, export)
│   └── structure.py        - Parser CSV/TSV + organigramme PDF
├── frontend/
│   ├── index.html
│   ├── css/style.css
│   └── js/
│       ├── app.js          - Logique principale + structure parser JS
│       ├── bridge-shim.js  - Adapter C#/pywebview
│       ├── preflight-view.js
│       ├── dashboard-live.js
│       ├── htmlpdf-view.js
│       └── tuto-overlay.js
├── backend/ml/                - Module ML XGBoost (V36)
│   ├── synthetic.py           - Générateur dataset ATIH 2000-2026
│   ├── parse_atih_specs.py    - Parser des Excel ATIH 2026 officiels
│   ├── extract_safe_features.py - Extracteur SAFE (zéro PII en sortie)
│   ├── train.py               - Pipeline d'entraînement multi-modèles
│   ├── predict.py             - Inference (auto-détecte XGB / LGBM / RF)
│   ├── data/                  - Datasets - synthétique + atih_specs_2026
│   └── models/                - Modèles entraînés (.json / .pkl / .lgbm.txt)
├── docs/research/             - Dossier de recherche vérifié (ATIH/ARS/PMSI)
│   ├── atih.md
│   ├── ars_idf_dim.md
│   ├── pmsi_formats_history.md
│   └── dim_business_value.md
├── tools/
│   ├── generate_manual.py     - PDF mode d'emploi court (utilisateurs)
│   ├── generate_guide.py      - PDF guide métier 38 pages (TIM, médecin DIM, chef de pôle)
│   ├── generate_guide_dev.py  - PDF guide développeur (DSI, contributeurs)
│   └── capture_screenshots.py - Playwright headless
├── tests/
│   ├── test_data_processor.py - 233 tests Python
│   └── frontend/
│       └── test_activity_analysis.mjs - 30 tests JS
├── Sovereign_OS_DIM_Guide.pdf     - Guide métier (TIM, médecin DIM, chef de pôle)
├── Sovereign_OS_DIM_Guide_Dev.pdf - Guide développeur (DSI, contributeurs)
└── README.md

Stack technique

Couche	Techno
Desktop	Python 3.12 + pywebview, ou C# .NET 8 + WebView2
Frontend	HTML + Tailwind CDN + Chart.js + anime.js + Lucide
Bridge HTTP	Flask (Python) ou ASP.NET Core (C#)
Persistance	SQLite (Microsoft.Data.Sqlite pour le port C#)
PDF	fpdf2 (Unicode Segoe UI / DejaVu, fallback latin-1)
Parser ATIH	Regex positionnel largeur fixe, lecture latin-1
ML	XGBoost + LightGBM + scikit-learn (RF) + pandas + pyarrow
Tests	pytest (Python), Node.js native (JS)
Build	PyInstaller (python build.py) ou dotnet publish

Sécurité et RGPD

• 100 % local - aucun envoi externe, aucune télémétrie.
• Bridge HTTP - binding uniquement 127.0.0.1, token Bearer obligatoire, CORS restrictif.
• Anonymisation - k-anonymity (k≥5) pour les exports recherche.
• Audit log art. 30 RGPD - chaque traitement horodaté.
• Pseudonymisation IPP - optionnelle pour rapports non-nominatifs.
• Bandit - 0 issue sur 2457 lignes backend.

Version distribuée

Le bundle C# prêt à livrer vit dans D:\SovereignOS_DIM_CSharp\ - SovereignOS.Desktop.exe (97 Mo), frontend/ (patchs sécurité inclus), Sovereign_OS_DIM_Guide.pdf (guide métier), Sovereign_OS_DIM_Guide_Dev.pdf (guide dev), LISEZ-MOI.txt, LICENCE.txt, VERSION, CHECKSUMS.sha256. Total 140 Mo.

Roadmap V37+

8 modules métier proposés en discussion avec l'équipe DIM (détail page 12 du guide PDF) -

1. Sentinel ARS - prédicteur de rejet DRUIDES avant upload
2. CimSuggester live - IA de codage CIM-10 dans l'UI
3. Cockpit chef DIM - tableau de bord exécutif mensuel
4. Audit DRUIDES temps réel - alerte instantanée sur rejet
5. CeSPA / CATTG validator - conformité réforme 4 juillet 2025
6. Sentinel INS - qualité INS Ségur
7. Connecteur SNDS local - pseudonymisation auto + k ≥ 5
8. Hospital Twin - simulation impact tarifaire DFA

Références ATIH et ARS

• ATIH - 117 boulevard Marius-Vivier-Merle, 69003 Lyon - DG Nathalie Fourcade (depuis 6 jan. 2025) - plateforme e-PMSI - notice technique ATIH-294-9-2025
• ARS Île-de-France - Immeuble Le Curve, 13 rue du Landy, 93200 Saint-Denis - DG Denis Robin (depuis 10 avril 2024) - délégation départementale 94 à Créteil - Datalogue
• GHT Psy Sud Paris - convention validée par ARS IDF le 1er juillet 2016 - Fondation Vallée + Paul Guiraud - 100 % psy - 1,3 M habitants - 37 000 patients en file active - 741 lits - 260 M€ budget
• DRUIDES PSY - M1 2025 (test décembre 2024 - janvier 2025) - remplace PIVOINE ex-DGF + ex-OQN + VisualQUALITE - MAGIC v5.12.0.0 reste obligatoire pour anonymisation
• Réforme PSY 4 juillet 2025 - création CeSPA + CATTG - suppression CATTP + ateliers thérapeutiques - 3 modes (temps complet, temps partiel, ambulatoire avec modalité 33 soins à domicile)

Détail complet et URLs vérifiées dans docs/research/atih.md, docs/research/ars_idf_dim.md, docs/research/pmsi_formats_history.md, docs/research/dim_business_value.md.

Support

• Issues - https://github.com/Adam-Blf/sovereign_os_dim/issues
• Email - adam.beloucif@psysudparis.fr (alternance Fondation Vallée)
• Portfolio - https://adam.beloucif.com

Licence

MIT pour le code source. LGPL pour fpdf2 (embarqué). Les formats PMSI sont propriété de l'ATIH.

---

_{Par Adam Beloucif - Data Engineer & Fullstack Developer - alternant TIM Fondation Vallée GHT Sud Paris - GitHub - LinkedIn}

Star History