ED02 - Mô hình Tổ chức SME: Tenant, Sphere, Role

Vấn đề

Một doanh nhân thành lập một tổ chức - và đối mặt với câu hỏi: Làm sao tôi cấu trúc tổ chức của mình để các nghĩa vụ tuân thủ được tách biệt sạch sẽ, có thể truy vết và kiểm toán được?

Thực hành hiện nay trong lĩnh vực SME không có sự tách biệt sạch:

• Tất cả trong một nồi - tài liệu cá nhân và doanh nghiệp trộn lẫn trong một hộp thư, một ổ đĩa, một tài khoản đám mây.
• Không tách Tenant - một holding với nhiều công ty giữ tất cả sổ sách trong một instance, mà không rõ hồ sơ nào thuộc công ty nào.
• Không tách Sphere - trong tổ chức phi lợi nhuận, các hoạt động ideal, quản lý tài sản, mục đích kinh doanh và thương mại trộn lẫn trong một tài khoản, một thư mục, một repo.
• Không tách Role - doanh nhân tự làm mọi thứ (GF, kế toán, bảng lương, R&D), nhưng repo không biết họ đang hành động trong vai trò nào.
• Không có danh tính rõ ràng - hồ sơ không có định danh duy nhất gán chúng cho một tổ chức, một sphere, một role.

Tuyên bố cốt lõi

Cấu trúc một tổ chức như một liên minh GitCover có nghĩa: Tenant (tổ chức), Sphere (lĩnh vực hoạt động cho phi lợi nhuận) và Role (chức năng của tác nhân) được định nghĩa là trường bắt buộc của mỗi artefact - không phải metadata tùy chọn. Git hook kiểm tra mỗi commit rằng sự tách biệt hoàn chỉnh. Như vậy tạo ra Compliance by Design: cấu trúc của tổ chức được neo trong cấu trúc của repo.

Compliance by Design: Tenant, Sphere và Role không phải nhãn dán sau sự cố - chúng là trường bắt buộc mang tính cấu trúc, không có chúng một artefact không được nhận vào repo.

Mô hình ba cấp: Tenant, Sphere, Role

Cấp 1 - Tenant (Tổ chức)

Một Tenant là đơn vị tổ chức độc lập về mặt pháp lý, có nghĩa vụ lưu trữ hồ sơ riêng. Trong liên minh GitCover, mỗi tenant được duy trì như một Git repo riêng (hoặc một không gian branch riêng).

Ví dụ thực tế: Một doanh nhân (E1) điều hành một holding (ORG-1) với hai công ty con (ORG-1a, ORG-1b). Mỗi công ty con là một tenant riêng với repo riêng. Holding có một meta-repo liên kết các công ty con qua tham chiếu V7GUID - nhưng sổ sách của các công ty con vẫn tách biệt.

Cấp 2 - Sphere (Lĩnh vực hoạt động, chỉ cho phi lợi nhuận)

Sphere chỉ liên quan cho tổ chức phi lợi nhuận - nhưng khi đó bắt buộc. Luật thuế (§ 51-68 AO) yêu cầu tách bốn sphere để không đe dọa địa vị phi lợi nhuận.

Rủi ro khi thiếu tách sphere: Trộn tài sản (§ 55 Abs. 1 Nr. 5 AO) là lý do tước địa vị phi lợi nhuận. Một tổ chức phi lợi nhuận không tách hoạt động thương mại và ideal có nguy cơ mất địa vị phi lợi nhuận - và do đó đánh thuế lại quỹ dự trữ (tối đa 15 năm hồi cứu).

Cấp 3 - Role (Chức năng của tác nhân)

Role ghi nhận tác nhân đã hành động trong chức năng nào. Điều này quan trọng vì trong nhiều tổ chức một người thường giữ nhiều role (đặc biệt ở SME) - và vì role xác định nghĩa vụ nào áp dụng.

Ví dụ thực tế: Doanh nhân E1 đồng thời là GF, kế toán, nghiên cứu, phát triển và trưởng R&D. Trong repo, mỗi artefact ghi nhận họ đã hành động trong role nào - ví dụ role: "GF" cho một nghị quyết, role: "F&E-Leiter" cho một ghi giờ FZul. Như vậy có thể truy vết hồ sơ xuất phát từ góc nhìn GF (hành chính) hay góc nhìn R&D (nghiên cứu).

Triển khai trong Git Repo

Cấu trúc thư mục

