EBSoft Account

1. Concepts

• Un utilisateur = un compte, identifié par son email, vérifié par email puis SMS à l'inscription.
• Un solde de crédit GLOBAL (euros), commun à toutes les applications. Le bonus de bienvenue est crédité une seule fois, à la création du compte.
• Chaque application est déclarée dans le registre (back-office) : elle reçoit un app_id public et un app_secret privé.
• Chaque app calcule ses propres coûts (tarifs, marge) et envoie un montant final en euros au débit — le service central ne connaît aucun tarif. Chaque débit est journalisé avec l'app émettrice.
• Accès par app : accordé automatiquement à la première connexion (politique auto) ou sur approbation (manual) ; révocable par utilisateur dans le back-office.

Deux niveaux d'API, deux niveaux de confiance : l'API client s'utilise depuis le navigateur avec un token utilisateur ; l'API serveur (débits) exige l'app_secret et ne doit être appelée que par votre backend.

2. Démarrage rapide — le widget

Le plus simple : le widget embarquable. Il affiche connexion / inscription / mot de passe oublié aux couleurs de votre app (avec son animation d'entrée), et vous rend une session.

<script src="https://account.ebsoft.studio/widget/ebsoft-account.js"></script>
<script>
  EBSoftAccount.init({
    app: "mon-app",                    // identifiant déclaré dans le back-office
    lang: "fr",                        // "fr" | "en" (défaut : langue du navigateur)
    onLogin: function (session) {
      // session = { email, token, salt, profile }
      // profile = { nom, prenom, email, balance, approved, status, apps, … }
      console.log("Connecté :", session.email, "solde :", session.profile.balance);
    },
    onLogout: function () { console.log("Déconnecté"); }
  });

  // Login auto au chargement (session mémorisée + validée serveur) :
  EBSoftAccount.me().then(function (session) {
    if (!session) EBSoftAccount.open();     // sinon : ouvre l'écran de connexion
  });
</script>

3. API client (navigateur)

POST https://account.ebsoft.studio/api/account.php — corps JSON { action, app?, lang?, … }. Le champ app personnalise les emails, applique la politique d'accès de votre app et alimente les statistiques : envoyez-le toujours.

4. API serveur (débits de crédit)

POST https://account.ebsoft.studio/api/billing.php — corps JSON { action, app_id, app_secret, … }.

detail (libre, journalisé — jamais de contenu de requête) : {model?, in?, out?, pages?, cost?, meta?}.

Exemple PHP (backend de votre app)

function eba_api(string $action, array $payload): array {
    $body = json_encode(array_merge([
        'action'     => $action,
        'app_id'     => 'mon-app',
        'app_secret' => MON_APP_EBA_SECRET,   // config privée serveur
    ], $payload));
    $ch = curl_init('https://account.ebsoft.studio/api/billing.php');
    curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => $body, CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
        CURLOPT_TIMEOUT => 20]);
    $res = json_decode((string)curl_exec($ch), true);
    curl_close($ch);
    return is_array($res) ? $res : ['ok' => false, 'error' => 'invalid-response'];
}

// 1) Garde AVANT l'appel IA
$chk = eba_api('check', ['email' => $email, 'token' => $token]);
if (empty($chk['ok'])) { http_response_code(402); exit(json_encode($chk)); }

// 2) … appel IA, calcul du prix final en euros …

// 3) Débit APRÈS l'appel (journalisé avec votre app_id)
eba_api('debit', ['email' => $email, 'token' => $token,
    'amount' => $prixEuros, 'task' => 'summarize',
    'detail' => ['model' => 'mistral-small', 'in' => $tin, 'out' => $tout, 'cost' => $cout]]);

5. Branding & animations par app

Tout se règle dans le back-office (onglet Applications) et se sert au widget via GET /api/app.php?app=<id> :

6. Codes d'erreur

7. Sécurité & zéro-knowledge

• Mots de passe : password_hash (bcrypt), jamais réversibles. Codes à 6 chiffres : 15 min, 5 essais, comparaison à temps constant.
• Chaque compte porte un sel (base64, 16 octets) servi au client à la connexion : les apps qui chiffrent côté client (comme mdView) dérivent leur clé de (mot de passe + sel) — le serveur ne voit jamais la clé.
• change_password CONSERVE le sel : votre app doit re-chiffrer ses données avec la nouvelle clé AVANT d'appeler l'action (utilisez verify_password avec le code d'abord — un code erroné doit échouer avant le re-chiffrement).
• reset_confirm RÉGÉNÈRE le sel (l'utilisateur a perdu son mot de passe : l'ancienne clé est irrécupérable). Le compte porte alors saltChangedAt ; si votre app stocke des données chiffrées, prévenez l'utilisateur qu'elles deviennent illisibles et purgez-les côté app.
• Anti-abus : quotas à fenêtre glissante sur inscription, login, codes, SMS, API serveur et console (mêmes seuils éprouvés que mdView).
• Anti-doublon : un email/téléphone révoqué ou supprimé est en liste noire (empreintes HMAC salées — jamais en clair).

8. Check-list d'intégration d'une nouvelle app

1. Back-office → Applications → Créer l'app (id, nom, URL, politique d'accès).
2. Régler le branding (couleurs, animation, logo, taglines) — testez avec le widget.
3. Copier l'app_secret dans la config privée du serveur de l'app.
4. Côté client : inclure le widget, init({app}), brancher onLogin/onLogout.
5. Côté serveur : garde check avant chaque usage payant, debit après (montant final en euros, task parlant).
6. Vérifier dans le back-office : l'utilisateur apparaît, l'accès est accordé, l'historique montre les débits avec votre app.

EBSoft Account — PHP 7.4, stockage fichier, zéro dépendance externe (hors PHPMailer). Console : back-office.