# Excel Quote Export Layout Update - Cập nhật layout xuất Excel khai báo

## Tổng quan
Cập nhật layout file Excel xuất chi tiết khai báo để có giao diện chuyên nghiệp và nhất quán với template in khai báo đã thiết kế trước đó.

## Thay đổi chính

### 1. Header công ty chuyên nghiệp
```python
# Company Header với thông tin đầy đủ
company_header = workbook.add_format({
    'bold': True, 
    'font_size': 18,
    'font_color': '#2196F3'  # Màu xanh thương hiệu
})

# Thông tin công ty
- THP GLOBAL (tên công ty)
- Dịch vụ vận chuyển hàng hóa Trung Quốc - Việt Nam
- Thông tin liên hệ: điện thoại, email, website
```

### 2. Cấu trúc theo sections
#### Section 1: Thông tin khách hàng
- Mã khách hàng và tên khách hàng
- Tên đơn hàng và trạng thái khai báo
- Background màu nhẹ để phân biệt

#### Section 2: Thông tin hàng hóa
- Bảng thông tin sản phẩm với headers rõ ràng
- Tên loại hàng, mã HS, số lượng, cân nặng, thể tích
- Trạng thái hình ảnh

#### Section 3: Chi tiết giá dịch vụ
- Bảng chi tiết từng khoản phí
- Định dạng tiền tệ và phần trăm rõ ràng
- Tính toán từng dòng item

#### Section 4: Tổng kết chi phí
- Summary box với background màu xanh
- Highlight TỔNG CỘNG bằng format đặc biệt
- Thông tin thanh toán và còn lại

#### Section 5: Ghi chú quan trọng
- Các điều khoản và lưu ý quan trọng
- Format dạng bullet points

### 3. Cải tiến format và styling

#### Color scheme thống nhất
```python
# Màu chủ đạo
PRIMARY_COLOR = '#2196F3'  # Xanh chủ đạo
GRAY_COLOR = '#666666'     # Xám cho thông tin phụ
BACKGROUND_COLOR = '#f8f9fa'  # Nền nhẹ cho sections
```

#### Typography cải tiến
- **Company name**: Font size 18, bold, màu xanh
- **Section headers**: Font size 14, bold, background xanh nhẹ
- **Data cells**: Font size 12, border đều
- **Summary**: Background xanh, text trắng

#### Column widths tối ưu
```python
worksheet.set_column('A:A', 20)  # Nội dung chính
worksheet.set_column('B:B', 15)  # Đơn giá
worksheet.set_column('C:C', 20)  # Tỷ lệ
worksheet.set_column('D:D', 15)  # Thành tiền
```

### 4. Chi tiết pricing section

#### Pricing table structure
| Nội dung | Đơn giá | Tỷ lệ (%) | Thành tiền |
|----------|---------|-----------|------------|
| Giá khai báo hải quan (CNY) | 1,200 CNY | - | 2,400 CNY |
| Tỷ giá quy đổi | 3,500 VND | - | 8,400,000 VND |
| Thuế nhập khẩu | - | 10.5% | 882,000 VND |
| Thuế VAT | - | 10% | 840,000 VND |
| Phí dịch vụ | - | 3.5% | 294,000 VND |
| Giá vận chuyển theo cân | 25,000 VND | - | 45,000 VND |
| Giá vận chuyển theo thể tích | 1,500,000 VND | - | 22,500 VND |
| Phí vận chuyển dự kiến TQ-VN | 30,000 VND | - | 54,000 VND |

#### Summary section format
```python
summary_header = workbook.add_format({
    'bold': True,
    'font_color': 'white',
    'bg_color': '#2196F3',
    'border': 1
})

total_format = workbook.add_format({
    'bold': True,
    'font_color': '#2196F3',
    'font_size': 12
})
```

### 5. Professional footer
- Lời cảm ơn khách hàng
- Timestamp tự động với format Việt Nam
- Font và màu sắc nhẹ nhàng

## So sánh trước và sau

### Trước (Layout cũ)
- Bảng dữ liệu đơn giản dạng spreadsheet
- Không có branding công ty
- Thiếu thông tin liên hệ
- Format đơn điệu, khó đọc
- Không có phân chia sections rõ ràng

