Minh Đỗ
Minh Đỗ
Workflow Documentation

PDF-to-Web Pipeline

Flowchart chi tiết quy trình tự động chuyển file PDF (tiếng Anh hoặc tiếng Việt) thành trang web premium tiếng Việt - từ Extract đến Deploy.

Trigger (Kích Hoạt)

Input

Bạn nói: "Chuyển file PDF này thành trang web giúp tôi"

Agent tự động nhận diện và match với workflow /pdf-to-web. Bắt đầu thực thi pipeline từ Step 0 đến Step 5.

Step 0: Validate Input

Validate

Kiểm Tra Đầu Vào

  • Kiểm tra file PDF có tồn tại hay không
  • Cài đặt dependencies: pip install PyPDF2 markdown

Step 1: Extract PDF

Extract

extract_pdf.py → pdf_extracted.txt

  • Chạy script trích xuất nội dung PDF sang text thô
  • Đọc 200 dòng đầu kiểm tra chất lượng encoding

Step 2: Detect Ngôn Ngữ

Detect

Tự động nhận diện ngôn ngữ PDF

Tiếng Anh

Dịch EN → VI → Markdown tiếng Việt. Giữ thuật ngữ song ngữ, anti-AI, giữ nguyên code.

Tiếng Việt

Chuyển thẳng → Markdown. Chỉ format lại heading, không cần dịch.

Step 3: Web Build Pipeline Global Rules

Phase 1

Pre-build: Generate Design System

  • Đọc ui-ux-pro-max → chạy search.py --design-system
  • Đọc engineering skill → xác định complexity
  • Áp dụng Web Design Standards (navigation, author branding, responsive)
Build

Code index.html

  • Design system (từ Phase 1) + Markdown content
  • Sidebar TOC tự generate từ H2 headings
  • Author branding: "Minh Đỗ" + Zalo link
  • Responsive layout cho mobile

Step 4: Auto Audit Tự Động

Audit

Kiểm Tra Tự Động (Không Cần User Yêu Cầu)

  • Responsive: 375px, 390px, 768px
  • Accessibility: contrast, alt text, focus states
  • UX: hover states, transitions, cursor-pointer
  • Layout: no horizontal scroll, TOC works
  • Nếu có issue → fix → audit lại

Step 5: Deploy Prompt Tự Động

Deploy

"Bạn có muốn deploy lên Vercel luôn không?"

OK

/deploy-to-vercel (git → GitHub → Vercel) → Live!

Không

Kết thúc quy trình. File index.html sẵn sàng.

Tóm Tắt

Câu Hỏi Trả Lời
Có auto audit không? Có - Phase 2, tự chạy
Có hỏi deploy không? Có - Phase 3, hỏi cuối
Có hỏi gì giữa chừng không? Không - chạy liền từ đầu đến audit
Hoạt động ở mọi workspace? Có - workflow + rules đều global
Hỗ trợ PDF Anh lẫn Việt? Có - tự detect