ARTAC · Observatoire régional des télécommunications et TIC
Kit de mise en œuvre · Version 1 · 9 octobre 2026

Architecture technique et guide de déploiement

Composition de la livraison

Application React avec rendu Vinext compatible Workers, API serveur, base D1 et fichiers R2. Les tables contiennent membres, observations, journaux, documents et campagnes. Les migrations Drizzle sont versionnées. Les secrets et données de production ne figurent pas dans le ZIP. Le code doit être compilé avant publication ; le dossier ne contient pas les dépendances installées.

Chemin de déploiement recommandé

Déployer la version vérifiée de la plateforme avec sa base de données et son stockage documentaire. L’accès initial est privé. Accorder les accès des titulaires puis configurer les habilitations métier. Ne pas publier comme portail public avant adoption institutionnelle et revue des contenus.

Déploiement Cloudflare direct

Utiliser README_DEPLOIEMENT.md pour installer les dépendances verrouillées, vérifier TypeScript, générer les migrations si le schéma change, construire, créer la base et le bucket, renseigner leurs identifiants et appliquer les migrations. Le guide fournit un exemple de commandes. Avant ouverture, remplacer ou sécuriser la couche d’identité actuelle : l’authentification liée à Sites ne constitue pas une solution autonome sur un domaine extérieur.

API de données

GET /api/data retourne les données autorisées au compte : les observations publiques pour un visiteur, le périmètre national pour les rôles pays et le périmètre régional pour les fonctions régionales. POST /api/data reçoit une observation ou un objet rows contenant jusqu’à 200 lignes. PATCH /api/data applique une transition avec id, revision, status et note. La révision et le rôle sont contrôlés sur serveur. Les systèmes externes doivent disposer d’une identité de confiance ; aucun accès inter-INS n’est préconfiguré.

API documentaire et administration

POST /api/documents reçoit un multipart avec file, title, category, visibility et country. GET /api/documents?id= retourne un téléchargement autorisé. GET /api/admin fournit les habilitations ; POST /api/admin les gère ou crée une campagne. Les écritures exigent une origine correspondante. Les réponses 400, 401/403, 404, 409 et 503 indiquent respectivement validation, accès, absence, conflit et indisponibilité.

Contrôle de livraison

Vérifier compilation, migrations, contrôles d’accès, collecte par lot, corrections, publication et fichiers. Réaliser la recette avec comptes distincts après partage du site. La livraison ne migre pas automatiquement les données ni les comptes de l’ancienne plateforme observatoire-tic-ac.org. Cette migration demande inventaire, export, correspondance des champs, validation et reprise testée.

Évolutions identifiées

Connexion automatisée INS et UIT, import XLSX direct, entrepôt statistique complet, couches SIG avancées, alertes et relances automatiques, Moodle, scénarios prospectifs, paiement des services premium et historique intégral des valeurs restent des développements complémentaires. Le socle livré fournit le circuit de données, les espaces et procédures nécessaires au pilote national. Ces extensions ne doivent pas être déclarées opérationnelles sans réalisation et recette.