From af043f576f09769e3c6666f4317601a7b4e0479b Mon Sep 17 00:00:00 2001
From: asus <fhanyuh>
Date: Thu, 27 Aug 2026 14:51:58 +0700
Subject: [PATCH] docs: add prominent auto-download buttons for handover docs
 and architecture assets in README

---
 README.md | 34 ++++++++++++++++++++++------------
 1 file changed, 22 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index 14a2d0c..02af6fd 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,16 @@
 <a href="docs/PANDUAN_SISTEM_LENGKAP.pdf"><img alt="Documentation" src="https://img.shields.io/badge/Docs-PDF%20Guide-red?logo=adobe-acrobat-reader&logoColor=white"></a>
 </p>
 
+<p align="center">
+  <a href="docs/PANDUAN_SISTEM_LENGKAP.pdf">
+    <img src="https://img.shields.io/badge/📥_DOWNLOAD_HANDOVER_DOCS-PDF_GUIDE_(41_PAGES)-2563EB?style=for-the-badge&logo=adobe-acrobat-reader&logoColor=white" alt="Download Handover Docs PDF" />
+  </a>
+  &nbsp;&nbsp;
+  <a href="docs/diagram-alur.png">
+    <img src="https://img.shields.io/badge/📊_DOWNLOAD_ARCHITECTURE-4K_UHD_DIAGRAM-0D9488?style=for-the-badge&logo=diagramsdotnet&logoColor=white" alt="Download 4K Diagram" />
+  </a>
+</p>
+
 [⚡ Quickstart](#quickstart) · [🏗️ Architecture](#architecture) · [🖼️ Visual UI Tour](#visual-tour) · [🎥 Counting Engine](#counting-engine) · [⚙️ Configuration](#configuration) · [📚 Documentation](#documentation) · [🔧 Troubleshooting](#troubleshooting)
 
 <br>
@@ -583,18 +593,18 @@ Heavy computational operations run through an asynchronous background worker (`b
 
 Comprehensive technical specifications, operational SOPs, and architecture diagrams are available in the [`docs/`](docs/) directory:
 
-| Document | Format | Description |
-|---|:---:|---|
-| [**Panduan Sistem Lengkap**](docs/PANDUAN_SISTEM_LENGKAP.pdf) | `PDF` (11 MB) | **Publication-Grade Master User Guide & Technical Manual** (Indonesian) with complete operational SOPs and embedded figures. |
-| [**Panduan Sistem Lengkap Source**](docs/PANDUAN_SISTEM_LENGKAP.fodt) | `FODT` (11.8 MB) | Native LibreOffice Writer Flat XML editable source document. |
-| [**Panduan Sistem Lengkap Markdown**](docs/PANDUAN_SISTEM_LENGKAP.md) | `MD` (68 KB) | Full Markdown transcript of the 14-chapter system manual. |
-| [**Architecture Flow Diagram (4K)**](docs/diagram-alur.png) | `PNG` (1.5 MB) | 4K Ultra-HD raster export of the 8-stage end-to-end retraining pipeline. |
-| [**Architecture Flow Diagram (Vector)**](docs/diagram-alur.svg) | `SVG` (34.6 KB) | Scalable vector graphic diagram for high-resolution display. |
-| [**Architecture Flow Diagram (Source)**](docs/diagram-alur.fodg) | `FODG` (24.8 KB) | Native LibreOffice Draw Flat XML editable source file. |
-| [**System Requirements Specification**](docs/requirements.md) | `MD` (23.6 KB) | Numbered technical requirements (`REQ-001` through `REQ-042`). |
-| [**System Design & Architecture**](docs/design.md) | `MD` (22.7 KB) | Database schema, REST API contracts, disk layouts, and backend invariants. |
-| [**UI/UX Design Specification**](docs/ui-spec.md) | `MD` (79.7 KB) | Dark theme design tokens, hotkey maps, and component specifications. |
-| [**Ground Truth Benchmark Dataset**](docs/GT.xlsx) | `XLSX` (586 KB) | Hand-verified physical conveyor bag counts across operational shifts. |
+| Document | Format | Description | Action |
+|---|:---:|---|:---:|
+| **Panduan Sistem Lengkap (Handover)** | `PDF` (11 MB) | **Publication-Grade Master User Guide & Technical Manual** (Indonesian) with complete operational SOPs and embedded figures. | [**⬇️ Download PDF**](docs/PANDUAN_SISTEM_LENGKAP.pdf) |
+| **Panduan Sistem Lengkap Source** | `FODT` (11.8 MB) | Native LibreOffice Writer Flat XML editable source document. | [**⬇️ Download FODT**](docs/PANDUAN_SISTEM_LENGKAP.fodt) |
+| **Panduan Sistem Lengkap Markdown** | `MD` (68 KB) | Full Markdown transcript of the 14-chapter system manual. | [**📖 View MD**](docs/PANDUAN_SISTEM_LENGKAP.md) |
+| **Architecture Flow Diagram (4K)** | `PNG` (1.5 MB) | 4K Ultra-HD raster export of the 8-stage end-to-end retraining pipeline. | [**⬇️ Download 4K**](docs/diagram-alur.png) |
+| **Architecture Flow Diagram (Vector)** | `SVG` (34.6 KB) | Scalable vector graphic diagram for high-resolution display. | [**⬇️ Download SVG**](docs/diagram-alur.svg) |
+| **Architecture Flow Diagram (Source)** | `FODG` (24.8 KB) | Native LibreOffice Draw Flat XML editable source file. | [**⬇️ Download FODG**](docs/diagram-alur.fodg) |
+| **System Requirements Specification** | `MD` (23.6 KB) | Numbered technical requirements (`REQ-001` through `REQ-042`). | [**📖 View Spec**](docs/requirements.md) |
+| **System Design & Architecture** | `MD` (22.7 KB) | Database schema, REST API contracts, disk layouts, and backend invariants. | [**📖 View Design**](docs/design.md) |
+| **UI/UX Design Specification** | `MD` (79.7 KB) | Dark theme design tokens, hotkey maps, and component specifications. | [**📖 View UI Spec**](docs/ui-spec.md) |
+| **Ground Truth Benchmark Dataset** | `XLSX` (586 KB) | Hand-verified physical conveyor bag counts across operational shifts. | [**⬇️ Download XLSX**](docs/GT.xlsx) |
 
 ---