# PG Next Brand Kit

**1.1.0 · 22/10/2026 · Digital sRGB**

Bộ nhận diện mở rộng từ biểu tượng voi/NV, emerald, Inter và JetBrains Mono hiện có. Phiên bản này nâng cấp bố cục truyền thông, tài liệu và portal; không đổi hình học biểu tượng hoặc tích hợp frontend sản phẩm.

## Bắt đầu

```sh
python3 tools/serve.py
```

Mở [Brand Library](http://127.0.0.1:5279/portal/). Server chỉ bind localhost, phục vụ bộ này và đúng ZIP release ở thư mục cha. Nút **Tải bộ nhận diện** tải `PG-Next-Brand-Kit-1.1.0.zip`, được sinh từ cùng manifest. Dừng server bằng Ctrl+C khi không dùng.

Có thể mở trực tiếp `portal/index.html` để lấy file riêng khi offline: nội dung và catalogue được dựng sẵn, không dùng fetch/CDN. Khi mở bằng file://, nút ZIP ẩn vì người nhận đã giải nén gói; các đường dẫn source/export vẫn tương đối trong bộ. Khi tắt JavaScript, bản mặc định của mỗi nhóm vẫn có link tải trực tiếp; chọn variant trong ZIP/manifest.

## Chọn và sử dụng tài sản

- **Logo:** ba bố cục (ngang, dọc, biểu tượng), mỗi bố cục có bốn bản: màu trên nền tối, màu trên nền sáng, đơn sắc tối và đơn sắc sáng. Bản SVG trong exports có chữ outline; SVG trong source/logo giữ chữ để chỉnh với Inter.
- **Màu:** các ô màu trên portal sao chép HEX. Dùng `source/tokens.json` làm nguồn palette. Light accent không dùng cho chữ nhỏ trên nền sáng.
- **Chữ:** Inter cho nội dung; JetBrains Mono cho mã. Font và giấy phép nằm trong source/fonts. Office template dùng Arial fallback để mở được khi chưa cài Inter.
- **Social:** square và wide có VI/EN; carousel ba trang có nhịp nền tối/sáng/emerald. Avatar và cover có bố cục riêng. Các kích thước là canvas chung, kiểm crop trên kênh tại lúc đăng.
- **PPTX/DOCX:** text, hình khối và bảng giữ editable. Thay nội dung trong ngoặc trước khi chia sẻ. PDF đi kèm để xem trước.
- **Email, motion, website:** HTML/text có thể chỉnh; website là prototype tĩnh không nối tài khoản/API thật. Logo luôn tĩnh, motion chỉ áp dụng cho motif.

Trong portal: **Thư viện tài sản → Tìm hoặc lọc → Xem chi tiết → Chọn phiên bản → Tải định dạng**. Hộp chi tiết ghi mục đích, quy cách và tên file thật; Escape hoặc nút đóng đưa focus về nơi mở. Các variant cùng họ được gom lại để tránh card trùng.

## Cấu trúc

| Thư mục/file | Nội dung |
| --- | --- |
| `source/logo/` | Mark kế thừa, bản đảo màu dẫn xuất và lockup có text |
| `source/fonts/`, `source/tokens.json` | Font, license và tokens chung |
| `source/release.json` | Phiên bản, ngày, thông số release |
| `exports/` | SVG outline và PNG dùng ngay |
| `templates/` | SVG text, PPTX, DOCX, PDF và HTML chỉnh sửa được |
| `guidelines/` | Handbook PDF 12 trang và nội dung Markdown |
| `portal/` | Portal dựng sẵn, dùng offline hoặc qua server |
| `manifest.json`, `deliverables.csv` | File thật, hash, dependency, revision và trạng thái |
| `strategy/`, `licenses.md` | Brief, quyết định, nguồn và điều kiện quyền |
| `evidence/QA-1.1.0.md`, `evidence/v1.1.0/` | Biên bản và bằng chứng hiện hành |

Gói ZIP 1.0.0 ở thư mục cha được giữ để đối chiếu lịch sử. Không dùng receipt hoặc screenshot 1.0.0 để xác nhận thiết kế mới. Gói 1.1.0 chỉ đóng bằng chứng hiện hành và preview cần thiết; loại node_modules, cache và ảnh QA cũ.

## Chỉnh sửa và tái xuất

Cách đơn giản: mở SVG nguồn, PPTX hoặc DOCX trong công cụ phù hợp, sửa text/bảng/hình, giữ logo và tỷ lệ, rồi xuất lại. Nguồn SVG dùng font Inter, Office dùng Arial fallback. Nội dung dài cần thêm trang/slide thay vì bóp chữ.

Với generator, sao lưu thay đổi trực tiếp trước khi chạy vì builder sẽ tái tạo template mặc định:

1. Python 3.12: tạo venv riêng, `pip install -r tools/requirements.txt`.
2. `python tools/build.py` sinh logo, SVG, A4 và handbook.
3. Từ `tools/`, chạy `npm ci --no-audit --no-fund`, rồi từ root bộ chạy `node tools/rasterize.mjs`.
4. Render A4 bằng Word/LibreOffice sau khi chỉnh. `tools/handbook.py` là nguồn nội dung/bố cục PDF; chạy lại bước 2 sau khi cập nhật preview PNG để handbook lấy đúng ảnh.
5. Sau review, `python tools/package.py` cập nhật manifest, dựng `portal/index.html` + `catalog.js` và ZIP 1.1.0.

Deck có nguồn `tools/deck.mjs` dùng Artifact Tool 2.8.99 của Codex. Runtime không được đóng vào ZIP; ngoài Codex, chỉnh PPTX trực tiếp, không cần generator. Các biến đường dẫn runtime chỉ dùng khi chạy trong Codex, không phải dependency asset của bộ.

Đổi text SVG source qua công cụ trực tiếp không tự cập nhật PNG/outline: phải xuất lại cả hai. Đổi palette cần cập nhật tài sản phụ thuộc, handbook và preview trước khi đóng gói. Package tool tăng revision khi file/dependency thay đổi và đưa hạng mục về `not_checked`; snapshot mới không tự chứng minh chất lượng. Chỉ reviewer sau retest mới dùng cờ review của tool để chốt trạng thái; xem báo cáo QA.

## Giới hạn

Biên bản QA được lập trên bản local; trạng thái triển khai portal được ghi riêng. Bộ này chưa tích hợp vào sản phẩm. Logo kế thừa không có giấy phép mở hoặc bảo đảm độc quyền; xem `licenses.md`. Chưa proof in/CMYK, thử email trong Gmail/Outlook, native Office hoặc người dùng thật. Các kết quả browser, Simulator, file và tái sử dụng được ghi riêng trong biên bản; không suy thành production acceptance.

## Phạm vi kiểm chứng 1.1.0

Tài sản digital đã được review; portal đã chạy các luồng chính trên desktop và iPhone Simulator. Nghiệm thu UI toàn diện vẫn NOT VERIFIED / PARTIAL; portal giữ `not_checked` trong manifest. Chưa kiểm iPad, VoiceOver, reduced-motion runtime, file:// runtime (IAB chặn protocol), native Office và email client. Xem biên bản hiện hành để biết từng case đã chạy.

## Cổng thư viện công khai

Đích triển khai được yêu cầu: https://brand.pgnext.dev. Portal dùng Cloudflare Worker Static Assets riêng, không triển khai API hoặc ứng dụng PG Next. Cấu hình và biên nhận triển khai nằm ở `brand-kit/DEPLOYMENT.md` trong repository; bản ZIP giữ hướng dẫn chạy local để dùng độc lập. Các giới hạn QA đã ghi vẫn có hiệu lực sau khi publish.