Invitation Maker

---
description: Tạo thiệp mời cá nhân hóa từ danh sách khách và ảnh mẫu
---

# Invitation Maker

Tạo hàng loạt thiệp mời cá nhân hóa với tên khách mời từ file Excel, đặt lên ảnh template.

## Mục tiêu
- Tạo N file ảnh thiệp mời (1 file/khách)
- Tên khách được đặt đúng vị trí và font theo config

## Input bắt buộc ⚠️

> **DỪNG LẠI VÀ KIỂM TRA** trước khi thực hiện bất kỳ bước nào!
> Nếu thiếu input → HỎI LẠI user ngay. KHÔNG tự suy đoán.

| #   | Input           | Mô tả                                     | Ví dụ                                  |
| --- | --------------- | ----------------------------------------- | -------------------------------------- |
| 1   | Ảnh mẫu thiệp   | File PNG/JPG làm nền                      | `template.png`                         |
| 2   | Danh sách khách | File Excel (.xlsx), cột đầu tiên chứa tên | `guests.xlsx`                          |
| 3   | Font chữ        | Tên font hoặc đường dẫn .ttf              | `Roboto`, `C:/Windows/Fonts/arial.ttf` |

**Câu hỏi mẫu:**
```
Để tạo thiệp mời, tôi cần các thông tin sau:
1. Đường dẫn đến ảnh mẫu thiệp (PNG/JPG)?
2. Đường dẫn đến file Excel danh sách khách mời?
3. Font chữ muốn sử dụng (tên font hoặc file .ttf)?
```

---

## Các bước thực hiện

### Bước 1: Kiểm tra thư mục làm việc
// turbo
```bash
ls -la
```

### Bước 2: Tìm và xác nhận Font

**Ưu tiên 1 - Font hệ thống (Windows):**
// turbo
```powershell
Get-ChildItem "C:\Windows\Fonts" -Filter "*[TÊN_FONT]*" -ErrorAction SilentlyContinue
```

**Ưu tiên 2 - Font trong project:**
```bash
ls fonts/
```

**Ưu tiên 3 - Tải từ Google Fonts:**
```powershell
# Roboto
Invoke-WebRequest -Uri "https://github.com/googlefonts/roboto/releases/download/v2.138/roboto-unhinted.zip" -OutFile roboto.zip
Expand-Archive -Path roboto.zip -DestinationPath fonts -Force

# Be Vietnam Pro
Invoke-WebRequest -Uri "https://fonts.google.com/download?family=Be%20Vietnam%20Pro" -OutFile bevietnam.zip
Expand-Archive -Path bevietnam.zip -DestinationPath fonts -Force
```

### Bước 3: Tạo/Cập nhật config.json

```json
{
    "input_excel": "danh-sach.xlsx",
    "template_image": "template.png",
    "output_dir": "invitations",
    "font_settings": {
        "path": "C:/Windows/Fonts/arial.ttf",
        "size": 60,
        "color": [255, 165, 0]
    },
    "text_position": {
        "y": 330,
        "center_x": 600
    }
}
```

### Bước 4: Cấu hình vị trí text (Tùy chọn)

```bash
python web_server.py
```
Mở `http://localhost:8000`, kéo thả text, nhấn Save.

### Bước 5: Tạo thiệp mời
// turbo
```bash
python generate_invitations.py
```

### Bước 6: Kiểm tra kết quả
// turbo
```bash
ls invitations/
```

---

## Output mong đợi
- Thư mục `invitations/` chứa N file PNG
- Mỗi file có định dạng: `invitation-[Tên khách].png`

## Tham khảo nhanh

### Font Windows có sẵn
| Font            | Đường dẫn                      |
| --------------- | ------------------------------ |
| Arial           | `C:/Windows/Fonts/arial.ttf`   |
| Arial Bold      | `C:/Windows/Fonts/arialbd.ttf` |
| Times New Roman | `C:/Windows/Fonts/times.ttf`   |
| Segoe UI        | `C:/Windows/Fonts/segoeui.ttf` |
| Tahoma          | `C:/Windows/Fonts/tahoma.ttf`  |

### Màu phổ biến (RGB)
| Màu       | RGB               |
| --------- | ----------------- |
| Trắng     | `[255, 255, 255]` |
| Vàng Gold | `[255, 215, 0]`   |
| Cam       | `[255, 165, 0]`   |
| Đỏ        | `[255, 0, 0]`     |

## Xử lý lỗi / Edge cases

| Tình huống                   | Cách xử lý                                  |
| ---------------------------- | ------------------------------------------- |
| Font không hỗ trợ tiếng Việt | Đổi sang Arial hoặc Roboto                  |
| Excel không có cột "Name"    | Dùng cột đầu tiên                           |
| Font không tìm thấy          | Tải từ Google Fonts hoặc dùng font hệ thống |
| Tên khách quá dài            | Giảm `font_size` trong config               |