Files
PTT-Live/server/api/admin.js
T
benoit 637cc3e3a7 feat: interface admin complète pour gestion système (Phase 2.3)
Implémentation complète de l'interface d'administration web :

Backend (server/api/admin.js) :
- Endpoints CRUD pour gestion des groupes (GET/POST/PUT/DELETE /admin/groups)
- Gestion utilisateurs connectés en temps réel (GET/DELETE /admin/users)
- Monitoring statistiques système (GET /admin/stats)
- Affichage logs serveur avec filtrage (GET /admin/logs)
- Configuration audio globale (PUT /admin/config/audio)
- Système de tracking des connexions/déconnexions
- Export fonctions registerUser, unregisterUser, addLog

Frontend (client/src/Admin.jsx + Admin.css) :
- Interface admin complète avec 4 onglets (Groupes, Utilisateurs, Stats, Logs)
- Gestion groupes : création, modification, suppression avec formulaires
- Gestion canaux audio par groupe (inputs/outputs)
- Liste utilisateurs connectés avec déconnexion forcée
- Dashboard statistiques temps réel (connexions, uptime, mémoire)
- Viewer logs avec code couleur par niveau (debug/info/warn/error)
- Rafraîchissement auto toutes les 3s
- Design responsive et mode sombre

Intégration système :
- Routes admin montées sous /admin dans index.js
- Enregistrement automatique des utilisateurs lors de la génération de token
- Logs serveur centralisés dans le système admin
- Routing simple frontend pour /admin (main.jsx)

🎛️ Interface accessible via https://localhost:5173/admin

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-24 20:13:20 +02:00

407 lines
9.6 KiB
JavaScript

