VX

VIỆC XANH X — V4 Prototype

Nền tảng dữ liệu lao động sống • SaaS Multi-tenant • AI-first

v4.0-prototype

VIỆC XANH X là gì?

Không phải sàn việc làm, không phải phần mềm HR. Là nền tảng số trung tâm kết nối công nhân — nhà cung ứng — nhà máy trên cùng hạ tầng, tích lũy dữ liệu lao động sống thành tài sản để mở rộng sang dịch vụ tài chính, bảo hiểm, phúc lợi.

📊
36
modules V4
🏢
Multi
tenant SaaS
🤖
7
AI agents chuyên biệt
🗓️
10-13
tháng triển khai

💡 Giá trị cho 3 bên

👷 Công nhân
Hồ sơ số cá nhân, bảng công minh bạch, ứng lương, ví quyền lợi, AI advisor
🏭 Nhà máy
Hệ điều hành số về lao động — tuyển dụng, chấm công, bảng công, AI hỗ trợ GĐ
🤝 Nhà cung ứng
Quản lý nguồn, CTV, vendor, hoa hồng đa tầng, đối soát, phân phối đa nhà máy

💰 Mô hình kinh doanh 4 tầng

1
SaaS subscription — phần mềm vận hành
2
Giao dịch lao động — lead, placement, tuyển dụng
3
Dịch vụ VAS cho CN — ứng lương, bảo hiểm, vay, ví
4
AI premium — trợ lý GĐ, phân tích, insight

🏗️ Kiến trúc 6 lớp

Lớp 6 — Tích hợp & Mở rộng
Integration Hub, API public, webhook, import/export, n8n
Lớp 5 — AI & Phân tích
AI Core Orchestrator (LangChain.js) + 7 AI specialized agents + Langfuse
Lớp 4 — Dữ liệu & Giao dịch
MySQL 8 + PostgreSQL+pgvector + Redis Streams + Trust Layer
Lớp 3 — Ứng dụng Công nhân
VIỆC XANH 247 (Expo + RN) — hồ sơ số, bảng công, ứng lương, AI advisor
Lớp 2 — Ứng dụng Doanh nghiệp
Admin SPA (React 19) + Public Web (Next.js 16) — nhà máy + nhà cung ứng dùng chung lõi
Lớp 1 — Nền tảng Trung tâm
Laravel 12 + stancl/tenancy + spatie/model-states + Workflow Engine + AI Core + Audit

Luồng dữ liệu xuyên suốt

👤 Ứng viên
✅ Tiếp nhận
⏱️ Chấm công
💰 Bảng công
💵 Lương/Thưởng
🏦 Dịch vụ TC

📈 Compliance V4 — Độ phủ hiện tại

0-30%
🔴 Gap Lớn
Multi-tenant • Integration Hub • AI permission • Trust snapshot • Ứng lương • Ví
30-60%
🟠 Gap Trung bình
Workflow formal • AI Core orchestrator • VX247 hồ sơ • Search • Real-time notif
60-100%
🟢 Đã có
DDD structure • Cross-service auth • Notification system • Mobile base • 3 LLMs

🏢 Multi-Tenant SaaS

Demo chuyển tenant ở header — mọi data đều scope theo tenant_id.

🏭
Tenant Factory
Module: HR, Attendance, Payroll, Recruitment, AI điều hành NM
🤝
Tenant Supplier
Module: Sourcing, CTV, Vendor, Commission, AI điều phối nguồn
🔀
Tenant Hybrid
Vừa tuyển vừa vận hành — bật cả 2 module sets

Tech: stancl/tenancy v3 (row-level)

📋 Migration plan (click)
1. Install package + config middleware
2. Migration add_tenant_id cho 71 tables
3. Backfill default tenant xanhvina-main
4. Global scope auto-inject tenant_id
5. Pilot 1 tenant canary
6. Penetration test cross-tenant leak

🔒 Trust Layer

