FAQ

Premiers pas

Q : Quel est le moyen le plus rapide d'essayer ObjectOS ? R : npm i -g @objectstack/cli && os start — puis ouvrez http://localhost:3000. Voir Démarrage rapide.

Q : Ai-je besoin de Docker ? R : Non. Node 20+ et le CLI suffisent. Docker est la forme de déploiement recommandée pour la production.

Q : Ai-je besoin d'une base de données ? R : Non, pas pour démarrer — ObjectOS utilise SQLite en local par défaut. Remplacez-le par Postgres / MySQL / Turso / Mongo lorsque vous passez en production.

Q : Ai-je besoin d'un compte / d'un service cloud ? R : Non. ObjectOS est entièrement autonome. ObjectStack Cloud est optionnel pour les déploiements multi-environnements / multi-applications avec un plan de contrôle.

Architecture

Q : Puis-je utiliser Postgres / MySQL / MongoDB ? R : Oui — Postgres, MySQL, SQLite, Turso/libSQL et MongoDB sont des pilotes pris en charge. Voir Configuration du runtime.

Q : Puis-je désactiver Console / Account et n'utiliser que l'API REST ? R : Oui. Exécutez os start --no-ui ou définissez les indicateurs correspondants. L'API REST est la même que les interfaces soient montées ou non.

