All-In Fitness BOD Handbook

Cài và dùng Lark CLI với Codex / Claude Code

Hướng dẫn trực quan để BOD dùng account Lark riêng truy vấn Base, phân tích hợp đồng, sale, lead và lỗi vận hành. Không dùng chung token cá nhân.

1. Cài nền

Node.js, Lark CLI, Codex hoặc Claude Code.

2. Login Lark

BOD dùng account riêng để cấp quyền Base.

3. Cài skill

`allin-lark-bod` vào Codex / Claude Code.

4. Phân tích

Hỏi sale, hợp đồng, lead, vận hành từ Lark Base.

Trước Khi Cài

Máy BOD

Điều kiện

macOS có internet, Terminal dùng được, có quyền cài Node/npm package.

Lark

Quyền truy cập

Account BOD phải được share quyền vào Base 1 và Base 2 theo vai trò.

Không copy

Credential

Không chuyển Telegram token, Gemini key, app secret, cookie hay `.env` cá nhân.

Base token/table ID trong kit chỉ định danh tài liệu. Nó không cấp quyền đọc nếu account Lark không được share.

Cài Đặt Nhanh

Copy folder kit sang máy BOD

Đặt tại Desktop hoặc thư mục dễ tìm.
```
cd "$HOME/Desktop/BOD_Lark_Codex_Claude_Setup_Kit"
```
Chạy one-shot setup

Cài skill vào Codex/Agents/Claude và cài hoặc cập nhật Lark CLI.
```
cd files/allin-lark-bod-skill-package
bash setup-bod-machine.sh
```

Nếu muốn chạy thủ công

Dùng script copy-paste ở root kit.

cd "$HOME/Desktop/BOD_Lark_Codex_Claude_Setup_Kit"
bash scripts/bod-copy-paste-commands.sh

Login Lark Bằng Account BOD

Lệnh login

lark-cli auth login --domain base
lark-cli auth login --domain docs
lark-cli auth login --domain im

Trình duyệt sẽ mở link xác thực. Đăng nhập bằng account Lark của BOD.

Khi nào cần quyền nào?

Domain	Dùng cho
base	Đọc Base, hợp đồng, lead, MiniCRM, HR/Ops.
docs	Tìm tài liệu, Base links, export/import khi cần.
im	Đọc/tìm chat nếu BOD có quyền và nhu cầu.

Nếu login thành công nhưng vẫn không đọc được Base, lỗi nằm ở quyền share Base trong Lark, không phải ở Codex/Claude Code.

Verify Sau Khi Cài

Kiểm tra Lark CLI
```
lark-cli --version
```

Kiểm tra quyền Base

cd "$HOME/Desktop/BOD_Lark_Codex_Claude_Setup_Kit/files/allin-lark-bod-skill-package"
bash allin-lark-bod/scripts/verify-lark-access.sh

Kết quả hợp lệ

Terminal hiển thị danh sách table của Base 1 và Base 2, sau đó có dòng:
```
OK: BOD account can access the configured Bases.
```

Cách Dùng Với Codex / Claude Code

Codex

Prompt kích hoạt

Use $allin-lark-bod to verify Lark Base access and list the key All-In business tables.

Use $allin-lark-bod to analyze current An Khánh contracts: expiry, installment risk, missing documents, wrong branch, and action plan for BOD.

Claude Code

Prompt kích hoạt

Use the allin-lark-bod skill. Verify Lark CLI access, then analyze current All-In contract and sales risks.

Use allin-lark-bod from my installed skills. Only use Base 1 contract and MiniCRM tables for sales/contract analysis.

Luồng phân tích chuẩn

Câu hỏi	Nguồn đúng	Không dùng
Sale, doanh số, hợp đồng	Base 1: Hợp đồng AK/NL, MiniCRM	HR, Ngày công, Lark account
Lead, marketing, verified	Base 1: Leads Smax, Verified, Trial, MKT Report	Attendance, tuyển dụng
Vận hành, gia hạn, chuyển HV	Base 1 MiniCRM + Base 2 approval forms	Bảng không liên quan
HR, chấm công	Base 2 HR/Ops	Bảng doanh số nếu không có liên quan

Prompt Mẫu Cho BOD

Hợp đồng

Use $allin-lark-bod to rà soát toàn bộ hợp đồng An Khánh hiện tại: hết hạn, sắp hết hạn, đóng đợt 1, hồ sơ chưa đạt, sai chi nhánh, thiếu lịch thu tiếp. Trả lời ngắn cho BOD kèm cách xử lý.

Use $allin-lark-bod to tìm các hợp đồng Đóng đợt 1 chưa có ngày thu tiếp theo hoặc có rủi ro thất thoát follow-up.

Sale

Use $allin-lark-bod to phân tích doanh số tháng này AK và NL: tổng tiền, số HĐ, đã thu, top HLV, top nguồn, điểm báo động và hành động trong 48h.

Use $allin-lark-bod to kiểm tra doanh số 7 ngày gần nhất có tụt không, tụt ở cơ sở/HLV/nguồn nào.

Lead

Use $allin-lark-bod to phân tích lead tháng này: tổng lead, verified rate, processing, fail, nguồn chính, TV chính và cảnh báo cần xử lý hôm nay.

Use $allin-lark-bod to tìm nguồn tạo nhiều fail lead nhất trong tháng này và đề xuất xử lý từng nguồn.

Vận hành

Use $allin-lark-bod to tìm lỗi vận hành ảnh hưởng sale: thiếu mã HĐ, thiếu HLV, thiếu ngày thu tiếp, trạng thái hết hạn sai, phiếu gia hạn pending.

Use $allin-lark-bod to rà soát các hợp đồng đã hết hạn nhưng MiniCRM vẫn DOING. Group theo HLV và ưu tiên xử lý.

Lỗi Thường Gặp

Lỗi	Nguyên nhân	Cách xử lý
`lark-cli: command not found`	Chưa cài CLI hoặc PATH chưa load.	`npm install -g @larksuite/cli@latest`, sau đó mở lại Terminal.
Permission denied	Account BOD chưa được share Base.	Admin Lark share Base, rồi chạy lại `auth login --domain base`.
Codex/Claude không thấy skill	Chưa copy skill hoặc chưa restart app.	Chạy `bash install-skill.sh`, restart Codex/Claude Code.
Kết quả sai bảng	Prompt quá rộng, agent fallback sang domain khác.	Ghi rõ nguồn bắt buộc: Base 1 hợp đồng/MiniCRM, không dùng HR/Ngày công.
Dump thiếu page/file rỗng	Mạng hoặc Lark API lỗi giữa chừng.	Không kết luận toàn cục. Chạy lại dump hoặc dùng realtime query.

Bảo Mật Và Phân Quyền

Được phép

Chuyển giao

Skill, hướng dẫn, Base token/table ID, script cài đặt, prompt mẫu.

Không được phép

Chuyển giao

Telegram token, Gemini/OpenAI key, Lark app secret, `.env`, cookie, access token.

Quyền thật

Do Lark quyết định

Người dùng chỉ đọc được Base nếu account Lark của họ được share quyền.

Checklist Bàn Giao

Việc cần xong	Trạng thái kiểm tra
Node.js hoạt động	`node --version`
Lark CLI hoạt động	`lark-cli --version`
BOD login Lark	`lark-cli auth login --domain base`
Skill đã cài	`ls ~/.codex/skills/allin-lark-bod`
Đọc được Base	`bash allin-lark-bod/scripts/verify-lark-access.sh`
Test prompt BOD	Hỏi rà soát hợp đồng AK hoặc lead tháng này.