Estado: NORMATIVO
Referencias de código: Consecutivos (nebula-masters), Embargos (nebula-treasury)
Checklist de cierre de una feature backend del ERP Nebula. Una feature solo está
DONE cuando todas las casillas aplicables están marcadas.
audit-htu <ruta-HT> con verdict: PASS (TRIPLE-LOCK; bypass --no-verify prohibido).COMMENT, Javadoc de Entity, validadores *Component.validar*()) y alineadas.status interno (ACTIVE/INACTIVE/BLOCKED) + estado de negocio propio en español.nebula-models (módulo correcto; versión SNAPSHOT alineada con consumidores).SequenceBusinessBaseEntity / SequenceBaseEntity).@Immutable mapeando v_<entidad> para get-record / page-response.index (probe de disponibilidad, sistema), get-record, page-response, listado de negocio /listado, CRUD).status nunca usado como negocio; campo de negocio propio para "activo/vigente".created_by/updated_by/created_at/updated_at/version poblados por la base; log de auditoría según diseño.simappe_admin.@Cacheable donde aplique (catálogos / lecturas calientes).audit-htu PASS (Sección H sin fallos).COMMENT + vista v_<entidad>.nebula_user_dev_01 (tabla: SELECT/INSERT/UPDATE/DELETE; vista: SELECT).user_tables / all_views / user_indexes OK.simappe_admin (keys + ES + EN), idempotente.feature/* desde develop.Co-Authored-By.feature/* → develop abierto y revisado.develop.:latest-dev construida y publicada en el registry interno (10.110.0.2:5000).microservicePipeline() / compose.actuator/health 200, login 2 pasos, index (probe) / listado / get-record / page-response responden.Comparación entre el patrón documentado en
FLUJO_DESARROLLO_NEBULA.md
(previo) y este patrón canónico (Consecutivos / Embargos).
| Aspecto | Patrón previo (FLUJO_DESARROLLO_NEBULA) | Patrón canónico nuevo | Acción |
|---|---|---|---|
| Ejemplo guía | Tercero (entity CRUD genérica) |
Consecutivos (nebula-masters) + Embargos (nebula-treasury) reales |
Actualizar |
Vista @Immutable |
No contemplada | Vista plana v_<entidad> solo-lectura para lecturas |
Agregar |
PageResponseSupport |
Listado genérico | page-response sobre la vista plana |
Mantener |
| lightloader | No documentado | Carga ligera de catálogos/lecturas | Agregar |
WebClients (nebula-shared) |
No existía | Autoconfig blocking + reactivo, token explícito | Agregar |
@Cacheable |
Mencionado parcial | Transversal obligatorio donde aplique | Actualizar |
| Kafka | No documentado | Eventos según contrato | Agregar |
| JaCoCo | "tests pasan" | Cobertura > 80% explícita | Actualizar |
| Javadoc | Implícito | Entity + Component (convenciones implícitas) | Actualizar |
| Flyway | Asumido automático en CI/CD | Manual (Flyway no corre en DEV): DDL+i18n a mano | Actualizar |
get-record / page-response |
CRUD genérico | Endpoints estándar ERP leyendo la vista plana | Actualizar |