GitCover Symbol GCBoKGitCover Body of Knowledge

DS09 — Báo cáo Envelope FES

Sự kiện 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 qua một dịch vụ FES (trình giữ chỗ FES-PROVIDER, kiểu DocuSign). Thực tiễn cổ điển: Envelope tồn tại trên đám mây của nhà cung cấp; một email xác nhận lọt vào hộp thư. Đứt gãy bằng chứng là điều chắc chắn.

GitCover kết nối vào: Báo cáo Envelope ghi nhận nghiệp vụ một cách repo-nativ — dưới dạng một 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",
  "uuidV7": "<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"
  }
}

Tại sao báo cáo thuộc về repo

Ba lý do về mặt chứng minh:

  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 cung cấp portal của mình. 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 tớ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ủ cả phần FES.
  3. Chuỗi chứng từ GoBD/AO — báo cáo là một chứng từ đầu vào (với Sidecar .v7g.md, phân loại theo V7GUID); tệp PDF đã ký là chứng từ gốc. Cả hai được chuyển 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 (.v7g.md) với một taxonomy các lớp FES:

Lớp Ý nghĩa
FES_ENVELOPE_REPORT Bản thân báo cáo (JSON)
FES_SIGNED_DOCUMENT Tệp 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 mình:

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

Kết quả thực tiễn: Một nghiệp vụ ví dụ (đã ẩn danh)

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

Tóm tắt

Ngày tạo: 260913 | Phần II, bài viết DS09 | Chuỗi bài: digital-signage