Gesellschaftsstruktur-Diagramm

Über Gesellschaftsstruktur-Diagramme

Ein Gesellschaftsstruktur-Diagramm bildet die rechtlichen und wirtschaftlichen Beziehungen zwischen Organisationen und Personen ab — wer was besitzt, durch welche Gesellschaftsform und in welcher Jurisdiktion. Unternehmensanwältinnen und -anwälte verwenden sie zur Dokumentation von Holdingstrukturen und Tochtergesellschaftsketten. Steuerberaterinnen und -berater zeichnen sie, um grenzüberschreitende IP-Lizenzzüsse und Verrechnungspreisgestaltungen darzustellen. Startup-Anwältinnen und -anwälte erstellen sie für Cap Tables und Board-Consents. Nachlassplanerinnen und -planer verwenden sie zur Darstellung von Grantor-Trust-Begünstigten-Arrangements. Das Diagramm ist das erste Dokument, das bei jedem M&A-Due-Diligence-Prozess angefordert wird, und der Standard-Anhang zu einem OECD-Transfer-Pricing-Masterdateipaket.

Schematex folgt den Praxiskonventionen, die aus SEC Regulation S-K Exhibit 21 (Offenlegung von Tochtergesellschaften), IRS Form 8832 Gesellschaftsklassifikationen, ISO 3166-1 Jurisdiktionscodes, ISO 20275 Rechtsformen und Big-Four-Steuermemo-Konventionen synthetisiert wurden. Gesellschaftstypen werden auf unterschiedliche Formen abgebildet (Rechteck für Kapitalgesellschaft, abgerundetes Rechteck für LLC, Ellipse für Trust), damit jede Leserin und jeder Leser die Rechtsform auf einen Blick erkennen kann. Diese Seite dokumentiert, was der Parser heute akzeptiert.

1. Ihre erste Gesellschaftsstruktur

Die kleinste sinnvolle Gesellschaftsstruktur: eine Muttergesellschaft mit zwei Tochtergesellschaften.

Vier Regeln decken 80 % der Nutzungsfälle ab:

1. Beginnen Sie mit entity-structure, optional gefolgt von einem Titel in Anführungszeichen.
2. Jede juristische Person ist ein Knoten: entity ID "Anzeigename" typ — der Typ bestimmt die Form.
3. Verbinden Sie Gesellschaften mit ->. Hängen Sie : pct an, um den Eigentumsanteil zu beschriften: parent -> child : 60%.
4. Fügen Sie @Jurisdiktion nach dem Typ hinzu, um ein Jurisdiktions-Badge anzuzeigen: corp@DE.

Kommentare müssen mit # am Anfang einer eigenen Zeile beginnen.

2. Gesellschaftstypen

Der Gesellschaftstyp bestimmt die für diesen Knoten gerenderte Form. Schematex ordnet mehrere gebräuchliche Aliase einem kanonischen Typ zu.

Gesellschaftssyntax:

entity ID "Anzeigename" typ
entity ID "Anzeigename" typ@JURISDIKTION
entity ID "Anzeigename" typ@JURISDIKTION [eigenschaften]

ID-Regeln. Muss mit einem Buchstaben beginnen, gefolgt von Buchstaben, Ziffern, Unterstrichen oder Bindestrichen: [A-Za-z][A-Za-z0-9_-]*.

3. Knoteneigenschaften

Optionale Eigenschaften innerhalb von […] versehen die Gesellschaft mit zusätzlichem Kontext, der im gerenderten Knoten sichtbar ist.

Jeder Schlüssel, der nicht im reservierten Satz ist (status, tax, role, note, est), wird als benutzerdefinierte Eigenschaft gespeichert.

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

Hängen Sie @CODE nach dem Gesellschaftstyp an, um ein Jurisdiktions-Badge am Knoten anzuzeigen. Der Code ist eine 2–3-stellige Zeichenkette — ISO-3166-1-Alpha-2-Ländercodes und US-Staatsabkürzungen werden beide akzeptiert.

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

