business-domain-grouping
Skill0 starsChanged 4 months agoMITView on GitHub
Método de agrupación lógica de entidades de negocio — cómo derivar carpetas de negocio desde los esquemas de BD, y aplicarlas consistentemente en backend (.NET) y frontend (Angular). Consúltala junto con sql-database-patterns/dotnet-clean-architecture/angular-feature-architecture para saber en qué carpeta de negocio va cada entidad nueva.
In this repository6 other files it gives its agents.
The file
Files
Business Domain Grouping
⚠️ Skill personal, transversal a BD/backend/frontend.
Un proyecto puede tener 100+ entidades de negocio. Sin agrupación lógica consistente, es difícil navegar el código. Esta skill define el MÉTODO para derivar carpetas de negocio ("cores") a partir de los esquemas de BD — para que BD, backend y frontend usen el mismo vocabulario. Reaplica este método en cada proyecto nuevo; no reutilices nombres de core de un proyecto anterior si el dominio de negocio es distinto.
Regla de decisión
- Cada esquema de BD (ver
sql-database-patterns) se convierte en una carpeta de negocio con el mismo nombre conceptual, en el idioma del proyecto. - Si un esquema agrupa dos responsabilidades de negocio claramente
distintas, se parte en dos carpetas en vez de una — el límite técnico
del esquema no obliga a una única carpeta. Ejemplo del criterio: un
esquema de seguridad que mezcla "cuentas de usuario/autenticación" con
"configuración de roles y permisos (RBAC)" son dos preocupaciones
distintas — una carpeta para cada una, aunque vivan en el mismo esquema.
Mismo criterio para un esquema de "datos maestros" que mezcla entidades
propias de un módulo con catálogos genéricos reutilizados por varios
módulos — se separan. Esta decisión se toma desde el principio, al
crear la tabla catálogo/maestra — no solo como corrección posterior
cuando ya quedaron mezcladas (ver
sql-database-patterns, "Esquemas por módulo de negocio", para el criterio de transversal-vs-específico y el esquemacatdedicado). - La carpeta de negocio (
{Core}) NUNCA afecta el namespace/paquete — solo organiza carpetas físicas.
Dónde aplica esta agrupación
- BD: el esquema mismo (
sql-database-patterns) — 1:1 con el core salvo cuando la regla 2 aplica. - Backend:
Persistence/Repositories/{Core}/,Application/Services/{Core}/,Application/Interfaces/{Repository,Service}/{Core}/,Application/DTOs/{Core}/,Validator/Validators/{Core}/,Validator/Rules/{Core}/(dotnet-clean-architecture). - Una pieza compartida (regla de validación, helper, mensaje) va en la carpeta del negocio cuya lógica expresa,
no en la de quien la consume ni en la de la entidad que guarda el dato. Ejemplo: la política de password se usa al
crear un usuario, pero define qué es una credencial válida → carpeta
Auth, noUsuario. Solo lo que no tiene dueño de negocio (un formato genérico) va en una carpetaComun. - Frontend: carpeta de feature de primer nivel (
features/{core}/) — verangular-feature-architecture.
Excepción: Mapper/Profiles es plano
Los perfiles de AutoMapper (Mapper/Profiles/{Entidad}Profile.cs) NO se
agrupan por core — quedan planos por entidad, sin excepción.
Ejemplo aplicado (sistema de ventas)
Así se aplicaría el método en un sistema de ventas típico, con esquemas
seg (seguridad), ven (ventas), inv (inventario), fac (facturación),
cat (catálogo):
| Carpeta | Esquema(s) | Por qué se separó así |
Auth | seg (subset) | Cuentas de usuario y autenticación — distinto de la configuración RBAC |
Seguridad | seg (subset) | Roles, permisos, perfiles (RBAC) |
Ventas | ven | 1:1 — pedidos, líneas de pedido, clientes |
Inventario | inv | 1:1 — productos, stock, almacenes |
Facturacion | fac | 1:1 — facturas, pagos |
Catalogo | cat | 1:1 — catálogos genéricos (unidades de medida, monedas, categorías) |
seg se parte en dos carpetas (regla 2 — autenticación vs. RBAC son
responsabilidades distintas aunque vivan en el mismo esquema);
ven/inv/fac/cat quedan 1:1 con su esquema (regla 1). Un gap típico
en frontend: si no se aplica el método completo ahí, Catalogo termina
anidado dentro de otro feature (ej. dentro de Ventas) en vez de tener su
propia carpeta de feature — aplica el método completo también en frontend,
no lo simplifiques a mitad de camino.
Agregar una entidad nueva: elegir su core
- ¿A qué esquema de BD pertenece la tabla?
- ¿Ese esquema agrupa una sola responsabilidad de negocio, o dos claramente distintas? Si es una sola → la carpeta = el esquema. Si son dos → decide a cuál de las dos pertenece la entidad nueva, o si amerita partir el esquema en dos carpetas (regla de decisión, arriba).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

