FAQ - Kazuryy/cochin-project-manager GitHub Wiki

❓ FAQ - Questions fréquemment posées

Réponses aux questions les plus courantes sur le Cochin Project Manager.

🚀 Installation et démarrage

Q: Quelles sont les exigences système minimales ?

R:

  • Docker : 4GB RAM, 10GB disque libre
  • Installation manuelle : Python 3.11+, Node.js 18+, 2GB RAM

Q: Pourquoi Docker ne démarre pas ?

R: Vérifiez que :

  • Docker est installé et démarré : docker --version
  • Votre utilisateur est dans le groupe docker : sudo usermod -aG docker $USER
  • Les ports 1337 et 8000 sont libres : sudo lsof -i :1337

Q: Comment changer les ports par défaut ?

R: Modifiez les ports dans docker-compose.yml :

services:
  frontend:
    ports:
      - "8080:80"  # Nouveau port frontend
  backend:
    ports:
      - "9000:8000"  # Nouveau port backend

👤 Authentification et utilisateurs

Q: J'ai oublié mon mot de passe, que faire ?

R: Contactez votre administrateur qui peut le réinitialiser via :

./docker-helper.sh exec backend python manage.py changepassword username

Q: Pourquoi ma session expire rapidement ?

R: Par sécurité, les sessions expirent après inactivité. L'administrateur peut ajuster la durée dans les paramètres Django.

Q: Comment créer plusieurs utilisateurs rapidement ?

R: Utilisez l'interface Django Admin (http://localhost:8000/admin) ou des scripts de création en lot.

📊 Tables dynamiques et données

Q: Puis-je modifier une table après création ?

R: Oui, via l'interface d'administration. Attention : certains changements peuvent affecter les données existantes.

Q: Combien d'enregistrements puis-je stocker ?

R: Avec SQLite (par défaut) : jusqu'à plusieurs millions d'enregistrements. Pour plus, utilisez PostgreSQL.

Q: Les données sont-elles sauvegardées automatiquement ?