### Sau (Layout mới)
- ✅ Header công ty chuyên nghiệp với logo text
- ✅ Thông tin liên hệ đầy đủ
- ✅ Phân chia sections rõ ràng
- ✅ Color scheme thống nhất
- ✅ Pricing table chi tiết và dễ hiểu
- ✅ Summary section nổi bật
- ✅ Ghi chú và điều khoản đầy đủ
- ✅ Footer thân thiện

## Tương thích với template in

### Consistency points
1. **Cùng company branding**: THP GLOBAL
2. **Cùng color scheme**: #2196F3 primary color
3. **Cùng cấu trúc sections**: Customer info → Product info → Pricing → Summary → Notes
4. **Cùng terminology**: Thuật ngữ và tên field giống nhau
5. **Cùng format số**: Currency và percentage format

### Khác biệt hợp lý
- **Excel**: Có thể click, edit, sort dữ liệu
- **Print**: Optimized cho in ấn A4
- **Excel**: Có thể chứa nhiều thông tin chi tiết hơn
- **Print**: Focus vào visual presentation

## Implementation details

### New format definitions
```python
company_header = workbook.add_format({...})  # Company name
company_info = workbook.add_format({...})    # Contact info
section_header = workbook.add_format({...})  # Section titles
summary_header = workbook.add_format({...})  # Summary box header
total_format = workbook.add_format({...})    # Total amount
```

### Dynamic content generation
```python
# Pricing details calculation
pricing_details = [
    ['Giá khai báo hải quan (CNY)', f"{quote_data.get('CustomsPriceCNY', 0):.2f} CNY", ...],
    ['Tỷ giá quy đổi', f"{quote_data.get('ExchangeRate', 0):,.0f} VND", ...],
    # ... more items
]

# Summary calculations
summary_items = [
    ['Tổng tiền khai báo hải quan:', f"{quote_data.get('CustomsAmountVND', 0):,.0f} VND"],
    # ... more items
]
```

## Benefits

### For Business
1. **Professional image**: Tăng tính chuyên nghiệp
2. **Brand consistency**: Nhất quán thương hiệu
3. **Customer confidence**: Tăng lòng tin khách hàng
4. **Easy reading**: Dễ đọc và hiểu

### For Users
1. **Better UX**: Giao diện đẹp và dễ sử dụng
2. **Complete information**: Thông tin đầy đủ
3. **Print ready**: Có thể in trực tiếp từ Excel
4. **Editable**: Có thể chỉnh sửa nếu cần

### For Development
1. **Maintainable**: Code được tổ chức tốt
2. **Reusable**: Có thể tái sử dụng cho reports khác
3. **Scalable**: Dễ mở rộng thêm sections

## Testing checklist

### Data validation
- [ ] Test với khai báo có đầy đủ dữ liệu
- [ ] Test với khai báo thiếu một số fields
- [ ] Test với giá trị 0 và null
- [ ] Test với tên khách hàng dài
- [ ] Test với tên sản phẩm có ký tự đặc biệt

### Format validation
- [ ] Check màu sắc hiển thị đúng
- [ ] Check font và size text
- [ ] Check alignment của các columns
- [ ] Check border và spacing
- [ ] Check number format (currency, percentage)

### Layout validation
- [ ] Check responsive trên các kích thước màn hình
- [ ] Check khi in ra giấy A4
- [ ] Check column widths phù hợp
- [ ] Check page breaks hợp lý

## File updated
- `/DepositAPI/api/Quote.py` - Method `export_excel_detail()`

## Future enhancements

### Phase 2 features
1. **Charts integration**: Thêm biểu đồ chi phí
2. **Multiple templates**: Template theo ngành hàng
3. **Custom branding**: Logo upload cho từng công ty
4. **Multi-language**: Hỗ trợ tiếng Anh
5. **Digital signature**: Chữ ký số tích hợp

### Technical improvements
1. **Performance optimization**: Cache format objects
2. **Memory management**: Optimize cho file lớn
3. **Error handling**: Better error messages
4. **Logging**: Track export usage

## Summary
Cập nhật này đưa file Excel xuất khai báo lên một tầm cao mới về mặt chuyên nghiệp và tính nhất quán với hệ thống. Layout mới không chỉ đẹp mắt mà còn cung cấp thông tin đầy đủ và dễ hiểu cho khách hàng, góp phần nâng cao hình ảnh thương hiệu THP GLOBAL.