📝 Activity Log
spatie/laravel-activitylog
👤 nguyen.a@nm-abc → UPDATED Worker#1024
🕐 2026-04-14 21:45:12 • tenant:nm-abc
📍 IP 192.168.1.5 • UA: Chrome/129
📸 Policy Snapshot
Custom JSON versioned
Payroll Rule v12 @ 2026-04-01
→ Apply: Payroll#5012 (approve 2026-04-14)
→ Snapshot frozen, không bị edit sau
🤖 AI Action Log
Custom table ai_actions
AI Tuyển dụng → suggest 5 candidates
prompt_hash: a8f3... • tokens: 1,240
approved_by: recruiter_12 ✅
⚖️ Dispute + Evidence
Custom Dispute domain
Case #D-2026-0142 • Worker#1024
Claim: Thiếu 2 công tháng 3
Evidence: 3 ảnh bảng công • Status: resolved
Vì sao bắt buộc? Khi nền tảng đi vào lương, thưởng, ứng lương, mọi thay đổi đều phải giải thích được — nếu không, không ai dám giao dịch tiền thật.

⚙️ Workflow Engine + State Machine

Click vào node để xem transition rules

Recruitment Workflow

5 câu hỏi mỗi state machine trả lời

  1. 1️⃣ State gì? — enum type-safe
  2. 2️⃣ Ai chuyển được? — permission check theo role
  3. 3️⃣ Điều kiện gì? — guards validation
  4. 4️⃣ Side effects? — jobs dispatch, notification, audit
  5. 5️⃣ AI vai trò gì? — suggest next action, detect anomaly
Tech: spatie/laravel-model-states (state) + laravel-workflow (saga/retry/compensation) + Horizon (queue monitor)

🤖 AI Core — 7 AI specialized agents

Chat với AI Tuyển dụng

Chào recruiter! Tôi là AI Tuyển dụng. Bạn cần gì?
Tìm 5 ứng viên may mặc cho NM ABC
🔎 Tìm thấy 47 hồ sơ phù hợp. Lọc theo retention tốt + cư trú gần NM, top 5:

1. Nguyễn T.A — điểm 92/100
2. Trần V.B — điểm 89/100
3. Lê T.C — điểm 87/100
4. Phạm V.D — điểm 85/100
5. Hoàng T.E — điểm 83/100

Cần tôi tạo chiến dịch tiếp cận?

7 Agents chuyên biệt

🎯
AI Tuyển dụng
Lead scoring, follow-up, match
40%
👷
AI Quản lý CN
Retention risk, onboarding alert
0%
⏱️
AI Chấm công-Lương
Detect anomaly, reconcile
0%
📊
AI Phân tích LĐ
Retention trend, source analytics
0%
🏭
AI GĐ Nhà máy
Insight điều hành, Q&A
0%
🤝
AI GĐ Nhà cung ứng
Recruiter/CTV/vendor hiệu quả
0%
🛡️
AI Kiểm soát
Fraud, dispute, anomaly
0%
Stack: NestJS (existing chat-service rename) + LangChain.js + Vercel AI SDK + Langfuse (prompt versioning + cost tracking) + pgvector (RAG) + per-tenant cost guardrail

🔌 Integration Hub

Dữ liệu xuyên giữa nhà máy ↔ nhà cung ứng ↔ VX247 ↔ hệ thống ngoài.

📥
Import
Excel/CSV chunked
📤
Export
Batch + scheduled
🔗
Webhook
Inbound + outbound retry
🔄
API Sync
2-way + mapping

Demo mapping UI

Partner ERP field
VIỆC XANH field
employee_code
workers.code
attendance_hours
attendance.hours
salary_rate
payroll.hourly_rate
Tech: n8n self-hosted (low-code flow, 400+ connectors) + Laravel webhooks + Laravel Excel + field mapping UI

📦 36 Modules V4

Click module để xem tính năng chi tiết

📱 VIỆC XANH 247 — Ví lao động số

"Personal Labor OS" cho công nhân. Click tab trên mobile frame để xem từng tính năng.

📶 VX247
21:45 🔋 92%
Xin chào
Nguyễn Văn A
CCCD đã xác thực ✅
Công tháng
24/26
Lương dự kiến
8.2tr
💰 Ứng lương khả dụng
Bạn có thể ứng tối đa 4.1tr (50% lương công hiện tại)
🤖 AI Advisor gợi ý
Bạn đủ điều kiện vay tín chấp 10tr lãi 1.2%/tháng dựa trên lịch sử 6 tháng đi làm ổn định.

6 Module VX247

