Unilog — Sistema de Servicios Logísticos (SIL) de Organización
Satélite de organizacion_arch: consume el estándar corporativo, versionado, desde el plugin organizacion-core. No lo copia.
Operador Logístico Aduanero desde 1978
Unilog implementa el sistema SIL (Servicios Logísticos), sigla Ratificada en el catálogo de la suite. Es un sistema desplegable (un Bounded Context); navegación plana README → Producto → PRDs.
| Identidad | |
|---|---|
| Tipo de repositorio (ADR-0069) | producto |
| Perfil | single-product |
| Producto / Sistema | SIL — Sistema de Servicios Logísticos |
| Identidad de sigla | sistema.yaml → sigla: SIL, estado_sigla: Ratificada |
| Raíz de fuente (ADR-0107) | src/ |
| Owner | aarroyo (Organización S.A.) |
Abre la fase en la que trabajas. Cada una declara su meta, sus documentos y sus hubs (índices de área).
Numeración canon
organizacion_arch: las fases van de 1 a 5 (Mapeo SDLC–Artefactos). No existe «Fase 0».
Fase 1 — Concepción y Descubrimiento · producto y requisitos
Meta: fijar el qué y el para quién del sistema.
La Visión del producto es única para todo el sistema. Cada PRD (PRD-SIL-NNN, PRD-MDM-NNN) trae su propio alcance, historias de usuario y backlog — el hub los agrupa por PRD.
| Documento | Descripción | Tipo |
|---|---|---|
| Hub de Fase 1 | PRDs con su alcance, historias y backlog; diagramas conceptuales | Hub |
| Visión del producto | Visión de SIL y su modelo conceptual en la suite — no varía por PRD | Visión |
| PRD-MDM-001 — Maestro de organizaciones y partes | Referencia de negocio de MDM, elaborada a posteriori: organizaciones, roles, establecimientos, relaciones, referencias al ERP y tipos de rol | PRD |
| PRD-MDM-002 — Geografía de la suite | Deriva de PRD-MDM-001: países, niveles administrativos por país con ubigeo, lugares de comercio exterior UN/LOCODE, códigos postales y coordenadas por etapas | PRD |
Fase 2 — Diseño y Arquitectura · el cómo estructural
Meta: fijar el cómo estructural, trazado a decisiones (ADRs).
El diseño se agrupa por el PRD del que deriva — hoy desciende de PRD-SIL-001 y, el de MDM, de PRD-MDM-001.
| Documento | Descripción | Tipo |
|---|---|---|
| Hub de Fase 2 | Cómo el sistema adopta o especializa la línea base, agrupado por PRD | Hub |
| Integración LOGAWARE TMS | Hub de área: documentos, vista interactiva, cuestionario en Word y descargas | Hub |
| Vistas de referencia de la arquitectura | Contexto de la suite SCM y SIL Fase 1 (Kafka, XMS, TMS) en SVG, contrastadas con las decisiones | Vista |
| Cuestionario para TI sobre el ERP (MDM) | Pendiente de revisión: qué ERP es, su estructura organizativa y sus interfaces; sin enviar | Cuestionario |
| MDM — Datos Maestros | Hub de área de MDM (mdm-api, alojado aquí de forma provisional): modelo Party, decisiones, propuestas de ADR, código en revisión y gaps |
Hub |
Fase 3 — Construcción · código gobernado
Meta: materializar el diseño en código gobernado.
| Documento | Descripción | Tipo |
|---|---|---|
Código (src/) |
Runtime del sistema, bajo la raíz de fuente | Código |
| Hub de Fase 3 | Historias técnicas y planes | Hub |
| Historia técnica | Requisitos técnicos de implementación | Historia |
Guía de la estructura de src/ |
Qué hay en cada directorio y dónde se crea cada archivo | Estándar |
| Glosario de código web | Equivalencias español → inglés de los identificadores | Glosario |
| Especificación técnica de organización y sede (MDM) | Diseño del CRUD de Tenant y Branch en mdm-api (D-031), en revisión por D-043; ver el hub de MDM |
Especificación |
| Contrato de la API de organización y sede (MDM) | Endpoints, códigos, If-Match/ETag y errores de mdm-api |
Contrato |
Fase 4 — Validación y QA · la promesa se comprueba
Meta: comprobar que el sistema cumple lo prometido.
| Documento | Descripción | Tipo |
|---|---|---|
| Hub de Fase 4 | Confiabilidad y latencia | Calidad |
| Reporte resumen de pruebas | Evidencia por capa | Pruebas |
Fase 5 — Entrega y Operaciones · lo que ya corre
Meta: operar el servicio y sostener su superficie de integración.
| Documento | Descripción | Tipo |
|---|---|---|
| Hub de Fase 5 | Topología de despliegue | Hub |
| Notas de lanzamiento | Cambios entregados por versión | Release |
Arranque rápido · del clon al primer commit válido
Este repositorio no lleva el estándar dentro. Lo obtiene del plugin organizacion-core, que se instala una vez y se comparte entre satélites.
-
Instala el plugin del estándar (marketplace de Organización):
claude plugin marketplace add organizacion-peru/organizacion-marketplace claude plugin install organizacion-core@organizacion
-
Localiza la versión instalada y activa el hook (una vez por clon; git no lo activa solo, por diseño):
# La copia instalada la declara el cliente en installed_plugins.json: se lee # de ahí, no del número mayor del caché, que nunca se recoge (ADR-0169 §2.6). ORG_CORE=$(node -e ' const { resolve } = require("path"); const registro = process.env.HOME + "/.claude/plugins/installed_plugins.json"; let entradas = []; try { entradas = require(registro).plugins?.["organizacion-core@organizacion"] ?? []; } catch {} const aqui = process.cwd(); const entrada = entradas.find((e) => e.projectPath && resolve(e.projectPath) === aqui) ?? entradas.find((e) => e.scope === "user") ?? entradas[0]; if (!entrada?.installPath) { console.error("organizacion-core no está instalado; ejecuta: claude plugin enable organizacion-core@organizacion"); process.exit(1); } console.log(entrada.installPath); ') node "$ORG_CORE/scripts/install-hooks.mjs"
-
Valida la gobernanza antes de tu primer commit:
# Con Claude Code, el barrido completo en un paso: # /organizacion-core:validar-gobernanza node "$ORG_CORE/scripts/validate-estructura-satelite.mjs" node "$ORG_CORE/scripts/validate-satellite-base.mjs"
-
Build y pruebas del runtime:
bash scripts/verify-local.sh node # frontend: typecheck, lint, pruebas y build bash scripts/verify-local.sh e2e # Playwright + axe
Reglas que gobiernan tu cambio · gobernanza viva del satélite
| Documento | Qué gobierna |
|---|---|
| CLAUDE.md | Reglas del núcleo Organización, redactadas para este satélite |
| CONTRIBUTING.md | Proceso de contribución y cómo proponer cambios al núcleo |
| AGENTS.md | Convenciones para agentes que operen aquí |
| DECISIONS.md | Triaje de herencia y decisiones locales |
| GAPS.md | Registro único de hallazgos (S-20) |
| MADUREZ.md | Medición de madurez TOGAF ACMM (S-19) |
Quality & Security: los gates locales (S-23, ADR-0106) son inevadibles en el pre-commit: gitleaks, auditoría de dependencias, coverage con umbral, commitlint y los validadores del estándar.
Proponer un cambio al estándar · el camino de vuelta al núcleo
Lo que este repositorio no puede decidir por su cuenta —una regla, un validador, una plantilla, un ADR de núcleo— se propone en organizacion_arch por PR. El estándar baja versionado en el plugin; nunca se parchea en local.
El detalle del flujo, con roles y categorías de cambio, está en CONTRIBUTING.md, sección «Contribuir al núcleo».
¿Dónde va cada cosa en este repositorio?
src/ raíz de fuente (ADR-0107) — todo el código bajo src/
apps/sil-web/ cliente web: anfitrión que compone la suite y SIL (D-026)
libs/ librerías Nx: suite-*, sil-*, ui-sil, ui-tokens
(API .NET prevista en apps/sil.api; hoy sin proyecto, G-014)
scripts/ verify-local.sh: la puerta local de build y pruebas
docs/ artefactos SDLC (PRDs, planes, reportes)
reference/ corpus propio (ADRs locales, blueprints, deployment)
DECISIONS.md GAPS.md MADUREZ.md CLAUDE.md CONTRIBUTING.md AGENTS.md
El detalle de cada directorio de src/ y dónde se crea cada archivo está en la guía de la estructura de src/.
¿Por qué no hay .harness/ aquí?
Porque el satélite consume el estándar, no lo aloja (S-16). Reglas, scripts y subagentes llegan por el plugin organizacion-core, así que todos los satélites ejecutan exactamente la misma versión y esa versión es su identidad (ADR-0062). Un hook PreToolUse deniega la escritura en .harness/ y el CI la rechaza.
¿Cómo actualizo el estándar a una versión nueva?
claude plugin update organizacion-core@organizacion
# La copia instalada la declara el cliente en installed_plugins.json: se lee
# de ahí, no del número mayor del caché, que nunca se recoge (ADR-0169 §2.6).
ORG_CORE=$(node -e '
const { resolve } = require("path");
const registro = process.env.HOME + "/.claude/plugins/installed_plugins.json";
let entradas = [];
try { entradas = require(registro).plugins?.["organizacion-core@organizacion"] ?? []; } catch {}
const aqui = process.cwd();
const entrada = entradas.find((e) => e.projectPath && resolve(e.projectPath) === aqui)
?? entradas.find((e) => e.scope === "user")
?? entradas[0];
if (!entrada?.installPath) {
console.error("organizacion-core no está instalado; ejecuta: claude plugin enable organizacion-core@organizacion");
process.exit(1);
}
console.log(entrada.installPath);
')
node "$ORG_CORE/scripts/validate-estructura-satelite.mjs"Si la versión nueva añade reglas, el triaje correspondiente se registra en DECISIONS.md con su operación Adopt / Extend / Override / N/A.
El pre-commit me bloqueó. ¿Qué hago?
Léelo: los validadores nombran el archivo y la regla. No se saltan con --no-verify — un gate evadido es un gate roto, y el CI lo vuelve a encontrar. Si crees que el validador se equivoca, eso es un hallazgo: regístralo en GAPS.md y propón el arreglo en organizacion_arch.
Encontré algo que no puedo arreglar ahora. ¿Dónde lo registro?
En GAPS.md, con su dimensión de madurez, criticidad y complejidad (SD-07). Con Claude Code: /organizacion-core:organizacion-gap. La evidencia precede a la afirmación (SD-05): si no puedes enlazar la prueba, el hallazgo se registra como pendiente en vez de darse por resuelto.
Necesito una decisión técnica que no tiene ADR. ¿La decido aquí?
No. Toda decisión técnica referencia un ADR aceptado de organizacion_arch; si no existe, se crea allí primero (S-06). Lo que sí vive aquí son los ADR locales (ADR-SIL-NNN): decisiones propias del sistema que no alteran el estándar.
© Organización S.A. · RUC 20100412447 · Operador Logístico Aduanero desde 1978
Estándar: Organización Arch · Plugin: organizacion-core