R: Oui, le système crée des sauvegardes automatiques quotidiennes/hebdomadaires (configurable par l'admin).

Q: Comment importer des données existantes ?

R: Utilisez l'API REST ou l'interface admin Django pour importer via CSV/JSON.

💰 Système de devis

Q: Que signifient les différents statuts de devis ?

R:

  • 🔴 OFF : Devis inactif
  • 🟡 À venir : Planifié pour le futur
  • 🔵 En cours : En cours d'exécution
  • 🟢 Terminé : Finalisé

Q: Puis-je avoir plusieurs devis par projet ?

R: Oui, chaque projet peut avoir plusieurs devis avec des statuts différents.

Q: Comment calculer automatiquement les montants ?

R: Actuellement manuel. Une fonctionnalité de calcul automatique est prévue dans une version future.

📄 Documents PDF

Q: Quelle est la taille limite pour les PDF ?

R: 10MB par fichier par défaut. L'administrateur peut modifier cette limite.

Q: Puis-je modifier un PDF après upload ?

R: Non, mais vous pouvez supprimer et re-uploader une nouvelle version.

Q: Les PDF sont-ils sécurisés ?

R: Oui, ils sont stockés de manière sécurisée et seuls les utilisateurs autorisés peuvent y accéder.

🔧 Problèmes techniques

Q: L'application est lente, que faire ?

R:

  1. Vérifiez l'espace disque disponible
  2. Redémarrez les conteneurs : ./docker-helper.sh restart
  3. Consultez les logs : ./docker-helper.sh logs

Q: Erreur "500 Internal Server Error" ?

R:

  1. Vérifiez les logs backend : ./docker-helper.sh logs backend
  2. Vérifiez la configuration .env
  3. Contactez l'administrateur avec les logs d'erreur

Q: Les changements ne s'affichent pas ?

R:

  1. Rechargez la page (Ctrl+F5)
  2. Videz le cache du navigateur
  3. Vérifiez que la sauvegarde a réussi

🎨 Interface et utilisation

Q: Comment changer la langue de l'interface ?

R: Actuellement en français uniquement. Le support multilingue est prévu pour une version future.

Q: Puis-je personnaliser l'apparence ?

R: Le thème sombre/clair s'adapte automatiquement à votre système. Plus d'options de personnalisation sont prévues.

Q: L'interface fonctionne-t-elle sur mobile ?

R: Oui, l'interface est responsive et fonctionne sur tablettes et smartphones.

🔄 Migration et mises à jour

Q: Comment mettre à jour vers une nouvelle version ?

R:

git pull origin main
./docker-helper.sh down
./docker-helper.sh dev --build

Q: Mes données seront-elles préservées lors d'une mise à jour ?

R: Oui, les données sont dans des volumes Docker persistants. Mais faites toujours une sauvegarde avant mise à jour.

Q: Comment migrer vers un autre serveur ?

R:

  1. Sauvegardez le dossier ./data/
  2. Exportez la base de données
  3. Restaurez sur le nouveau serveur
  4. Relancez l'application

🌐 Déploiement et production

Q: Puis-je utiliser un nom de domaine personnalisé ?

R: Oui, configurez votre DNS vers l'IP du serveur et utilisez Nginx avec SSL.

Q: Comment configurer HTTPS ?

R: Utilisez Certbot pour obtenir un certificat gratuit :

sudo certbot --nginx -d votre-domaine.com

Q: L'application peut-elle gérer plusieurs entreprises ?

R: Actuellement mono-tenant. Une version multi-tenant est en développement.

📧 Notifications et intégrations

Q: Comment configurer les notifications Discord ?

R: L'administrateur doit ajouter DISCORD_WEBHOOK_URL dans le fichier .env.

Q: Puis-je intégrer avec d'autres outils ?

R: Oui, via l'API REST. Documentation disponible sur /api/docs/.

Q: Y a-t-il une API pour développeurs ?

R: Oui, API REST complète accessible à /api/. Authentification par JWT ou session.

💾 Sauvegarde et restauration

Q: À quelle fréquence sont faites les sauvegardes ?

R: Par défaut : quotidienne (4h), hebdomadaire (dimanche 5h), mensuelle (1er du mois 6h).

Q: Comment restaurer une sauvegarde ?

R: Via les commandes admin (pour administrateurs uniquement) :

./docker-helper.sh exec backend python manage.py restore_backup --backup-id=ID

Q: Les sauvegardes sont-elles chiffrées ?

R: Oui, avec AES-256 (configurable par l'administrateur).

🔍 Recherche et filtres

Q: Puis-je rechercher dans tous les projets à la fois ?

R: Actuellement limité à une table à la fois. La recherche globale est prévue.

Q: Comment sauvegarder mes filtres favoris ?

R: Utilisez la fonction "Sauvegarder le filtre" dans les filtres avancés.

Q: Puis-je exporter les résultats filtrés ?

R: Oui, l'export respecte les filtres appliqués.

🆘 Support et aide

Q: Où obtenir de l'aide ?

R:

  1. Documentation : Ce wiki complet
  2. Administrateur : Contact interne de votre organisation
  3. GitHub Issues : Rapporter un bug
  4. Discussions : Forum communautaire

Q: Comment rapporter un bug ?

R:

  1. Vérifiez qu'il n'existe pas déjà dans les Issues GitHub
  2. Incluez les étapes pour reproduire
  3. Joignez les logs d'erreur si possible
  4. Précisez votre environnement (OS, navigateur, version)

Q: Comment suggérer une amélioration ?

R: Ouvrez une Discussion GitHub avec le tag "enhancement".

🔮 Fonctionnalités futures

Q: Quelles nouvelles fonctionnalités sont prévues ?

R: Roadmap publique disponible dans les Issues GitHub :

  • Interface multilingue
  • Système de notifications avancé
  • Rapports et analytics avancés
  • Mode multi-tenant
  • Application mobile native

Q: Puis-je contribuer au développement ?

R: Absolument ! Consultez le Guide de contribution pour commencer.

💡 Une question non listée ? Ouvrez une Discussion GitHub ou contactez votre administrateur.

📚 Ressources utiles :