96 lines
2.9 KiB
Markdown
96 lines
2.9 KiB
Markdown
# PercoHub 🏠
|
|
|
|
Dashboard centralisé pour accéder à tous les services et projets du homelab de Perco.
|
|
|
|
## Stack
|
|
|
|
- **Backend** : PHP 8 (lecture `services.json`, check Docker + HTTP)
|
|
- **Frontend** : Tailwind CSS CDN + Vanilla JS
|
|
- **Données** : `services.json` — catalogue éditable manuellement
|
|
|
|
## Démarrage
|
|
|
|
```bash
|
|
nohup php -S 0.0.0.0:9300 -t /home/perco/projects/percohub/ > /tmp/percohub-php.log 2>&1 &
|
|
```
|
|
|
|
**URL locale** : http://192.168.1.29:9300
|
|
|
|
## Fonctionnalités
|
|
|
|
- ✅ Vue centralisée de tous les services (Docker + projets PHP)
|
|
- ✅ Status live (Docker inspect + HTTP ping)
|
|
- ✅ Catégories : Projets Luca / Infrastructure / Média / Domotique / Productivité / VPN Firefox
|
|
- ✅ Filtre par catégorie (navbar)
|
|
- ✅ Stats globales (online/offline)
|
|
- ✅ Auto-refresh toutes les 30s
|
|
- ✅ Clic sur une carte → ouvre l'URL dans un nouvel onglet
|
|
- ✅ Dark theme cohérent avec les autres projets
|
|
|
|
## Structure
|
|
|
|
```
|
|
percohub/
|
|
├── index.php # Page principale (shell HTML)
|
|
├── api.php # Backend : statuts Docker + HTTP
|
|
├── services.json # Catalogue des services (à éditer)
|
|
├── assets/
|
|
│ ├── style.css # Dark theme custom
|
|
│ └── app.js # Frontend : rendu, refresh, filtres
|
|
└── README.md
|
|
```
|
|
|
|
## Ajouter un service
|
|
|
|
Éditer `services.json` — ajouter un objet dans le tableau `services` de la bonne catégorie :
|
|
|
|
```json
|
|
{
|
|
"name": "Mon Service",
|
|
"desc": "Description courte",
|
|
"url": "http://192.168.1.29:PORT",
|
|
"docker": "nom-du-container",
|
|
"tags": ["tag1", "tag2"]
|
|
}
|
|
```
|
|
|
|
- `url` : null si pas d'interface web
|
|
- `docker` : null si ce n'est pas un container Docker (ex: serveur PHP)
|
|
- Si `docker` est renseigné → status via `docker inspect`
|
|
- Si seulement `url` → status via HTTP ping
|
|
|
|
## Ajouter une catégorie
|
|
|
|
Dans `services.json`, ajouter dans le tableau `categories` :
|
|
|
|
```json
|
|
{
|
|
"id": "ma-categorie",
|
|
"name": "Ma Catégorie",
|
|
"icon": "🔌",
|
|
"color": "violet",
|
|
"services": [...]
|
|
}
|
|
```
|
|
|
|
**Couleurs disponibles** : violet, slate, amber, emerald, sky, orange, rose
|
|
|
|
## API
|
|
|
|
| Endpoint | Description |
|
|
|----------|-------------|
|
|
| `/api.php?action=all` | Tous les services avec statuts |
|
|
| `/api.php?action=config` | Catalogue brut (sans checks) |
|
|
| `/api.php?action=docker` | Liste tous les containers Docker |
|
|
|
|
## Catégories actuelles
|
|
|
|
| Catégorie | Services |
|
|
|-----------|----------|
|
|
| 🛠️ Projets Luca | AgentStats, CronViz, MonStatut, AgentChat, HomeStatus |
|
|
| 🔧 Infrastructure | Portainer, Traefik, Grafana, InfluxDB, Dashdot, Watchtower |
|
|
| 🎬 Média | Plex, Jellyseerr, Sonarr, Radarr, Lidarr, Prowlarr, Jackett, qBittorrent, Pinchflat, Tautulli |
|
|
| 🏠 Domotique | Home Assistant, ESPhome, Syncthing, Grott, Bresser Live, Mosquitto, Frigate, CamWatch |
|
|
| 💼 Productivité | Nextcloud, Gitea, VSCode, Planka, Actual Budget, CronMaster, Homarr |
|
|
| 🦊 VPN Firefox | retak, coucouze, roxxor, xouz, nale |
|