ED06 - Tài liệu Quy trình GoBD: Trường bắt buộc, Quản lý phiên bản, Phê duyệt

Vấn đề

GoBD Rz. 64-91 yêu cầu một tài liệu quy trình - nhưng trong lĩnh vực SME nó là ngoại lệ lớn:

"Tài liệu quy trình là gì?" - hầu hết các doanh nhân không biết thuật ngữ này, chưa nói đến nội dung
"Kế toán thuế làm việc đó" - nhiều người tin rằng StB tạo tài liệu quy trình - nhưng ông ấy chỉ có thể hướng dẫn, doanh nhân phải tự tạo và duy trì nó
Tài liệu Word trong bàn làm việc - nếu có tài liệu quy trình, nó là một tài liệu Word tĩnh, không được cập nhật khi hệ thống thay đổi - vi phạm GoBD
Không có quản lý phiên bản - các thay đổi đối với tài liệu quy trình không được ghi nhận có thể truy vết - nhưng GoBD Rz. 83 yêu cầu tính cập nhật và khả năng truy vết
Không có phê duyệt - tài liệu quy trình không bao giờ được "phê duyệt" - nhưng GoBD yêu cầu trạng thái tại thời điểm kiểm toán phải rõ ràng
Thay đổi hệ thống không được ghi nhận - khi di chuyển sang phần mềm mới tài liệu quy trình không được tiếp tục - GoBD Rz. 146-150 yêu cầu điều này một cách rõ ràng

Tuyên bố cốt lõi

Một tài liệu quy trình tuân thủ GoBD trong kho Git có nghĩa:

Tài liệu quy trình là một tạo tác Git được quản lý phiên bản - không phải tài liệu Word, mà là Markdown + JSON trong kho
Mọi thay đổi đều có thể truy vết - git log hiển thị Ai, Khi nào, Cái gì, Tại sao (tác giả commit, dấu thời gian uuidV7, diff, thông điệp commit)
Phê duyệt qua tag - một Git tag đánh dấu trạng thái đã phê duyệt của tài liệu quy trình (ví dụ vd-v1.0-2026)
Thay đổi hệ thống được tiếp tục - khi di chuyển, một commit mới với lý do được tạo, phiên bản cũ vẫn có thể truy vết
Bản thân kho là một phần của tài liệu quy trình - git log hiển thị quy trình, .gitcover/schemas/ hiển thị cấu trúc dữ liệu, Git hook hiển thị các kiểm soát

Tuân thủ theo thiết kế: Tài liệu quy trình không phải là việc làm sau - nó phát sinh thông qua việc sử dụng Git. Bất kỳ ai làm việc với kho Git đều ghi nhận quy trình của họ tự động thông qua commit, diff và tag. Tài liệu quy trình chính thức bổ sung điều này bằng mô tả có thể đọc bởi con người.

Tài liệu quy trình là gì?

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#FBFAF7','primaryTextColor':'#0F1B33','primaryBorderColor':'#6B7280','lineColor':'#6B7280'}}}%% flowchart TD VD["Verfahrensdokumentation
(GoBD Rz. 64–91)"] VD --> V["Verfahren
(Wie wird gebucht?)"] VD --> S["Systemumgebung
(Welche Software/Hardware?)"] VD --> O["Organisation
(Wer macht was?)"] VD --> K["Kontrollen
(Wie wird geprüft?)"] VD --> D["Daten
(Welche Formate/Strukturen?)"] V --> G["Git-Repo
(Commits, Hooks)"] S --> G O --> G K --> G D --> G style VD fill:#0F1B33,stroke:#0F1B33,color:#FBFAF7 style V fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style S fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style O fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style K fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style D fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style G fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33

