Crealcs Development DokuWiki

Outils pour utilisateurs

Outils du site

Piste :
ujusum:1-implantation:12-administration-parametrage

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

ujusum:1-implantation:12-administration-parametrage [2026/06/06 03:20] – créée 91.170.108.99ujusum:1-implantation:12-administration-parametrage [2026/06/06 03:22] (Version actuelle) – 91.170.108.99
Ligne 1: Ligne 1:
-====== Phase suivante ======+====== Sprint 11 — Administration & Paramétrage ======
  
-La roadmap entre maintenant dans la phase d'industrialisation avancée.+===== Objectif du Sprint =====
  
-===== Sprint 11 — Administration & Paramétrage =====+Permettre à chaque agence d'adapter la plateforme à son organisation, ses processus métier et ses règles de gestion sans intervention technique.
  
-Objectif :+À l'issue du Sprint 11 :
  
-Permettre à chaque agence de configurer entièrement son environnement.+  * Les paramètres agence sont configurables 
 +  * Les workflows sont personnalisables 
 +  * Les champs métiers sont extensibles 
 +  * Les audits sont consultables 
 +  * Les journaux système sont centralisés 
 +  * Les fonctionnalités peuvent être activées ou désactivées 
 +  * Le mode multi-agence est pleinement opérationnel
  
-Modules concernés :+Ce sprint transforme la plateforme en véritable solution SaaS configurable. 
 + 
 +---- 
 + 
 +====== Périmètre ====== 
 + 
 +===== Modules concernés =====
  
 <code> <code>
Ligne 23: Ligne 35:
  
 FeatureFlagsModule FeatureFlagsModule
 +
 +TenantManagementModule
 </code> </code>
  
-Fonctionnalités :+----
  
