📖 Hướng Dẫn Sử Dụng

Khi đăng nhập, bạn sẽ thấy lưới (grid) các công ty. Mỗi thẻ công ty hiển thị tên, loại hình, quốc gia và số lượng dự án. Click vào một công ty để xem danh sách dự án bên trong.

Sử dụng thanh filter ở đầu trang để lọc công ty theo quốc gia. Chọn "All" để xem tất cả, hoặc chọn tên quốc gia cụ thể (Vietnam, Japan...).

Nhấn nút "+" để thêm công ty mới hoặc dự án mới. Để chỉnh sửa, nhấn vào biểu tượng bút (✏️) trên thẻ. Để xoá, mở form chỉnh sửa rồi nhấn nút Xoá bên dưới. Chỉ người có quyền quản lý mới thấy các nút này.

Bạn có thể kéo thả (drag & drop) các thẻ công ty hoặc dự án để thay đổi thứ tự hiển thị. Thứ tự mới sẽ được lưu tự động vào hệ thống.

Sau khi click vào công ty, bạn sẽ thấy danh sách dự án. Chuyển giữa chế độ Grid và List bằng các nút ở góc phải. Nhấn mũi tên quay lại (←) để trở về danh sách công ty.

Hệ thống THB Hub vận hành 17 AI agents chia thành 2 nhóm:

•CEO Dashboard (6 agents) — phục vụ quản trị cấp cao: quét thị trường, phân tích tài chính, kiểm tra dữ liệu, tổng hợp báo cáo

•Tech Factory (11 agents) — đội ngũ do hệ thống Antigravity (AG) nội bộ điều phối: tầm nhìn sản phẩm, thiết kế kiến trúc, lập trình, kiểm thử trực quan, gỡ lỗi và kiểm soát chất lượng

Mỗi thẻ agent hiển thị tên, vai trò, trạng thái (Active/Standby/Planned) và hệ thống thuộc về. Sử dụng 3 nút lọc ở đầu trang để xem theo nhóm.

Đội CEO Dashboard chạy tự động theo lịch mỗi sáng, tạo thành chuỗi xử lý dữ liệu:

•06:00 — Market Scanner quét tin tức thị trường, phân tích đối thủ cạnh tranh

•06:30 — Financial Analyst kết nối 3 nguồn dữ liệu (jpvn-portal, genki-dashboard, gaijin-sales) để phân tích tài chính đa Tenant

•07:00 — Data Validator kiểm tra bất thường số liệu, kích hoạt cảnh báo nếu phát hiện sai lệch

•07:15 — Chief of Staff tổng hợp toàn bộ thông tin thành briefing cho CEO, trả lời câu hỏi qua chatbot me_v1.2

•07:30 — Report Generator tạo báo cáo Excel/PDF tự động (hàng ngày + tuần vào thứ Hai)

•07:45 — Notification Agent phân phối báo cáo + cảnh báo qua Telegram và me_v1.2 mini app

Bạn chỉ cần theo dõi kết quả — toàn bộ quy trình chạy tự động, không cần kích hoạt thủ công.

① Market Scanner — Mở thẻ để xem danh sách nguồn tin đã quét. Dùng khi cần nắm tin tức ngành trước cuộc họp.

② Financial Analyst — Xem data sources kết nối (jpvn-portal, genki-dashboard, gaijin-sales). Agent này dùng skill Cloudflare AI Proxy + Firebase để tự đọc/ghi dữ liệu tài chính. Mở popup Cấu hình > tab DB Connections để xem chi tiết kết nối.

③ Data Validator — Theo dõi ngưỡng cảnh báo (P0/P1/P2). P0: doanh thu giảm >30% hoặc leads = 0 sẽ gửi báo ngay. P1: doanh thu giảm >15%. P2: mọi thay đổi khác. Quan trọng nhất để phát hiện sớm vấn đề.

④ Chief of Staff — Agent tư vấn thông minh nhất. Tổng hợp dữ liệu từ 3 agent trước và đưa ra nhận định. Truy cập qua chatbot me_v1.2 để hỏi đáp trực tiếp.

⑤ Report Generator — Tự động tạo Excel (ExcelJS) mỗi sáng. Báo cáo tuần đầy đủ hơn, gửi vào thứ Hai. Mở popup để xem lịch sử Activity Logs.