ORG-1/                          # Tenant: KMU
├── .gitcover/                  # GitCover-Konfiguration
│   ├── LEGAL_ENTITY.v7g.json   # Tenant-Identität (V7GUID)
│   ├── dictionaries/           # Sphären, Rollen, Beleg-Typen
│   └── schemas/                # JSON-Schemata für Artefakte
├── diary/                      # Tagebuch (SSoT)
│   ├── entries/                # Tages-Einträge
│   └── tenants/                # Tenant-Sichten (Symlinks)
├── registry/                   # Behörden-Identifikatoren
├── sources/                    # Belegarchiv (PDF, XML, EML)
├── sidecars/                   # .v7g.md Sidecars
└── checks/                     # Fristen-Check, Sphären-Check

Artefact JSON với Tenant, Sphere, Role

Mỗi artefact (mục nhật ký, chứng từ, mục sổ cái) chứa Tenant, Sphere và Role như trường bắt buộc. Nguyên lý trung tâm của khả năng truy vết thời gian: thời điểm ghi nhận không phải một trường riêng, mà được neo trong chính uuidV7 - như timestamp 48-bit theo RFC 9562 §5.7. uuidV7 được tạo từ một timestamp định sẵn (không phải now()) qua GitCover helper (UuidV7Gen), phần còn lại điền ngẫu nhiên. Như vậy thời điểm ghi nhận được liên kết mật mã với danh tính của artefact và không thể thay đổi sau đó.

Quan trọng - cái gì vào Git repo: Chỉ các artefact có cấu trúc (mục JSON, sidecar, chứng từ) mới được nhận vào Git repo. Tài liệu cá nhân không bao giờ được nhận vào repo trừ khi được giới thiệu và phân loại rõ ràng như artefact.

{
  "$schema": "https://gitcover.org/schemas/diary-entry-1.0.schema.json",
  "V7GUID": "<V7GUID-Class-aus-Registry>",
  "uuidV7": "<uuidV7-Object-mit-vorgegebener-Zeitmarke>",
  "author": "E1",
  "role": "GF",
  "tenant": "ORG-1",
  "sphere": "ideell",
  "source": "E1",
  "source_sha256": "<SHA-256-...>",
  "tags": ["lohnabrechnung", "sv-meldung"]
}

Giải thích Composite Key: V7GUID (Class Identifier) phân loại tài liệu/hành động dựa trên registry .gitcover (cái gì/loại nào). uuidV7 (Object ID) là định danh đối tượng cụ thể với timestamp định sẵn (RFC 9562 §5.7, 48-bit Unix-ms). Cả hai cùng tạo GCPN Sidecar Composite Key V7GUID:uuidV7. Một biểu diễn chuỗi datetime hoặc date riêng là dư thừa và không được giữ trong facts - timestamp 48-bit đã có sẵn trong uuidV7. Biểu diễn chuỗi cho DTO/HTMX transfer là trách nhiệm của harness, không phải lớp facts.

Git Hook kiểm tra sự tách biệt

Liên minh Tenant: Nhiều tổ chức

Một liên minh tenant (holding với công ty con, liên danh) được liên kết qua tham chiếu V7GUID - không qua repo chung. Mỗi tenant giữ kế toán riêng, nhưng meta-repo của holding có thể tham chiếu chứng từ và mục của công ty con mà không sao chép.

Quan trọng: Meta-repo không chứa booking - chỉ tham chiếu chéo. Kế toán vẫn ở mỗi tenant. Meta-repo là lớp index, không phải lớp kế toán.

Đòn bẩy rủi ro

Yêu cầu Harness (Xem trước)

Dẫn xuất từ ED02:

Danh sách yêu cầu đầy đủ trong Harness-Anforderungen.md.

Nguồn

• AO (§§ 51-68 - phi lợi nhuận, tách sphere, § 55 Abs. 1 Nr. 5 - trộn tài sản)
• EStG (§ 3 Nr. 26/26a - khoản cố định, tham chiếu sphere)
• GoBD (thư BMF, tài liệu quy trình, tách tenant)
• AFJD/agents/ (ẩn danh) - khái niệm SSoT với Tenant, Sphere, Role

Topo nguồn và liên kết tham chiếu CDN

Lưu ý: Phân công nguồn, mirror và community hub này phản ánh trạng thái hiện tại và có thể thay đổi. Vui lòng kiểm tra nguồn chính thức tương ứng trên gitcover.org cho trạng thái hiện tại.