@rubix0270/arboris 1.0.0

package/README.md

@@ -0,0 +1,151 @@
+# 🌳 Arboris
+
+**Catalogue de skills IA prêts à l'emploi.** Copie le prompt d'un skill, ton agent
+(Cursor, Claude, Codex, Copilot…) l'ajoute au codebase et applique les bonnes
+pratiques. Zéro config.
+
+Application full-stack construite avec **TanStack Start** (React 19), **Prisma**
+(PostgreSQL) et **Tailwind CSS v4**, entièrement typée en **TypeScript**.
+
+## ✨ Fonctionnalités
+
+- **Catalogue filtrable** — recherche, filtres par catégorie, compatibilité et technologie, tri par score ou nom.
+- **Fiches détaillées** — prompt à copier, « ce que fait le skill », étapes, déclencheurs, skills liés.
+- **Premier pas** — choisis ta stack (Node, TypeScript, React, Next.js…) et copie tous les skills recommandés d'un coup.
+- **Authentification** — connexion / inscription (e-mail + mot de passe, sessions HTTP-only).
+- **Bilingue FR / EN** — bascule instantanée, mémorisée.
+- **Thème clair / sombre** — bascule animée (View Transitions API), sans flash au chargement.
+- **Rendu côté serveur (SSR)** — les données viennent de la base via des *server functions* TanStack Start adossées à Prisma.
+
+## 🧱 Stack technique
+
+| Domaine        | Choix                                                      |
+| -------------- | ---------------------------------------------------------- |
+| Framework      | TanStack Start (React 19, routing fichiers, SSR)           |
+| Server / RPC   | `createServerFn` (server functions, exécutées sur Node)    |
+| ORM / Base     | Prisma 6 + PostgreSQL 16 (Docker)                          |
+| Styles         | Tailwind CSS v4 + tokens de design (variables CSS)         |
+| Icônes/Polices | Phosphor Icons, Space Grotesk / Hanken Grotesk / JetBrains Mono |
+| Langage        | TypeScript                                                 |
+
+## 🚀 Démarrage
+
+> **Prérequis** : Node.js (recommandé **≥ 22.12**, fonctionne aussi en 20.19+), npm et **Docker**.
+
+```bash
+# 1. Installer les dépendances
+npm install
+
+# 2. Copier la config d'environnement
+cp .env.example .env
+
+# 3. Démarrer PostgreSQL (Docker) + migrations + seed
+npm run db:up
+npm run db:migrate      # applique les migrations et lance le seed
+
+# 4. Lancer le serveur de développement
+npm run dev
+```
+
+L'application démarre sur **http://localhost:3000** (bascule sur un autre port
+si 3000 est occupé).
+
+### PostgreSQL (Docker)
+
+Le fichier `docker-compose.yml` lance Postgres sur le port **5433** (évite les
+conflits avec une instance locale sur 5432) :
+
+| Variable | Valeur par défaut |
+| -------- | ----------------- |
+| Utilisateur | `arboris` |
+| Mot de passe | `arboris` |
+| Base | `arboris` |
+| Port hôte | `5433` |
+
+Format `DATABASE_URL` dans `.env` :
+
+```
+postgresql://arboris:arboris@localhost:5433/arboris
+```
+
+Commandes utiles :
+
+```bash
+npm run db:up      # docker compose up -d
+npm run db:down    # docker compose down
+npm run db:studio  # explorateur Prisma Studio
+npm run db:reset   # réinitialise la base + reseed
+```
+
+> `SESSION_SECRET` (min. 32 caractères) est requis pour l'authentification.
+
+## 📜 Scripts npm
+
+| Script                  | Description                                            |
+| ----------------------- | ------------------------------------------------------ |
+| `npm run dev`           | Serveur de développement (SSR + HMR)                   |
+| `npm run build`         | Build de production                                    |
+| `npm run start`         | Sert le build de production                            |
+| `npm run typecheck`     | Vérification des types TypeScript                      |
+| `npm run generate-routes` | Régénère l'arbre de routes TanStack (`routeTree.gen.ts`) |
+| `npm run db:up`         | Démarre PostgreSQL via Docker Compose                  |
+| `npm run db:down`       | Arrête le conteneur PostgreSQL                         |
+| `npm run db:migrate`    | Crée/applique les migrations Prisma (puis seed)        |
+| `npm run db:push`       | Synchronise le schéma sans migration (prototypage)     |
+| `npm run db:seed`       | (Re)remplit la base avec le catalogue                  |
+| `npm run db:studio`     | Ouvre Prisma Studio (explorateur de données)           |
+| `npm run db:reset`      | Réinitialise la base puis reseed                       |
+
+## 🗂️ Structure du projet
+
+```
+arboris/
+├── docker-compose.yml       # PostgreSQL 16 (port 5433)
+├── prisma/
+│   ├── schema.prisma        # Modèles Category, Stack, Skill, User
+│   ├── catalog-data.ts      # Données source du catalogue (pour le seed)
+│   ├── seed.ts              # Script de seed (prisma db seed)
+│   └── migrations/          # Historique des migrations PostgreSQL
+├── src/
+│   ├── routes/
+│   │   ├── __root.tsx           # Shell HTML (head, providers, Header/Footer)
+│   │   ├── index.tsx            # Accueil (hero + index rapide)
+│   │   ├── auth.tsx             # Connexion / inscription
+│   │   ├── skills.index.tsx     # /skills — catalogue filtrable
+│   │   ├── skills.$id.tsx       # /skills/:id — fiche d'un skill
+│   │   └── getting-started.tsx  # /getting-started — premier pas par stack
+│   ├── server/
+│   │   ├── db.ts                # Singleton PrismaClient (serveur uniquement)
+│   │   ├── catalog.server.ts    # Requêtes Prisma → objets UI
+│   │   ├── auth.functions.ts    # Login, register, logout, session
+│   │   └── functions.ts         # Server functions (getCatalog, getSkill)
+│   ├── components/              # Header, Footer, ThemeToggle, LangSwitch, Icon
+│   ├── lib/
+│   │   ├── catalog.ts           # Types partagés + helpers (prompts, couleurs)
+│   │   ├── i18n.tsx             # Contexte FR/EN + dictionnaires
+│   │   ├── theme.ts             # Thème clair/sombre (View Transitions)
+│   │   └── useCopy.ts           # Hook copie presse-papiers
+│   └── styles.css               # Tailwind + tokens de design Arboris
+└── vite.config.ts               # Plugins TanStack Start + Tailwind
+```
+
+## 🧠 Notes d'architecture
+
+- **Accès base côté serveur uniquement.** Prisma n'est jamais importé côté client :
+  `src/server/db.ts` est chargé *dynamiquement* à l'intérieur des handlers de
+  server functions, donc il ne finit jamais dans le bundle navigateur. Les pages
+  appellent ces fonctions via leur `loader`.
+- **Modèle de données.** `Category (1) — (N) Skill`, `Skill (N) — (N) Stack`
+  (relation many-to-many implicite), `User` pour l'authentification. Les listes
+  bilingues et les tableaux (`tech`, `compat`, `does`, `triggers`) sont stockés
+  en JSON sérialisé (colonnes `*Json`) et désérialisés dans `catalog.server.ts`.
+- **Sessions.** Cookies HTTP-only chiffrés via `@tanstack/react-start/server`
+  (`useSession`), secret `SESSION_SECRET` dans `.env`.
+- **i18n sans flash de contenu.** Le serveur rend le français par défaut ; la
+  langue mémorisée (localStorage) est appliquée au montage côté client.
+- **Thème sans flash.** Un court script inline (`THEME_INIT_SCRIPT`) applique
+  `data-theme` avant le premier paint.
+
+---
+
+Généré à partir du prototype « Catalogue de skills IA ».

