GVI Phase 3 — Activation Playbook

📊 Trạng Thái Hiện Tại (2026-07-20)

🔐 Bước 3.1 — Test Admin Login

Thông tin đăng nhập

Checklist kiểm tra sau login

• Truy cập https://goldvninvest.online/en/login → đăng nhập thành công → redirect /en/user/dashboard
• Truy cập https://goldvninvest.online/en/admin → Admin panel load (không 500)
• Admin > CRM > Users → Danh sách user hiển thị được (role_permission OK)
• Admin > Finance > Deposit Gateways → Có gateway hoạt động
• Admin > System > Settings → Các key cấu hình load được (149 keys)
• Đổi mật khẩu superadmin@example.com ngay
• Bật 2FA cho tài khoản admin chính (Admin > Profile > Security)

Fix nhanh nếu Admin Panel vẫn lỗi

pm2 logs backend --lines 50   # Xem lỗi mới nhất
pm2 restart backend           # Restart backend, reload cache
node scripts/redis-seed-cache.js --force  # Warm Redis cache

🗄️ Bước 3.2 — Tạo Bảng internal_wallet & payment_provider_config

# Từ thư mục gốc (/var/app/public_html)
cd /var/app/public_html

# DRY-RUN trước — xem thay đổi mà không ghi DB
node backend/scripts/create-internal-wallet-table.mjs

# Kết quả mong đợi DRY-RUN:
# [CREATE] Bảng 'internal_wallet'.
# [ADD]    INDEX 'internalWalletProviderIdx' ...
# DRY-RUN — 5 thay đổi cần áp dụng. Chạy lại với --apply.

# APPLY thực tế
node backend/scripts/create-internal-wallet-table.mjs --apply

