import os import sys from reportlab.lib.pagesizes import letter from reportlab.lib import colors from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle from reportlab.platypus import ( SimpleDocTemplate, Paragraph, Spacer, Table, TableStyle, PageBreak ) def create_cpanel_guide_pdf(output_path): os.makedirs(os.path.dirname(output_path), exist_ok=True) doc = SimpleDocTemplate( output_path, pagesize=letter, rightMargin=36, leftMargin=36, topMargin=32, bottomMargin=32 ) styles = getSampleStyleSheet() primary_color = colors.HexColor("#1e429f") # MAP Blue secondary_color = colors.HexColor("#0f172a") # Dark Slate border_color = colors.HexColor("#cbd5e1") title_style = ParagraphStyle( 'DocTitle', parent=styles['Normal'], fontName='Helvetica-Bold', fontSize=18, leading=22, textColor=primary_color, spaceAfter=2 ) subtitle_style = ParagraphStyle( 'DocSubtitle', parent=styles['Normal'], fontName='Helvetica-Bold', fontSize=10, leading=13, textColor=colors.HexColor("#475569"), spaceAfter=8 ) h1_style = ParagraphStyle( 'Heading1_Custom', parent=styles['Normal'], fontName='Helvetica-Bold', fontSize=11.5, leading=14.5, textColor=primary_color, spaceBefore=8, spaceAfter=4 ) h2_style = ParagraphStyle( 'Heading2_Custom', parent=styles['Normal'], fontName='Helvetica-Bold', fontSize=9.5, leading=12.5, textColor=secondary_color, spaceBefore=5, spaceAfter=2 ) body_style = ParagraphStyle( 'Body_Custom', parent=styles['Normal'], fontName='Helvetica', fontSize=8.5, leading=11.5, textColor=colors.HexColor("#1e293b"), spaceAfter=4 ) bold_body_style = ParagraphStyle( 'BoldBody_Custom', parent=body_style, fontName='Helvetica-Bold' ) terminal_code_style = ParagraphStyle( 'Terminal_Code', parent=styles['Normal'], fontName='Courier-Bold', fontSize=8.5, leading=12, textColor=colors.HexColor("#ffffff") # High contrast crisp pure white ) struct_code_style = ParagraphStyle( 'Struct_Code', parent=styles['Normal'], fontName='Courier', fontSize=8, leading=11, textColor=colors.HexColor("#f8fafc") ) callout_style = ParagraphStyle( 'Callout_Text', parent=styles['Normal'], fontName='Helvetica', fontSize=8, leading=11, textColor=colors.HexColor("#065f46") ) elements = [] # Title & Header elements.append(Paragraph("MAP LiveMirror VTON — Panduan Deployment", title_style)) elements.append(Paragraph("Step-by-Step Cara Install & Deploy Python Backend (FastAPI) di cPanel Rumahweb", subtitle_style)) # Reference Box ref_table = Table( [[ Paragraph("Referensi Resmi: https://www.rumahweb.com/journal/cara-install-python-di-cpanel/
" "Target Platform: cPanel CloudLinux (Setup Python App / Passenger WSGI) • Python 3.11 / 3.12
" "Timezone Backend: Asia/Jakarta (WIB, UTC+7)", callout_style) ]], colWidths=[540] ) ref_table.setStyle(TableStyle([ ('BACKGROUND', (0,0), (-1,-1), colors.HexColor("#ecfdf5")), ('BORDER', (0,0), (-1,-1), 1, colors.HexColor("#6ee7b7")), ('TOPPADDING', (0,0), (-1,-1), 5), ('BOTTOMPADDING', (0,0), (-1,-1), 5), ('LEFTPADDING', (0,0), (-1,-1), 8), ('RIGHTPADDING', (0,0), (-1,-1), 8), ])) elements.append(ref_table) elements.append(Spacer(1, 6)) # SECTION 1: Struktur File Proyek elements.append(Paragraph("1. Persiapan File & Struktur Proyek (Pre-Deployment)", h1_style)) elements.append(Paragraph( "Di cPanel CloudLinux Passenger, aplikasi FastAPI (ASGI) dihubungkan menggunakan adapter a2wsgi di dalam file passenger_wsgi.py. " "Pastikan struktur folder backend Anda tersusun rapi sebagai berikut:", body_style )) struct_text = ( "mapvton-backend/
" " |-- app/
" " | |-- api/ (Endpoints v1: clothes, fleet telemetry, api keys, rembg)
" " | |-- models/ (Database SQLAlchemy models dengan timezone Asia/Jakarta)
" " | |-- services/ (Rembg ONNX service, Fleet WebSocket telemetry)
" " | |-- static/ (uploads/clothes, uploads/cutouts, images/map_logo.png)
" " | |-- templates/ (Web Dashboard Fleet Management HTML/Tailwind)
" " | |-- database.py & main.py
" " |-- passenger_wsgi.py (Jembatan cPanel CloudLinux Passenger -> FastAPI)
" " \\-- requirements.txt (fastapi, a2wsgi, uvicorn, sqlalchemy, rembg, pillow, dll.)" ) struct_table = Table([[Paragraph(struct_text, struct_code_style)]], colWidths=[540]) struct_table.setStyle(TableStyle([ ('BACKGROUND', (0,0), (-1,-1), colors.HexColor("#0f172a")), ('BORDER', (0,0), (-1,-1), 1, colors.HexColor("#334155")), ('PADDING', (0,0), (-1,-1), 6), ])) elements.append(struct_table) elements.append(Spacer(1, 6)) # SECTION 2: Setup Python App di cPanel elements.append(Paragraph("2. Membuat Aplikasi di Setup Python App cPanel", h1_style)) elements.append(Paragraph("1. Login ke cPanel Rumahweb (melalui ClientZone atau https://domainanda.com:2083).", body_style)) elements.append(Paragraph("2. Scroll ke bagian SOFTWARE dan klik menu Setup Python App.", body_style)) elements.append(Paragraph("3. Klik tombol biru Create Application di pojok kanan atas.", body_style)) elements.append(Paragraph("4. Isi formulir konfigurasi persis seperti tabel di bawah:", body_style)) cpanel_config_data = [ [Paragraph("Field Pengaturan", bold_body_style), Paragraph("Nilai Rekomendasi", bold_body_style), Paragraph("Keterangan", bold_body_style)], [Paragraph("Python version", body_style), Paragraph("3.11 atau 3.12", bold_body_style), Paragraph("Gunakan Python modern yang mendukung ZoneInfo", body_style)], [Paragraph("Application root", body_style), Paragraph("mapvton-backend", bold_body_style), Paragraph("Nama folder di /home/username/mapvton-backend", body_style)], [Paragraph("Application URL", body_style), Paragraph("vton.domainanda.com", bold_body_style), Paragraph("Domain atau Subdomain tujuan aplikasi", body_style)], [Paragraph("Application startup file", body_style), Paragraph("passenger_wsgi.py", bold_body_style), Paragraph("File entry script yang mengeksekusi aplikasi", body_style)], [Paragraph("Application Entry point", body_style), Paragraph("application", bold_body_style), Paragraph("Variabel WSGI callable di dalam passenger_wsgi.py", body_style)], [Paragraph("Passenger log file", body_style), Paragraph("passenger.log (opsional)", bold_body_style), Paragraph("Log aktivitas & error dari Passenger WSGI", body_style)], ] t_config = Table(cpanel_config_data, colWidths=[130, 150, 260]) t_config.setStyle(TableStyle([ ('BACKGROUND', (0,0), (-1,0), colors.HexColor("#f1f5f9")), ('GRID', (0,0), (-1,-1), 0.5, border_color), ('VALIGN', (0,0), (-1,-1), 'MIDDLE'), ('PADDING', (0,0), (-1,-1), 3.5), ])) elements.append(t_config) elements.append(Paragraph("5. Klik tombol CREATE di pojok kanan atas.", body_style)) elements.append(Spacer(1, 6)) # SECTION 3: Upload File ke cPanel File Manager elements.append(Paragraph("3. Mengunggah File Proyek ke File Manager", h1_style)) elements.append(Paragraph( "1. Di cPanel, buka File Manager (di kategori Files).
" "2. Masuk ke folder aplikasi yang baru dibuat: /home/username/mapvton-backend/.
" "3. Klik tombol Upload, pilih file zip proyek (misal: backend.zip).
" "4. Setelah upload 100% selesai, klik kanan file zip tersebut lalu pilih Extract.
" "5. Atur Permissions: Pastikan folder app/static/uploads memiliki permission 755 atau 775 agar upload foto baju dari web dashboard berjalan lancar.", body_style )) elements.append(Spacer(1, 6)) # Page break to keep Section 4, 5, 6 together on Page 2 cleanly elements.append(PageBreak()) # SECTION 4: Install Dependencies elements.append(Paragraph("4. Instalasi Dependency / Library Python", h1_style)) elements.append(Paragraph("Opsi A: Menggunakan cPanel Terminal (Paling Direkomendasikan & Cepat)", h2_style)) elements.append(Paragraph( "1. Di halaman Setup Python App, salin perintah aktivasi virtualenv yang berada di kotak kuning paling atas, contoh:", body_style )) # Command 1 Box - High Contrast Pure White Text on Dark Navy Background cmd1_text = "source /home/username/virtualenv/mapvton-backend/3.11/bin/activate && cd /home/username/mapvton-backend" cmd_box = Table( [[Paragraph(cmd1_text, terminal_code_style)]], colWidths=[540] ) cmd_box.setStyle(TableStyle([ ('BACKGROUND', (0,0), (-1,-1), colors.HexColor("#0f172a")), ('BORDER', (0,0), (-1,-1), 1, colors.HexColor("#38bdf8")), ('TOPPADDING', (0,0), (-1,-1), 7), ('BOTTOMPADDING', (0,0), (-1,-1), 7), ('LEFTPADDING', (0,0), (-1,-1), 10), ('RIGHTPADDING', (0,0), (-1,-1), 10), ])) elements.append(cmd_box) elements.append(Spacer(1, 4)) elements.append(Paragraph( "2. Buka menu Terminal di cPanel, paste perintah di atas lalu tekan Enter.
" "3. Jalankan perintah instalasi dependency berikut:", body_style )) # Command 2 Box - High Contrast Pure White Text on Dark Navy Background cmd2_text = "pip install --upgrade pip
pip install -r requirements.txt" pip_box = Table( [[Paragraph(cmd2_text, terminal_code_style)]], colWidths=[540] ) pip_box.setStyle(TableStyle([ ('BACKGROUND', (0,0), (-1,-1), colors.HexColor("#0f172a")), ('BORDER', (0,0), (-1,-1), 1, colors.HexColor("#38bdf8")), ('TOPPADDING', (0,0), (-1,-1), 7), ('BOTTOMPADDING', (0,0), (-1,-1), 7), ('LEFTPADDING', (0,0), (-1,-1), 10), ('RIGHTPADDING', (0,0), (-1,-1), 10), ])) elements.append(pip_box) elements.append(Spacer(1, 6)) elements.append(Paragraph("Opsi B: Menggunakan Tombol Pip di cPanel UI", h2_style)) elements.append(Paragraph( "1. Di halaman Setup Python App, scroll ke bagian Configuration files.
" "2. Ketik requirements.txt lalu klik Add.
" "3. Klik tombol Run Pip Install di samping file requirements.txt.", body_style )) elements.append(Spacer(1, 8)) # SECTION 5: Environment Variables & Restart elements.append(Paragraph("5. Konfigurasi Environment & Restart Aplikasi", h1_style)) elements.append(Paragraph( "1. Di halaman Setup Python App, scroll ke bagian Environment variables:
" " • TIMEZONE = Asia/Jakarta
" " • DEFAULT_DECART_API_KEY = dct_mapmirrovton1_pDDIZqPuydEshqGXLumKLVjJQIYQZTagJYIMRuGWhmVHNHRlLQkKBPpegiQmfjRW
" "2. Klik tombol Done lalu klik Save di pojok kanan atas.
" "3. Klik tombol Restart untuk menerapkan seluruh perubahan.", body_style )) elements.append(Spacer(1, 8)) # SECTION 6: Pengujian & Integrasi Kiosk elements.append(Paragraph("6. Pengujian & Menghubungkan Android Kiosk", h1_style)) elements.append(Paragraph( "A. Uji Coba Web & API di Browser:
" "• Akses Web Dashboard Fleet: https://vton.domainanda.com/
" "• Akses Swagger API Docs: https://vton.domainanda.com/docs
" "• Verifikasi Jam WIB: https://vton.domainanda.com/api/v1/fleet/devices

" "B. Menghubungkan Aplikasi Android Kiosk:
" "1. Buka aplikasi MAP LiveMirror di Android Kiosk / Smart Mirror 32\".
" "2. Tap 5 kali pada Logo MAP untuk membuka dialog Admin Settings.
" "3. Masukkan PIN Admin: 1234.
" "4. Ubah Server URL menjadi URL domain Rumahweb: https://vton.domainanda.com.
" "5. Klik Save Settings. Kiosk akan otomatis terhubung (• Fleet Synced) dan katalog busana langsung sinkron!", body_style )) # Build PDF Document doc.build(elements) print(f"✓ PDF Re-Generated Successfully with High Contrast Text at: {output_path}") if __name__ == "__main__": out = "/Users/prahata/Documents/3.Tutorial/image_processing_clothesmatching_rev_decart/Panduan_Deploy_Python_Backend_cPanel_Rumahweb.pdf" create_cpanel_guide_pdf(out)