# P2603 - Sistema de Bitácoras (dtic-BITACORAs)

> Manifiesto de Proyecto | Referencia: [`adn/07_proyectos.md`](../../../adn/07_proyectos.md)

## Identificación

| Campo | Valor |
| :--- | :--- |
| **Código** | P2603 |
| **Nombre** | Sistema de Bitácoras Web |
| **Estado** | ⏳ En Ejecución |
| **Inicio** | 03/03/2026 |
| **Fin Estimado** | Por definir |

## Objetivo

Evolucionar el registro manual de operaciones (archivos `.md`) hacia una **aplicación web** con arquitectura frontend/backend que permita:

1. **Registro en tiempo real** de entradas de bitácora mediante API REST.
2. **Consulta visual** de la actividad diaria agrupada por nodo y proyecto.
3. **Compatibilidad** con el formato I-F-D-E del ADN (exportación a Markdown).
4. **Estética unificada** con el dashboard del proyecto P2601.

## Stakeholders

| Rol | Persona | Visibilidad |
| :--- | :--- | :--- |
| **Responsable Técnico** | Lic. Ricardo MONLA | Operador directo |
| **Dirección de TIC** | (Jerárquico superior) | Dashboard asíncrono |

## Nodos Involucrados

### Nodos Exclusivos (Core)
| Nodo | IP | Rol en el Proyecto |
| :--- | :--- | :--- |
| [**srv-ns8**](../../../nodos/srv-ns8.md) | `10.0.10.8` | Servidor de la aplicación (Docker) |

## Herramientas

| Herramienta | Uso |
| :--- | :--- |
| **React 18 + TypeScript** | Frontend SPA |
| **Vite** | Build tool y dev server |
| **Node.js + Express** | Backend API REST |
| **PostgreSQL 15** | Base de datos relacional |
| **Docker Compose** | Orquestación de servicios |

---

## Progreso

```
Fase 1: ██░░░░░░░░  20%  Base de Datos y API
Fase 2: ░░░░░░░░░░   0%  Interfaz de Usuario (UI)
Fase 3: ░░░░░░░░░░   0%  Módulos de Exportación
Fase 4: ░░░░░░░░░░   0%  Despliegue y Producción
Fase 5: ░░░░░░░░░░   0%  Integración CLI ADN
```

---

## Hitos Clave

| Fecha | ID | Estado | Hito |
| :--- | :--- | :---: | :--- |
| 03/03 | INIT | ✅ | Inicialización del proyecto. Creación de `dtic-BITACORAs/` con esquema DB y APIs. |
| 12/03 | MIG | ✅ | Transición operativa a DB-First ([Ver P2603.00](P2603.00_Migracion-DB-First.md)). |
| — | UI01 | ✅ | Frontend: Vista de bitácora diaria con entradas I-F-D-E agrupadas por nodo. |
| — | API01 | ✅ | Backend: CRUD completo de entradas, nodos y bitácoras. |
| — | EXP01 | ✅ | Exportador a Markdown compatible con el ADN. |
| — | PROD | ⏳ | Despliegue en producción (srv-ns8, Nginx reverse proxy). |
| 07/03 | ADN01 | ✅ | Automatización Ruby del ADN: Implementación de CLI unificadas. |
| 19/03 | REM1 | ✅ | Acceso proxy remoto NGINX, Vite y Tailscale ([P2603.02](P2603.02_Acceso-Remoto-Bitacora-Web.md)). |
| 19/03 | JRND | ✅ | Autonomización: Herencia automática de Modo de Jornada ([P2603.04](P2603.04_Herencia-Modo-Jornada.md)). |
| 27/03 | DOC1 | ✅ | Visor de planes integrados y referenciación dinámica Markdown (`doc_path`) ([P2603.03](P2603.03_Referencia-Planes-Bitacora.md)). |
| 30/03 | UI02 | ✅ | Refactor Ámbitos ([Armonía Integral](P2603.01_Armonia-Integral-Bitacoras.md)): Agrupación granular y renderizado fiel de base de datos. |

## Arquitectura

```
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Frontend      │    │     Backend      │    │   Database      │
│   React/Vite    │◄──►│  Node.js/Express │◄──►│  PostgreSQL 15  │
│   Puerto 5173   │    │   Puerto 3001    │    │   Puerto 5432   │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                      │
         └──────────────────────┘
                  Docker Compose
```

## Referencias

- **Bitácoras**: Consultar en DB vía `./adn/tools/run db evento:listar`
- **ADN**: [Ontología](../../../adn/01_ontologia.md) | [Proyectos](../../../adn/07_proyectos.md) | [Bitácora](../../../adn/02_bitacora.md)
- **Base Legacy**: [servicios/bitacoras/](../../../servicios/bitacoras/README.md)