Q : Puis-je utiliser mon propre front-end à la place de Console ? R : Oui. Console utilise les mêmes points de terminaison /api/v1/* que vous appelleriez depuis votre propre code. Utilisez le SDK @objectstack/client ou n'importe quel client HTTP.

Q : ObjectOS prend-il en charge GraphQL ? R : REST est la surface principale. GraphQL est dans la feuille de route — en attendant, le langage de requête ObjectQL (par-dessus REST ?filter=/?sort=) couvre le même périmètre.

Q : Comment la multilocation est-elle gérée ? R : Un seul processus ObjectOS peut servir de nombreux Environments (locataires). La résolution nom d'hôte → Environment est mise en cache dans un LRU ; chaque Environment a sa propre base de données, son identité et son journal d'audit. Les cookies sont délimités par nom d'hôte afin que les sessions ne puissent pas fuiter entre locataires.

Q : ObjectOS peut-il s'exécuter dans un environnement serverless / Lambda ? R : Le runtime est un processus Node de longue durée — conçu pour des conteneurs ou des VM, pas pour des fonctions sans état. Le cache du noyau et le modèle de session Better Auth dépendent tous deux d'un état chaud en cours de processus.

Q : Est-ce que ça monte en charge horizontalement ? R : Oui. Exécutez plusieurs instances derrière un répartiteur de charge. Les sessions résident dans la base de données (et non en mémoire), de sorte que n'importe quelle instance peut servir n'importe quelle requête. Utilisez Redis pour la limitation de débit partagée et la file d'attente si vous activez ces capacités.

Données & migrations

Q : Comment les migrations de schéma sont-elles gérées ? R : Le pilote synchronise le schéma de la base de données avec vos objets déclarés au démarrage. Pour Postgres, ce sont des instructions CREATE TABLE / ALTER TABLE. Pour des migrations contrôlées dans des environnements réglementés, définissez OS_SKIP_SCHEMA_SYNC=1 et gérez le DDL vous-même.

Q : Qu'advient-il des données lorsque je renomme un champ ? R : Un renommage est une modification destructrice au niveau de la couche de données (cela ressemble à « supprimer l'ancienne colonne, ajouter une nouvelle colonne »). Utilisez os diff pour le détecter et ajoutez une étape de migration (renommez la colonne dans la base de données avant de déployer le nouvel artefact).

Q : Puis-je importer des données depuis CSV / Excel / Salesforce ? R : CSV : oui, via os data create dans une boucle ou via le téléversement en masse de Console. Salesforce : la meilleure voie aujourd'hui consiste à exporter vers CSV puis à importer. Des connecteurs natifs sont dans la feuille de route.

Q : La mise à niveau d'ObjectOS fera-t-elle perdre mes données ? R : Non. Les mises à niveau de correctif et mineures ne sont pas destructrices. Les mises à niveau majeures (par ex. 4 → 5) documentent explicitement les migrations requises. Faites d'abord une sauvegarde — Sauvegarde & DR.

Permissions & multilocation

Q : Comment mettre en place une sécurité au niveau des lignes ? R : Déclarez une règle de partage (déclarative, comme Salesforce) ou un prédicat CEL sur la configuration recordAccess d'un objet. Le plugin de sécurité injecte le filtre correspondant à chaque requête. Voir Permissions.

Q : Puis-je rendre certains champs invisibles pour certains utilisateurs ? R : Oui — sécurité au niveau des champs dans les ensembles de permissions. Masqué ou en lecture seule, par champ et par ensemble de permissions. Appliqué uniformément sur REST, ObjectQL et Console. Voir Ensembles de permissions.

Q : Comment intégrer Okta / Entra / Keycloak ? R : OIDC. Configurez l'URL de découverte + le client id/secret dans Console → Authentication (ou via les variables d'environnement). L'URL de rappel du fournisseur est /api/v1/auth/oauth2/callback/<provider-id>. Voir Authentification.

Intégrations

Q : Puis-je envoyer des webhooks ? R : Oui — activez webhooks dans requires. ObjectOS utilise une boîte d'envoi persistante avec signature HMAC-SHA256. Voir Webhooks.

Q : Puis-je intégrer Zapier / Make / n8n ? R : Oui — des webhooks pour le sortant et l'API REST + des clés d'API pour l'entrant. Des connecteurs natifs pour les outils iPaaS populaires sont dans la feuille de route.

Q : Les agents IA peuvent-ils appeler mon ObjectOS ? R : Oui, via MCP (@objectstack/plugin-mcp-server) — il expose les objets et les actions comme des outils MCP que Claude Desktop, les IDE ou d'autres clients MCP peuvent utiliser. Voir Service IA.

Personnalisation

Q : Puis-je écrire des plugins personnalisés ? R : Oui — les plugins suivent un modèle simple d'injection de dépendances et de cycle de vie (init → start → destroy). Voir les paquets @objectstack/plugin-* sur GitHub pour des exemples.

Q : Puis-je personnaliser l'apparence de Console ? R : L'image de marque (logo, couleur d'accentuation, thème par défaut) se trouve dans Console → System Settings. Une personnalisation poussée de l'UI implique de forker @objectstack/client-react ou de créer votre propre front-end basé sur l'API REST.

Q : Puis-je ajouter d'autres langues que l'anglais ? R : Oui — l'i18n est de première classe. Utilisez os i18n extract / os i18n check et livrez un bundle de traduction.

Exploitation

Q : Quel est le déploiement de production recommandé ? R : Docker (ou Kubernetes pour le multi-pod) + Postgres managé + S3 ou R2 pour les fichiers + votre gestionnaire de secrets pour OS_AUTH_SECRET. Voir Préparation à la production.

Q : ObjectOS dispose-t-il d'une page de statut ? R : Pour votre déploiement auto-hébergé, le statut est de votre ressort — branchez /health à votre moniteur. Pour les services hébergés, voir status.objectstack.ai.

Q : Quelles métriques dois-je surveiller ? R : Taux de 5xx, latence p95, taux d'échec d'authentification, taux d'échec de cache du noyau, profondeur de la file d'attente. Exemple Prometheus minimal dans Observabilité.

Q : Comment effectuer une sauvegarde ? R : Sauvegardez la base de données et le bucket de stockage — ce sont eux qui contiennent toutes les données client. ObjectOS lui-même est sans état. Voir Sauvegarde.

Tarification & aspects juridiques

Q : ObjectOS est-il vraiment gratuit ? R : Oui. Apache-2.0. Pas de sièges, pas de palier d'utilisation, pas de serveur de licences.

Q : Puis-je utiliser ObjectOS dans un produit commercial que je vends ? R : Oui. Apache-2.0 autorise un usage commercial. Voir Licence.

Q : Collectez-vous de la télémétrie ? R : Non. Zéro appel sortant sauf si vous les configurez (OIDC, e-mail, IA, webhooks). Voir Sécurité & conformité.

Q : ObjectOS est-il conforme à SOC 2 / ISO 27001 / HIPAA / RGPD ? R : ObjectOS fournit les primitives que tout framework requiert (RBAC, audit, prêt pour le chiffrement, résidence). La certification est une propriété de votre déploiement, pas du binaire. De nombreux déploiements ObjectOS sont certifiés. Voir Sécurité & conformité.

Se débloquer

Q : Quelque chose ne fonctionne pas — par où commencer ? R : os doctor. Il détecte à lui seul 80 % des erreurs de configuration. Ensuite, Dépannage.

Q : Où signaler un bug ? R : GitHub Issues. Incluez la sortie de os doctor. Problèmes de sécurité : security@objectstack.ai.

Q : Où obtenir de l'aide auprès d'humains ? R : GitHub Discussions, le Discord communautaire, ou sales@objectstack.ai pour le support commercial.