mysql -u goldvninvest v5 -e "
CREATE TABLE IF NOT EXISTS \`payment_provider_config\` (
  \`id\`                  CHAR(36)      NOT NULL,
  \`name\`                VARCHAR(100)  NOT NULL UNIQUE,
  \`provider\`            ENUM('STRIPE','PAYPAL','COINBASE','NOWPAYMENTS',
                              'MANUAL','VIETQR','VNPAY','MOMO','ZALOPAY')
                            NOT NULL,
  \`environment\`         ENUM('SANDBOX','PRODUCTION') NOT NULL DEFAULT 'SANDBOX',
  \`credentials\`         JSON NULL,
  \`supportedCurrencies\` JSON NULL,
  \`webhookSecret\`       VARCHAR(500) NULL,
  \`callbackUrl\`         VARCHAR(1000) NULL,
  \`status\`              ENUM('ACTIVE','INACTIVE','ERROR') NOT NULL DEFAULT 'INACTIVE',
  \`priority\`            INT NOT NULL DEFAULT 10,
  \`createdAt\`           DATETIME NOT NULL,
  \`updatedAt\`           DATETIME NOT NULL,
  PRIMARY KEY (\`id\`),
  INDEX \`paymentProviderConfigStatusIdx\` (\`status\`),
  INDEX \`paymentProviderConfigProviderIdx\` (\`provider\`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
"

mysql -u goldvninvest v5 -e "SHOW TABLES LIKE 'internal_wallet'; SHOW TABLES LIKE 'payment_provider_config';"
# Expected: 2 tables listed

pm2 restart backend  # Backend cần restart để nhận model mới

🏦 Bước 3.3 — Điền Bank Account (internal_wallet)

Mã ngân hàng Napas (bankCode) — tham khảo nhanh

SQL — Insert tài khoản ngân hàng nhận tiền (thay STK thật)

-- Ưu tiên 1: Tài khoản nhận chính (VD: VCB)
INSERT INTO internal_wallet
  (id, name, provider, currency, balance,
   bankAccountNumber, bankName, bankCode, accountHolderName,
   isDepositWallet, isWithdrawWallet,
   minDeposit, maxDeposit, status,
   accountDetails, createdAt, updatedAt)
VALUES (
  UUID(),
  'VCB Nhận Nạp Chính',
  'VIETQR',
  'VND',
  0,
  'STK_THUC_TE_VCB',         -- ← thay bằng số TK thật (VD: 0071000123456)
  'Vietcombank',
  '970436',                   -- BIN Napas của VCB
  'CONG TY TNHH GVI',        -- ← tên chủ TK đúng như ngân hàng
  1,  -- isDepositWallet
  0,  -- isWithdrawWallet
  50000,     -- minDeposit: 50,000 VND
  500000000, -- maxDeposit: 500 triệu VND
  1,
  JSON_OBJECT(
    'qrTemplate',  'https://img.vietqr.io/image/970436-STK_THUC_TE_VCB-compact2.png',
    'napasCode',   '970436',
    'transferNote', 'GVN{userId}'
  ),
  NOW(), NOW()
);

-- Ưu tiên 2: Tài khoản dự phòng (VD: Techcombank)
INSERT INTO internal_wallet
  (id, name, provider, currency, balance,
   bankAccountNumber, bankName, bankCode, accountHolderName,
   isDepositWallet, isWithdrawWallet,
   minDeposit, maxDeposit, status,
   accountDetails, createdAt, updatedAt)
VALUES (
  UUID(),
  'TCB Dự Phòng',
  'VIETQR',
  'VND',
  0,
  'STK_THUC_TE_TCB',         -- ← thay bằng số TK thật
  'Techcombank',
  '970407',
  'CONG TY TNHH GVI',
  1, 0,
  50000, 500000000,
  1,
  JSON_OBJECT('napasCode', '970407'),
  NOW(), NOW()
);

-- Xác nhận
SELECT name, bankName, bankAccountNumber, bankCode,
       accountHolderName, isDepositWallet, status
FROM internal_wallet;

Cập nhật .env sau khi điền TK

💳 Bước 3.4 — Cấu Hình VietQR & VNPAY

A. VietQR (Casso / MB Open Banking)

Insert VietQR vào payment_provider_config

INSERT INTO payment_provider_config
  (id, name, provider, environment, credentials,
   supportedCurrencies, webhookSecret, callbackUrl,
   status, priority, createdAt, updatedAt)
VALUES (
  UUID(),
  'VietQR Production',
  'VIETQR',
  'PRODUCTION',
  JSON_OBJECT(
    'bankCode',     '970436',         -- BIN Napas ngân hàng nhận
    'accountNo',    'STK_THUC_TE',    -- ← thay bằng số TK thật
    'accountName',  'CONG TY TNHH GVI',
    'memoPrefix',   'GVN',
    'cassoToken',   'CASSO_API_TOKEN_DAY',  -- ← token từ casso.vn
    'ipnSecretKey', 'WEBHOOK_SECRET_DAY'    -- ← secret từ casso.vn
  ),
  JSON_ARRAY('VND', 'VNL'),
  'WEBHOOK_SECRET_DAY',   -- phải giống ipnSecretKey
  'https://goldvninvest.online/api/webhook/vietqr',
  'ACTIVE',
  1,
  NOW(), NOW()
);

-- Thêm webhook secret vào .env
-- VIETQR_WEBHOOK_SECRET=WEBHOOK_SECRET_DAY

Update .env — VietQR secrets

Luồng hoạt động VietQR tự động

B. VNPAY (Sandbox → Production)

INSERT INTO payment_provider_config
  (id, name, provider, environment, credentials,
   supportedCurrencies, webhookSecret, callbackUrl,
   status, priority, createdAt, updatedAt)
VALUES (
  UUID(),
  'VNPay Sandbox',
  'VNPAY',
  'SANDBOX',
  JSON_OBJECT(
    'tmnCode',    'YOUR_TMN_CODE',     -- ← từ VNPay developer portal
    'hashSecret', 'YOUR_HASH_SECRET',  -- ← từ VNPay developer portal
    'payUrl',     'https://sandbox.vnpayment.vn/paymentv2/vpcpay.html',
    'returnUrl',  'https://goldvninvest.online/finance/deposit/vnpay/return',
    'ipnUrl',     'https://goldvninvest.online/api/webhook/vnpay'
  ),
  JSON_ARRAY('VND'),
  NULL,
  'https://goldvninvest.online/api/webhook/vnpay',
  'INACTIVE',   -- Để INACTIVE cho đến khi test sandbox xong
  2,
  NOW(), NOW()
);

-- Khi test sandbox thành công → đổi sang PRODUCTION + ACTIVE:
UPDATE payment_provider_config
SET environment = 'PRODUCTION', status = 'ACTIVE',
    credentials = JSON_SET(credentials,
      '$.payUrl', 'https://pay.vnpay.vn/vpcpay.html',
      '$.tmnCode', 'PROD_TMN_CODE',
      '$.hashSecret', 'PROD_HASH_SECRET'
    )
WHERE provider = 'VNPAY';

C. Xác nhận cấu hình thanh toán

-- Kiểm tra payment providers
SELECT name, provider, environment, status, priority
FROM payment_provider_config
ORDER BY priority;

-- Kiểm tra internal wallet
SELECT name, bankName, bankAccountNumber, bankCode,
       isDepositWallet, status
FROM internal_wallet
WHERE isDepositWallet = 1;

-- Smoke test IPN endpoint (thay memo và amount thật)

curl -X POST https://goldvninvest.online/api/webhook/vietqr \
  -H "Content-Type: application/json" \
  -d '{"id":"TEST-001","amount":100000,"description":"GVN","bankCode":"VCB"}'
# Expected: {"success":true,"processed":{...}}

🪪 Bước 3.5 — eKYC C06 qua VNPT (ekyc.vnpt.vn)

Bước 3.5.1 — Đăng ký & lấy token VNPT eKYC

Bước 3.5.2 — Seed kyc_verification_service VNPT

-- Thêm VNPT eKYC service (VNPT C06 — Căn cước công dân)
INSERT INTO kyc_verification_service
  (id, name, description, type, integrationDetails, createdAt, updatedAt)
VALUES (
  'vnpt-ekyc-1',
  'VNPT eKYC — C06 Bộ Công An',
  'Xác minh danh tính công dân Việt Nam qua cơ sở dữ liệu C06 Bộ Công An. Hỗ trợ CCCD gắn chip, ePassport, nhận diện khuôn mặt liveness.',
  'VNPT_EKYC',
  JSON_OBJECT(
    'features', JSON_ARRAY(
      'CCCD_CHIP',
      'C06_LOOKUP',
      'FACE_MATCHING',
      'LIVENESS_CHECK',
      'EPASSPORT'
    ),
    'apiBase',      'https://api.idg.vnpt.vn',
    'cdnBase',      'https://ekyc-web.vnpt.vn',
    'sdkGuide',     'https://ekyc.vnpt.vn/vi/docs/web-sdk',
    'tokenKey',     'THAY_BANG_TOKEN_KEY_THUC_TE',
    'tokenId',      'THAY_BANG_TOKEN_ID_THUC_TE',
    'authorization', 'THAY_BANG_ACCESS_TOKEN_THUC_TE'
  ),
  NOW(), NOW()
);

-- Xác nhận
SELECT id, name, type FROM kyc_verification_service;

Bước 3.5.3 — Seed kyc_level cho VNPT

-- Level 1: Xác minh CCCD cơ bản (Rút dưới 50 triệu/ngày)
INSERT INTO kyc_level
  (id, name, description, level, fields, features, status, serviceId, createdAt, updatedAt)
VALUES (
  UUID(),
  'KYC Level 1 — Xác minh CCCD',
  'Xác minh Căn cước công dân qua VNPT eKYC. Cho phép nạp/rút tối đa 50 triệu VND/ngày.',
  1,
  JSON_ARRAY(
    JSON_OBJECT('name', 'frontImage',   'title', 'Ảnh mặt trước CCCD',  'type', 'image', 'required', JSON_VALUE('true','$')),
    JSON_OBJECT('name', 'backImage',    'title', 'Ảnh mặt sau CCCD',   'type', 'image', 'required', JSON_VALUE('true','$')),
    JSON_OBJECT('name', 'selfieImage',  'title', 'Ảnh selfie nhận diện', 'type', 'image', 'required', JSON_VALUE('true','$'))
  ),
  JSON_ARRAY('DEPOSIT', 'WITHDRAW', 'TRADE'),
  'ACTIVE',
  'vnpt-ekyc-1',
  NOW(), NOW()
);

-- Level 2: Xác minh nâng cao (tra cứu C06 + liveness — Rút trên 50 triệu)
INSERT INTO kyc_level
  (id, name, description, level, fields, features, status, serviceId, createdAt, updatedAt)
VALUES (
  UUID(),
  'KYC Level 2 — C06 + Liveness',
  'Xác minh nâng cao: tra cứu C06 Bộ Công An + nhận diện khuôn mặt liveness. Không giới hạn giao dịch.',
  2,
  JSON_ARRAY(
    JSON_OBJECT('name', 'frontImage',   'title', 'Ảnh mặt trước CCCD gắn chip', 'type', 'image'),
    JSON_OBJECT('name', 'backImage',    'title', 'Ảnh mặt sau CCCD gắn chip',  'type', 'image'),
    JSON_OBJECT('name', 'livenessVideo', 'title', 'Video liveness check',          'type', 'video'),
    JSON_OBJECT('name', 'cccdNumber',   'title', 'Số CCCD/CMND',               'type', 'text')
  ),
  JSON_ARRAY('DEPOSIT', 'WITHDRAW_UNLIMITED', 'TRADE', 'P2P', 'FUTURES'),
  'ACTIVE',
  'vnpt-ekyc-1',
  NOW(), NOW()
);

-- Xác nhận
SELECT id, name, level, status, serviceId FROM kyc_level;

Bước 3.5.4 — Cập nhật .env với VNPT credentials

Bước 3.5.5 — Thêm handler VNPT vào check-connection.get.js

// Thêm vào hàm default export, sau block `else if (id.startsWith("deepseek"))`:

else if (id.startsWith("vnpt")) {
  result = await checkVnptEkycConnection();
}

// Thêm hàm checkVnptEkycConnection() vào cuối file:
async function checkVnptEkycConnection() {
  const tokenKey = process.env.VNPT_EKYC_TOKEN_KEY;
  const tokenId  = process.env.VNPT_EKYC_TOKEN_ID;
  const auth     = process.env.VNPT_EKYC_AUTHORIZATION;
  if (!tokenKey || !tokenId || !auth) {
    return { connected: false,
      message: "Missing VNPT_EKYC_TOKEN_KEY / TOKEN_ID / AUTHORIZATION in .env" };
  }
  try {
    const resp = await fetch(
      `https://api.idg.vnpt.vn/ai/v1/server-info`,
      { method: "GET", headers: {
          "token-key":    tokenKey,
          "token-id":     tokenId,
          "Authorization": `Bearer ${auth}`,
          "Content-Type": "application/json"
        }
      }
    );
    if (resp.ok) return { connected: true, message: "VNPT eKYC API reachable" };
    return { connected: false, message: `VNPT eKYC: HTTP ${resp.status}` };
  } catch(e) {
    return { connected: false, message: `VNPT eKYC error: ${e.message}` };
  }
}