Gebräuchliche Codes: US Vereinigte Staaten · DE Delaware · CA Kalifornien · NY New York · UK Vereinigtes Königreich · IE Irland · NL Niederlande · KY Kaimaninseln · SG Singapur · HK Hongkong · JP Japan · BM Bermuda · VG Britische Jungferninseln · CH Schweiz · LU Luxemburg · SD South Dakota.

@DE wird standardmäßig als Delaware aufgelöst (am häufigsten im US-amerikanischen Rechtskontext).

Jurisdiktionscluster

Deklarieren Sie eine Jurisdiktion mit jurisdiction CODE "Name" [color: "#hex"], um alle Gesellschaften mit demselben Code in einer beschrifteten, gestrichelten Clusterregion auf dem Diagramm zu gruppieren.

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

Wenn der @CODE einer Gesellschaft mit einer deklarierten jurisdiction übereinstimmt, wird sie automatisch innerhalb dieses Clusters platziert. Wenn jurisdiction nicht deklariert ist, erscheint das Badge trotzdem, aber es wird keine Clusterregion gezeichnet.

Manuelle Cluster

Verwenden Sie cluster "Bezeichnung" [members: [id1, id2], color: "#hex"], um Gesellschaften zu gruppieren, die keinen gemeinsamen Jurisdiktionscode haben.

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

5. Eigentumsbeziehungen

Eine Kantenzeile verbindet zwei Gesellschafts-IDs mit einem Operator. Der Operator bestimmt den Linienstil und die visuelle Semantik.

Beteiligungsprozentsatz: hängen Sie : pct nach der Ziel-ID an.

parent -> subsidiary : 60%

Aktiengattung: fügen Sie [class: "Series A Pref"] hinzu, um die Aktiengattung auf der Kante zu beschriften.

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

Nicht-Kapital-Beschriftung: verwenden Sie [label: "…"] für beschreibenden Kantentext bei Lizenz- oder Ausschüttungskanten.

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

Kombination: class: und label: können gemeinsam verwendet werden.

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

6. Beschriftungen & Kommentare

• Titel: entity-structure "Acme Holdings" — erste Zeile, in Anführungszeichen.
• Gesellschaftsanzeigename: die Zeichenkette in Anführungszeichen in entity ID "Name" typ — erscheint innerhalb des Knotens.
• Jurisdiktions-Badge: @CODE nach dem Typ — 2–3-stelliger Code in der Knotenecke.
• Knoteneigenschaften: [note: "…", role: "…", status: new, …] — Annotationen innerhalb des Knotens.
• Kantenprozentsatz: : pct nach der Ziel-ID — erscheint auf dem Beteiligungspfeil.
• Kantenklasse: [class: "…"] — Aktiengattungsbezeichnung auf dem Pfeil.
• Kantenbeschriftung: [label: "…"] — beschreibender Text auf dem Pfeil.
• Kommentare: # am Anfang einer Zeile (nach führendem Leerzeichen). Nachgestellte #-Kommentare innerhalb von Klammerblöcken werden ebenfalls entfernt.

7. Reservierte Wörter & Maskierung

Am Zeilenanfang reserviert: entity-structure (Kopfzeile), entity, jurisdiction, cluster.

Gesellschaftstyp-Schlüsselwörter — diese Zeichenketten werden als Gesellschaftstypen geparst und dürfen nicht als Gesellschafts-IDs verwendet werden: corp, corporation, inc, llc, llp, gmbh, bv, lp, lllp, fund, trust, individual, person, foundation, npo, disregarded, branch, pool, placeholder, tbf.

Kantenoperator-Token — vermeiden Sie diese Zeichenfolgen in IDs: ->, ==>, -.->, -~->, -->.

Zeichenketten mit Leerzeichen müssen in doppelte Anführungszeichen gesetzt werden: Anzeigenamen, Notizen, Rollenbezeichnungen und Farbwerte.

Jurisdiktionscodes sind in der Quelle Groß-/Kleinschreibung-unabhängig, werden aber in Großbuchstaben normiert: @de und @DE sind gleichwertig.

8. Häufige Fehler