/**
* API Admin - Gestion groupes, utilisateurs, monitoring
* Phase 2.3
*/
import { Router } from 'express';
import { readFileSync, writeFileSync } from 'fs';
import { join } from 'path';
import YAML from 'yaml';
import { fileURLToPath } from 'url';
import { dirname } from 'path';
const __dirname = dirname(fileURLToPath(import.meta.url));
const router = Router();
// État en mémoire des utilisateurs connectés
const connectedUsers = new Map(); // identity -> { username, groupId, roomName, connectedAt, lastActivity }
// Stats monitoring
const stats = {
totalConnections: 0,
activeConnections: 0,
audioStats: [],
logs: []
};
// Configuration file path
const configPath = join(__dirname, '..', 'config', 'config.yaml');
/**
* Charge la configuration depuis le fichier YAML
*/
function loadConfig() {
const configFile = readFileSync(configPath, 'utf8');
return YAML.parse(configFile);
}
/**
* Sauvegarde la configuration dans le fichier YAML
*/
function saveConfig(config) {
const yamlContent = YAML.stringify(config);
writeFileSync(configPath, yamlContent, 'utf8');
}
/**
* Ajoute un log au système
*/
export function addLog(level, message, meta = {}) {
const log = {
timestamp: new Date().toISOString(),
level,
message,
meta
};
stats.logs.unshift(log);
// Garder max 1000 logs en mémoire
if (stats.logs.length > 1000) {
stats.logs = stats.logs.slice(0, 1000);
}
}
/**
* Enregistre une connexion utilisateur
*/
export function registerUser(identity, username, groupId, roomName) {
connectedUsers.set(identity, {
username,
groupId,
roomName,
connectedAt: new Date().toISOString(),
lastActivity: new Date().toISOString()
});
stats.totalConnections++;
stats.activeConnections = connectedUsers.size;
addLog('info', `User connected: ${username}`, { groupId, identity });
}
/**
* Déconnecte un utilisateur
*/
export function unregisterUser(identity) {
const user = connectedUsers.get(identity);
if (user) {
connectedUsers.delete(identity);
stats.activeConnections = connectedUsers.size;
addLog('info', `User disconnected: ${user.username}`, { groupId: user.groupId, identity });
}
}
/**
* Met à jour l'activité d'un utilisateur
*/
export function updateUserActivity(identity) {
const user = connectedUsers.get(identity);
if (user) {
user.lastActivity = new Date().toISOString();
}
}
/**
* Ajoute des statistiques audio
*/
export function addAudioStats(data) {
const stat = {
timestamp: new Date().toISOString(),
...data
};
stats.audioStats.unshift(stat);
// Garder max 100 stats
if (stats.audioStats.length > 100) {
stats.audioStats = stats.audioStats.slice(0, 100);
}
}
// ========== Routes Admin ==========
/**
* GET /admin/groups
* Liste tous les groupes avec détails
*/
router.get('/groups', (req, res) => {
try {
const config = loadConfig();
res.json({
groups: config.groups
});
} catch (error) {
console.error('Erreur GET /admin/groups:', error);
res.status(500).json({ error: 'Failed to load groups' });
}
});
/**
* POST /admin/groups
* Crée un nouveau groupe
* Body: { id, name, description, audioBitrate?, channels }
*/
router.post('/groups', (req, res) => {
try {
const { id, name, description, audioBitrate, channels } = req.body;
if (!id || !name || !channels || !Array.isArray(channels)) {
return res.status(400).json({
error: 'Missing required fields: id, name, channels'
});
}
const config = loadConfig();
// Vérifier que l'ID n'existe pas déjà
if (config.groups.find(g => g.id === id)) {
return res.status(409).json({
error: `Group ${id} already exists`
});
}
// Créer le nouveau groupe
const newGroup = {
id,
name,
description: description || '',
audioBitrate: audioBitrate || config.audio.defaultBitrate,
channels
};
config.groups.push(newGroup);
saveConfig(config);
addLog('info', `Group created: ${name}`, { id });
res.status(201).json({
message: 'Group created',
group: newGroup
});
} catch (error) {
console.error('Erreur POST /admin/groups:', error);
res.status(500).json({ error: 'Failed to create group' });
}
});
/**
* PUT /admin/groups/:id
* Modifie un groupe existant
* Body: { name?, description?, audioBitrate?, channels? }
*/
router.put('/groups/:id', (req, res) => {
try {
const { id } = req.params;
const { name, description, audioBitrate, channels } = req.body;
const config = loadConfig();
const groupIndex = config.groups.findIndex(g => g.id === id);
if (groupIndex === -1) {
return res.status(404).json({
error: `Group ${id} not found`
});
}
// Mettre à jour les champs fournis
if (name !== undefined) config.groups[groupIndex].name = name;
if (description !== undefined) config.groups[groupIndex].description = description;
if (audioBitrate !== undefined) config.groups[groupIndex].audioBitrate = audioBitrate;
if (channels !== undefined) config.groups[groupIndex].channels = channels;
saveConfig(config);
addLog('info', `Group updated: ${config.groups[groupIndex].name}`, { id });
res.json({
message: 'Group updated',
group: config.groups[groupIndex]
});
} catch (error) {
console.error('Erreur PUT /admin/groups:', error);
res.status(500).json({ error: 'Failed to update group' });
}
});
/**
* DELETE /admin/groups/:id
* Supprime un groupe
*/
router.delete('/groups/:id', (req, res) => {
try {
const { id } = req.params;
const config = loadConfig();
const groupIndex = config.groups.findIndex(g => g.id === id);
if (groupIndex === -1) {
return res.status(404).json({
error: `Group ${id} not found`
});
}
const groupName = config.groups[groupIndex].name;
config.groups.splice(groupIndex, 1);
saveConfig(config);
addLog('info', `Group deleted: ${groupName}`, { id });
res.json({
message: 'Group deleted',
id
});
} catch (error) {
console.error('Erreur DELETE /admin/groups:', error);
res.status(500).json({ error: 'Failed to delete group' });
}
});
/**
* GET /admin/users
* Liste tous les utilisateurs connectés
*/
router.get('/users', (req, res) => {
try {
const users = Array.from(connectedUsers.entries()).map(([identity, data]) => ({
identity,
...data
}));
res.json({
users,
count: users.length
});
} catch (error) {
console.error('Erreur GET /admin/users:', error);
res.status(500).json({ error: 'Failed to load users' });
}
});
/**
* DELETE /admin/users/:identity
* Déconnecte un utilisateur (force disconnect)
*/
router.delete('/users/:identity', (req, res) => {
try {
const { identity } = req.params;
const user = connectedUsers.get(identity);
if (!user) {
return res.status(404).json({
error: `User ${identity} not found`
});
}
unregisterUser(identity);
addLog('warn', `User force disconnected: ${user.username}`, { identity });
res.json({
message: 'User disconnected',
identity
});
} catch (error) {
console.error('Erreur DELETE /admin/users:', error);
res.status(500).json({ error: 'Failed to disconnect user' });
}
});
/**
* GET /admin/stats
* Statistiques temps réel
*/
router.get('/stats', (req, res) => {
try {
res.json({
totalConnections: stats.totalConnections,
activeConnections: stats.activeConnections,
audioStats: stats.audioStats.slice(0, 20), // 20 dernières stats
uptime: process.uptime(),
memory: process.memoryUsage()
});
} catch (error) {
console.error('Erreur GET /admin/stats:', error);
res.status(500).json({ error: 'Failed to load stats' });
}
});
/**
* GET /admin/logs
* Logs serveur
* Query params: ?limit=100&level=info
*/
router.get('/logs', (req, res) => {
try {
const limit = parseInt(req.query.limit) || 100;
const level = req.query.level;
let logs = stats.logs;
// Filtrer par niveau si spécifié
if (level) {
logs = logs.filter(log => log.level === level);
}
// Limiter le nombre
logs = logs.slice(0, limit);
res.json({
logs,
total: stats.logs.length
});
} catch (error) {
console.error('Erreur GET /admin/logs:', error);
res.status(500).json({ error: 'Failed to load logs' });
}
});
/**
* GET /admin/config
* Configuration serveur complète
*/
router.get('/config', (req, res) => {
try {
const config = loadConfig();
res.json(config);
} catch (error) {
console.error('Erreur GET /admin/config:', error);
res.status(500).json({ error: 'Failed to load config' });
}
});
/**
* PUT /admin/config/audio
* Met à jour la configuration audio globale
* Body: { sampleRate?, defaultBitrate?, jitterBufferMs? }
*/
router.put('/config/audio', (req, res) => {
try {
const { sampleRate, defaultBitrate, jitterBufferMs } = req.body;
const config = loadConfig();
if (sampleRate !== undefined) config.audio.sampleRate = sampleRate;
if (defaultBitrate !== undefined) config.audio.defaultBitrate = defaultBitrate;
if (jitterBufferMs !== undefined) config.audio.jitterBufferMs = jitterBufferMs;
saveConfig(config);
addLog('info', 'Audio config updated', { sampleRate, defaultBitrate, jitterBufferMs });
res.json({
message: 'Audio config updated',
audio: config.audio
});
} catch (error) {
console.error('Erreur PUT /admin/config/audio:', error);
res.status(500).json({ error: 'Failed to update audio config' });
}
});
export default router;