-  * Paramétrage agence +====== Architecture Fonctionnelle ====== 
-  * Paramétrage métier + 
-  * Champs personnalisés+<code> 
 +Tenant 
 + 
 +↓ 
 + 
 +Configuration Agence 
 + 
 +├── Paramètres 
 + 
 +├── Workflows 
 + 
 +├── Champs personnalisés 
 + 
 +├── Permissions 
 + 
 +├── Feature Flags 
 + 
 +└── Audit 
 +</code> 
 + 
 +---- 
 + 
 +====== User Stories ====== 
 + 
 +===== US-1101 : Consulter les paramètres agence ===== 
 + 
 +**En tant qu'administrateur d'agence** 
 + 
 +Je souhaite consulter la configuration de mon agence 
 + 
 +Afin de piloter mon activité. 
 + 
 +---- 
 + 
 +===== Endpoint ===== 
 + 
 +<code http> 
 +GET /admin/settings 
 +</code> 
 + 
 +---- 
 + 
 +===== Paramètres ===== 
 + 
 +<code> 
 +Nom agence 
 + 
 +Adresse 
 + 
 +Téléphone 
 + 
 +Email 
 + 
 +Site web 
 + 
 +Logo 
 + 
 +Fuseau horaire 
 + 
 +Devise 
 +</code> 
 + 
 +---- 
 + 
 +====== US-1102 : Modifier les paramètres agence ====== 
 + 
 +===== Endpoint ===== 
 + 
 +<code http> 
 +PUT /admin/settings 
 +</code> 
 + 
 +---- 
 + 
 +===== Contraintes ===== 
 + 
 +<code> 
 +Droits administrateur requis 
 +</code> 
 + 
 +---- 
 + 
 +====== US-1103 : Gérer les paramètres financiers ====== 
 + 
 +===== Endpoint ===== 
 + 
 +<code http> 
 +GET /admin/settings/finance 
 + 
 +PUT /admin/settings/finance 
 +</code> 
 + 
 +---- 
 + 
 +===== Paramètres ===== 
 + 
 +<code> 
 +Taux acompte 
 + 
 +Taux TVA 
 + 
 +Taxe séjour 
 + 
 +Devise 
 + 
 +Conditions paiement 
 +</code> 
 + 
 +---- 
 + 
 +====== Workflows ====== 
 + 
 +===== US-1104 : Configurer le workflow réservation ===== 
 + 
 +===== Objectif ===== 
 + 
 +Permettre à chaque agence de définir son cycle métier. 
 + 
 +---- 
 + 
 +===== Exemple ===== 
 + 
 +<code> 
 +PENDING 
 + 
 +↓ 
 + 
 +CONFIRMED 
 + 
 +↓ 
 + 
 +SIGNED 
 + 
 +↓ 
 + 
 +PAID 
 + 
 +↓ 
 + 
 +COMPLETED 
 +</code> 
 + 
 +---- 
 + 
 +===== Endpoint ===== 
 + 
 +<code http> 
 +GET /admin/workflows 
 + 
 +PUT /admin/workflows 
 +</code> 
 + 
 +---- 
 + 
 +====== US-1105 : Configurer les statuts personnalisés ====== 
 + 
 +===== Exemple ===== 
 + 
 +<code> 
 +EN_ATTENTE_VALIDATION 
 + 
 +DOSSIER_INCOMPLET 
 + 
 +CHECKIN_EFFECTUE 
 +</code> 
 + 
 +---- 
 + 
 +====== Champs personnalisés ====== 
 + 
 +===== US-1106 : Créer un champ personnalisé ===== 
 + 
 +===== Endpoint ===== 
 + 
 +<code http> 
 +POST /admin/custom-fields 
 +</code> 
 + 
 +---- 
 + 
 +===== Types ===== 
 + 
 +<code> 
 +TEXT 
 + 
 +TEXTAREA 
 + 
 +NUMBER 
 + 
 +BOOLEAN 
 + 
 +DATE 
 + 
 +SELECT 
 + 
 +MULTISELECT 
 +</code> 
 + 
 +---- 
 + 
 +===== Entités compatibles ===== 
 + 
 +<code> 
 +Client 
 + 
 +Propriétaire 
 + 
 +Bien 
 + 
 +Réservation 
 + 
 +Contrat 
 +</code> 
 + 
 +---- 
 + 
 +====== US-1107 : Associer un champ à une entité ===== 
 + 
 +===== Exemple ===== 
 + 
 +<code> 
 +Bien 
 + 
 +↓ 
 + 
 +Champ : 
 + 
 +Classification interne 
 +</code> 
 + 
 +---- 
 + 
 +====== Feature Flags ====== 
 + 
 +===== US-1108 : Activer une fonctionnalité ===== 
 + 
 +===== Endpoint ===== 
 + 
 +<code http> 
 +GET /admin/feature-flags 
 + 
 +PUT /admin/feature-flags 
 +</code> 
 + 
 +---- 
 + 
 +===== Exemples ===== 
 + 
 +<code> 
 +CRM 
 + 
 +SMS 
 + 
 +Paiement Stripe 
 + 
 +Paiement MangoPay 
 + 
 +IA 
 + 
 +Signature électronique 
 +</code> 
 + 
 +---- 
 + 
 +===== Cas d'usage ===== 
 + 
 +<code> 
 +Agence A 
 + 
 +CRM activé 
 + 
 +Agence B 
 + 
 +CRM désactivé 
 +</code> 
 + 
 +---- 
 + 
 +====== Audit ====== 
 + 
 +===== US-1109 : Consulter les audits ===== 
 + 
 +===== Endpoint ===== 
 + 
 +<code http> 
 +GET /admin/audit 
 +</code> 
 + 
 +---- 
 + 
 +===== Informations ===== 
 + 
 +<code> 
 +Utilisateur 
 + 
 +Action 
 + 
 +Date 
 + 
 +Adresse IP 
 + 
 +Entité 
 + 
 +Valeurs avant 
 + 
 +Valeurs après 
 +</code> 
 + 
 +---- 
 + 
 +====== US-1110 : Rechercher dans les audits ===== 
 + 
 +===== Filtres ===== 
 + 
 +<code> 
 +Utilisateur 
 + 
 +Date 
 + 
 +Type 
 + 
 +Module 
 + 
 +Entité 
 +</code> 
 + 
 +---- 
 + 
 +====== Journaux système ====== 
 + 
 +===== US-1111 : Consulter les logs ===== 
 + 
 +===== Endpoint ===== 
 + 
 +<code http> 
 +GET /admin/system/logs 
 +</code> 
 + 
 +---- 
 + 
 +===== Niveaux ===== 
 + 
 +<code> 
 +INFO 
 + 
 +WARNING 
 + 
 +ERROR 
 + 
 +CRITICAL 
 +</code> 
 + 
 +---- 
 + 
 +====== US-1112 : Consulter les erreurs applicatives ===== 
 + 
 +===== Informations ===== 
 + 
 +<code> 
 +Date 
 + 
 +Service 
 + 
 +Exception 
 + 
 +Stack Trace 
 + 
 +Contexte 
 +</code> 
 + 
 +---- 
 + 
 +====== Gestion Multi-Agence ====== 
 + 
 +===== US-1113 : Gérer les agences ===== 
 + 
 +===== Endpoint ===== 
 + 
 +<code http> 
 +GET /admin/agencies 
 + 
 +POST /admin/agencies 
 +</code> 
 + 
 +---- 
 + 
 +===== Données ===== 
 + 
 +<code> 
 +Nom 
 + 
 +Code 
 + 
 +Statut 
 + 
 +Plan 
 + 
 +Quota 
 +</code> 
 + 
 +---- 
 + 
 +====== US-1114 : Activer ou suspendre une agence ===== 
 + 
 +===== Statuts ===== 
 + 
 +<code> 
 +ACTIVE 
 + 
 +SUSPENDED 
 + 
 +TRIAL 
 + 
 +ARCHIVED 
 +</code> 
 + 
 +---- 
 + 
 +====== Gestion des quotas ====== 
 + 
 +===== US-1115 : Configurer les limites ===== 
 + 
 +===== Exemples ===== 
 + 
 +<code> 
 +Nombre biens 
 + 
 +Nombre utilisateurs 
 + 
 +Stockage 
 + 
 +Emails mensuels 
 +</code> 
 + 
 +---- 
 + 
 +====== Modèle Prisma ====== 
 + 
 +===== Tenant ===== 
 + 
 +<code prisma> 
 +model Tenant { 
 + 
 +  id              String @id @default(uuid()) 
 + 
 +  code            String @unique 
 + 
 +  name            String 
 + 
 +  status          String 
 + 
 +  createdAt       DateTime @default(now()) 
 + 
 +} 
 +</code> 
 + 
 +---- 
 + 
 +===== AgencySetting ===== 
 + 
 +<code prisma> 
 +model AgencySetting { 
 + 
 +  id              String @id @default(uuid()) 
 + 
 +  tenantId        String 
 + 
 +  settingKey      String 
 + 
 +  settingValue    Json 
 + 
 +} 
 +</code> 
 + 
 +---- 
 + 
 +===== WorkflowDefinition ===== 
 + 
 +<code prisma> 
 +model WorkflowDefinition { 
 + 
 +  id              String @id @default(uuid()) 
 + 
 +  tenantId        String 
 + 
 +  entityType      String 
 + 
 +  definition      Json 
 +} 
 +</code> 
 + 
 +---- 
 + 
 +===== CustomField ===== 
 + 
 +<code prisma> 
 +model CustomField { 
 + 
 +  id              String @id @default(uuid()) 
 + 
 +  tenantId        String 
 + 
 +  entityType      String 
 + 
 +  fieldName       String 
 + 
 +  fieldType       String 
 +} 
 +</code> 
 + 
 +---- 
 + 
 +===== AuditLog ===== 
 + 
 +<code prisma> 
 +model AuditLog { 
 + 
 +  id              String @id @default(uuid()) 
 + 
 +  tenantId        String 
 + 
 +  userId          String 
 + 
 +  entityType      String 
 + 
 +  entityId        String 
 + 
 +  action          String 
 + 
 +  beforeData      Json? 
 + 
 +  afterData       Json? 
 + 
 +  createdAt       DateTime @default(now()) 
 +} 
 +</code> 
 + 
 +---- 
 + 
 +===== FeatureFlag ===== 
 + 
 +<code prisma> 
 +model FeatureFlag { 
 + 
 +  id              String @id @default(uuid()) 
 + 
 +  tenantId        String 
 + 
 +  code            String 
 + 
 +  enabled         Boolean 
 +} 
 +</code> 
 + 
 +---- 
 + 
 +====== Architecture Backend ====== 
 + 
 +<code> 
 +src/modules/administration 
 + 
 +├── agencies 
 +│ 
 +├── settings 
 +│ 
 +├── workflows 
 +│ 
 +├── custom-fields 
 +│ 
 +├── audit 
 +│ 
 +├── feature-flags 
 +│ 
 +└── system 
 +</code> 
 + 
 +---- 
 + 
 +====== Domain Services ====== 
 + 
 +<code> 
 +AgencyService 
 + 
 +SettingsService 
 + 
 +WorkflowService 
 + 
 +CustomFieldService 
 + 
 +AuditService 
 + 
 +FeatureFlagService 
 +</code> 
 + 
 +---- 
 + 
 +====== Événements métier ====== 
 + 
 +===== AgencyCreated ===== 
 + 
 +<code> 
 +AgencyCreated 
 +</code> 
 + 
 +---- 
 + 
 +===== FeatureFlagChanged ===== 
 + 
 +<code> 
 +FeatureFlagChanged 
 +</code> 
 + 
 +---- 
 + 
 +===== WorkflowUpdated ===== 
 + 
 +<code> 
 +WorkflowUpdated 
 +</code> 
 + 
 +---- 
 + 
 +====== Swagger ====== 
 + 
 +===== Tags ===== 
 + 
 +<code> 
 +Administration 
 + 
 +Settings 
 + 
 +Workflows 
 + 
 +CustomFields 
 + 
 +Audit 
 + 
 +FeatureFlags 
 + 
 +Tenants 
 +</code> 
 + 
 +---- 
 + 
 +===== Volume API ===== 
 + 
 +Environ : 
 + 
 +<code> 
 +40 endpoints 
 +</code> 
 + 
 +---- 
 + 
 +====== Frontend ====== 
 + 
 +===== Pages ===== 
 + 
 +<code> 
 +/admin 
 + 
 +/admin/settings 
 + 
 +/admin/workflows 
 + 
 +/admin/custom-fields 
 + 
 +/admin/feature-flags 
 + 
 +/admin/audit 
 + 
 +/admin/system 
 + 
 +/admin/agencies 
 +</code> 
 + 
 +---- 
 + 
 +===== Composants ===== 
 + 
 +<code> 
 +SettingsForm 
 + 
 +WorkflowEditor 
 + 
 +CustomFieldManager 
 + 
 +AuditTable 
 + 
 +FeatureFlagSwitch 
 + 
 +TenantManagementTable 
 +</code> 
 + 
 +---- 
 + 
 +====== Dashboard Administration ====== 
 + 
 +===== KPI ===== 
 + 
 +<code> 
 +Agences actives 
 + 
 +Utilisateurs actifs 
 + 
 +Stockage utilisé 
 + 
 +Emails envoyés 
 + 
 +Erreurs système 
 + 
 +Fonctionnalités activées 
 +</code> 
 + 
 +---- 
 + 
 +====== Tests ====== 
 + 
 +===== Unitaires ===== 
 + 
 +<code> 
 +SettingsService 
 + 
 +WorkflowService 
 + 
 +AuditService 
 + 
 +FeatureFlagService 
 +</code> 
 + 
 +---- 
 + 
 +===== Intégration ===== 
 + 
 +<code> 
 +Modification paramètre 
 + 
 +↓ 
 + 
 +Audit 
 + 
 +↓ 
 + 
 +Propagation configuration 
 +</code> 
 + 
 +---- 
 + 
 +===== E2E ===== 
 + 
 +<code> 
 +Connexion Admin 
 + 
 +↓ 
 + 
 +Modification paramètre agence 
 + 
 +↓ 
 + 
 +Création champ personnalisé 
 + 
 +↓ 
 + 
 +Activation fonctionnalité 
 + 
 +↓ 
 + 
 +Consultation audit 
 +</code> 
 + 
 +---- 
 + 
 +====== Définition de terminé ====== 
 + 
 +Le Sprint 11 est terminé lorsque : 
 + 
 +  * Paramètres agence opérationnels 
 +  * Workflows configurables 
 +  * Champs personnalisés opérationnels 
 +  * Audit complet opérationnel 
 +  * Journaux système consultables 
 +  * Feature Flags opérationnels 
 +  * Multi-agence opérationnel 
 +  * Swagger à jour 
 +  * Tests verts 
 +  * CI verte 
 + 
 +---- 
 + 
 +====== Livrables ====== 
 + 
 +  * AdministrationModule 
 +  * AgencySettingsModule 
 +  * WorkflowModule 
 +  * CustomFieldsModule 
 +  * AuditModule 
 +  * FeatureFlagsModule 
 +  * TenantManagementModule 
 +  * DTO 
 +  * Swagger 
 +  * Tests 
 +  * Migrations Prisma 
 + 
 +---- 
 + 
 +====== Bilan Release 2.1 ====== 
 + 
 +À l'issue du Sprint 11 : 
 + 
 +  * Plateforme entièrement configurable 
 +  * Multi-tenant avancé
   * Audit complet   * Audit complet
