Diagrama de estructura de entidades

Acerca de los diagramas de estructura de entidades

Un diagrama de estructura de entidades mapea las relaciones legales y económicas entre organizaciones y personas — quién posee qué, a través de qué forma de entidad y en qué jurisdicción. Los abogados corporativos los usan para documentar estructuras holding y cadenas de subsidiarias. Los asesores fiscales los dibujan para mostrar flujos de licencias de PI transfronterizas y acuerdos de precios de transferencia. Los abogados de startups los producen para tablas de capitalización y consentimientos del consejo. Los planificadores patrimoniales los usan para mostrar arreglos fideicomitente-fideicomiso-beneficiario. El diagrama es el primer documento solicitado en cualquier proceso de due diligence de M&A y el anexo estándar a un archivo maestro de precios de transferencia de la OCDE.

Schematex sigue las convenciones de los profesionales sintetizadas del Anexo 21 del Reglamento S-K de la SEC (divulgación de subsidiarias), las clasificaciones de entidades del Formulario 8832 del IRS, los códigos de jurisdicción ISO 3166-1, las formas de entidades legales ISO 20275 y las convenciones de memorándums fiscales de las Big Four. Los tipos de entidad se mapean a formas distintas (rectángulo para corp, rectángulo redondeado para LLC, elipse para fideicomiso) para que cualquier lector pueda identificar la forma legal de un vistazo. Esta página documenta lo que el parser acepta hoy.

1. Su primera estructura de entidades

La estructura de entidades útil más pequeña: un padre que posee dos subsidiarias.

Cuatro reglas cubren el 80% del uso:

1. Comience con entity-structure, seguido opcionalmente de un título entre comillas.
2. Cada entidad legal es un nodo: entity ID "Nombre a mostrar" tipo — el tipo determina la forma.
3. Conecte entidades con ->. Añada : pct para etiquetar el porcentaje de propiedad: parent -> child : 60%.
4. Añada @jurisdicción después del tipo para mostrar un distintivo de jurisdicción: corp@DE.

Los comentarios deben comenzar con # en su propia línea.

2. Tipos de entidad

El tipo de entidad determina la forma renderizada para ese nodo. Schematex mapea varios alias comunes a un tipo canónico.

Sintaxis de entidad:

entity ID "Display Name" type
entity ID "Display Name" type@JURISDICTION
entity ID "Display Name" type@JURISDICTION [properties]

Reglas de ID. Deben comenzar con una letra, seguida de letras, dígitos, guiones bajos o guiones: [A-Za-z][A-Za-z0-9_-]*.

3. Propiedades del nodo

Las propiedades opcionales dentro de […] anotan la entidad con contexto adicional visible en el nodo renderizado.

Cualquier clave que no esté en el conjunto reservado (status, tax, role, note, est) se almacena como propiedad personalizada.

entity alice "Alice Chen" individual [role: "Founder & CEO"]
entity trust1 "Smith Irrevocable Trust" trust@SD [est: "2019-06-01", note: "Spendthrift provisions"]
entity opco "OpCo, Inc." corp@DE [status: new, tax: ccorp]

4. Jurisdicción

Añada @CÓDIGO después del tipo de entidad para mostrar un distintivo de jurisdicción en el nodo. El código es una cadena de 2–3 letras — se aceptan tanto los códigos de país alfa-2 de ISO 3166-1 como las abreviaturas de los estados de EE.UU.

entity parent "Parent Corp" corp@US
entity ie_sub "Ireland Sub" corp@IE
entity ky_fund "Cayman Fund" lp@KY
entity de_llc "Delaware LLC" llc@DE

Códigos comunes: US Estados Unidos · DE Delaware · CA California · NY Nueva York · UK Reino Unido · IE Irlanda · NL Países Bajos · KY Islas Caimán · SG Singapur · HK Hong Kong · JP Japón · BM Bermuda · VG Islas Vírgenes Británicas · CH Suiza · LU Luxemburgo · SD Dakota del Sur.

@DE se resuelve como Delaware de forma predeterminada (el más común en contextos legales de EE.UU.).

Clústeres de jurisdicción

Declare una jurisdicción con jurisdiction CÓDIGO "Nombre" [color: "#hex"] para agrupar todas las entidades que comparten ese código en una región de clúster con borde discontinuo etiquetado en el diagrama.