📄 6.1 Hồ sơ số cá nhân
6 blocks • liên kết mọi tenant đã làm
🔎 6.2 Sàn việc làm cá nhân hóa
AI match + 1-click apply
⏱️ 6.3 Bảng công + thu nhập realtime
Push realtime từ tenant
📝 6.4 Nghỉ phép + yêu cầu
Workflow approval multi-step
💰 6.5 Quyền lợi + tiện ích TC
Ứng lương • Ví • Bảo hiểm • Vay tín chấp
🤖 6.6 Thông báo + AI advisor
Personal AI agent

🏭 Module chuyên biệt cho Nhà máy

📋

4.1 Kế hoạch nhu cầu nhân lực

Kế hoạch theo bộ phận / dây chuyền / ca, forecast AI

4.2 Tiếp nhận lao động

Xác nhận nhận việc, onboarding checklist, milestone D3/D7/D15/D30

⏱️

4.3 Chấm công nguồn

Integration với thiết bị chấm công, import batch, đối chiếu

📤

4.4 Phản hồi dữ liệu cho NCƯ

Sync công, lương, retention cho nhà cung ứng đối tác

🔄

4.5 Phối hợp với NCƯ

Portal chung cho đối tác, đối soát realtime

🤖

4.6 AI điều hành NM

Dashboard thông minh + Q&A tiếng Việt cho GĐ

🤝 Module chuyên biệt cho Nhà cung ứng

📡

5.1 Đa nguồn ứng viên

Facebook, Zalo, website, referral, offline — về 1 funnel

👥

5.2 Cộng tác viên (CTV)

Onboard CTV, tracking link, commission realtime

🏢

5.3 Vendor / tuyến dưới

Mạng lưới đa cấp, phân phối quota, kiểm soát chất lượng

🎯

5.4 Phân phối đa nhà máy

1 ứng viên → nhiều NM, AI match tối ưu

💵

5.5 Hoa hồng đa tầng

Rule engine commission: recruiter + CTV + vendor + bonus retention

📊

5.6 Đối soát nhiều đầu mối

Match data NM ↔ NCƯ, dispute workflow

🤖

5.7 AI điều phối nguồn

Phân tích hiệu quả từng kênh, từng CTV, từng recruiter. Tự động điều phối lead theo năng lực.

💻 Tech Stack V4

✅ KEEP (80%)
  • • Laravel 12 + PHP 8.3
  • • Next.js 16 + React 19
  • • Expo 55 + RN 0.83
  • • NestJS (chat-service)
  • • MySQL 8 + Redis
  • • Sanctum auth
  • • GitHub Actions CI
➕ ADD (9 libs)
  • • stancl/tenancy
  • • spatie/laravel-activitylog
  • • owen-it/laravel-auditing
  • • spatie/laravel-model-states
  • • laravel-workflow/laravel-workflow
  • • spatie/laravel-permission
  • • laravel/scout + Horizon
  • • laravel/reverb
  • • LangChain.js + Vercel AI SDK
🏗️ INFRA (3)
  • • Meilisearch (search)
  • • n8n (integration low-code)
  • • Langfuse (AI observability)
  • • pgvector (RAG)
  • • MinIO/Spaces (S3)
  • • OpenTelemetry + Grafana
❌ KHÔNG trong 12 tháng đầu
Microservices • Kubernetes • Kafka • Temporal standalone • OpenAI Assistants API • Python migration

🗓️ Roadmap 4 Phase — 10-13 tháng

Phase 1 — Foundation

3 tháng • 80 PW

Trust Layer • Permission DB • Observability • Repository pattern. Chuẩn bị nền cho multi-tenant.

Phase 2 — Multi-Tenant SaaS

4 tháng • 110 PW

stancl/tenancy • tenant_id backfill • State machines • Meilisearch • Reverb • Canary tenant pilot.

Phase 3 — V4 Core

3 tháng • 100 PW

Workflow engine • AI Orchestrator • 3 AI agents đầu • n8n • Redis Streams • pgvector RAG.

Phase 4 — VIỆC XANH 247

3 tháng • 90 PW

Ứng lương + KYC + SePay • Ví quyền lợi ledger • Bảo hiểm partner • AI advisor • 4 AI agents còn lại.

8
Dev core
~400
Person-weeks
~$340K
Budget 13 tháng
0%
Rewrite from zero