开发指南

面向业务接入方

如果你们是业务系统开发团队（平板 App 与认证体系由平台方提供，只需开发自己的业务前后端并接入认证能力），请直接阅读：

👉 第三方业务系统接入指南 —— 交付边界、架构、教学 Demo（before/after）使用方法、前后端接入六步与端到端联调验收。

开发环境要求

工具	版本	用途
Node.js	≥ 20.19	前端构建
pnpm	≥ 8.8	包管理（前端必须）
Python	3.8+（建议 3.11）	后端开发
DevEco Studio	对应 API 6.1.1(24)	鸿蒙开发
Git / repo	2.x	单仓 / 多仓管理

获取工作区

mkdir qxj-project && cd qxj-project
repo init -u http://192.168.168.51:3000/qxj-project/manifest.git
repo sync

单独克隆文档站：git clone http://192.168.168.51:3000/qxj-project/qxj-vitepress-page.git。

repo 管理仓的 .git 是符号链接，Windows 上 git 操作走 WSL。

代码规范

提交信息格式

type(scope): subject

body

footer

类型：

• feat: 新功能
• fix: 修复 Bug
• docs: 文档更新
• style: 代码格式
• refactor: 重构
• test: 测试
• chore: 构建/工具

分支管理（现状）

鸿蒙浏览器：
  main                 # 稳定线（单页模式，4.1.x）
  dev                  # 功能线（多标签 v2，5.2.x）
  feature/*            # 19 个功能分支

其他仓库：
  main                 # 稳定基线
  feature/*、fix/*     # 功能 / 修复分支（后端、前端、SDK 仓当前在此推进）

构建命令

# 前端开发
cd qxj-frontend-admin && pnpm dev

# 后端开发
cd qxj-backend-admin && python manage.py runserver 0.0.0.0:4607

# 鸿蒙构建
cd qxj_harmony_next_pad_nsp_browser && hpack pd  # Debug
cd qxj_harmony_next_pad_nsp_browser && hpack pr  # Release

# 文档站点
cd qxj-vitepress-page && pnpm dev

下一步

• 🔌 第三方业务系统接入指南 - 业务方如何用 SDK 接入认证与加密能力
• 📖 快速开始 - 详细环境搭建
• 🏗️ 架构设计 - 了解系统架构