Aller au contenu principal

Installation

AUSUS v0.1.0 comporte deux moitiés que vous pouvez installer indépendamment : les paquets du backend PHP et le paquet npm du moteur de rendu React.

Prérequis​

CoucheOutilMinimumTesté avec
Runtime (PHP)php8.38.4.18
Runtime (PHP)ext-pdo, ext-pdo_sqlitebundledbundled
Outillage (PHP)composer2.02.9.5
Runtime (JS)node1822.x
Outillage (JS)npm810.x
Runtime (JS)react, react-dom^18 || ^1918.3.1

AUSUS ne nécessite pas le framework Laravel, Eloquent, Filament, Tailwind, un bundler ou une bibliothèque de composants UI. La persistance dans la v0.1.0 utilise le pilote PDO SQLite intégré.

Option A — partir du modèle de projet​

La voie la plus rapide. ausus/starter est un projet prêt à l'emploi qui câble déjà ensemble le kernel, la persistance, le runtime et un domaine d'exemple.

composer create-project ausus/starter myapp
cd myapp
composer boot

Sortie attendue :

ausus/starter boot
  ✓ compiled graph (hash …)
  ✓ schema applied
  ✓ created invoice id=…
  ✓ issued invoice (DRAFT → ISSUED)
  ✓ rendered summary projection (items=1)
OK — ausus/starter boots cleanly.

Si vous avez utilisé --no-install, terminez avec composer install && composer boot.

Option B — ajouter des paquets à un projet existant​

N'installez que les paquets dont vous avez besoin. L'ordre des dépendances est ascendant :

composer require ausus/kernel
composer require ausus/runtime-default
composer require ausus/persistence-sql
composer require ausus/api-http        # optional — HTTP API surface

Ou figez l'ensemble validé de la v0.1.0 avec le métapaquet :

composer require ausus/standard-stack

Option C — compiler depuis les sources (monorepo)​

Utilisez cette voie pour lire le code, exécuter les portes de validation ou contribuer.

git clone https://github.com/adonko3xBitters/ausus-framework.git
cd ausus-framework
composer install     # workspace install via path repositories
npm install           # workspace install
bash scripts/ci.sh    # full validation gate

scripts/ci.sh exécute une porte en 10 étapes et se termine par :

[ci] DONE — all 10 steps passed

Le moteur de rendu React​

Le moteur de rendu est un paquet npm distinct. react et react-dom sont des peer dependencies — vous les installez vous-même.

npm install @ausus/renderer-react react@18 react-dom@18
# React 19 also works:
# npm install @ausus/renderer-react react@^19 react-dom@^19

Le paquet est ESM uniquement ("type": "module", résolution NodeNext). Il ne livre aucune dépendance intégrée ni aucun fichier CSS — consultez Le moteur de rendu React.

Limites actuelles de la v0.1.0​

  • La persistance est validée uniquement sur SQLite. Les pilotes MySQL/PostgreSQL sont un objectif de conception, pas une capacité testée de la v0.1.0.
  • composer create-project ausus/starter est un flux en 2 commandes (create-project puis composer boot) ; avec --no-install il devient un flux en 3 commandes.
  • Les paquets réservés (tenancy-row, audit-database, auth-bridge, presentation-default) ne sont pas installables en tant que code fonctionnel — ce sont des réservations de noms. Consultez Paquets.

Étapes suivantes​