Yêu cầu GoBD	Nội dung	Cách Git thực hiện
Quy trình (Rz. 64-71)	Mô tả quy trình kế toán	`git log` hiển thị mọi bước; thông điệp commit ghi nhận lý do
Môi trường hệ thống (Rz. 72-76)	Phần mềm, phần cứng, phiên bản	`.gitcover/` với schema, từ điển; `git config` hiển thị cài đặt
Tổ chức (Rz. 77-80)	Trách nhiệm, vai trò, quyền	Trường `role` mỗi tạo tác; `git log --author` hiển thị trách nhiệm
Kiểm soát (Rz. 81-85)	Kiểm soát nội bộ, kiểm tra hợp lý	Pre-commit hook (schema, sphere, lỗi thời); post-commit hook (chỉ mục)
Dữ liệu (Rz. 86-91)	Cấu trúc dữ liệu, định dạng, giao diện	JSON schema trong `.gitcover/schemas/`; sidecar với `v7g_taxonomy`

Trường bắt buộc của tài liệu quy trình

Cấu trúc trong kho Git

ORG-1/
├── .gitcover/
│   ├── schemas/                    # Cấu trúc dữ liệu (Rz. 86-91)
│   │   ├── diary-entry-1.0.schema.json
│   │   ├── v7g-sidecar-1.0.schema.json
│   │   └── timesheet-1.0.schema.json
│   ├── dictionaries/               # Phân loại (Rz. 86-91)
│   │   ├── spheres.json
│   │   ├── roles.json
│   │   └── beleg-types.json
│   └── LEGAL_ENTITY.v7g.json       # Định danh tenant
├── docs/
│   └── verfahrensdokumentation/
│       ├── README.md               # Mục nhập + tổng quan
│       ├── 01-verfahren.md         # Quy trình kế toán (Rz. 64-71)
│       ├── 02-systemumgebung.md    # Phần mềm/phần cứng (Rz. 72-76)
│       ├── 03-organisation.md      # Trách nhiệm (Rz. 77-80)
│       ├── 04-kontrollen.md        # Kiểm soát nội bộ (Rz. 81-85)
│       └── 05-daten.md             # Cấu trúc dữ liệu (Rz. 86-91)
└── .githooks/
    ├── pre-commit                  # Kiểm soát (Rz. 81-85)
    └── post-commit                 # Tạo chỉ mục

Tài liệu quy trình dưới dạng tạo tác JSON

Bản thân tài liệu quy trình là một tạo tác được quản lý phiên bản với V7GUID (Class) và uuidV7 (Object ID làm DocID):

{
  "$schema": "https://gitcover.org/schemas/verfahrensdoku-1.0.schema.json",
  "V7GUID": "<V7GUID-Class-aus-Registry>",
  "uuidV7": "<uuidV7-Object-mit-vorgegebener-Zeitmarke>",
  "author": "E1",
  "role": "GF",
  "tenant": "ORG-1",
  "sphere": "wirtschaftlich",
  "source": "E1",
  "version": "1.0",
  "status": "released",
  "sections": ["01-verfahren", "02-systemumgebung", "03-organisation", "04-kontrollen", "05-daten"]
}

Lưu ý: uuidV7 là DocID của tài liệu quy trình. Khóa tổng hợp V7GUID:uuidV7 phục vụ tổ chức lưu trữ và truy vấn DB. Không có trường datetime/date riêng - thời gian nằm trong uuidV7.

Quản lý phiên bản và phê duyệt

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#FBFAF7','primaryTextColor':'#0F1B33','primaryBorderColor':'#6B7280','lineColor':'#6B7280'}}}%% flowchart TD E["Entwurf
Commit 1"] E --> R["Review
Commit 2 (Änderungen)"] R --> F["Freigabe
Tag: vd-v1.0-2026"] F --> P["Produktiv
Stand v1.0"] P --> A["Änderung nötig
(z. B. Systemwechsel)"] A --> E2["Entwurf v2.0
Commit 3"] E2 --> R2["Review v2.0"] R2 --> F2["Freigabe
Tag: vd-v2.0-2027"] F2 --> P2["Produktiv
Stand v2.0"] F -.-> OBS["obsolescence:
v1.0 → superseded by v2.0"] style E fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style R fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style F fill:#10A987,stroke:#0A7F5C,color:#FBFAF7 style P fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style A fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style E2 fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style R2 fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style F2 fill:#10A987,stroke:#0A7F5C,color:#FBFAF7 style P2 fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style OBS fill:#E5E7EB,stroke:#6B7280,color:#0F1B33