Bước 3.5.6 — Seed staking_pools (còn thiếu)

INSERT INTO staking_pools
  (id, name, token, symbol, description, walletType,
   apr, lockPeriod, minStake, maxStake, availableToStake,
   earlyWithdrawalFee, adminFeePercentage, status, isPromoted,
   \`order\`, earningFrequency, autoCompound, externalPoolUrl,
   profitSource, fundAllocation, risks, rewards, createdAt, updatedAt)
VALUES
(UUID(), 'USDT Flexible Savings', 'Tether USD', 'USDT',
 'Gửi USDT linh hoạt, nhận lãi hàng ngày, rút bất kỳ lúc nào.', 'SPOT',
 0.08, 0, 10, NULL, 1000000, 0, 2,
 'ACTIVE', 1, 1, 'DAILY', 0, NULL,
 'Market Making nội bộ', '70% thanh khoản, 30% dự trữ',
 'Rủi ro thị trường thấp', 'APR 8%, rút bất kỳ lúc nào',
 NOW(), NOW()),

(UUID(), 'USDT 30-Day Lock', 'Tether USD', 'USDT',
 'Khoá USDT 30 ngày, nhận APR 12%.', 'SPOT',
 0.12, 30, 50, 100000, 500000, 5, 2,
 'ACTIVE', 1, 2, 'MONTHLY', 1, NULL,
 'Lending + arbitrage', '60% lending, 40% hedge',
 'Không rút trước 30 ngày (phạt 5%)', 'APR 12%, tự động tái tục',
 NOW(), NOW()),

(UUID(), 'GIV Loyalty Pool', 'GIV Token', 'GIV',
 'Pool đặc biệt cho GIV holder. APR 20%, nhận lãi hàng tuần.', 'ECO',
 0.20, 30, 1000, NULL, 0, 5, 1,
 'COMING_SOON', 1, 3, 'WEEKLY', 1, NULL,
 'Phí platform chia sẻ cho GIV holder', '100% phí giao dịch',
 'GIV là token nội bộ', 'APR 20%, nhận GIV hàng tuần',
 NOW(), NOW());

-- Xác nhận
SELECT name, symbol, apr, lockPeriod, status FROM staking_pools;

✅ Checklist Cuối — Phase 3 Complete

Lệnh reload sau tất cả thay đổi

# 1. Restart backend để model nhận bảng mới + .env mới
pm2 restart backend --update-env

# 2. Warm Redis cache với data mới
node scripts/redis-seed-cache.js --force

# 3. Kiểm tra logs không có lỗi mới
pm2 logs backend --lines 100 | grep -E "ERROR|WARN|CRIT"

# 4. Smoke test
curl https://goldvninvest.online/api/health
curl https://goldvninvest.online/api/settings | jq '.total'  # Expected: 149
curl https://goldvninvest.online/api/binary/market | jq '.total'  # Expected: 7