⑥ Notification Agent — Kênh phân phối cuối cùng. Đang phát triển — sẽ gửi qua Telegram bot và me_v1.2 mini app.

11 agent Tech Factory hoạt động dưới sự điều phối của hệ thống Antigravity (AG):

① CEO Vision & Discovery — Định hướng 10-star product và phân tích yêu cầu từ sớm.

② Tech Lead & Product Manager — Thiết kế kiến trúc, lên chiến lược công nghệ và viết tài liệu spec.

③ Builder — Phụ trách viết code chính (React/Node.js/Python) thông qua việc phân tích và thiết kế.

④ QA & Quality Gate — Chạy các kiểm duyệt khắt khe: browser testing, i18n, schema, accessibility trước khi xuất xưởng.

⑤ Debug & Retro — Phụ trách gỡ lỗi theo hệ thống 4 pha chuyên sâu và lưu trữ những bài học kinh nghiệm.

⑥ DevOps & Ship — CI/CD, tự động hóa quy trình sync, test, đẩy code và tạo Pull Request.

📌 Lưu ý: Các agent này không chạy độc lập mà nhận lệnh từ Tech Factory truyền đạt qua AG orchestration.

Click thẻ agent → mở rộng xem chi tiết: lịch chạy, skills, data sources, ngưỡng cảnh báo, endpoint.

Nhấn nút "Cấu hình" → popup với 3 tab:

•Tab "Cấu hình JSON" — xem raw config để hiểu agent được thiết lập thế nào

•Tab "Kết nối DB" — danh sách databases + quy tắc cảnh báo tự động

•Tab "Activity Logs" — nhật ký hoạt động gần đây (lần chạy cuối, kết quả)

Dấu chấm 🟢 nhấp nháy = agent đang hoạt động. Agent không có chấm = Standby hoặc Planned.

Tech Factory KHÔNG trực tiếp chạy code, mà thay vào đó hoạt động như một nền tảng giám sát (Orchestrator) cho hệ thống AG (Antigravity) bên dưới. Nó điều phối AG chạy qua 17 giai đoạn SDLC tĩnh:

1️⃣ CEO Vision → Định hình sản phẩm

2️⃣ Workspace Init → Khởi tạo môi trường

3️⃣ Discovery → Mở rộng yêu cầu

4️⃣ Project Detection → Nhận diện dự án

5️⃣ Tech Strategy → Chiến lược công nghệ

6️⃣ PRD + Spec Review → Chuẩn bị tài liệu

7️⃣ Implementation Plan → Lập kế hoạch chi tiết

8️⃣ Security + Auth → Bảo mật

9️⃣ Implementation → Lập trình theo TDD

🔟 Spec + Quality Review → Đánh giá nội bộ

1️⃣1️⃣ Debug → Phân tích sửa lỗi 4 pha

1️⃣2️⃣ QA Browser Testing → Kiểm thử qua trình duyệt

1️⃣3️⃣ Pre-Delivery Quality Gate → Cổng rà soát toàn diện (i18n, a11y, schema)

1️⃣4️⃣ Deployment → Triển khai phát hành

1️⃣5️⃣ Ship → Hoàn tất đẩy code

1️⃣6️⃣ Knowledge Capture → Viết Walkthrough/Bài học

1️⃣7️⃣ Retrospective → Hồi cứu dữ liệu

Tech Factory sử dụng mô hình "AG-Orchestrated Supervised Autopilot":

Bước 1: Chọn chế độ Autopilot — Nhấn "Chạy Autopilot" để hệ thống tự động sinh các dispatch commands truyền tớ AG.

Bước 2: Giám sát AG Activity Log — Quan sát danh sách activity logs hiện các tác vụ đang được AG xử lý, thời gian ms, và số lần repair.

Bước 3: Vượt Cổng Duyệt (Human Gates) — Ở các stage mang biểu tượng 🔒 (ví dụ Quality Gate, Cost Guard), quá trình Autopilot sẽ tạm dừng chờ Chairman chẩn đoán trước khi cho AG đi tiếp.

Bước 4: Test-Fix Loops — Nều build lỗi, Tech Factory tự ra lệnh cho AG (vd: `tf-fix-loop`) để debug, với giới hạn retry 3 lần trước khi bắt buộc huỷ.

Workflows là các luồng thao tác đóng gói cho môi trường AG:

