快速开始
pk-commerce-platform 是巴基斯坦电商站群平台。所有站点在开发目录下均统一使用 Vite 驱动，并使用 brand.js 进行品牌配置：
- 电商站：静态展示站点（使用 Vite 构建，通过
brand.js配置品牌信息）。 - 技术咨询站：Vue 3 + Vite + Pinia，接
pk-order-hub订单 API（通过brand.js配置品牌信息）。
所有站点必须统一打包输出至 dist 目录。
整体架构
项目结构
pk-commerce-platform/
├── sites/ # 所有站点；标准结构为 sites/<公司名>/<域名>/
│ ├── registry.json # 站点注册表
│ ├── BOUNCENET/
│ │ └── techconsult.site/
│ ├── TROUGHNET/
│ │ └── technologyconsult.org/
│ ├── RELIABLE/
│ │ └── thereliabletechnologies.com/
│ └── INSPIREINNO/
│ └── inspireinnostore.com/
├── factory/ # 建站工厂和部署日志
├── scripts/ # setup / deploy / order 脚本
├── docs/ # VitePress 文档
└── pay-methods/ # 支付 logo SSOT关联项目
| 项目 | 说明 | 仓库 |
|---|---|---|
pk-order-hub | 统一订单 API（Hono.js + MongoDB） | gitlab:pk/pk-order-hub |
pk-order-admin | 订单管理后台（Vue 3 + Naive UI） | gitlab:pk/pk-order-admin |
pk-commerce-platform | 前台站群（本项目） | gitlab:pk/pk-commerce-platform |
安装依赖
bash
npm run setup脚本会自动识别 pnpm / yarn / npm，并安装根目录和所有已登记站点的依赖。
部署站点
bash
npm run deploy:web
npm run deploy:web -- bazaar.techconsult.site
npm run deploy:web -- --all部署脚本会执行 build、Cloudflare Pages deploy、部署日志更新、git commit，并在 push 前先同步远端 main。
新增站点
bash
node factory/intake.mjs按提示输入域名、品类、支付方式后生成 factory/latest.json，再交给 agent 执行建站。
环境变量
每个站点根目录放 .env.local：
env
# 本地调试时指向本地 API，留空则自动用 api.{domain}
VITE_ORDER_API_BASE=http://localhost:4000生产不需要设置，orderApi.js 会自动推导 https://api.{domain}。