Repository navigation
04 modulos documentacion de modulos
Estado: identificación y, después, descripciones añadidas. No se movió, extrajo ni reescribió ningún comentario de lib/. Los
comentarios locales que explican una operación interna se conservan donde están.
Con autorización expresa y limitada a añadir texto, se completaron las descripciones que faltaban:
-
17 archivos sin descripción de módulo recibieron su cabecera (outbox de eventos, teclado de cobro, hooks, inscripción al gimnasio,
operaciones de inventario y compras, movimiento, navegación, definiciones de operaciones, menú de operaciones y
tenant/db.ts). Quedan 0 archivos delib/sin cabecera. - 401 funciones exportadas recibieron su JSDoc (de 401 sin descripción a 0, medido con la misma heurística). Cada una dice qué hace, qué valida o qué devuelve según el código real; las reglas largas siguen en la cabecera del archivo.
-
Verificación: cada archivo tocado se transpiló sin comentarios y se comparó contra el commit anterior: el código es idéntico en todos.
Además
tscsin errores ypnpm lintsin errores. - Sin tocar: los 198 comentarios dentro de funciones (60 archivos) se conservan en su sitio; no se cambió lógica, firmas, tipos, comportamiento ni carpetas.
- 114 archivos de
lib/abren con un bloque de documentación de módulo; solo 9 tienen 10 líneas con texto o más y ninguno llega a 20 líneas. - 63 bloques de comentario tienen 9 o más líneas seguidas; casi todos son documentación de una función concreta (por ejemplo
budget.ts:233,projects.ts:211) y explican un paso interno. - Conclusión: la documentación de módulos es corta y está pegada al código que describe. No hay una masa de documentación que trasladar.
Se traslada (copiando un resumen, sin quitar el comentario del código) solo lo que cumple las tres:
- Describe una regla o convención que cruza varios módulos, no un detalle de uno.
- Un lector necesita entenderla sin abrir el código.
- Hoy no está en
docs/.
Entre paréntesis, líneas del bloque de comentario (incluidas las vacías).
| Archivo | Qué explica | ¿Trasladar? | Destino sugerido |
|---|---|---|---|
lib/business/sales/money-service.ts (14 líneas) |
Un cobro son varias escrituras que pasan todas o ninguna | Resumen, sí: cruza caja, recibos, stock y documentos. Ya cita ADR-0006 y DATA-01 | Nota «Dinero» en docs/architecture/ que enlace al ADR |
lib/industry/construction/apu-engine.ts (14) + lib/foundation/kernel/cop-amount.ts (16) |
Los Decimal llegan como texto desde el driver de Prisma 8; los montos se normalizan sin pasar por number
|
Sí, en una sola nota: es una convención técnica que afecta a todo cálculo con dinero | La misma nota «Dinero y decimales» |
lib/core/tenancy/deletion.ts (19) |
Qué borra el borrado de raíz de un negocio y qué no es reversible | Sí: es una política de datos, útil para quien opere o audite | Nota «Borrado de un negocio» |
lib/industry/construction/lean-engine.ts (19) |
Semana relativa (1..6) frente a semana ISO-8601 en Bogotá |
Sí, pero en docs/construction/, no en architecture: es convención de un rubro |
docs/construction/ |
lib/experience/motion/modal-morph.ts (16) |
Efecto de apertura de modales | No: ya está en packages/brand/docs/04-patrones/movimiento.md
|
— |
lib/industry/construction/apu-importer/confidence-score.ts, master-pack-plan.ts, master-pack-import.ts (12–17) |
Fórmula y pasos del importador | No: describen el algoritmo y deben quedar junto a él | — |
lib/industry/construction/report-engine.ts (15) |
Qué consolida el motor de informes | No: se lee mejor junto al código | — |
lib/industry/construction/budget.ts, lib/industry/construction/projects.ts
|
Comentarios de función interna | No: son locales | — |
Resumen con enlaces al código; los comentarios originales de lib/ se conservan sin cambios.
-
dinero-y-decimales.md: servicio de dinero, texto/BigIntpara decimales y montos en COP. -
borrado-de-un-negocio.md: qué borra, qué no y cómo se mantiene la lista de tablas. -
../construction/convencion-semanas-lean.md: semana relativa frente a semana ISO.
Todo lo demás se queda en el código.
Esta página se genera desde docs/wiki/04-modulos/documentacion-de-modulos.md. No la edites en la Wiki de GitHub: abre un cambio en el repositorio.
Documentación generada desde docs/wiki. Para cambiar algo, edita el repositorio.