# Nextvision AI Brand Kit

Phiên bản 1.0.0 · 22/10/2026 · Bộ local cho doanh nghiệp quốc tế.

## Mở thư viện

Tại thư mục đã giải nén, chạy:

```sh
python3 scripts/serve.py --port 4178
```

Mở `http://localhost:4178/portal/`. Website minh họa riêng: `/templates/website/`. Không cần Node để xem hoặc tải tài sản. Server tự tạo ZIP nếu bản giải nén chưa có gói tải.

## Chọn file

- Logo đầy đủ: `exports/logo/logo-primary.svg`, `logo-reverse.svg`, `logo-mono.svg`; PNG trong cùng thư mục, alpha thật. Dùng từ 240 px ngang. Bản gốc trong `source/logo/original-nextvision-ai.png` được giữ nguyên. SVG là bản dựng lại, không gọi là master gốc.
- Biểu tượng N: `symbol-*.svg` và PNG. Dùng từ 24 px cao. Avatar 512×512 đã chừa vùng crop tròn.
- Màu/font: `source/tokens.json` là nguồn thông số. Web EN dùng Space Grotesk + DM Sans; VI dùng Space Grotesk cho đủ dấu; Office dùng Arial tương thích. Font và OFL có trong `source/fonts/`.
- Social: SVG editable; PNG để sử dụng nhanh. Hai canvas 1080×1080 và 1080×1350; cover 1584×396 là canvas mẫu, chưa bảo đảm crop cho mọi nền tảng. Kiểm safe area trên dịch vụ đích trước đăng.
- Word: `templates/document/project-brief.docx`; giữ header logo và footer, sửa title, paragraphs và bảng. Dùng styles sẵn có; không thêm claim chưa xác minh.
- PowerPoint: `templates/presentation/company-profile.pptx`, 4 slide. Text là object native, logo là ảnh riêng; thay nội dung và ảnh mà không flatten slide. Có PDF preview.
- Email: mở `templates/email/signature.html`, thay phần trong ngoặc vuông, copy bảng vào email client. Plain text dự phòng nằm cạnh file. Chưa thử client email thực tế.
- Guidelines: đọc PDF 12 trang. Sửa nội dung ở `guidelines/content.json`, bố cục ở `scripts/build-documents.py`.

Logo, font, tên và tỷ lệ lockup là phần cố định. Có thể sửa copy, ảnh, dữ liệu bảng, nhịp nội dung và crop motif trong vùng được hướng dẫn. Không bóp méo logo hoặc đổi màu PG Next thành màu công ty. Sample content phải thay trước xuất bản.

## Tái xuất

Nguồn SVG/HTML/DOCX/PPTX chỉnh trực tiếp được trong ứng dụng phù hợp. Với SVG có text, cài font được gói kèm hoặc dùng renderer đã cấu hình. Mẫu Office dùng Arial, không cần cài font thương hiệu.

Các script Python cần Python 3.10+; cài dependencies từ `scripts/requirements.txt` vào môi trường riêng. Script raster cần Node và `sharp` theo `scripts/package.json`:

```sh
python3 -m pip install -r scripts/requirements.txt
npm install --prefix scripts
python3 scripts/build-assets.py
python3 scripts/outline-social.py
node scripts/render-assets.mjs
python3 scripts/build-documents.py
```

`build-assets.py` tái tạo baseline và mẫu mặc định; không chạy lên template đã chỉnh nếu chưa sao lưu. Muốn xuất PNG từ SVG đã sửa, chạy `outline-social.py` rồi `render-assets.mjs`. Fontconfig đọc font local để PNG khớp font; Windows có thể cần renderer hỗ trợ fontconfig hoặc mở SVG bằng ứng dụng thiết kế sau khi cài font.

Deck được tạo bằng Artifact Tool trong Codex. Script `build-deck.mjs` cần runtime `@oai/artifact-tool` do Codex cung cấp; chỉnh file PPTX hiện có không cần runtime này. Kiểm đầu ra bằng LibreOffice hoặc PowerPoint khi tái tạo; tạo bản mới trước, không ghi đè release đã kiểm.

PDF của Word và PowerPoint được render qua LibreOffice. Sau khi sửa nguồn, xuất lại PDF/preview từ ứng dụng, kiểm lại các trang rồi cập nhật manifest. `package-kit.py` dùng preview đã kiểm trong `evidence/`; không dùng để chứng nhận bản đã sửa mà chưa render.

## Kiểm chứng và giới hạn

Xem `evidence/verification.md`, `evidence/contrast.json` và `deliverables.csv`. `manifest.json` quản lý revision, file hash và dependency snapshot. Báo cáo là tự kiểm trong môi trường Codex/LibreOffice, không phải nghiên cứu khách hàng hay kiểm thử Microsoft Office.

Chưa proof in/CMYK, chưa kiểm email client, chưa review riêng cho một quốc gia, chưa xác nhận nhãn hiệu độc quyền. Bộ chỉ digital sRGB, tiếng Anh và hướng dẫn tiếng Việt; chưa dịch toàn bộ sáu locale của website.

Nguồn và quyền: `licenses.md` và `strategy/research-and-decisions.md`. Không deploy hay thay tài sản production trong nhiệm vụ này.