# HoctapAZ · Brand system 1.1.0

Bộ nhận diện mở rộng ngày 22/10/2026. Logo AZ và palette gốc được bảo toàn. Hệ đồ họa, ứng dụng và portal được nâng cấp theo yêu cầu đánh giá lại chất lượng.

## Bắt đầu

Mở `portal/index.html` để xem nền tảng, ứng dụng và 17 bộ tài sản được biên tập. Để dùng nút **Tải trọn bộ**, chạy tại thư mục gói:

```sh
python3 -m http.server 5788 --bind 127.0.0.1
```

Mở `http://127.0.0.1:5788/portal/index.html`. Portal chạy local, không cần tài khoản hoặc dịch vụ ngoài. Khi mở bằng file://, vẫn xem và tải riêng từng file; tải ZIP cần máy chủ local theo lệnh trên.

## Chọn và chỉnh sửa

- **SVG**: vector và chữ sống trong mẫu social. Cài Inter từ `source/fonts` trước khi mở trong phần mềm thiết kế. Logo chữ là outline được kế thừa, không tự gõ lại.
- **PNG**: bản xuất dùng trực tiếp, theo canvas ghi trong cửa sổ chi tiết. Logo có bản nền trong suốt.
- **PPTX**: sáu layout với text và hình riêng, chỉnh được trong PowerPoint. Thay các mục trong [ ]; giữ logo đúng tỷ lệ.
- **DOCX**: A4 có styles, header, footer và bảng thật. Thay nội dung trong [ ]; có header bảng lặp khi nội dung qua trang.
- **PDF**: bản xem để đối chiếu hoặc chia sẻ; không thay file editable.
- **HTML/TXT**: chữ ký email; website và motion là mẫu chạy local. Chưa thử gửi email hoặc kiểm email client thực tế.

Guidelines 10 trang nằm trong `guidelines/`. Nguồn biên soạn là `tools/build-guidelines.py` và `source/guidelines-content.json`. Chiến lược, voice và lịch sử ở `strategy/`. Các quyết định mới vẫn là đề xuất thiết kế, không thay nghiên cứu người dùng hoặc claim kinh doanh.

## Tái xuất

Dùng Python 3.12+, Node 22+, các thư viện reportlab, python-docx, pillow, sharp và @oai/artifact-tool. Không cần chạy generator để sửa SVG/HTML hoặc Office trực tiếp.

```sh
python3 -m pip install reportlab python-docx pillow
npm install sharp @oai/artifact-tool
export RUNTIME_NODE=/absolute/path/to/node
export RUNTIME_NODE_MODULES=/absolute/path/to/node_modules
python3 tools/build-kit.py
node tools/build-deck.mjs
```

Xuất PDF từ DOCX/PPTX trong Office/LibreOffice; lưu vào `templates/`. Render bìa slide/A4 thành `previews/deck-cover.png`, `previews/a4.png`. Sau đó:

```sh
python3 tools/build-guidelines.py
# Render trang 1 PDF sang previews/guidelines-cover.png bằng công cụ PDF.
python3 tools/package-kit.py
python3 tools/check-brand-kit.py .
```

`portal/` là source HTML/CSS/JS chỉnh trực tiếp, không có build framework. `tools/package-kit.py` sinh manifest, catalog, file index và ZIP từ các file thật. Chỉ dùng `--passed` sau khi đã xem bản render và kiểm các thay đổi theo `evidence/qa.md`. Công cụ kiểm kỹ thuật không chứng minh chất lượng thiết kế.

`tools/prepare-fonts.py` dùng fontTools để tái tạo static Inter 400/700 từ variable master có sẵn và đặt đúng family/PostScript name. File static đã kèm nên không cần chạy lại trừ khi đổi font. Giữ `source/fonts/OFL.txt` khi phân phối.

Trong Codex có thể đặt `PRESENTATION_SKILL_DIR` và `RUNTIME_PYTHON` để chạy finalizer của skill presentations; không đặt thì script xuất PPTX trực tiếp, không phụ thuộc đường dẫn máy người tạo. Nên xem lại trong phần mềm đích trước khi sử dụng.

## Phiên bản và giới hạn

Bản hiện hành là **1.1.0** trong manifest, portal và ZIP. Bản **1.0.0** được giữ nguyên tại ZIP cùng cấp, không trộn vào thư viện hiện hành. Xem `strategy/changelog.md` để biết phần thay đổi và giới hạn nguồn logo. Bộ dùng digital sRGB; in CMYK/ICC/proof, bảo hộ nhãn hiệu và thử người dùng thật là phạm vi riêng chưa thực hiện.