新增站点(前端开发版)
先确认你要做哪种站,再选对应模板。
两种站点
| 电商站 | 技术咨询站 | |
|---|---|---|
| 能干什么 | 展示页面,纯内容 | 浏览商品、加购物车、下单、支付 |
| 技术栈 | Vite (工程化静态) | Vue 3 + Vite + Pinia |
| 配置方式 | src/config/brand.js | src/config/brand.js |
| 产物目录 | dist | dist |
| 模板 | deals.techconsult.site | bazaar.techconsult.site |
前提
- Node.js ≥ 18
- pnpm(
npm i -g pnpm) - GitLab 仓库权限
核心开发规范
- 统一打包目录:所有站点必须配置打包输出为
dist。 - 统一配置入口:所有站点必须使用
src/config/brand.js管理品牌和公司信息。 - 严禁纯 HTML:开发目录下必须是工程化项目,支持
npm run build。
A. 新增技术咨询站(Vue 流程)
1. 复制模板
bash
cd sites
cp -r bazaar.techconsult.site mydomain.techconsult.site
cd mydomain.techconsult.site
rm -rf node_modules dist .wrangler .gitignore
pnpm install2. 改品牌信息
编辑 src/config/brand.js(具体字段参考模板)。
3. 本地验证
bash
pnpm dev # 开发服务器
pnpm build # 必须确保生成 dist 目录B. 新增电商站(静态工程化流程)
即使业务上是静态展示,也必须走工程化流程:
- 复制模板:使用
deals.techconsult.site的工程化版本。 - 配置信息:同样通过
src/config/brand.js更换站点名称和公司名。 - 生成产物:执行
npm run build确保输出至dist。
共同步骤
注册站点
编辑项目根目录 sites/registry.json,加一条:
json
{ "domain": "mydomain.techconsult.site", "company": "your-group", "status": "wip", "deployed": false }提交
- 新建分支:
git checkout -b feat/add-mydomain - 提交更改:
bash
git add sites/mydomain.techconsult.site sites/registry.json
git commit -m "feat: 新增 mydomain.techconsult.site"
git push origin feat/add-mydomain- 提交 Merge Request:在 GitLab 提交 MR。
提交 MR 后,联系项目部署负责人 webkubor 进行部署。
红线
- 站点对外文案使用英文;commit message 必须使用中文,类型前缀可保留,例如
feat: 新增 mydomain.techconsult.site。 - 价格统一
Rs.(PKR),不要用 $ 或 ¥ - 电商站固定支付:JazzCash / Easypaisa / COD,不需要改支付逻辑
- 订单状态显示 "Order Processing / Awaiting Review",禁止显示 "Order Success"
- 移动端优先
部署负责人 (webkubor) 的操作
- Cloudflare Pages 新建项目
- DNS 解析 → CF Pages
- CF Tunnel 加
api.{domain}→ 服务器(仅技术咨询站) - 跑
node scripts/deploy-web.mjs <domain>