Application Staffs

L'application Staffs est la plateforme d'administration de 2Krika. Elle permet à l'équipe administrative de gérer l'ensemble de la plateforme, modérer le contenu, gérer les utilisateurs et analyser les performances.

Vue d'Ensemble

L'application Staffs offre des outils de gestion et d'administration pour:

Gestion des Utilisateurs

• Voir et rechercher tous les utilisateurs
• Gérer les profils utilisateurs
• Suspendre ou bannir des comptes
• Gérer les vérifications KYC
• Consulter l'historique d'activité

Modération de Contenu

• Approuver ou rejeter les services
• Modérer les avis et commentaires
• Gérer les signalements
• Surveiller le contenu

Gestion des Commandes

• Voir toutes les commandes
• Gérer les litiges
• Assistance client
• Remboursements

Analytics et Statistiques

• Tableau de bord avec KPIs
• Revenus et commissions
• Statistiques d'utilisation
• Rapports personnalisés

Configuration

• Paramètres de la plateforme
• Gestion des catégories
• Configuration des commissions
• Gestion des frais de plateforme

Technologies

• Framework: Next.js avec App Router
• Styling: Tailwind CSS
• UI Components: Mantine UI 7.x/8.x
• Data Fetching: TanStack React Query
• Charts: Recharts
• HTTP Client: Axios
• Date Handling: date-fns

Structure du Projet

apps/staffs/
├── src/
│   ├── app/                           # Routes et pages
│   │   ├── (auth)/                    # Authentification admin
│   │   │   └── login/
│   │   ├── (dashboard)/               # Dashboard principal
│   │   │   ├── page.tsx               # Vue d'ensemble
│   │   │   ├── users/                 # Gestion utilisateurs
│   │   │   ├── services/              # Gestion services
│   │   │   ├── orders/                # Gestion commandes
│   │   │   ├── reviews/               # Modération avis
│   │   │   ├── reports/               # Signalements
│   │   │   ├── categories/            # Gestion catégories
│   │   │   ├── transactions/          # Transactions
│   │   │   ├── analytics/             # Analytics
│   │   │   └── settings/              # Paramètres
│   │   └── layout.tsx
│   ├── components/                     # Composants réutilisables
│   │   ├── ui/                        # Composants UI de base
│   │   ├── layout/                    # Layout components
│   │   ├── charts/                    # Graphiques
│   │   └── features/                  # Feature components
│   ├── services/                       # Services API
│   ├── hooks/                          # Custom React hooks
│   ├── lib/                            # Libraries et utilities
│   ├── models/                         # TypeScript interfaces
│   ├── types/                          # Types TypeScript
│   ├── config/                         # Configuration
│   ├── utils/                          # Utilitaires
│   └── middleware.ts                   # Middleware Next.js
├── public/                             # Assets statiques
├── .env.example                        # Variables d'environnement
├── next.config.mjs                     # Config Next.js
├── tailwind.config.ts                  # Config Tailwind
└── package.json

Route Groups

(auth) - Authentification Admin

Routes publiques pour l'authentification des administrateurs.

(dashboard) - Dashboard Admin

Routes protégées pour toutes les fonctionnalités d'administration:

• Tableau de bord principal avec KPIs
• Gestion des utilisateurs
• Modération de services
• Gestion des commandes
• Analytics et rapports
• Configuration de la plateforme

Fonctionnalités Principales

1. Dashboard Principal

• Vue d'ensemble avec KPIs
• Graphiques de performance
• Activité récente
• Alertes et notifications

2. Gestion des Utilisateurs

• Liste complète des utilisateurs
• Recherche et filtres avancés
• Profils détaillés
• Historique d'activité
• Actions administratives (suspendre, bannir)

3. Modération de Services

• Queue de modération
• Validation des services
• Rejet avec raisons
• Édition de contenu

4. Gestion des Commandes

• Vue de toutes les commandes
• Filtres par statut
• Gestion des litiges
• Remboursements manuels

5. Vérification KYC

• Queue de vérifications en attente
• Documents uploadés par les vendeurs
• Validation ou rejet avec commentaires
• Historique des vérifications

6. Analytics

• Revenus et commissions
• Statistiques d'utilisation
• Performance des catégories
• Rapports exportables

7. Configuration

• Paramètres de plateforme
• Gestion des catégories
• Configuration des taux de commission
• Frais de plateforme
• Paramètres de paiement

8. Gestion des Transactions

• Historique complet
• Détails des transactions
• Statistiques de revenus
• Gestion des payouts

Rôles et Permissions

Super Admin

Accès complet à toutes les fonctionnalités:

• Gestion des utilisateurs
• Configuration de la plateforme
• Gestion des autres admins
• Accès aux données sensibles

Admin

Accès aux fonctionnalités principales:

• Modération de contenu
• Gestion des commandes
• Support client
• Analytics

Moderator

Accès limité:

• Modération de services
• Modération d'avis
• Gestion des signalements

Configuration

Variables d'Environnement

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

# Admin Panel
NEXT_PUBLIC_APP_URL=https://staff.2krika.com

Middleware

L'application utilise un middleware Next.js pour:

• Protection des routes
• Vérification de l'authentification admin
• Redirection si non authentifié

Sécurité

Authentification

• Login sécurisé par email/mot de passe
• JWT tokens
• Refresh token automatique
• Session timeout

Permissions

• Vérification des rôles côté serveur
• Restrictions d'accès par fonctionnalité
• Audit logs des actions admin

Protection des Données

• Chiffrement des données sensibles
• Logs d'accès
• HTTPS obligatoire

Développement

Démarrer l'application

cd apps/staffs
pnpm dev

L'application sera disponible sur http://localhost:3001

Routes Principales

• /login - Connexion admin
• / - Dashboard principal
• /users - Gestion des utilisateurs
• /services - Gestion des services
• /orders - Gestion des commandes
• /analytics - Analytics et statistiques
• /settings - Configuration

Guides Détaillés