jurisdiction US "United States" [color: "#3b82f6"]
jurisdiction IE "Ireland" [color: "#059669"]

Cuando el @CÓDIGO de una entidad coincide con una jurisdiction declarada, se coloca automáticamente dentro de ese clúster. Si no se declara jurisdiction, el distintivo sigue apareciendo pero no se dibuja ninguna región de clúster.

Clústeres manuales

Use cluster "Etiqueta" [members: [id1, id2], color: "#hex"] para agrupar entidades que no comparten un único código de jurisdicción.

cluster "Ireland / Cayman IP" [members: [ie_ip, nl_bv], color: "#059669"]

5. Aristas de propiedad

Una línea de arista conecta dos IDs de entidad con un operador. El operador determina el estilo de línea y la semántica visual.

Porcentaje de propiedad: añada : pct después del ID objetivo.

parent -> subsidiary : 60%

Clase de acciones: añada [class: "Series A Pref"] para etiquetar la clase de acciones en la arista.

vc -> startup : 22% [class: "Series A Pref"]

Etiqueta sin acciones: use [label: "…"] para texto descriptivo en aristas de licencia o distribución.

ip_co -~-> opco [label: "IP License · royalty"]
trust --> beneficiary [label: "Discretionary distributions"]

Combinación: class: y label: pueden aparecer juntos.

fund -> portfolio : 35% [class: "Common", label: "Post-Series B"]

6. Etiquetas y comentarios

• Título: entity-structure "Acme Holdings" — primera línea, entre comillas.
• Nombre a mostrar de la entidad: la cadena entre comillas en entity ID "Nombre" tipo — aparece dentro del nodo.
• Distintivo de jurisdicción: @CÓDIGO después del tipo — código de 2–3 letras mostrado en la esquina del nodo.
• Propiedades del nodo: [note: "…", role: "…", status: new, …] — anotaciones dentro del nodo.
• Porcentaje de arista: : pct después del ID objetivo — aparece en la flecha de propiedad.
• Clase de arista: [class: "…"] — etiqueta de clase de acciones en la flecha.
• Etiqueta de arista: [label: "…"] — texto descriptivo en la flecha.
• Comentarios: # al inicio de una línea (después de espacios iniciales). Los comentarios # al final dentro de bloques de corchetes también se eliminan.

7. Palabras reservadas y escape

Reservadas al inicio de línea: entity-structure (encabezado), entity, jurisdiction, cluster.

Palabras clave de tipo de entidad — estas cadenas se analizan como tipos de entidad y no deben usarse como IDs de entidad: corp, corporation, inc, llc, llp, gmbh, bv, lp, lllp, fund, trust, individual, person, foundation, npo, disregarded, branch, pool, placeholder, tbf.

Tokens de operador de arista — evite estas secuencias dentro de los IDs: ->, ==>, -.->, -~->, -->.

Las cadenas con espacios deben ir entre comillas dobles en nombres a mostrar, notas, etiquetas de rol y valores de color.

Los códigos de jurisdicción no distinguen mayúsculas de minúsculas en el fuente pero se normalizan a mayúsculas: @de y @DE son equivalentes.

8. Errores comunes

9. Gramática (EBNF)

document        = header (blank | comment | jurisdiction-def | cluster-def | entity-def | edge)*

header          = "entity-structure" ( WS quoted-string )? NEWLINE
quoted-string   = '"' any-char-but-quote* '"'

jurisdiction-def = "jurisdiction" CODE WS quoted-string ( "[" jur-attrs "]" )? NEWLINE
jur-attrs        = jur-attr ("," jur-attr)*
jur-attr         = "color:" quoted-string

cluster-def     = "cluster" WS quoted-string ( "[" cluster-attrs "]" )? NEWLINE
cluster-attrs   = cluster-attr ("," cluster-attr)*
cluster-attr    = "members:" "[" id ("," id)* "]"
                | "color:" quoted-string

entity-def      = "entity" WS id WS quoted-string WS entity-type ( "@" CODE )?
                  ( "[" entity-attrs "]" )? NEWLINE
entity-attrs    = entity-attr ("," entity-attr)*
entity-attr     = "status:" status
                | "tax:" quoted-string
                | "role:" quoted-string
                | "note:" quoted-string
                | "est:" quoted-string
                | key ":" quoted-string        # custom property