9. Grammatik (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        # benutzerdefinierte Eigenschaft

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        = beliebiger Text bis "[" oder Zeilenende   # z. B. "100%" oder "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

Maßgebliche Quelle: src/diagrams/entity/parser.ts. Wenn diese Dokumentation vom Parser abweicht, hat der Parser Vorrang — bitte öffnen Sie ein Issue.

10. Normkonformität

Schematex-Gesellschaftsstruktur-Diagramme synthetisieren Konventionen aus:

• SEC Regulation S-K, Item 601(b)(21) — Exhibit-21-Offenlegungskonventionen für Tochtergesellschaften
• IRS Form 8832 — C-Corp / Pass-through / Disregarded-Entity-Klassifikationen
• ISO 3166-1 alpha-2 — Jurisdiktionscodes auf Knoten-Badges
• ISO 20275:2017 — Legal-Entity-Identifier (LEI)-Rechtsformklassifikation
• OECD-Verrechnungspreisleitlinien (2022) — grenzüberschreitende IP-Lizenz- und Lizenzgebührenfluss-Konventionen
• Big-Four-Steuermemo-Konventionen (EY / PwC / KPMG / Deloitte) — De-facto-Standard für grenzüberschreitende Strukturdiagramme

Was heute implementiert ist:

• ✅ Neun Gesellschaftstypen mit unterschiedlichen Formen: corp, llc, lp, trust, individual, foundation, disregarded, pool, placeholder
• ✅ Typ-Aliase: corporation, inc, llp, gmbh, bv, lllp, fund, person, npo, branch, tbf
• ✅ Fünf Kantenoperatoren: -> (Eigentum), ==> (Stimmrechte), -.-> (Pool), -~-> (Lizenz), --> (Ausschüttung)
• ✅ Beteiligungsprozentsatz-Beschriftungen (: pct) und Aktiengattung ([class: "…"])
• ✅ Jurisdiktions-Badges (@CODE) mit ISO-3166-1 und US-Staatscodes
• ✅ Jurisdiktionscluster-Regionen (gestrichelte Umrandungsgruppierung nach @CODE)
• ✅ Manuelle Cluster (cluster "…" [members: […]])
• ✅ Knoteneigenschaften: status, tax, role, note, est, benutzerdefinierte Schlüssel-Wert-Paare
• ⏳ V/E-Split-Prozentsatz — V 75% / E 50% in percentage-Zeichenkette gespeichert, aber Rendering als zweizeilige Beschriftung noch nicht implementiert
• ⏳ Transaktionsschritt-Diff-Rendering — status: new / eliminated / modified gespeichert, aber visuelle Diff-Badges noch nicht gerendert
• ⏳ Inline-Aktienanzahl-Annotation — 100 shares Common neben dem Prozentsatz

11. Verwandte Beispiele

12. Roadmap

Geplant — noch nicht parsierbar. Verwenden Sie diese nicht in generiertem DSL; der Parser wird sie zurückweisen oder ignorieren.

• V/E-Split-Rendering — V 75% / E 50% auf einer einzelnen Kante, als zweizeilige Prozentsatz-Beschriftung angezeigt, die Stimmrechtsanteil von wirtschaftlichem Anteil unterscheidet.
• Transaktionsschritt-Diff-Badges — status: new rendert ein grünes „NEU"-Badge; status: eliminated rendert eine rote Durchstreichung; verwendet für Vorher/Nachher-M&A-Strukturvergleiche in einem einzigen Diagramm.
• Aktienanzahl-Annotation — -> sub : 100 shares Common neben einem Prozentsatz, um die genaue Aktienanzahl aus einer Kapitalisierungstabelle zu erfassen.
• Bidirektionales Eigentum — explizite <->-Kante für Kreuzbeteiligungen (zwei Gesellschaften, die sich gegenseitig halten), mit S-Kurven-Routing zur Vermeidung von Unübersichtlichkeit.
• Legendenblock — automatisch generierte Legende, die Form-zu-Gesellschaftstyp- und Operator-zu-Beziehungstyp-Zuordnungen zeigt.

Verfolgen Sie den Fortschritt in den GitHub-Issues, wenn Sie diese Funktionen früher benötigen.