Aller au contenu

4. Spécifications techniques

4.1 Stack Technique

  • Backend: Node.js 18+
  • Framework: Express.js
  • Base de données: PostgreSQL 15
  • ORM: Sequelize
  • Cache/Queue: Redis
  • Architecture: Docker Compose

4.2 Architecture Modulaire

L'application utilise un Service Registry dynamique : - ServiceBase : Classe parente pour tous les services - registerAction(name, desc, params) - registerReaction(name, desc, params) - checkTrigger(action, area, params) : Méthode à redéfinir - executeReaction(reaction, area, params) : Méthode à redéfinir - ServiceRegistry : Singleton gérant le chargement des services (register, getService, getAllServices) - automation.js : Boucle d'exécution agnostique (ne connait pas les services spécifiques) qui itère sur les AREA actives toutes les 10s (configurable).

4.3 API REST

Endpoints exposés : - /auth/ : Authentification (JWT, OAuth2) - /users/ : Gestion profil - /areas/ : CRUD des automatisations - /about.json : Découverte des services

4.4 Sécurité

  • Authentification: JWT (Header Authorization: Bearer <token>)
  • Mots de passe: Hachage via bcryptjs
  • OAuth2: Stratégie Passport.js (Google)
  • Protection:
  • CORS configuré
  • Environnement via .env

4.4 Logs

  • Log des hooks exécutés
  • Log des erreurs API
  • Log des authentifications