Installation

Ce guide vous accompagne dans l'installation et la configuration du projet 2Krika.

Prérequis

Avant de commencer, assurez-vous d'avoir installé:

• Node.js version 18 ou supérieure
• pnpm version 9.0.0 ou supérieure
• Git pour le contrôle de version

Vérifier les installations

node --version  # v18.0.0 ou supérieur
pnpm --version  # 9.0.0 ou supérieur
git --version

Installation du Projet

1. Cloner le Repository

git clone [repository-url]
cd krika-ui

2. Installer les Dépendances

Le projet utilise pnpm workspaces pour gérer le monorepo:

pnpm install

Cette commande installera toutes les dépendances pour:

• L'application customers
• L'application staffs
• L'application docs
• Les packages partagés (utilities)

3. Configuration des Variables d'Environnement

Chaque application nécessite ses propres variables d'environnement.

App Customers

cd apps/customers
cp .env.example .env

Configurez les variables suivantes dans apps/customers/.env:

# API Configuration
NEXT_PUBLIC_API_URL=https://api.2krikaservices.cloud

# Socket Configuration
NEXT_PUBLIC_SOCKET_URL=wss://api.2krikaservices.cloud

App Staffs

cd apps/staffs
cp .env.example .env

Configurez les variables pour l'application staffs.

Démarrage du Projet

Démarrer Toutes les Applications

Pour démarrer toutes les applications en mode développement:

pnpm dev

Cela lancera:

• Customers: http://localhost:3000
• Staffs: http://localhost:3001
• Docs: http://localhost:3002

Démarrer une Application Spécifique

Pour démarrer uniquement l'application customers:

cd apps/customers
pnpm dev

Pour l'application staffs:

cd apps/staffs
pnpm dev

Scripts Disponibles

Scripts Globaux (racine du projet)

• pnpm dev - Démarre tous les serveurs de développement
• pnpm build - Build toutes les applications
• pnpm lint - Vérifie le code avec ESLint
• pnpm format - Formate le code avec Prettier
• pnpm check-types - Vérifie les types TypeScript

Scripts par Application

Dans chaque dossier d'application (apps/customers, apps/staffs):

• pnpm dev - Démarre le serveur de développement
• pnpm build - Build l'application pour la production
• pnpm start - Démarre le serveur de production
• pnpm lint - Vérifie le code de l'application

Vérification de l'Installation

Une fois l'installation terminée et les serveurs démarrés, vérifiez:

1. L'application customers sur http://localhost:3000
2. L'application staffs sur http://localhost:3001
3. La documentation sur http://localhost:3002

Problèmes Courants

Port déjà utilisé

Si un port est déjà utilisé, vous pouvez:

• Arrêter le processus utilisant le port
• Ou modifier le port dans le fichier de configuration de l'application

Erreurs de dépendances

Si vous rencontrez des erreurs de dépendances:

# Nettoyer les node_modules
rm -rf node_modules apps/*/node_modules

# Nettoyer le cache pnpm
pnpm store prune

# Réinstaller
pnpm install

Prochaines Étapes