Trục 6: Biểu mẫu

Mẫu danh mục OSCAL

Bản nháp

GCBoK định nghĩa các taxonomy tuân thủ của Đức dưới dạng danh mục OSCAL - một điểm mới trên thị trường:

oscal_catalog:
  groups:
    - id: "gobdControls"
      title: "GoBD - Nachvollziehbarkeit"
      controls:
        - id: "GOBD-01"
          title: "Progressive Navigation"
          description: "Jeden Geschäftsvorfall rückwärts verfolgbar"
    - id: "bsiControls"
      title: "BSI IT-Grundschutz Module"
      controls:
        - id: "APP.3.1.A1"
          title: "Datensicherung"
    - id: "dsgvoControls"
      title: "DSGVO Anförderungen"
      controls:
        - id: "DSGVO-Art.17"
          title: "Recht auf Vergessenwerden"

Mẫu chính sách OPA

Bản nháp

Ví dụ về một chính sách Rego để xác thực chứng từ:

package gitcover.compliance

deny[msg] {
    input.class == "INVOICE"
    not input.prev_sha256
    msg := "INVOICE muss prev-hash referenzieren"
}

deny[msg] {
    input.class == "PAYMENT"
    not input.gpg_fingerprint
    msg := "PAYMENT muss GPG-signiert sein"
}

allow {
    count(deny) == 0
}

Lược đồ V7GUID

Bản nháp

Lược đồ siêu dữ liệu V7GUID chuẩn tắc:

v7guid: "0197a3b2-f3c0-7b00-8001-000000000042"
class: INVOICE          # PERSON | INVOICE | PAYMENT | CONTRACT | ...
sha256: "7d4e2f..."
prev_sha256: "3f2a1c..."  # null für Genesis-Beleg
gpg_fingerprint: "ABCD1234..."
timestamp_iso: "2026-06-14T11:18:00+02:00"
gobd_periode: "FY2026"

Độ sâu tuân thủ → Phân tầng lược đồ V7GUID

Tùy theo độ sâu tích hợp của kho Git và yêu cầu tuân thủ, cần các lược đồ JSON V7GUID khác nhau. GCBoK định nghĩa một phân tầng lược đồ (mô hình theo cấp), được gắn với VariantId, kind và status:

Tầng	Yêu cầu tuân thủ	Các trường lược đồ bắt buộc	`VariantId`	`kind`	`status`
T1	Chỉ GoBD/AO (Tối thiểu)	`v7guid`, `class`, `sha256`, `prev_sha256`, `gpg_fingerprint`, `timestamp_iso`, `gobd_periode`	`10` (Lưu trữ 10 năm §147 AO)	`INVOICE`, `RECEIPT`, `CONTRACT`	`ACTIVE`
T2	PII / DSGVO	T1 + `tenant_id`, `org_unit_id`, `data_category` (Art. 9 DSGVO), `retention_legal_basis`	`11` (Cấp bảo vệ DSGVO)	`PERSON`, `HR_DATA`	`ACTIVE`
T3	NIS2 (Cơ sở hạ tầng trọng yếu)	T2 + `risk_level`, `incident_reporting_obligation`, `supply_chain_tier`	`12` (Lớp rủi ro NIS2)	`INFRASTRUCTURE`, `LOG_DATA`	`ACTIVE`
T4	ISO 27001 (Đầy đủ)	T3 + `control_id` (ISO 27001 Annex A), `asset_classification`, `treatment_plan_ref`	`13` (IFRS/HGB + ISO)	`POLICY`, `AUDIT_EVIDENCE`	`ACTIVE`

Nguyên tắc: „Cuối cùng chỉ còn lại các kho Git“ — phương án dự phòng khi kiểm tra/đánh giá là Code-Artifacts + sổ đăng ký/từ điển .gitcover ở định dạng JSON/JSONL. Gói kiểm tra HTML chỉ là phần trình bày; phần pháp y chính là kho Git (xem Quy trình: Sẵn sàng kiểm toán và dẫn xuất gcbok-audit-evidence-docs/docs/02-audit-website-als-pruefungsartefakt).

Các tệp lược đồ được lưu trữ có phiên bản trong .gitcover/schemas/ của kho TOP và được làm cho có thể phân giải qua others.json.

Mẫu vùng chứa DMS

Vùng chứa .v7g.zip cho GCDMS (phạm vi phụ thuộc vào use case):

document.v7g.zip
├── .v7g.md          # Metadaten, ggfs. mit Strukturinformationen in Markdown Artefakten (JSON/YAML/XML, SHA256 Hash des Urdokuments, etc.)
├── .v7g.sig         # GPG-Signatur
├── document.pdf     # Originaldokument (Urdokument)
├── document.json    # Maschinenlesbare Extrakte
├── document.xml     # Maschinenlesbare Extrakte (z.B. X-Rechnung)
└── attachments/     # Anhänge

Lựa chọn định dạng tùy theo use case

Định dạng	Cách sử dụng
`.v7g.json`	Máy đọc được, chính sách OPA, xuất OSCAL
`.v7g.md`	Siêu liên kết, con người đọc được, Git-Web-UI
`.v7g.yaml`	Tệp cấu hình, con người chỉnh sửa được

Mẫu sidecar V7GUID

Sidecar chuẩn tắc (*.v7g.md) cho một tài liệu gốc kỹ thuật số. Lược đồ: https://gitcover.org/schemas/v7g-sidecar-1.0.schema.json; siêu dữ liệu phiên bản tuân theo record-metadata-1.0.schema.json (ISO 15489).

DocID = uuidv7 (mã định danh phiên bản) so với v7guid (mã định danh lớp/ngữ cảnh). Cả hai đều được ghi trong sidecar và liên kết qua composite_key ({v7guid}:{uuidv7}). Nội dung tối thiểu: sha256 của tài liệu gốc.

# V7G Sidecar - {original_filename}

**SHA-256:** `{sha256}`
**Tenant:** {tenant}
**Kategorie:** {category}
**Sphäre:** {sphere}
**Tags:** {tags}

```json
{
  "$schema": "https://gitcover.org/schemas/v7g-sidecar-1.0.schema.json",
  "docUid": "{uuidv7}",
  "sha256": "{sha256}",
  "title": "{original_filename}",
  "original_filename": "{original_filename}",
  "locations": [
    { "unc_path": "./{tenant}/{path}", "from": "{YYMMDD}", "to": null, "note": "Primärspeicherort" }
  ],
  "v7g_taxonomy": [
    { "v7guid": "{v7guid}", "taxonomy": "{tenant}/{taxonomy}", "valid_from": "{YYMMDD}", "valid_to": null }
  ],
  "gcpn": { "prima_nota_ref": null, "journal_entry_ref": null },
  "obsolescence": { "status": "active", "superseded_by": null, "last_checked_at": "{ts}", "last_checked_by": "{user}" },
  "verification": { "verified_at": "{ts}", "verified_by": "auto", "method": "sha256_file", "intact": true },
  "tags": ["{tag}"],
  "sphere": "{sphere}"
}
```

Cấp phát DocID: Khi tài liệu được đưa mới vào DMS, công cụ sidecar tạo một UUIDv7 từ một đối số TimeStamp làm DocID (uuidV7). Nguồn mặc định là mtime của tệp; nếu tên tệp hoặc nội dung cung cấp một ngày nghiệp vụ, thì ngày đó được sử dụng (xem Trục 5: Quy trình).