Reestructuración modular integral de servicios, reorganización de gestión en docs/ y limpieza profunda del repositorio

2026-03-06 18:03:07 -03:00
parent 15725e0b3c
commit ac9bdf516b
286 changed files with 36187 additions and 112775 deletions
@@ -0,0 +1,7 @@
+FROM node:18-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm install
+COPY . .
+EXPOSE 3001
+CMD ["npm", "run", "dev"]
@@ -0,0 +1,19 @@
+{
+    "name": "dtic-bitacoras-api",
+    "version": "1.0.0",
+    "description": "API REST para dtic-BITACORAs",
+    "main": "src/server.js",
+    "scripts": {
+        "start": "node src/server.js",
+        "dev": "nodemon src/server.js"
+    },
+    "dependencies": {
+        "cors": "^2.8.5",
+        "express": "^4.18.2",
+        "helmet": "^7.1.0",
+        "pg": "^8.11.3"
+    },
+    "devDependencies": {
+        "nodemon": "^3.0.2"
+    }
+}
@@ -0,0 +1,122 @@
+module.exports = (pool) => {
+    const router = require('express').Router();
+
+    // GET /api/bitacoras — Listar bitácoras (opcionalmente por fecha)
+    router.get('/', async (req, res) => {
+        const { fecha } = req.query;
+        if (fecha) {
+            const { rows } = await pool.query('SELECT * FROM bitacoras.bitacoras WHERE fecha = $1', [fecha]);
+            if (rows.length === 0) {
+                // Auto-crear bitácora del día
+                const insert = await pool.query(
+                    'INSERT INTO bitacoras.bitacoras (fecha) VALUES ($1) RETURNING *', [fecha]
+                );
+                return res.json(insert.rows[0]);
+            }
+            return res.json(rows[0]);
+        }
+        const { rows } = await pool.query('SELECT * FROM bitacoras.bitacoras ORDER BY fecha DESC LIMIT 30');
+        res.json(rows);
+    });
+
+    // GET /api/bitacoras/:fecha/completa — Bitácora completa con entradas agrupadas por nodo
+    router.get('/:fecha/completa', async (req, res) => {
+        const { fecha } = req.params;
+
+        // Obtener o crear bitácora
+        let bitacora;
+        const bResult = await pool.query('SELECT * FROM bitacoras.bitacoras WHERE fecha = $1', [fecha]);
+        if (bResult.rows.length === 0) {
+            const insert = await pool.query('INSERT INTO bitacoras.bitacoras (fecha) VALUES ($1) RETURNING *', [fecha]);
+            bitacora = insert.rows[0];
+        } else {
+            bitacora = bResult.rows[0];
+        }
+
+        // Obtener entradas con datos del nodo
+        const { rows: entradas } = await pool.query(`
+      SELECT e.*, n.nombre as nodo_nombre, n.ip as nodo_ip
+      FROM bitacoras.entradas e
+      LEFT JOIN bitacoras.nodos n ON e.nodo_id = n.id
+      WHERE e.bitacora_id = $1
+      ORDER BY e.inicio DESC
+    `, [bitacora.id]);
+
+        // Agrupar por nodo
+        const porNodo = {};
+        entradas.forEach(e => {
+            const nodo = e.nodo_nombre || 'sin-nodo';
+            if (!porNodo[nodo]) porNodo[nodo] = { nodo: nodo, ip: e.nodo_ip, entradas: [] };
+            porNodo[nodo].entradas.push(e);
+        });
+
+        res.json({ ...bitacora, nodos: Object.values(porNodo) });
+    });
+
+    // GET /api/bitacoras/:fecha/export — Exportar a Markdown
+    router.get('/:fecha/export', async (req, res) => {
+        const { fecha } = req.params;
+        const bResult = await pool.query('SELECT * FROM bitacoras.bitacoras WHERE fecha = $1', [fecha]);
+        if (bResult.rows.length === 0) return res.status(404).json({ error: 'Bitácora no encontrada' });
+
+        const bitacora = bResult.rows[0];
+        const { rows: entradas } = await pool.query(`
+      SELECT e.*, n.nombre as nodo_nombre
+      FROM bitacoras.entradas e
+      LEFT JOIN bitacoras.nodos n ON e.nodo_id = n.id
+      WHERE e.bitacora_id = $1
+      ORDER BY n.nombre, e.inicio DESC
+    `, [bitacora.id]);
+
+        // Generar Markdown compatible con ADN
+        const [y, m, d] = fecha.split('-');
+        let md = `# Bitácora de Operaciones - ${d}/${m}/${y}\n\n`;
+        md += `## 📂 Actividades Detalladas\n\n`;
+
+        const porNodo = {};
+        entradas.forEach(e => {
+            const nodo = e.nodo_nombre || 'sin-nodo';
+            if (!porNodo[nodo]) porNodo[nodo] = [];
+            porNodo[nodo].push(e);
+        });
+
+        Object.entries(porNodo).forEach(([nodo, entries]) => {
+            md += `### ${nodo}\n\n`;
+            md += `| I | F | Descripción | E |\n`;
+            md += `| :--- | :--- | :--- | :--- |\n`;
+            entries.forEach(e => {
+                const inicio = e.inicio ? e.inicio.substring(0, 5) : '-';
+                const fin = e.fin ? e.fin.substring(0, 5) : '-';
+                const ia = e.es_ia ? '(IA) ' : '';
+                const estado = `[${e.modo}] ${e.estado}`;
+                md += `| ${inicio} | ${fin} | ${ia}${e.descripcion} | ${estado} |\n`;
+            });
+            md += '\n';
+        });
+
+        res.set('Content-Type', 'text/markdown');
+        res.send(md);
+    });
+
+    // PUT /api/bitacoras/:id — Actualizar resumen de bitácora
+    router.put('/:id', async (req, res) => {
+        const { id } = req.params;
+        const { resumen } = req.body;
+        const { rows } = await pool.query(
+            'UPDATE bitacoras.bitacoras SET resumen=$1 WHERE id=$2 RETURNING *',
+            [resumen, id]
+        );
+        if (rows.length === 0) return res.status(404).json({ error: 'Bitácora no encontrada' });
+        res.json(rows[0]);
+    });
+
+    // DELETE /api/bitacoras/:id — Eliminar bitácora y sus entradas
+    router.delete('/:id', async (req, res) => {
+        await pool.query('DELETE FROM bitacoras.entradas WHERE bitacora_id = $1', [req.params.id]);
+        const { rowCount } = await pool.query('DELETE FROM bitacoras.bitacoras WHERE id = $1', [req.params.id]);
+        if (rowCount === 0) return res.status(404).json({ error: 'Bitácora no encontrada' });
+        res.json({ message: 'Bitácora eliminada' });
+    });
+
+    return router;
+};
@@ -0,0 +1,46 @@
+module.exports = (pool) => {
+    const router = require('express').Router();
+
+    // GET /api/entradas — Listar entradas (filtro por bitacora_id o nodo_id)
+    router.get('/', async (req, res) => {
+        const { bitacora_id, nodo_id } = req.query;
+        let query = 'SELECT e.*, n.nombre as nodo_nombre FROM bitacoras.entradas e LEFT JOIN bitacoras.nodos n ON e.nodo_id = n.id WHERE 1=1';
+        const params = [];
+        if (bitacora_id) { params.push(bitacora_id); query += ` AND e.bitacora_id = $${params.length}`; }
+        if (nodo_id) { params.push(nodo_id); query += ` AND e.nodo_id = $${params.length}`; }
+        query += ' ORDER BY e.inicio DESC';
+        const { rows } = await pool.query(query, params);
+        res.json(rows);
+    });
+
+    // POST /api/entradas — Crear entrada
+    router.post('/', async (req, res) => {
+        const { inicio, fin, descripcion, estado, modo, es_ia, bitacora_id, nodo_id } = req.body;
+        const { rows } = await pool.query(`
+      INSERT INTO bitacoras.entradas (inicio, fin, descripcion, estado, modo, es_ia, bitacora_id, nodo_id)
+      VALUES ($1, $2, $3, $4, $5, $6, $7, $8) RETURNING *
+    `, [inicio, fin || null, descripcion, estado || '⏳', modo || 'P', es_ia || false, bitacora_id, nodo_id]);
+        res.status(201).json(rows[0]);
+    });
+
+    // PUT /api/entradas/:id — Actualizar entrada
+    router.put('/:id', async (req, res) => {
+        const { id } = req.params;
+        const { inicio, fin, descripcion, estado, modo, es_ia } = req.body;
+        const { rows } = await pool.query(`
+      UPDATE bitacoras.entradas SET inicio=$1, fin=$2, descripcion=$3, estado=$4, modo=$5, es_ia=$6
+      WHERE id=$7 RETURNING *
+    `, [inicio, fin, descripcion, estado, modo, es_ia, id]);
+        if (rows.length === 0) return res.status(404).json({ error: 'Entrada no encontrada' });
+        res.json(rows[0]);
+    });
+
+    // DELETE /api/entradas/:id — Eliminar entrada
+    router.delete('/:id', async (req, res) => {
+        const { rowCount } = await pool.query('DELETE FROM bitacoras.entradas WHERE id = $1', [req.params.id]);
+        if (rowCount === 0) return res.status(404).json({ error: 'Entrada no encontrada' });
+        res.json({ message: 'Entrada eliminada' });
+    });
+
+    return router;
+};
@@ -0,0 +1,49 @@
+module.exports = (pool) => {
+    const router = require('express').Router();
+
+    // GET /api/nodos — Listar todos los nodos
+    router.get('/', async (req, res) => {
+        const { rows } = await pool.query('SELECT * FROM bitacoras.nodos WHERE activo = true ORDER BY nombre');
+        res.json(rows);
+    });
+
+    // POST /api/nodos — Crear nodo
+    router.post('/', async (req, res) => {
+        const { nombre, ip, tipo, descripcion } = req.body;
+        const { rows } = await pool.query(
+            'INSERT INTO bitacoras.nodos (nombre, ip, tipo, descripcion) VALUES ($1, $2, $3, $4) RETURNING *',
+            [nombre, ip, tipo, descripcion]
+        );
+        res.status(201).json(rows[0]);
+    });
+
+    // PUT /api/nodos/:id — Actualizar nodo
+    router.put('/:id', async (req, res) => {
+        const { id } = req.params;
+        const { nombre, ip, tipo, descripcion, activo } = req.body;
+        const { rows } = await pool.query(
+            'UPDATE bitacoras.nodos SET nombre=$1, ip=$2, tipo=$3, descripcion=$4, activo=$5 WHERE id=$6 RETURNING *',
+            [nombre, ip, tipo, descripcion, activo, id]
+        );
+        if (rows.length === 0) return res.status(404).json({ error: 'Nodo no encontrado' });
+        res.json(rows[0]);
+    });
+
+    // DELETE /api/nodos/:id — Eliminar nodo (lógico o físico si no tiene entradas asociadas)
+    router.delete('/:id', async (req, res) => {
+        try {
+            const { rowCount } = await pool.query('DELETE FROM bitacoras.nodos WHERE id = $1', [req.params.id]);
+            if (rowCount === 0) return res.status(404).json({ error: 'Nodo no encontrado' });
+            res.json({ message: 'Nodo eliminado' });
+        } catch (err) {
+            // Si hay foreign key violation, podemos marcarlo como inactivo
+            if (err.code === '23503') {
+                await pool.query('UPDATE bitacoras.nodos SET activo=false WHERE id = $1', [req.params.id]);
+                return res.json({ message: 'Nodo marcado como inactivo por tener entradas asociadas' });
+            }
+            res.status(500).json({ error: err.message });
+        }
+    });
+
+    return router;
+};
@@ -0,0 +1,118 @@
+module.exports = (pool) => {
+    const router = require('express').Router();
+
+    // GET /api/proyectos — Listar proyectos
+    router.get('/', async (req, res) => {
+        const { rows } = await pool.query('SELECT * FROM bitacoras.proyectos ORDER BY codigo');
+        res.json(rows);
+    });
+
+    // GET /api/proyectos/:codigo — Detalle con fases, hitos y métricas
+    router.get('/:codigo', async (req, res) => {
+        const { codigo } = req.params;
+
+        const pResult = await pool.query('SELECT * FROM bitacoras.proyectos WHERE codigo = $1', [codigo]);
+        if (pResult.rows.length === 0) return res.status(404).json({ error: 'Proyecto no encontrado' });
+        const proyecto = pResult.rows[0];
+
+        // Fases con hitos y nodo
+        const { rows: fases } = await pool.query(`
+            SELECT f.*, json_agg(
+                json_build_object(
+                    'id', h.id,
+                    'id_hito', h.id_hito,
+                    'titulo', h.titulo,
+                    'descripcion', h.descripcion,
+                    'estado', h.estado,
+                    'fecha', h.fecha,
+                    'horas_presencial', h.horas_presencial,
+                    'horas_remoto', h.horas_remoto,
+                    'nodo_nombre', n.nombre,
+                    'nodo_ip', n.ip
+                ) ORDER BY h.fecha NULLS LAST, h.id
+            ) FILTER (WHERE h.id IS NOT NULL) AS hitos
+            FROM bitacoras.fases f
+            LEFT JOIN bitacoras.hitos h ON h.fase_id = f.id
+            LEFT JOIN bitacoras.nodos n ON h.nodo_id = n.id
+            WHERE f.proyecto_id = $1
+            GROUP BY f.id
+            ORDER BY f.numero
+        `, [proyecto.id]);
+
+        // Métricas globales
+        const { rows: [metricas] } = await pool.query(`
+            SELECT
+                COUNT(*) FILTER (WHERE h.estado = '✅') AS hitos_completados,
+                COUNT(*) FILTER (WHERE h.estado != '✅') AS hitos_pendientes,
+                COUNT(*) AS hitos_total,
+                COALESCE(SUM(h.horas_presencial), 0) AS total_presencial,
+                COALESCE(SUM(h.horas_remoto), 0) AS total_remoto,
+                COALESCE(SUM(h.horas_presencial + h.horas_remoto), 0) AS total_horas
+            FROM bitacoras.hitos h
+            JOIN bitacoras.fases f ON h.fase_id = f.id
+            WHERE f.proyecto_id = $1
+        `, [proyecto.id]);
+
+        // Nodos únicos involucrados
+        const { rows: nodos } = await pool.query(`
+            SELECT DISTINCT n.id, n.nombre, n.ip, n.tipo, n.descripcion
+            FROM bitacoras.hitos h
+            JOIN bitacoras.fases f ON h.fase_id = f.id
+            JOIN bitacoras.nodos n ON h.nodo_id = n.id
+            WHERE f.proyecto_id = $1
+            ORDER BY n.nombre
+        `, [proyecto.id]);
+
+        res.json({ ...proyecto, fases, metricas, nodos });
+    });
+
+    // POST /api/proyectos/:codigo/hitos — Crear hito
+    router.post('/:codigo/hitos', async (req, res) => {
+        const { codigo } = req.params;
+        const { fase_numero, id_hito, titulo, descripcion, estado, fecha, horas_presencial, horas_remoto, nodo_nombre } = req.body;
+
+        const pResult = await pool.query('SELECT id FROM bitacoras.proyectos WHERE codigo = $1', [codigo]);
+        if (pResult.rows.length === 0) return res.status(404).json({ error: 'Proyecto no encontrado' });
+
+        const fResult = await pool.query(
+            'SELECT id FROM bitacoras.fases WHERE proyecto_id = $1 AND numero = $2',
+            [pResult.rows[0].id, fase_numero]
+        );
+        if (fResult.rows.length === 0) return res.status(404).json({ error: 'Fase no encontrada' });
+
+        let nodo_id = null;
+        if (nodo_nombre) {
+            const nResult = await pool.query('SELECT id FROM bitacoras.nodos WHERE nombre = $1', [nodo_nombre]);
+            if (nResult.rows.length > 0) nodo_id = nResult.rows[0].id;
+        }
+
+        const { rows } = await pool.query(
+            `INSERT INTO bitacoras.hitos (fase_id, id_hito, titulo, descripcion, estado, fecha, horas_presencial, horas_remoto, nodo_id)
+             VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9) RETURNING *`,
+            [fResult.rows[0].id, id_hito, titulo, descripcion || '', estado || '⏳', fecha || null,
+            horas_presencial || 0, horas_remoto || 0, nodo_id]
+        );
+        res.status(201).json(rows[0]);
+    });
+
+    // PUT /api/proyectos/hitos/:id — Actualizar hito
+    router.put('/hitos/:id', async (req, res) => {
+        const { id } = req.params;
+        const { titulo, descripcion, estado, fecha, horas_presencial, horas_remoto } = req.body;
+        const { rows } = await pool.query(
+            `UPDATE bitacoras.hitos SET
+                titulo = COALESCE($1, titulo),
+                descripcion = COALESCE($2, descripcion),
+                estado = COALESCE($3, estado),
+                fecha = COALESCE($4, fecha),
+                horas_presencial = COALESCE($5, horas_presencial),
+                horas_remoto = COALESCE($6, horas_remoto)
+            WHERE id = $7 RETURNING *`,
+            [titulo, descripcion, estado, fecha, horas_presencial, horas_remoto, id]
+        );
+        if (rows.length === 0) return res.status(404).json({ error: 'Hito no encontrado' });
+        res.json(rows[0]);
+    });
+
+    return router;
+};
@@ -0,0 +1,41 @@
+const express = require('express');
+const cors = require('cors');
+const helmet = require('helmet');
+const { Pool } = require('pg');
+
+const app = express();
+const PORT = process.env.PORT || 3001;
+
+// Middleware
+app.use(helmet());
+app.use(cors({ origin: process.env.CORS_ORIGIN || '*' }));
+app.use(express.json());
+
+// Database pool
+const pool = new Pool({ connectionString: process.env.DATABASE_URL });
+
+// Health check
+app.get('/health', async (req, res) => {
+    try {
+        await pool.query('SELECT 1');
+        res.json({ status: 'ok', timestamp: new Date().toISOString() });
+    } catch (err) {
+        res.status(500).json({ status: 'error', message: err.message });
+    }
+});
+
+// Routes
+app.use('/api/nodos', require('./routes/nodos')(pool));
+app.use('/api/bitacoras', require('./routes/bitacoras')(pool));
+app.use('/api/entradas', require('./routes/entradas')(pool));
+app.use('/api/proyectos', require('./routes/proyectos')(pool));
+
+// Error handler
+app.use((err, req, res, next) => {
+    console.error('Error:', err.message);
+    res.status(500).json({ error: err.message });
+});
+
+app.listen(PORT, () => {
+    console.log(`🔐 dtic-BITACORAs API corriendo en puerto ${PORT}`);
+});