HPDC 平台快速入门

// 1. 项目本地配置 config.js
const appConfig = {
    aql_support: true, // 门禁开关：只有开启且配置了 aql_api 时才执行 AQL
    aql_api_key: "aql_live_5f273b692244",
    aql_secret: "sec_aql_c52b50c178a25561351acea0ce3dc30c"
};

// 2. Web 登录回调处理
function handleHopoAuthCallback(userData) {
    // 门禁判断：若项目未开启 AQL 支持，直接跳过
    if (!appConfig.aql_support || !appConfig.aql_api_key) {
        return { role: 'user', username: userData.username };
    }

    // 动态提取 AQL 校验 Token
    const aqlToken = userData['beBPqGduwTpzrbhp'];
    
    // 管理员角色判定：第 7 位为 'a' 且 第 15 位为 '8'
    if (aqlToken && aqlToken.charAt(6) === 'a' && aqlToken.charAt(14) === '8') {
        console.log("[AQL 触发] 识别到管理员账号，自动赋予该站点原生 Admin 权限！");
        return { role: 'admin', username: userData.username, is_admin: true };
    }

    return { role: 'user', username: userData.username };
}

const crypto = require('crypto');

function generateSignature(secretKey, timestamp, requestBody) {
    const rawPayload = `${timestamp}.${typeof requestBody === 'string' ? requestBody : JSON.stringify(requestBody)}`;
    return crypto.createHmac('sha256', secretKey).update(rawPayload).digest('hex');
}

{
  "code": 200,
  "status": "success",
  "data": {
    "session_id": "cs_pay_998123719283",
    "out_trade_no": "ORDER_20260804_0091",
    "payment_url": "https://pay.hopostudio.xyz/checkout/cs_pay_998123719283",
    "total_amount": 29900,
    "currency": "CNY",
    "expires_at": "2026-08-10T12:00:00Z"
  }
}

{
  "code": 200,
  "status": "success",
  "data": {
    "out_trade_no": "ORDER_20260804_0091",
    "trade_state": "SUCCESS",
    "transaction_id": "hop_tx_881923019283",
    "total_amount": 29900,
    "paid_at": "2026-08-10T09:45:12Z",
    "payment_method": "WECHAT_PAY"
  }
}

{
  "out_trade_no": "ORDER_20260804_0091",
  "out_refund_no": "REFUND_20260810_001",
  "refund_amount": 29900,
  "refund_reason": "用户申请商品退货"
}

{ "out_trade_no": "ORDER_20260804_0091", "reason": "订单已超时关闭" }

{
  "code": "SUCCESS",
  "data": {
    "total": 42,
    "list": [
      { 
        "product_id": "prod_1001", 
        "name": "Hopo Developer Pro 会员", 
        "price": 19900, 
        "stock": 999,
        "status": "active",
        "created_at": 1691234567
      }
    ]
  }
}

const { HopoAuthClient } = require('@hopostudio/hpdc-sdk');

const hopo = new HopoAuthClient({
    clientId: 'vps_hopo',
    clientSecret: 'efa65993b7d6934dd4c123de',
    aqlApiKey: 'aql_live_5f273b692244',
    aqlSecret: 'sec_aql_c52b50c178a25561351acea0ce3dc30c'
});

// 1. 发起登录
app.get('/login', (req, res) => {
    const loginUrl = hopo.getAuthorizationUrl({
        redirectUri: 'https://vps.hopostudio.xyz/auth/callback'
    });
    res.redirect(loginUrl);
});

// 2. 回调处理与 AQL 自动识别
app.get('/auth/callback', async (req, res) => {
    const { user, isAdminByAql } = await hopo.handleCallback(req.query.code, 'https://vps.hopostudio.xyz/auth/callback');
    req.session.user = user;
    req.session.role = isAdminByAql ? 'admin' : 'user';
    res.redirect('/dashboard');
});

const { ShopoClient } = require('@hopostudio/hpdc-sdk');

const shopo = new ShopoClient({
    apiKey: 'hop_live_981273918237',
    apiSecret: 'sec_live_abcdef123456'
});

// 1. 创建支付会话
const session = await shopo.createPaymentSession({
    merchantId: 'mer_shopo_8829',
    outTradeNo: 'ORDER_20260810_001',
    totalAmount: 29900,
    notifyUrl: 'https://myshop.com/api/pay/webhook'
});

// 2. Webhook 自动防重放与 HMAC-SHA256 验签中间件
app.post('/api/pay/webhook', shopo.webhookMiddleware(async (event) => {
    console.log('⚡ 支付成功回调:', event.out_trade_no);
    // 处理业务订单发货...
}));

<!-- 引入 Hopo 官方字体与 UI 样式库 -->
<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=Google+Sans:wght@400;500;700&family=Roboto+Mono:wght@400;500&display=swap" rel="stylesheet">
<link rel="stylesheet" href="https://dev.hopostudio.xyz/css/hopo-design.css">

<!-- 为 body 添加 Hopo 专属画布纹理 -->
<body class="hopo-canvas">
    <div class="hopo-horizon-bar"></div>
    ...
</body>

<!-- 1. Hopo 磨砂悬浮大卡片 -->
<div class="hopo-card">
    <h3>卡片主标题</h3>
    <p>内容说明段落，支持自适应 Google Material 排版。</p>
    <div style="margin-top:16px;">
        <span class="hopo-badge-sys">🛡️ SYS 生态官方</span>
        <span class="hopo-badge-aql">⚡ AQL 已启用</span>
    </div>
</div>

<!-- 2. Hopo 胶囊主操作按钮 -->
<button class="hopo-btn-primary">
    <svg viewBox="0 0 24 24" width="16" height="16" fill="currentColor"><path d="M19 13h-6v6h-2v-6H5v-2h6V5h2v6h6v2z"/></svg>
    创建新应用
</button>
<button class="hopo-btn-outline">次级操作</button>

<!-- 3. Hopo 终端代码视窗 (带 Mac 三色圆点) -->
<div class="hopo-code-window">
    <div class="hopo-code-header">
        <div>
            <div class="hopo-mac-dots">
                <span class="hopo-dot hopo-dot-red"></span>
                <span class="hopo-dot hopo-dot-yellow"></span>
                <span class="hopo-dot hopo-dot-green"></span>
            </div>
            <span>terminal.sh</span>
        </div>
        <span style="color:#94a3b8; font-size:11px;">BASH</span>
    </div>
    <pre class="code-content">npm install @hopostudio/hpdc-sdk</pre>
</div>