package/cli/manifest.json

@@ -0,0 +1,323 @@
+{
+  "version": 1,
+  "generatedAt": "2026-07-02T11:59:34.797Z",
+  "stacks": [
+    {
+      "id": "node",
+      "label": "Node.js"
+    },
+    {
+      "id": "js",
+      "label": "JavaScript"
+    },
+    {
+      "id": "ts",
+      "label": "TypeScript"
+    },
+    {
+      "id": "fastapi",
+      "label": "FastAPI"
+    },
+    {
+      "id": "react",
+      "label": "React"
+    },
+    {
+      "id": "angular",
+      "label": "Angular"
+    },
+    {
+      "id": "java",
+      "label": "Java"
+    },
+    {
+      "id": "spring-boot",
+      "label": "Spring Boot"
+    },
+    {
+      "id": "docker",
+      "label": "Docker"
+    },
+    {
+      "id": "k9",
+      "label": "K9"
+    },
+    {
+      "id": "postgresql",
+      "label": "PostgreSQL"
+    },
+    {
+      "id": "mysql",
+      "label": "MySQL"
+    },
+    {
+      "id": "prisma",
+      "label": "Prisma"
+    }
+  ],
+  "skillsByStack": {
+    "node": [
+      "ai-regression-testing",
+      "autonomous-loops",
+      "backend-patterns",
+      "bun-runtime",
+      "ck",
+      "codebase-onboarding",
+      "configure-ecc",
+      "cost-tracking",
+      "database-migrations",
+      "deployment-patterns",
+      "django-celery",
+      "dmux-workflows",
+      "docker-patterns",
+      "e2e-testing",
+      "ecc-guide",
+      "energy-procurement",
+      "exa-search",
+      "flox-environments",
+      "healthcare-eval-harness",
+      "kubernetes-patterns",
+      "mcp-server-patterns",
+      "mysql-patterns",
+      "nodejs-keccak256",
+      "prisma-patterns",
+      "prompt-optimizer",
+      "react-performance",
+      "react-testing",
+      "redis-patterns",
+      "search-first",
+      "strategic-compact",
+      "tdd-workflow",
+      "ui-demo",
+      "vite-patterns",
+      "windows-desktop-e2e"
+    ],
+    "js": [
+      "bun-runtime",
+      "coding-standards",
+      "configure-ecc",
+      "django-security",
+      "error-handling",
+      "frontend-slides",
+      "hexagonal-architecture",
+      "iterative-retrieval",
+      "laravel-security",
+      "mcp-server-patterns",
+      "mysql-patterns",
+      "nodejs-keccak256",
+      "plankton-code-quality",
+      "quarkus-verification",
+      "react-native-patterns",
+      "react-performance",
+      "ui-demo",
+      "verification-loop",
+      "vite-patterns"
+    ],
+    "ts": [
+      "agent-payment-x402",
+      "agent-sort",
+      "ai-regression-testing",
+      "api-connector-builder",
+      "api-design",
+      "autonomous-loops",
+      "backend-patterns",
+      "benchmark",
+      "bun-runtime",
+      "clickhouse-io",
+      "codebase-onboarding",
+      "coding-standards",
+      "configure-ecc",
+      "database-migrations",
+      "deployment-patterns",
+      "e2e-testing",
+      "error-handling",
+      "evm-token-decimals",
+      "frontend-patterns",
+      "healthcare-cdss-patterns",
+      "healthcare-emr-patterns",
+      "healthcare-phi-compliance",
+      "hexagonal-architecture",
+      "laravel-plugin-discovery",
+      "mailtrap-email-integration",
+      "mcp-server-patterns",
+      "nestjs-patterns",
+      "nodejs-keccak256",
+      "orch-pipeline",
+      "plan-orchestrate",
+      "plankton-code-quality",
+      "prisma-patterns",
+      "prompt-optimizer",
+      "react-native-patterns",
+      "recsys-pipeline-architect",
+      "security-review",
+      "tdd-workflow",
+      "verification-loop",
+      "vite-patterns",
+      "vue-patterns"
+    ],
+    "fastapi": [
+      "codebase-onboarding",
+      "error-handling",
+      "fastapi-patterns",
+      "flox-environments",
+      "gan-style-harness",
+      "ml-adoption-playbook",
+      "python-patterns",
+      "python-testing",
+      "recsys-pipeline-architect"
+    ],
+    "react": [
+      "agent-harness-construction",
+      "agent-sort",
+      "angular-developer",
+      "benchmark-methodology",
+      "click-path-audit",
+      "codebase-onboarding",
+      "coding-standards",
+      "configure-ecc",
+      "continuous-learning-v2",
+      "documentation-lookup",
+      "error-handling",
+      "frontend-a11y",
+      "frontend-patterns",
+      "gan-style-harness",
+      "liquid-glass-design",
+      "motion-advanced",
+      "motion-foundations",
+      "motion-patterns",
+      "motion-ui",
+      "prompt-optimizer",
+      "react-native-patterns",
+      "react-patterns",
+      "react-performance",
+      "react-testing",
+      "remotion-video-creation",
+      "security-review",
+      "taste",
+      "tdd-workflow",
+      "video-editing",
+      "vite-patterns"
+    ],
+    "angular": [
+      "angular-developer",
+      "codebase-onboarding",
+      "react-patterns"
+    ],
+    "java": [
+      "agent-payment-x402",
+      "configure-ecc",
+      "hexagonal-architecture",
+      "inherit-legacy-style",
+      "java-coding-standards",
+      "jpa-patterns",
+      "kotlin-patterns",
+      "kotlin-testing",
+      "plan-orchestrate",
+      "prompt-optimizer",
+      "quarkus-patterns",
+      "quarkus-security",
+      "quarkus-tdd",
+      "quarkus-verification",
+      "repo-scan",
+      "springboot-patterns",
+      "springboot-security",
+      "springboot-tdd",
+      "springboot-verification",
+      "tinystruct-patterns"
+    ],
+    "spring-boot": [
+      "agent-payment-x402",
+      "configure-ecc",
+      "java-coding-standards",
+      "jpa-patterns",
+      "prompt-optimizer",
+      "springboot-patterns",
+      "springboot-security",
+      "springboot-tdd",
+      "springboot-verification"
+    ],
+    "docker": [
+      "agent-eval",
+      "benchmark",
+      "codebase-onboarding",
+      "deployment-patterns",
+      "docker-patterns",
+      "flox-environments",
+      "homelab-pihole-dns",
+      "homelab-wireguard-vpn",
+      "kubernetes-patterns",
+      "mle-workflow",
+      "production-audit",
+      "prompt-optimizer",
+      "quarkus-verification",
+      "safety-guard",
+      "uncloud",
+      "vite-patterns"
+    ],
+    "k9": [
+      "deployment-patterns",
+      "docker-patterns",
+      "flox-environments",
+      "kubernetes-patterns",
+      "prompt-optimizer",
+      "quarkus-security",
+      "uncloud"
+    ],
+    "postgresql": [
+      "agentic-os",
+      "architecture-decision-records",
+      "blueprint",
+      "clickhouse-io",
+      "codebase-onboarding",
+      "configure-ecc",
+      "csharp-testing",
+      "database-migrations",
+      "deployment-patterns",
+      "django-patterns",
+      "django-security",
+      "django-verification",
+      "docker-patterns",
+      "flox-environments",
+      "git-workflow",
+      "golang-patterns",
+      "golang-testing",
+      "hexagonal-architecture",
+      "jpa-patterns",
+      "knowledge-ops",
+      "kotlin-exposed-patterns",
+      "kotlin-ktor-patterns",
+      "kotlin-patterns",
+      "mle-workflow",
+      "mysql-patterns",
+      "perl-testing",
+      "plan-orchestrate",
+      "postgres-patterns",
+      "prisma-patterns",
+      "prompt-optimizer",
+      "python-testing",
+      "quarkus-patterns",
+      "quarkus-verification",
+      "redis-patterns",
+      "springboot-tdd",
+      "springboot-verification",
+      "uncloud"
+    ],
+    "mysql": [
+      "clickhouse-io",
+      "database-migrations",
+      "laravel-security",
+      "mysql-patterns",
+      "python-testing"
+    ],
+    "prisma": [
+      "ai-regression-testing",
+      "architecture-decision-records",
+      "codebase-onboarding",
+      "database-migrations",
+      "deployment-patterns",
+      "documentation-lookup",
+      "nestjs-patterns",
+      "prisma-patterns"
+    ]
+  }
+}