🔴 ĐIỀU PHỐI (ORCHESTRATION):

•tf-auto-factory (Dream Team V6) — Luồng trung tâm điều hướng AG state machine

•Open Session / End Session — Nạp hoặc lưu state máy (Context load/Index update)

🟡 KIỂM SOÁT (GATES & QA):

•tf-quality-gate — Chạy kiểm tra tĩnh chuyên biệt trước khi xuất xưởng

•tf-review — Kiểm duyệt và Playwright browser QA

•tf-fix-loop — Phân tích lỗi tự động cho AG

•secops-gate — Rà soát bảo mật mã nguồn

🟢 XÂY DỰNG & TRIỂN KHAI:

•tf-discovery, tf-plan, tf-schema-first — Design & Spec generation

•tf-build — Gọi AG viết components/UI

•tf-ship — Quy trình phát hành tự động

•tf-retro — Thu thập feedback dự án gốc

Tech Factory quản lý 14 dự án đang hoạt động, chia theo nhóm chức năng:

📚 Education: eiken-guru, jlpt-guru, oki-language — Nền tảng học tiếng Nhật (JLPT/Eiken)

📊 Dashboard: genki-dashboard — Bảng điều khiển kinh doanh với OKR, KPI

💼 Sales: gaijin-sales, abano-website — Nền tảng bán hàng và landing page

📝 Content: genki-content-pilot — Tạo nội dung tự động bằng AI

📄 Document: docstudio — Nhà máy tài liệu

🎬 Media: auto-video — Tạo video tự động (Python/FastAPI/MoviePy)

🔧 Tools: hojo-navi, drive-tree, export-hsc-huma — Công cụ SaaS và xuất dữ liệu

🏢 Portal: jpvn-portal — Cổng quản trị CEO (trang này!)

🤖 Personal: me_v1.2 — Hệ điều hành cá nhân + chatbot AI

Mỗi thẻ dự án hiển thị tên, stack công nghệ, vai trò, và loại. Hover để xem đường dẫn thư mục.

•Nút Manual/Autopilot — Chuyển đổi giữa chạy thủ công và chế độ tự động hoá AG-Orchestrated supervised.

•Nút AG Log — Xem nhanh lịch sử các lệnh được dispatch bởi hệ thống xuống cho agent thực thi.

•Click vào giai đoạn (stage) trên timeline → mở rộng xem chi tiết mô tả + agent phụ trách + workflows.

•🔒/🔓 bên cạnh stage = Dấu hiệu yêu cầu có sự cho phép (gate approval) từ người duyệt.

•Phần "Workflows" → liệt kê các kịch bản chuẩn trong AG-pack.

Skill là một module kỹ năng mà nhiều AI agents có thể dùng chung. Thay vì mỗi agent tự code riêng chức năng đọc database hay gọi AI, chúng dùng chung một skill đã được test kỹ.

Ví dụ thực tế: Agent "Financial Analyst" và "Data Validator" đều cần đọc/ghi dữ liệu từ Firebase. Thay vì viết code 2 lần, cả hai đều sử dụng skill "Firebase CRUD".

Điều này giúp:

•Giảm trùng lặp code

•Dễ bảo trì — sửa skill 1 lần, tất cả agents được cập nhật

•Dễ kiểm soát — bật/tắt skill = bật/tắt khả năng của agents

① Cloudflare AI Proxy — Gọi LLM (Gemini/Claude) qua proxy bảo mật Cloudflare Workers. Dùng bởi: Financial Analyst, Chief of Staff, Builder. Ứng dụng: phân tích văn bản, tạo báo cáo AI, viết code tự động.

② Firebase CRUD — Đọc/Ghi Firestore bằng Firebase Admin SDK. Dùng bởi: Financial Analyst, Data Validator, Report Generator. Ứng dụng: truy xuất dữ liệu kinh doanh, lưu kết quả phân tích, tạo báo cáo.

③ Excel Report Generator — Tạo file Excel (.xlsx) tự động từ data bằng ExcelJS + JSZip. Dùng bởi: Report Generator. Ứng dụng: báo cáo tài chính tuần/tháng, export dữ liệu cho stakeholders.

④ Video Renderer (đang phát triển) — Tạo video tự động từ script bằng FastAPI + MoviePy + Whisper. Chưa có agent nào dùng. Ứng dụng tương lai: tạo video marketing, video đào tạo tự động.