Giai đoạn	Thao tác Git	Tham chiếu GoBD
Bản thảo	Commit trên `main` (hoặc nhánh tính năng)	Rz. 83 (tính cập nhật)
Rà soát	Commit thêm với thay đổi	Rz. 83 (khả năng truy vết)
Phê duyệt	`git tag vd-v1.0-2026`	Rz. 83 (trạng thái ràng buộc)
Sản xuất	Tag là bất biến (được bảo vệ)	Rz. 146 (tính bất biến)
Thay đổi	Commit mới + tag mới	Rz. 146-150 (thay đổi hệ thống)
Lỗi thời	Phiên bản cũ `obsolescence: superseded_by`	Rz. 146 (khả năng truy vết)

Quan trọng - tag làm dấu phê duyệt: Một Git tag là bất biến

nó đánh dấu một trạng thái commit chính xác không thể thay đổi hồi tố. Điều này tương ứng với GoBD Rz. 146 (tính bất biến). Người kiểm toán có thể tái dựng trạng thái chính xác của tài liệu quy trình tại thời điểm kiểm toán bằng git show vd-v1.0-2026.

Thay đổi hệ thống và di chuyển (GoBD Rz. 146-150)

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#FBFAF7','primaryTextColor':'#0F1B33','primaryBorderColor':'#6B7280','lineColor':'#6B7280'}}}%% flowchart LR A["Altes System
(z. B. Cloud-Lohn)"] A --> M["Migration
Commit mit Begründung"] M --> N["Neues System
(z. B. Git-Cover)"] A --> DA["Daten alt
git bundle
(self-contained)"] N --> DN["Daten neu
Git-Repo
(fortgeführt)"] M --> VD["Verfahrensdoku
fortgeschrieben
+ Commit-Message
mit Begründung"] style A fill:#FDBA74,stroke:#C2410C,color:#0F1B33 style M fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style N fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style DA fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style DN fill:#D1FAE5,stroke:#0A7F5C,color:#0F1B33 style VD fill:#10A987,stroke:#0A7F5C,color:#FBFAF7

GoBD Rz. 146-150 yêu cầu khi thay đổi hệ thống:

Giữ dữ liệu của hệ thống cũ có sẵn - git bundle làm lưu trữ tự chứa (không cần tài khoản đám mây, xem ED04 Z3)
Tiếp tục tài liệu quy trình - commit mới với lý do: "Di chuyển từ kế toán đám mây sang GitCover, ngày, vai trò"
Ghi nhận giai đoạn chuyển tiếp - dữ liệu nào được di chuyển như thế nào, kiểm tra nào được thực hiện
Đánh dấu phiên bản cũ là lỗi thời - obsolescence: superseded_by trong tạo tác tài liệu quy trình cũ

Ví dụ thực tế: Doanh nhân (E1) di chuyển từ phần mềm kế toán đám mây sang GitCover. Ông tạo git bundle của dữ liệu cũ, tiếp tục tài liệu quy trình (commit mới với thông điệp commit "Di chuyển sang GitCover, 260815, vai trò: GF"), đánh dấu phiên bản cũ là superseded và tag phiên bản mới là vd-v2.0-2027. Người kiểm toán có thể truy vết cả hai phiên bản.

Bản thân kho làm tài liệu quy trình

