q-admin 0.1.2

Universal Database Admin Interface - Connect to any database and get an instant admin panel

🚀 Q Admin

Interface d'administration universelle pour vos bases de données.
Connectez-vous à n'importe quelle base de données (SQLite, PostgreSQL, MySQL) et profitez instantanément d'un panel d'administration moderne, compact et performant.

(Note: Vous pouvez remplacer ce fichier par votre propre capture d'écran)

---

✨ Fonctionnalités

• 💎 Interface "Elite Compact" : Un design ultra-dense et moderne inspiré des meilleurs dashboards actuels.
• 🌍 Multi-Projets : Gérez plusieurs connexions de bases de données simultanément via le "Hub".
• 🔐 Sécurité Native : Système d'authentification intégré avec persistance des sessions.
• 🛠️ Outils Intégrés :
  • Explorateur de données (CRUD).
  • Playground SQL pour des requêtes personnalisées.
  • Visualiseur de schéma (ERD).
  • Support des tunnels SSH pour les bases distantes.
• 🌓 Mode Sombre / Clair : Une interface qui s'adapte à vos préférences.

---

📋 Prérequis

Pour l'utilisateur final (Utilisation simple)

• Python 3.9+ uniquement.
  (L'interface est pré-compilée et incluse dans le package Python).

Pour le développeur (Modification de l'interface)

• Node.js 18+ & npm (pour compiler le frontend).
• Python 3.9+ (pour le backend).

---

📦 Installation Rapide

Q Admin est distribué en tant que package Python. Vous pouvez l'installer via pip ou pipx (recommandé pour les outils CLI).

Via pipx (Recommandé)

pipx install q-admin

Via pip

pip install q-admin

---

🚀 Utilisation

Lancer le serveur

Une fois installé, lancez simplement la commande suivante :

q_admin --port 8787

Ouvrez ensuite votre navigateur sur : http://localhost:8787/admin

Premier lancement

Au premier démarrage, Q Admin vous guidera via un Assistant de Configuration pour :

1. Créer votre compte administrateur maître.
2. Connecter votre première base de données (Locale ou Distante via SSH).

---

🛠️ Configuration des bases de données

Q Admin supporte nativement :

• SQLite : Indiquez simplement le chemin vers votre fichier .db.
• PostgreSQL : Support du pilote asyncpg.
• MySQL / MariaDB : Support du pilote aiomysql.
• SSH Tunneling : Si votre base n'est pas accessible publiquement, Q Admin peut ouvrir un tunnel sécurisé.

---

👨‍💻 Pour les développeurs

Si vous souhaitez contribuer ou modifier l'interface :

1. Cloner le dépôt.
2. Backend : pip install -e .
3. Frontend : cd frontend && npm install && npm run dev
4. Build : npm run build dans le dossier frontend pour intégrer les modifs au package Python.

---

🔒 Sécurité & Confidentialité

Si vous hébergez ce projet sur un dépôt Git (GitHub, GitLab, etc.) :

• Exclusion des données : Le fichier .gitignore est configuré par défaut pour ne PAS inclure vos fichiers de configuration locaux (q_admin_config.json) ni la base de données du Hub (q_admin_hub.db).
• Mots de passe : Vos identifiants de connexion aux bases de données ne sont jamais poussés sur vos dépôts distants. Ils restent confinés à votre instance locale de Q Admin.

---

📄 Licence

Distribué sous licence MIT. Voir LICENSE pour plus d'informations.