📦 Estructura Canónica de Google Cloud Storage (GCS)¶

Sistema de Decisión Asistida (SDA) — BKM¶

Versión: v1
Estado: Activa
Rol: Gobierno estructural del Storage (no ejecución)

1. Propósito de este documento¶

Este documento define la estructura canónica de Google Cloud Storage (GCS) para el Sistema de Decisión Asistida (SDA) de BKM.

La estructura definida aquí actúa como:

repositorio central de información no estructurada,
memoria documental del SDA,
soporte para trazabilidad y auditoría,
base para el uso controlado de IA sobre documentación.

Este documento no define permisos técnicos ni detalla implementaciones, sino la lógica funcional obligatoria de organización.

2. Principios de diseño¶

La estructura de GCS se rige por los siguientes principios:

Función antes que herramienta
La organización responde al rol de la información, no a la tecnología que la genera.
Separación explícita de responsabilidades
Gobierno, inputs, outputs, decisiones y archivo viven en zonas claramente diferenciadas.
Versionado explícito
Los documentos no se sobrescriben. El histórico es parte del valor del sistema.
IA como lectora y productora controlada
La IA nunca modifica documentos de gobierno ni ejecuta acciones fuera de su rol.
Estructura mínima y evolutiva
Diseñada para crecer sin refactorizaciones disruptivas.

3. Bucket raíz del sistema¶

Se define un único bucket raíz para el SDA en esta fase: bkm-decision-system/

No se crean buckets separados por:

agente,
herramienta,
entorno,
o decisión.

Cualquier evolución futura deberá estar explícitamente gobernada.

4. Estructura de primer nivel¶

bkm-decision-system/ ├── 00_governance/ ├── 01_inputs/ ├── 02_outputs/ ├── 03_decisions/ ├── 04_evidence/ └── 99_archive/

Cada carpeta responde a una función clara e inequívoca dentro del sistema.

5. Descripción de carpetas¶

00_governance/ — Gobierno del sistema¶

Rol
Contiene los documentos canónicos y normativos que gobiernan el SDA.

Contenido típico - visión y principios, - marco de decisiones, - manual de gobierno, - glosario oficial.

Reglas - ❌ La IA no escribe aquí. - ❌ Procesos automáticos no escriben aquí. - ✔️ Solo escritura humana autorizada.

00_governance/ ├── vision_principles/ ├── marco_decisiones/ ├── gobierno_sistema/ └── glosario/

01_inputs/ — Inputs humanos al sistema¶

Rol
Información que entra al sistema como contexto, briefing o materia prima para análisis.

Contenido típico - briefings, - actas de reunión, - documentos de trabajo, - inputs de dirección y equipos.

Reglas - ✔️ Escritura humana. - ✔️ Lectura por IA. - ❌ No se consideran outputs ni decisiones.

01_inputs/ ├── direccion/ ├── marketing/ ├── comercial/ └── operaciones/

02_outputs/ — Outputs generados por IA¶

Rol
Repositorio exclusivo de outputs producidos por IA.

Contenido típico - análisis, - recomendaciones, - resúmenes ejecutivos, - informes automáticos.

Reglas clave - ❗ Nunca se sobrescribe contenido. - ❗ Todo output debe ser versionado y trazable. - ✔️ Escritura permitida a IA bajo control.

02_outputs/ ├── analisis/ ├── recomendaciones/ ├── resumenes/ └── informes/

03_decisions/ — Memoria por decisión¶

Rol
Agrupa toda la información relacionada con una decisión concreta del negocio.

Contenido típico - inputs usados, - outputs generados, - estado de la decisión, - documentación asociada.

03_decisions/ ├── decision_01_xxx/ │ ├── inputs/ │ ├── outputs/ │ └── estado.md ├── decision_02_xxx/ └── decision_03_xxx/

El archivo estado.md refleja el estado actual de la decisión (en análisis, validada, congelada, descartada, etc.).

04_evidence/ — Evidencias¶

Rol
Documentos que respaldan, justifican o contextualizan decisiones.

Contenido típico - informes técnicos, - fotografías, - presupuestos, - comparativas, - históricos relevantes.

04_evidence/ ├── obras/ ├── rentabilidad/ ├── capacidad/ └── historico/

99_archive/ — Archivo histórico¶

Rol
Contiene información ya no activa, pero que debe conservarse por trazabilidad y memoria.

Reglas - ❌ No se borra información. - ✔️ Solo se mueve a archivo.

99_archive/ ├── deprecated/ └── historico_cerrado/

6. Qué NO se hace en esta fase¶

Queda explícitamente fuera de alcance:

buckets por agente o herramienta,
inputs automáticos no supervisados,
dumps de datos,
logs técnicos,
estructuras operativas ad hoc.

Todo lo anterior se evaluará por decisión y con gobierno explícito.

7. Definición de “DONE” de esta estructura¶

Esta estructura se considera correcta cuando:

Dirección entiende qué vive en cada carpeta.
La IA puede operar sin tocar gobierno.
Existe trazabilidad clara input → output → decisión.
La estructura puede crecer sin romperse.

8. Nota final¶

Esta estructura no optimiza ejecución.
Optimiza criterio, memoria y control.

La automatización vendrá después.
El orden es parte esencial del valor del SDA.