Tổng quan Doc Engine v2

Tổng quan Doc Engine v2

Doc Engine là hệ thống render tài liệu của Parkone — biến 1 template Word .docx thành hàng trăm HĐ / báo giá / thư từ với data thực tự động.

Vấn đề Doc Engine giải quyết

Trước Doc Engine:

• FC / Pháp chế mở Word → copy template → thay tên KH / số HĐ / ngày / MST bằng tay → save mới
• 30 HĐ/tháng × 15 phút/HĐ = 7.5 giờ
• Sai chính tả, quên field, format lệch

Sau Doc Engine:

• 1 template .docx với placeholders {{ record.customer_id.name }}
• Click “Render” trên HĐ → tự tạo Word có data thực trong 3 giây
• Format perfect, không nhầm field

2 phiên bản

	v1 (basic)	v2 (2026)
Render engine	docxtpl (Jinja)	docxtpl + OnlyOffice inline editor
Sửa nội dung	Download → mở Word → sửa → upload lại	Sửa inline browser với OnlyOffice
Field picker	Không có	Sidebar 5 groups curated fields
Insert placeholder	Gõ tay {{ ... }}	Click 1 lần từ sidebar
PDF convert	LibreOffice CLI (optional)	LibreOffice CLI (built-in)

Trang này focus v2.

Các chức năng trong phần này

📄 Mẫu tài liệu (Templates)

Upload .docx với Jinja placeholders

Đọc →

🔤 Jinja placeholders cheatsheet

Syntax + fields hay dùng

Đọc →

🖊️ OnlyOffice editor inline

Sửa Word trực tiếp trong browser

Đọc →

🎯 Field picker sidebar

5 groups curated — Chủ đầu tư / KH / HĐ / Lô / Thời gian

Đọc →

⚡ Single-click insert snippet

Chèn Jinja code vào editor bằng click

Đọc →

🧙 Wizard Render Doc

Chọn template + record → tạo Word output

Đọc →

📑 Auto-convert PDF

LibreOffice CLI convert .docx → .pdf

Đọc →

🐛 Troubleshoot

Common errors + fixes

Đọc →

Kiến trúc high-level

┌────────────────────────────────────────────────────────────┐
│  Browser (KH / FC / Pháp chế)                              │
│  ├─ Odoo Backend Form (HĐ / Báo giá / Đặt cọc)             │
│  ├─ Nút "📝 Render từ template"                            │
│  └─ OnlyOffice iframe (edit inline)                        │
└────────────────────────────────────────────────────────────┘
                            ↓ HTTPS
┌────────────────────────────────────────────────────────────┐
│  Odoo Backend                                               │
│  ├─ parkone.doc.template (model)                            │
│  ├─ docxtpl render service                                  │
│  ├─ JWT HS256 signer                                        │
│  └─ WOPI-style endpoints (download/save/callback)           │
└────────────────────────────────────────────────────────────┘
                            ↓
┌────────────────────────────────────────────────────────────┐
│  OnlyOffice Document Server (Docker container)              │
│  ├─ Read .docx via WOPI                                     │
│  ├─ Render UI trong iframe                                  │
│  ├─ User edit → save → callback Odoo                        │
│  └─ Plugin sidecar cho field picker IPC                     │
└────────────────────────────────────────────────────────────┘
                            ↓ (optional)
┌────────────────────────────────────────────────────────────┐
│  LibreOffice CLI (in Odoo container)                        │
│  └─ Convert .docx → .pdf on demand                          │
└────────────────────────────────────────────────────────────┘

User personas

👨‍💼 Admin / Pháp chế

Tạo + maintain templates. Setup 1 lần khi mở KCN mới hoặc thay đổi format HĐ.

👩‍💻 Sales rep

Render HĐ / Báo giá từ template có sẵn. Edit content specific per-deal.

💰 FC

Render báo cáo, thư nhắc nợ từ template. Không sửa template.

Templates default có sẵn

Parkone install kèm 4 templates:

Template	Model apply	Dùng khi
HĐ thuê đất chuẩn	zone.contract	Ký HĐ mới
HĐ Đặt cọc chuẩn	zone.deposit.agreement	Ký đặt cọc
Báo giá CPQ chuẩn	sale.order	Gửi báo giá cho KH
Phụ lục HĐ chuẩn	zone.contract.amendment	Ký phụ lục

Đại có thể clone + customize cho brand/style riêng.

Workflow render — bird’s eye

1. Sales rep mở HĐ ZC-2026-042
2. Click nút ”📝 Render từ template” → wizard mở
3. Chọn template “HĐ thuê đất chuẩn”
4. Click “Render” → OnlyOffice iframe load .docx với data đã fill
5. Sales rep review + sửa nội dung inline nếu cần
6. Click “Save” trong OnlyOffice → callback Odoo save file
7. Click “Convert PDF” (optional) → .pdf attached vào HĐ
8. Click “Send by Email” → PDF gửi KH ký

Setup yêu cầu (Admin)

• Docker container onlyoffice/documentserver:latest running
• JWT secret shared giữa Odoo + OnlyOffice (env OO_JWT_SECRET)
• CF Tunnel route oo.parkone.vn → OnlyOffice container
• Python dependency docxtpl trong Odoo container (đã đóng gói sẵn trong bundle triển khai Parkone)
• LibreOffice CLI install trong Odoo container (optional for PDF)

Chi tiết setup ở Cấu hình OnlyOffice hoặc liên hệ Admin.

FAQ nhanh

KH không cần cài OnlyOffice — chỉ Sales rep?

Đúng. OnlyOffice chạy server-side, KH chỉ nhận PDF cuối.

Template không limit Word features — chèn ảnh / bảng / header footer?

Đúng. docxtpl preserve toàn bộ formatting của Word. Chỉ replace placeholders {{ ... }} với data.

Có thể render Excel / PowerPoint không?

Hiện chỉ Word. Excel roadmap Q4 2026 (dùng openpyxl template).

Liên kết liên quan

• Mẫu tài liệu — Tạo template
• Wizard render
• Doc Engine v1 legacy notes