%%{init: {'theme':'base','themeVariables':{'primaryColor':'#FBFAF7','primaryTextColor':'#0F1B33','primaryBorderColor':'#6B7280','lineColor':'#6B7280'}}}%% flowchart TD R["Git-Repo"] R --> GL["git log
Verfahren (Rz. 64–71)"] R --> GC["git config
Systemumgebung (Rz. 72–76)"] R --> GA["git log --author
Organisation (Rz. 77–80)"] R --> GH["Git-Hooks
Kontrollen (Rz. 81–85)"] R --> SC["Schemata + Sidecars
Daten (Rz. 86–91)"] GL --> VD["Verfahrensdokumentation
entsteht automatisch"] GC --> VD GA --> VD GH --> VD SC --> VD style R fill:#0F1B33,stroke:#0F1B33,color:#FBFAF7 style GL fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style GC fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style GA fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style GH fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style SC fill:#DBEAFE,stroke:#1D4ED8,color:#0F1B33 style VD fill:#10A987,stroke:#0A7F5C,color:#FBFAF7

Thông tin trọng tâm: Một kho Git chính nó là một tài liệu quy trình - git log hiển thị quy trình, git config hiển thị môi trường hệ thống, Git hook hiển thị kiểm soát, schema hiển thị cấu trúc dữ liệu. Tài liệu quy trình chính thức (Markdown trong docs/verfahrensdokumentation/) bổ sung điều này bằng mô tả có thể đọc bởi con người - nhưng nguồn có thẩm quyền là bản thân kho.

Đòn bẩy rủi ro

Hôm nay (rẻ)	Ngày mai (chứng minh được kiểm toán)	Rủi ro được giảm
Tài liệu quy trình làm tạo tác Git	GoBD Rz. 64-91 thực hiện theo thiết kế	Ước tính § 162 AO (không có tài liệu quy trình)
`git log` làm bằng chứng quy trình	Khả năng truy vết trong thời gian hợp lý	Tranh chấp tài liệu quy trình
Tag làm dấu phê duyệt	Trạng thái bất biến tại thời điểm kiểm toán	Tranh chấp trạng thái
Thay đổi hệ thống làm commit + bundle	Tuân thủ GoBD Rz. 146-150	Vi phạm GoBD do thay đổi không được ghi nhận
Đánh dấu lỗi thời	Phiên bản cũ có thể truy vết	Thay đổi ẩn
Bản thân kho làm tài liệu quy trình	Ghi nhận tự động qua sử dụng	Tài liệu quy trình lỗi thời

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

Có thể suy ra từ ED06:

ID	Yêu cầu	Mức ưu tiên
FA-6.1	Tài liệu quy trình làm tạo tác Git được quản lý phiên bản	MUST
FA-6.3	Quản lý bảng tài khoản SKR04 (bao gồm tài khoản lương)	SHOULD
FA-6.6	Tính bất biến sau phê duyệt (tag, nhánh được bảo vệ)	MUST
FA-6.7	Trình tạo web tĩnh cho kết kỳ (Z3+)	SHOULD
TA-2.1	Pre-commit: xác thực JSON schema	MUST
TA-2.4	Pre-commit: kiểm tra trạng thái lỗi thời	SHOULD
TA-2.6	Post-commit: tạo chỉ mục tự động	SHOULD

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

Nguồn

GoBD (thư BMF, Rz. 64-91 - tài liệu quy trình, Rz. 146-150 - thay đổi hệ thống, Rz. 83 - tính cập nhật)
AO (§ 146 - quy định thứ tự, § 147 - lưu trữ)
AFJD/agents/ (ẩn danh) - khái niệm SSoT với tài liệu quy trình làm tạo tác Git

Cấu trúc nguồn và liên kết tham chiếu CDN

Vai trò	Địa điểm	Mục đích
Chính / SSoT	git.gitcover.org/GCC	Lưu trữ chuẩn (ký GPG, quản lý phiên bản)
OSS Mirror công khai / CDN	codeberg.org/gitcover-commons	Bản sao chỉ đọc; khám phá FLOSS
Trung tâm cộng đồng	github.com/gitcover-commons	Vấn đề & thảo luận; tham chiếu mã nguồn trên Codeberg

Lưu ý: Phân công nguồn, mirror và trung tâm cộng đồng 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 chuẩn tương ứng trên gitcover.org cho trạng thái hiện tại.