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

adn/conocimiento/configuracion_bd.md

@@ -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
+```