SAGAPI — Service Account Governance & Automation Programmable Interface

SAGAPI est un monorepo conçu pour fournir une API de gouvernance et des connecteurs permettant d’automatiser des opérations de sécurité (ex: gouvernance de comptes de service, rotation, approbations), dans une posture Zero Trust.

Documentation

• Architecture / SAD (document maître) : /docs/SAGAPI_Architecture_SAD.md
  (source : /docs/architecture/Architecture.md)
• Gouvernance (WIP) : /docs/GOVERNANCE.md
• Runbooks : /docs/runbooks/
• Wiki GitHub (recommandé) : pages sources à copier depuis /docs/wiki/

Structure du repo (actuelle)

/ (Root)
├── /apps
│   ├── /frontend             # Applications Web (React)
│   │   ├── /shell            # Application hôte (Auth & Routing)
│   │   ├── /ops              # Micro-frontend "Opérations" (Espace User)
│   │   └── /admin            # Micro-frontend "Administration" (Espace Admin)
│   │
│   ├── /backend              # Services Serverless (.NET 8)
│   │   ├── /governance       # API Cerveau décisionnel (Logique Métier)
│   │   └── /connector        # API Connecteur AD isolé (Zero Trust)
│   │
│   └── /data                 # Outils de données
│       └── /db-migrations    # Scripts de gestion schéma DynamoDB
│
├── /libs                     # Bibliothèques Partagées (Non déployables seules)
│   ├── /shared               # Code agnostique (C# & TS)
│   │   └── /contracts        # DTOs, Enums et Interfaces partagés (Source de vérité)
│   └── /ui                   # Composants React
│       └── /components       # Design System (Boutons, Tableaux, Layouts)
│
├── /docs                     # Documentation
│   ├── /architecture         # Diagrammes et SAD
│   ├── /governance
│   ├── /runbooks
│   ├── /wiki
│   └── /adrs                 # Architecture Decision Records
│
├── /scripts                  
│   └── /security
│
└── /infra                    # Infrastructure as Code (Terraform/CDK)

Pré-requis (développement local)

Selon le SAD, la cible est typiquement :

• Node.js LTS + npm (monorepo tooling / Nx / front)
• .NET 8 SDK (APIs serverless / backend)
• Docker (services locaux : mocks, DB, etc.)

✅ Le dépôt est actuellement un squelette (placeholder .gitkeep).
Les commandes ci-dessous sont fournies comme conventions et seront finalisées lorsque le tooling sera présent (ex: package.json, nx.json, solutions .NET, etc.).

Installation (WIP)

git clone https://github.com/OurITRes/sagapi.git
cd sagapi

Dépendances Node (si Nx/Node est en place)

npm ci

Dépendances .NET (si solutions .NET présentes)

dotnet restore

Builds & Tests (WIP)

Tests

• Monorepo Nx (prévu)

  npx nx test

• .NET (prévu)

  dotnet test

Build

• Nx (prévu)

  npx nx build <app>

• .NET (prévu)

  dotnet build -c Release

Sécurité — checklist

• Scan de secrets (historique git complet) : TruffleHog et/ou git-secrets
• Licence : respecter la LICENSE (AGPLv3)
• Security policy : SECURITY.md (reporting privé, pas d’issue publique)
• Rulesets activés sur master (PR obligatoire, checks, linear history, no bypass)
• Documentation à jour (README + Wiki + runbooks)

Scripts de scan (optionnels) : /scripts/security/

Contribution

• Voir : CONTRIBUTING.md
• PR obligatoire vers master (pas de push direct), CI verte, revue requise.

Gouvernance

• Gouvernance : docs/GOVERNANCE.md
• Settings recommandés : docs/governance/Repository_Settings.md
• Ownership : .github/CODEOWNERS

Licence

Ce projet est sous licence AGPL-3.0.
Voir LICENSE.