Dashboard_Admin_Sys/README.md
Guillaume DENIS 05df4c0dd8 chore(server): reformat code and improve mise tooling config
- Normalise le style (guillemets doubles, black/ruff)
- mise.toml : ajoute [tools], tâches dev/clean, port par défaut
- server.py : fallback PORT via variable d'environnement
2026-07-04 18:17:22 +02:00

55 lines
1.6 KiB
Markdown

# Portail Infra
Portail d'outils pour administrateurs systèmes et réseau, servi par un serveur Python unique :
- **cmdb** — inventaire (machines, réseaux, IP/MAC, salles & baies), recherche Active Directory, import/export CSV, snapshots de la base
- **cert-generator** — génération de certificats SSL (clés RSA, CSR)
- **switch-config** — mapper de VLAN et export de configuration switch
Le tout accessible depuis un seul serveur, avec navigation entre les 3 apps.
## Prérequis
- [mise](https://mise.jdx.dev/) — lanceur de tâches
Installer mise :
```bash
curl https://mise.run | sh # mise
```
## Installation
Le dossier `cmdb` est un sous-module git — cloner avec `--recurse-submodules` :
```bash
git clone --recurse-submodules https://git.thehackdes.com/TheHackdes/Dashboard_Admin_Sys.git
cd Dashboard_Admin_Sys
```
Sous-module déjà cloné sans l'option :
```bash
git submodule update --init --recursive
```
## Lancer
```bash
mise run run
```
Puis ouvrir **http://127.0.0.1:8000** (redirige vers la CMDB).
Équivalent direct, sans mise :
```bash
uv run server.py # port 8000 par défaut
uv run server.py 8080 # port personnalisé
```
## Notes
- **Données** : la base `cmdb/cmdb.db` et le dossier `cmdb/snapshots/` restent **locaux** (non versionnés). Sauvegarde/migration via **Export CSV** ou **Snapshots** (Préférences ⚙).
- **Active Directory** : la recherche AD nécessite `ldap3` (installé par uv). Configuration dans Préférences → Active Directory.
- **Proxy d'entreprise** : si l'accès réseau passe par un proxy, exporter `http_proxy` / `https_proxy` avant de lancer.