เวิร์กโฟลว์¶

┌─────────────────────────────────────────────────────────────────┐
│ 1. Officer opens the submitted inspection                         │
│ 2. Officer clicks  [ Send for Signature ]                         │
│                                                                   │
│    Bridge:                                                        │
│      a. Renders ปจป. PDF via the existing qweb report             │
│      b. Resolves 3 partners from chair/member_1/member_2          │
│         (.user_id.partner_id)                                     │
│      c. Creates sign.oca.request:                                 │
│           record_ref = "hemms.asset.inspection,<id>"              │
│           signer_ids = [chair, member_1, member_2]                │
│      d. Opens the request form for review                         │
│                                                                   │
│ 3. Officer reviews signers, optionally clicks  [ Configure        │
│    Document ]  to drag signature fields onto the PDF (the         │
│    bridge does NOT pre-place fields)                              │
│                                                                   │
│ 4. Officer clicks  [ Send ]                                       │
│      → request.state: 1_draft → 0_sent                            │
│      → notification emails sent to all 3 signers                  │
│                                                                   │
│ 5. Chair clicks 📝 pencil icon (systray)                          │
│      → opens the request                                          │
│      → reviews the PDF                                            │
│      → clicks  [ Sign ]                                           │
│      → draws signature in canvas                                  │
│      → submits                                                    │
│      Chair's signer record: signed_on populated, hash computed    │
│                                                                   │
│ 6. Member 1 + Member 2 follow the same path (any order — no       │
│    workflow ordering per OQ2)                                     │
│                                                                   │
│ 7. As the 3rd signer submits:                                     │
│      Upstream sign.oca.request._check_signed():                   │
│        all(signer_ids.signed_on) → state := 2_signed              │
│      Our Q4.5 extension fires:                                    │
│        - inspection.roots_signed_pdf := request.data              │
│        - inspection.roots_signed_pdf_filename := AI-2026-00001-   │
│          signed.pdf                                               │
│        - inspection.message_post(body="✅ Document signed by all  │
│          parties...", attachments=[(filename, raw_pdf)])          │
│      Inspection.state STAYS 'submitted' (OQ3/OQ2 — no auto-       │
│      advance)                                                     │
│                                                                   │
│ 8. Print the report. The signature footer now shows the green     │
│    "✅ ลงนามดิจิทัลครบถ้วน" stamp pointing to the signed PDF in     │
│    chatter. Filed paper printouts before this point keep the      │
│    legacy 3-box signature footer.                                 │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│ 1. BME Manager opens the contract                                 │
│ 2. BME Manager clicks  [ Send for Signature ]                     │
│                                                                   │
│    Bridge:                                                        │
│      a. Renders contract qweb summary PDF                         │
│         (report_hemms_service_contract_summary_document)          │
│      b. Resolves partners:                                        │
│           vendor signer = contract.partner_id                     │
│           hospital signer = roots_hospital_signer_id.partner_id   │
│      c. Creates sign.oca.request with 2 signers                   │
│      d. Opens the request form                                    │
│                                                                   │
│ 3. BME Manager clicks [ Configure Document ] → drags signature    │
│    fields for vendor + hospital onto the PDF                      │
│                                                                   │
│ 4. BME Manager clicks  [ Send ]                                   │
│      → request.state: 1_draft → 0_sent                            │
│      → vendor receives an email with a portal link                │
│      → hospital signer sees a 📝 icon in their systray            │
│                                                                   │
│ 5. Vendor clicks the email link → portal page opens with the      │
│    PDF preview → vendor reviews + signs + submits                 │
│      (No Odoo login required — portal access is granted by the    │
│       per-request access_token)                                   │
│                                                                   │
│ 6. Hospital signer opens via systray → signs                      │
│      (Order doesn't matter — vendor can sign first or hospital    │
│       first, per OQ2)                                             │
│                                                                   │
│ 7. As the 2nd signer submits, the Q4.5 hook fires:                │
│      - contract.roots_signed_pdf := request.data                  │
│      - contract.roots_signed_pdf_filename := SC-2026-00001-       │
│        signed.pdf                                                 │
│      - contract.message_post(body="✅ Document signed by all      │
│        parties...", attachments=[...])                            │
│      Contract.state UNCHANGED (OQ3 — signing is parallel to       │
│      the date-driven draft/active/expired lifecycle)              │
│                                                                   │
│ 8. The signed-PDF download widget appears on the contract form    │
│    under "ลงนามดิจิทัล (Digital Signature)".                       │
└─────────────────────────────────────────────────────────────────┘