💳 Proof of Concept – Fusion de 2 applications financières avec AdonisJS

🧠 Contexte

Ce Proof of Concept (PoC) démontre la faisabilité technique de la fusion de formats transactionnels différents, en provenance de deux applications financières, au sein d’une plateforme unifiée à l’aide du framework AdonisJS.

Les sources de données sont deux fichiers JSON locaux représentant deux environnements bancaires différents :

🇨🇭 TWINT (normes suisses) et 🇪🇺 WERO (normes européennes).

Aucune API externe n’est utilisée — toutes les données sont chargées localement, fusionnées en base MySQL, puis consultées depuis le dossier /resources/.

---

🎯 Objectifs du PoC

Objectifs principaux

• Fusion des données de deux systèmes financiers distincts (App A et App B).
• Chargement depuis fichiers JSON locaux sans dépendance externe.
• Architecture modulaire pour isoler la logique de chaque application.
• Gestion commune de la logique métier, services et schémas.
• Fusion et transformation des données dans un format unique.
• Migration opérationnelle vers une base SQL complète.

---

⚙️ Objectifs techniques

1. Environnement & persistance

• Utilisation d’un conteneur MySQL (Docker) pour centraliser les données fusionnées.
• Lecture et importation des fichiers /data/TX_TWINT.json et /data/TX_WERO.json dans la base à l’initialisation du projet.
• Aucune route API brute exposée : les données sont exploitées depuis le dossier /data/.
• Possibilité d’utiliser des scripts de seeding AdonisJS pour automatiser le chargement.

---

2. Sources de données locales

Les deux fichiers JSON sont identiques en structure (même schéma, mêmes clés),
mais leurs contenus diffèrent (valeurs, montants, devises, origine, etc.).

Fichier	Origine	Description	Format
/data/TX_TWINT.json	🇨🇭 App A – TWINT / Swiss Payment Standard	Données simulées au format des normes suisses (TWINT micro-transaction)	TWINT / Swiss QR Bill / ISO 20022
/data/TX_WERO.json	🇪🇺 App B – WERO / PSD2 Berlin Group	Données simulées au format des normes européennes (Open Banking EU)	PSD2 Berlin Group

---

3. Processus de fusion et de lecture

1. Chargement initial

   • Les fichiers /data/TX_TWINT.json et /data/TX_WERO.json sont lus par DataLoaderService.
   • Chaque entrée est validée, enrichie et préparée pour insertion.

2. Insertion et fusion en base

   • Les enregistrements sont insérés dans MySQL.
   • Une table unique regroupe toutes les transactions avec un champ d’origine :
     • "origin": "SWISS" pour /data/TX_TWINT.json
     • "origin": "EU" pour /data/TX_WERO.json.

3. Lecture depuis /resources/

   • Les vues, scripts ou exports dans /resources/ accèdent directement à la base.
   • Aucun dossier /api/ n’est utilisé : tout est interne et géré par AdonisJS.

---

4. Normalisation & validation

Avant insertion en base, un service de normalisation applique :

• ✅ Validation de structure (user_id, merchant_id, amount, currency_id, etc.)
• 🔄 Conversion de statuts → normes ISO 20022 :
  completed → BOOKED, pending → PENDING, failed → REJECTED

---

📂 Arborescence globale

/app
 ├── controllers/              # Contrôleurs métier : lecture et fusion des données JSON
 ├── data/                     # Données JSON brutes simulant deux environnements bancaires
 │   ├── TX_TWINT.json                # 🇨🇭 Données TWINT / Swiss Payment Standard
 │   └── TX_WERO.json                # 🇪🇺 Données WERO / PSD2 Berlin Group
 ├── exceptions/               # Gestion des erreurs et exceptions globales
 ├── middleware/               # Middlewares AdonisJS (container bindings, etc.)
 │   └── container_bindings_middleware.ts
 ├── models/                   # Modèles Lucid ORM (liés à la base MySQL)
 │   ├── currency.ts           # Table des devises (ISO 4217)
 │   ├── merchant.ts           # Table des marchands
 │   ├── test.ts               # Modèle de test / sandbox
 │   ├── transaction.ts        # Table principale des transactions
 │   ├── user.ts               # Table des utilisateurs
 │   └── wallet.ts             # Table des portefeuilles électroniques
/bin                           # Scripts CLI (ex: seed, maintenance)
/config                        # Configuration AdonisJS (app, database, etc.)
/database                      # Migrations et seeds pour la base MySQL
/resources                     # Couche présentation : CSS, JS et templates Edge
 │
 ├── css/                      # Feuilles de styles du front-end
 │   ├── app.css
 │   ├── dashboard.css
 │   └── home.css
 │
 ├── js/                       # Scripts front-end spécifiques aux vues
 │   ├── app.js
 │   ├── common.js
 │   ├── dashboard.js
 │   ├── home.js
 │   ├── merchant.js
 │   └── pay.js
 │
 ├── views/                    # Templates Edge pour affichage des pages
 │   ├── components/layout/    # Composants réutilisables (layout global)
 │   │   └── main.edge
 │   ├── pages/                # Pages de l’application
 │   │   ├── errors/           # Pages d’erreurs (404, 500, etc.)
 │   │   ├── dashboard.edge    # Vue du tableau de bord (transactions agrégées)
 │   │   ├── merchant.edge     # Vue marchands
 │   │   ├── pay.edge          # Vue paiement
 │   │   └── home.edge         # Vue d’accueil / overview
 │
/start                         # Initialisation (kernel, routes, providers, etc.)