____13DS — Referenced-Doc, Actor, Attendees, Persons

Desencadenante S6, hallazgo AP5/AP6

La primera versión del contenedor confundió los estratos de intervinientes: el GF figuraba como participante decisor y la socia única faltaba como Actor. La corrección por parte del empresario (E1) arrojó una estratificación de roles, que se incorporó al esquema — el hallazgo de investigación más importante del primer uso.

La estratificación

Actor = el acto de los socios

El Actor no es la persona que firma — es el acto de los socios: la asamblea o bien la socia única como órgano decisor.

"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": [ … ]
  }
}

El error que con esto corregimos: E1 figuraba inicialmente como Actor «GF de la ORG-1» — incorrecto, porque la GVB da las instrucciones al GF; él no es quien adopta el acuerdo. Su relación con la ORG-1 no tiene ninguna importancia en el procedimiento.

Attendee = la persona como participante

"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 = el puente PII pseudonimizado

"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)"
    }
  ]
}

Las relaciones en el diagrama

%%{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

La delimitación (verificada tras la corrección)

Término Antes (versión errónea) Corrección
Actor GF como participante decisor Acto de los socios (PARTNER-ORG adopta el acuerdo; kind: gvb)
Attendee Tenant como participante Persona como participante (GF, firmando)
Persons Roles dobles de la persona Solo puente PII: Persona → attendee_id → rol (firmando)

Frase clave: Es un acto de los socios; el participante es la persona. El GF actúa como órgano de la PARTNER-ORG — su rol de GF frente a la ORG-1 no tiene ninguna importancia en el procedimiento (la GVB da instrucciones al GF).

Enlace con las necesidades de trabajo del GCBoK

La asignación de persona a rol está anotada como necesidad de trabajo en Eje 4: Técnicas («Git como IdP»): User→Role, Role→Group (equipos de Gitea), Group→Org-Unit (rellenar departments.json), Org-Unit→Tenant (rellenar others.json), Person(PII)→User (esquema PII). Hasta su elaboración, las referencias pseudonimizadas se consideran una solución transitoria.


Creado: 260913 | Parte III, artículo ____13DS | Serie: digital-signage