entity-type     = "corp" | "corporation" | "inc"
                | "llc" | "llp" | "gmbh" | "bv"
                | "lp" | "lllp" | "fund"
                | "trust"
                | "individual" | "person"
                | "foundation" | "npo"
                | "disregarded" | "branch"
                | "pool"
                | "placeholder" | "tbf"

edge            = id WS op WS id ( ":" WS pct-text )? ( "[" edge-attrs "]" )? NEWLINE
op              = "->" | "==>" | "-.->" | "-~->" | "-->"
pct-text        = any text up to "[" or end of line   # e.g. "100%" or "V 75% / E 50%"

edge-attrs      = edge-attr ("," edge-attr)*
edge-attr       = "class:" quoted-string
                | "label:" quoted-string

status          = "new" | "eliminated" | "modified" | "normal"
CODE            = [A-Za-z]{2,3}
id              = [A-Za-z] [A-Za-z0-9_-]*
comment         = "#" any NEWLINE

Fuente autorizada: src/diagrams/entity/parser.ts. Si esto diverge del parser, el parser tiene precedencia — por favor, abra un issue.

10. Conformidad con estándares

Los diagramas de estructura de entidades de Schematex sintetizan convenciones de:

• SEC Reglamento S-K, Elemento 601(b)(21) — Convenciones de divulgación de subsidiarias del Anexo 21
• Formulario 8832 del IRS — Clasificaciones de entidades C-corp / pass-through / ignoradas
• ISO 3166-1 alfa-2 — Códigos de jurisdicción en distintivos de nodo
• ISO 20275:2017 — Clasificación de formas de entidad del Identificador de Entidad Legal (LEI)
• Directrices de Precios de Transferencia de la OCDE (2022) — Convenciones de flujo de licencias de PI transfronterizas y regalías
• Convenciones de memorándums fiscales de las Big Four (EY / PwC / KPMG / Deloitte) — estándar de facto para diagramas de estructura transfronteriza

Lo que está implementado hoy:

• ✅ Nueve tipos de entidad con formas distintas: corp, llc, lp, trust, individual, foundation, disregarded, pool, placeholder
• ✅ Alias de tipo: corporation, inc, llp, gmbh, bv, lllp, fund, person, npo, branch, tbf
• ✅ Cinco operadores de arista: -> (propiedad), ==> (voto), -.-> (pool), -~-> (licencia), --> (distribución)
• ✅ Etiquetas de porcentaje de propiedad (: pct) y clase de acciones ([class: "…"])
• ✅ Distintivos de jurisdicción (@CÓDIGO) con códigos ISO 3166-1 y de estados de EE.UU.
• ✅ Regiones de clúster de jurisdicción (agrupación con borde discontinuo por @CÓDIGO)
• ✅ Clústeres manuales (cluster "…" [members: […]])
• ✅ Propiedades del nodo: status, tax, role, note, est, pares clave-valor personalizados
• ⏳ Porcentaje dividido V/E — V 75% / E 50% almacenado en la cadena percentage pero el renderizado como etiqueta de dos líneas aún no está implementado
• ⏳ Renderizado de diferencias en pasos de transacción — status: new / eliminated / modified almacenado pero los distintivos visuales de diferencia aún no se renderizan
• ⏳ Anotación de recuento de acciones en línea — 100 shares Common junto al porcentaje

11. Ejemplos relacionados

12. Hoja de ruta

Planificado — aún no analizable. No use estos elementos en DSL generado hoy; el parser los rechazará o los ignorará.

• Renderizado de porcentaje dividido V/E — V 75% / E 50% en una sola arista, mostrado como etiqueta de porcentaje de dos líneas que distingue la participación con derecho a voto de la participación económica.
• Distintivos de diferencia en pasos de transacción — status: new renderiza un distintivo verde "NEW"; status: eliminated renderiza un tachado rojo; usado para la comparación de estructuras pre/post M&A en un único diagrama.
• Anotación de recuento de acciones — -> sub : 100 shares Common junto a un porcentaje para capturar el recuento exacto de acciones de una tabla de capitalización.
• Propiedad bidireccional — arista explícita <-> para propiedad cruzada (dos entidades que se poseen mutuamente), con enrutamiento en curva S para evitar el desorden.
• Bloque de leyenda — leyenda autogenerada que muestra el mapeo de forma a tipo de entidad y de operador a tipo de relación.

Haga seguimiento en los issues de GitHub si necesita alguno de estos antes.