Feat(ADN): Creado subcomando 'conocimiento' para asimilar documentación

This commit is contained in:
Ricardo Monla
2026-03-07 16:12:39 -03:00
parent aa68893bc8
commit 412a379c62
5 changed files with 257 additions and 29 deletions
+9
View File
@@ -46,3 +46,12 @@ En este proyecto **todo tiene que ver con todo**. El ADN (hebras), las Bitácora
| [**08/02/2026**](../bitacoras/2026-02-08.md) | Solución Licencia FENIX. | Resolución del incidente de apagado automático en `srvv-fenix`. |
| [**07/02/2026**](../bitacoras/2026-02-07.md) | Incidentes srvv-fenix. | Investigación forense ante apagados recurrentes. |
| [**14/01/2026**](../bitacoras/2026-01-14.md) | Gestión Digital CD. | Gestión y publicación de grabaciones de Consejo Directivo en YouTube. |
---
## 📚 Base de Conocimiento
| Documento | Fecha de Asimilación | Descripción |
| :--- | :--- | :--- |
| [**Guía de Instalación y Configuración del Sistema ADN-BD**](conocimiento/configuracion_bd.md) | 07/03/2026 | Esta guía describe cómo implementar el backend de la base de datos `dtic-BITACORAs` y conectarlo adecuadamente a las herramientas del ADN del reposi... |
+61
View File
@@ -0,0 +1,61 @@
# Guía de Instalación y Configuración del Sistema ADN-BD
**Módulo:** Integración `dtic-BITACORAs`
Esta guía describe cómo implementar el backend de la base de datos `dtic-BITACORAs` y conectarlo adecuadamente a las herramientas del ADN del repositorio `srv-ns8`.
## 1. Requerimientos Previos
- **Docker** y **Docker-Compose**
- **Ruby 3.x**
- Gema **pg** instalada localmente (necesita `libpq-dev` en Linux).
## 2. Levantando el Entorno PostgreSQL
La persistencia de nuestras bitácoras vive dentro de un contenedor dedicado.
1. Navega hasta el directorio del sub-módulo (u origen docker-compose):
```bash
cd dtic-BITACORAs
```
2. Inicializa el stack en segundo plano:
```bash
docker-compose up -d
```
3. El contenedor expone por defecto PostgreSQL en el **puerto 5433** (del host). Revisa la salud del contenedor:
```bash
docker ps | grep postgres
```
## 3. Configuración de Credenciales CLI (`tools/config/database.yml`)
Las herramientas ADN alojadas en `tools/adn/run` delegaron su configuración al archivo maestro que se sitúa en `tools/config/database.yml`.
> [!IMPORTANT]
> El entorno de `development` se define por defecto e interactúa en el puerto `5433` usando credenciales locales (`dtic_user` / `dtic_pass_2026`).
Si el servidor experimentara una reconfiguración de credenciales de producción, asegúrate de exportar las variables globales **antes de ejecutar comandos de ADN**:
```bash
export DB_HOST=localhost
export DB_PORT=5432
export DB_NAME=dtic_bitacoras_prod
export DB_USER=produccion
export DB_PASSWORD=***
```
Inmediatamente, la CLI redirigirá los accesos al nodo principal configurado.
## 4. Validando la Conexión Bidireccional
La mejor forma de testear que todo se ha inicializado y configurado correctamente es utilizando el Reporte de Salud de la BD proporcionado por la consola ADN:
```bash
./tools/adn/run db salud:bd
```
Si recibes el siguiente dictamen, el sistema funciona correctamente:
`✅ Conexión a PostgreSQL establecida`
## 5. Pruebas Unitarias Integradas (Minitest)
Si estás desarrollando nuevas funcionalidades o has migrado el esquema, ejecuta el paquete `bitacora_db_test.rb` incluido para validar CRUD sin ensuciar la base de datos final. El sistema de tests encapsula todo el script dentro de comandos `BEGIN` / `ROLLBACK`.
```bash
ruby tools/adn/spec/bitacora_db_test.rb
```