Skip to content

About

Master Data Management System

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

organizacion-unilog

Organización Perfil Producto Estado Satélite License


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.)

Flujo SDLC

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

Cómo colaborar

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.

  1. Instala el plugin del estándar (marketplace de Organización):

    claude plugin marketplace add organizacion-peru/organizacion-marketplace
    claude plugin install organizacion-core@organizacion
  2. 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"
  3. 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"
  4. 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».


Preguntas y respuestas

¿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

About

Master Data Management System

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages