GitCover Symbol GCBoKGitCover Body of Knowledge

DS09 — Báo cáo Envelope FES

Điểm kích hoạt S3, phần tiếp theo

Hợp đồng dự án/mua bán với PARTNER-1 được ký kết thông qua một dịch vụ FES (placeholder FES-PROVIDER, kiểu DocuSign). Thực tiễn cổ điển: Envelope sống trong cloud của nhà cung cấp; một xác nhận qua email rơi vào hộp thư. Đứt gãy chuỗi chứng cứ là chắc chắn.

GitCover kết nối vào: Báo cáo Envelope ghi lại quy trình ngay trong repo — dưới dạng artefact JSON với toàn bộ metadata mà dịch vụ cung cấp.

Cấu trúc Envelope

{
  "$schema": "https://gitcover.org/schemas/fes-envelope-1.0.schema.json",
  "docUid": "<deterministische uuidV7>",
  "type": "fes-envelope-report",
  "envelope_id": "ENV-EXAMPLE-0001-XXXX-XXXX-XXXXXXXXXXXX",
  "provider": {
    "name": "FES-PROVIDER",
    "service": "DocuSign-artig",
    "report_source": "Web-UI-Export / API"
  },
  "matter": {
    "title": "Trademark and Domain Purchase and Transfer Agreement",
    "contract_date": "2026-08-24",
    "ur_doc_ref": {
      "kind": "external-doc",
      "note": "Vertrag als PDF beim Dienst; Quell-Dokument-SHA im Report verankert",
      "sha256": "7a054fa53ef6ec09053fc925d264ca0a8b7c140ff49e157fef393257d476272b"
    }
  },
  "signers": [
    {
      "name": "Erich Mustermann",
      "role": "Seller (Verkäufer)",
      "entity": "E1 (natürliche Person)",
      "status": "signed",
      "signed_at": "2026-08-24T14:12:00Z",
      "cert_fingerprint": "…",
      "auth_method": "provider-identity-check"
    },
    {
      "name": "PARTNER-1 (PARTNER-2)",
      "role": "Purchaser (Käufer)",
      "entity": "PARTNER-2 (Platzhalter: Vertragspartner-Sitz, EU-Ausland)",
      "status": "signed",
      "signed_at": "2026-08-24T14:15:00Z",
      "cert_fingerprint": "…",
      "auth_method": "provider-identity-check"
    }
  ],
  "documents": [
    {
      "kind": "contract-pdf",
      "filename": "contract-agreement-signed.pdf",
      "sha256": "7a054fa53ef6ec09053fc925d264ca0a8b7c140ff49e157fef393257d476272b",
      "pages": 12,
      "signature_format": "[PAdES](../../glossar.html#pades "PDF Advanced Electronic Signature — Glossar")-B-T"
    },
    {
      "kind": "certificate-of-completion",
      "filename": "DocuSign_Certificate-of-Completion.pdf",
      "sha256": "…",
      "note": "Dienst-Report (Sicht der Plattform)"
    }
  ],
  "timeline": [
    {"event": "envelope-created", "at": "2026-08-22T09:00:00Z"},
    {"event": "sent-to-signers", "at": "2026-08-22T09:05:00Z"},
    {"event": "signed", "by": "Seller", "at": "2026-08-24T14:12:00Z"},
    {"event": "signed", "by": "Purchaser", "at": "2026-08-24T14:15:00Z"},
    {"event": "completed", "at": "2026-08-24T14:15:30Z"}
  ],
  "verification": {
    "method": "sha256-Verifikation der PDFs + pdfsig-Prüfung der Signatur",
    "verified_at": "2026-09-13T16:30:00Z",
    "verified_by": "E1"
  }
}

Vì sao báo cáo phải nằm trong repo

Ba lý do chứng cứ:

  1. Độc lập với dịch vụ — báo cáo Envelope vẫn tồn tại ngay cả khi nhà cung cấp thay đổi hoặc ngừng cổng thông tin của họ. Các metadata (Envelope-ID, người ký, thời điểm, hash) có thể được xác minh một cách độc lập.
  2. Liên kết với chuỗi repo — báo cáo liên kết qua SHA-256 với phiên bản tài liệu nguồn và tài liệu chữ ký (Phần I); quy trình xác minh (DS04) cũng bao phủ phần FES.
  3. GoBD/chuỗi chứng từ AO — báo cáo là một chứng từ đầu vào (với sidecar .gc.md, phân loại theo V7GUID); PDF đã ký là chứng từ gốc. Cả hai được đưa vào container GCPN (DS05) hoặc gói container (DS10).

Phân loại Sidecar

Báo cáo Envelope nhận một sidecar (.gc.md) với một taxonomy lớp FES:

Class Ý nghĩa
FES_ENVELOPE_REPORT Bản thân báo cáo (JSON)
FES_SIGNED_DOCUMENT PDF đã ký (chứng từ gốc)
FES_CERTIFICATE_OF_COMPLETION Báo cáo của dịch vụ (góc nhìn của nền tảng)

Cả ba đều là ứng viên promote cho OSS-Normative-Root.

Báo cáo trong container GCPN

Container (DS05) mở rộng danh sách artifacts của nó:

{
  "role": "fes-envelope-report",
  "kind": "json",
  "location": "260913_fes-envelope-report.json",
  "sha256": "<SHA-256>",
  "sidecar": "260913_fes-envelope-report.json.gc.md"
},
{
  "role": "fes-signed-document",
  "kind": "pdf",
  "location": "contract-agreement-signed.pdf",
  "sha256": "7a054fa5…272b",
  "note": "physisch im Container-Paket (DS10)"
}

Ghi nhận thực tiễn: Một quy trình ví dụ (ẩn danh)

Câu chuyện được cụ thể hóa bằng một quy trình ví dụ (placeholder): hợp đồng mua bán (khởi tạo → Envelope FES ENV-EXAMPLE-0001… → ký kết → thanh toán → giao hàng → hoàn tất), được xử lý đúng theo mẫu này — báo cáo Envelope, PDF đã ký (SHA-256 được neo), Certificate-of-Completion và các tài liệu tiếp theo nằm trong repo và tạo thành chuỗi không gián đoạn: khởi tạo → ký kết → thanh toán → giao hàng → hoàn tất. Mọi tên, ID và ngày tháng đều là placeholder; cấu trúc chính là bài học mẫu.

Tóm tắt

Đã tạo: 260913 | Phần II, Bài DS09 | Chuỗi: digital-signage