-  * Journaux système +  * Paramétrage métier sans code 
-  * Feature Flags +  * Gouvernance opérationnelle 
-  * Multi-agence avancé+ 
 +La solution devient exploitable comme produit SaaS multi-agences. 
 + 
 +---- 
 + 
 +====== Sprint suivant ====== 
 + 
 +===== Sprint 12 — Maintenance, Exploitation & Observabilité ===== 
 + 
 +Objectif : 
 + 
 +Industrialiser l'exploitation de la plateforme en production. 
 + 
 +Modules concernés : 
 + 
 +<code> 
 +MonitoringModule 
 + 
 +LoggingModule 
 + 
 +MetricsModule 
 + 
 +AlertingModule 
 + 
 +BackupModule 
 + 
 +HealthCheckModule 
 +</code> 
 + 
 +Fonctionnalités : 
 + 
 +  * Monitoring temps réel 
 +  * Centralisation des logs 
 +  * Tableaux de bord techniques 
 +  * Alertes automatiques 
 +  * Sauvegardes automatisées 
 +  * Supervision applicative 
 +  * Santé des services
  
-À l'issue du Sprint 11, la plateforme deviendra entièrement configurable sans intervention technique.+À l'issue du Sprint 12, la plateforme sera prête pour une exploitation SaaS à grande échelle.
ujusum/1-implantation/12-administration-parametrage.1780708836.txt.gz · Dernière modification : 2026/06/06 03:20 de 91.170.108.99 · Actuellement bloqué par : 192.168.0.100,216.73.216.200
DokuWiki Appliance - Powered by TurnKey Linux