____13DS — Referenced-Doc, Actor, Attendees, Persons

Trigger S6, Finding AP5/AP6

The first container version confused the participant layers: The GF was listed as the decision-making participant and the sole shareholder was missing as Actor. The correction by the entrepreneur (E1) yielded a role layering that flowed into the schema — the most important research gain of the first use.

The Layering

Actor = the Act of the Shareholders

The Actor is not the person who signs — it is the act of the shareholders: the meeting or, respectively, the sole shareholder as the decision-making body.

"actor": {
  "actor_id": "PARTNER-ORG",
  "kind": "gvb",
  "name": "PARTNER-ORG (Platzhalter: Alleingesellschafterin der ORG-1)",
  "role": "Alleingesellschafterin (100 % der Geschäftsanteile)",
  "capacity": "fasst den Beschluss als Gesellschafterversammlung im Sinne des § 48 Abs. 3 GmbHG — es ist ein Akt der Gesellschafter (Alleingesellschafterbeschluss in Textform, § 126b BGB)",
  "entity": "PARTNER-ORG",
  "act": {
    "kind": "shareholder-meeting-resolution",
    "note": "…",
    "acts": [ … ]
  }
}

The error we corrected with this: E1 was initially listed as Actor "GF of ORG-1" — wrong, because the GVB issues the instructions to the GF; he is not the decision-maker. His relationship to ORG-1 has no significance in the process.

Attendee = the Person as Participant

"attendees": [
  {
    "attendee_id": "E1-PARTNER-ORG-GF",
    "kind": "actor",
    "actor_ref": "E1",
    "tenant_ref": "PARTNER-ORG",
    "role": "Geschäftsführer der PARTNER-ORG",
    "org_unit_id": "PARTNER-ORG-Portfolio",
    "participation": "zeichnend",
    "presence": "Teilnehmer der Gesellschafterversammlung (Textform § 126b BGB) — nimmt als GF der PARTNER-ORG an der Versammlung teil und zeichnet für die Alleingesellschafterin PARTNER-ORG"
  }
]

Persons = the pseudonymized PII bridge

"persons": {
  "note": "Personen-zu-Rollen-Zuordnung liegt im PII-Kreis (gitignored, DSGVO) — hier nur der Pseudonymisierungs-Verweis",
  "mappings": [
    {
      "person_pseudonym": "E1",
      "person_ref_type": "pii-repo-ref",
      "person_ref": "E1 = Erich Mustermann (natürliche Person, Platzhalter)
      "attendee_id": "E1-PARTNER-ORG-GF",
      "roles": ["Geschäftsführer der PARTNER-ORG (Teilnehmer/Zeichner)"],
      "pii_repo": "PII-Verzeichnis des Tenants (gitignored)"
    }
  ]
}

The Relationships in the Diagram

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#FBFAF7','primaryTextColor':'#0F1B33','primaryBorderColor':'#6B7280','lineColor':'#6B7280'}}}%% flowchart TB A["actor: PARTNER-ORG
(kind: gvb — Akt der Gesellschafter)"] --> B["attendee: E1-PARTNER-ORG-GF
(Person als Teilnehmer, zeichnend)"] B --> C["persons.mapping
E1 → attendee_id (PII-Brücke, pseudonymisiert)"] C --> D["PII-Repo (gitignored)
kanonische Person→Rollen-Zuordnung"] A -.-> E["referenced_doc
(sha256-Verweis, 1×)"] style D fill:#f3e6e6,stroke:#8b2635

The Demarcation (correction-checked)

Term	Before (faulty version)	Correction
Actor	GF as the decision-making participant	Act of the shareholders (PARTNER-ORG passes the resolution; `kind: gvb`)
Attendee	Tenant as participant	Person as participant (GF, signing)
Persons	Double roles of the person	PII bridge only: Person → attendee_id → role (signing)

Core sentence: It is an act of the shareholders; the participant is the person. The GF acts as an organ of PARTNER-ORG — his GF role vis-à-vis ORG-1 has no significance in the process (the GVB gives the GF instructions).

Link to GCBoK Work Requirements

The person-to-role mapping is noted as work requirements in Axis 4: Techniques ("Git as IdP"): User→Role, Role→Group (Gitea teams), Group→Org-Unit (populate departments.json), Org-Unit→Tenant (populate others.json), Person(PII)→User (PII schema). Until elaborated in detail, the pseudonymized references serve as an interim solution.

Created: 260913 | Part III, Article ____13DS | Series: digital-signage