⑤ i18n Translator (đang phát triển) — Dịch tự động key JSON đa ngôn ngữ bằng Gemini API. Chưa có agent nào dùng. Ứng dụng tương lai: tự động dịch UI cho các ứng dụng đa ngôn ngữ (VN/JP/EN).

Thanh thống kê phía trên hiển thị: số skill đang bật, tổng số, số sẵn sàng, số đang phát triển, và tổng lượt agent dùng.

•Toggle ON/OFF — Công tắc ở góc phải mỗi thẻ. Chỉ skill "Sẵn sàng" mới bật/tắt được. Skill "Đang phát triển" bị khoá (thẻ mờ, viền vàng).

•Tắt skill = tạm ngưng khả năng — Ví dụ: tắt "Cloudflare AI Proxy" → các agent không thể gọi LLM cho đến khi bật lại.

•Phần "Dùng bởi" — Xem danh sách agent đang phụ thuộc vào skill. Cẩn thận khi tắt skill đang có nhiều agent dùng!

•Tech stack — Hiển thị công nghệ cốt lõi của skill (Cloudflare Workers, Firebase Admin, ExcelJS...)

•Source — Cho biết mã nguồn skill nằm trong dự án nào

Skills đóng vai trò then chốt trong chuỗi xử lý:

📊 Quy trình thuyết minh quản trị (CEO Dashboard):

Data Sources → Firebase CRUD (đọc dữ liệu) → Cloudflare AI Proxy (phân tích AI) → Excel Report (xuất báo cáo)

🛠️ Quy trình build ứng dụng (Tech Factory):

Discovery → Product specs → Cloudflare AI Proxy (Builder viết code) → QA testing → Deploy

💡 Khi muốn thêm khả năng mới cho agents:

1. Phát triển skill mới trong thư mục thb_hub/skills/

2. Skill sẽ xuất hiện trên giao diện với trạng thái "Đang phát triển"

3. Khi hoàn thiện → chuyển status sang "Sẵn sàng" → bật toggle

4. Thêm skill vào danh sách skills của agent cần dùng trong config

Tab "Thành viên" hiển thị danh sách tất cả người dùng: email, tên, vai trò, công ty được gán. Sử dụng ô tìm kiếm để lọc theo tên hoặc email.

Nhấn nút "Thêm thành viên" → điền Email, Mật khẩu, Tên đầy đủ → chọn Công ty và Vai trò (BOD/Admin/Member/Viewer) → nhấn Lưu. Hệ thống sẽ tạo tài khoản Firebase Auth tự động.

4 cấp vai trò từ cao đến thấp:

•BOD — Toàn quyền, thấy tất cả công ty và dự án

•ADMIN — Quản lý thành viên trong phạm vi công ty được gán

•MEMBER — Xem và tương tác với dự án được gán

•VIEWER — Chỉ xem, không chỉnh sửa được

Tab "Nhật ký" ghi lại tất cả hành động đăng nhập/đăng xuất: ai, khi nào, từ đâu (IP). Dùng để kiểm tra bảo mật và theo dõi hoạt động người dùng.

Nhập email và mật khẩu đã được cấp bởi quản trị viên, rồi nhấn "Đăng nhập". Nếu đăng nhập thành công, bạn sẽ được chuyển đến Bảng Điều Khiển.

Liên hệ quản trị viên (Admin hoặc BOD) để được cấp lại mật khẩu. Hiện tại hệ thống chưa hỗ trợ tự đổi mật khẩu.

Click vào các mục trên thanh bên để chuyển trang: Bảng Điều Khiển, Đội AI, Nhà Máy Code, Kho Kỹ Năng, và Hướng Dẫn. Mục đang active sẽ được tô sáng.

Nhấn biểu tượng 🌐 ở phần dưới sidebar để chuyển giữa Tiếng Việt (VN) và English (EN). Tất cả nội dung giao diện sẽ thay đổi ngay lập tức.

Nhấn biểu tượng ☀️/🌙 để chuyển giữa giao diện Sáng và Tối. Cài đặt sẽ được lưu lại cho lần truy cập sau.

Nhấn mũi tên ở cuối sidebar để thu gọn (chỉ hiện icon) hoặc mở rộng (hiện cả chữ). Trên điện thoại, sidebar tự động thu gọn.