文档 / 开始使用
快速开始
两种方式任选:直接安装 2.0 候选版部署包,或者在 Windows 上从源码运行。只想先看看效果,可以用在线演示,无需安装。
安装 2.0 候选版
从发布页下载部署包和校验文件,先校验再解压。
| 文件 | 说明 |
|---|---|
| qiheng-erp-2.0.0-rc.1.zip | 后端、前端、移动端和数据库迁移脚本 |
| qiheng-erp-2.0.0-rc.1.zip.sha256 | SHA-256 校验值 |
# PowerShell:比对输出与 .sha256 文件中的值 Get-FileHash .\qiheng-erp-2.0.0-rc.1.zip -Algorithm SHA256
解压后按部署说明配置 JDK 21、MySQL 8.0.46、Redis 和入口代理,再初始化企业和管理员。
候选版提示2.0.0-rc.1 是预发布版本,适合试用和验收。正式用于生产前请先在测试环境完成升级演练。
在 Windows 从源码运行
准备 Git、PowerShell 7、JDK 21、Maven、Node.js 24、npm 和 Redis,启动 MySQL 8.0.46。首次安装请按本机环境说明准备建库与授权账号,在当前终端设置 DB_USERNAME 和 DB_PASSWORD。
git clone --branch v2.0.0-rc.1 --single-branch https://github.com/qingyu6688/qiheng-erp.git cd qiheng-erp # JDK 和 Redis 路径按本机安装位置填写 pwsh -NoProfile -File ./scripts/prepare-local.ps1 -JavaHome 'D:/tools/jdk-21' -RedisDirectory 'D:/tools/redis' npm --prefix erp-web ci
在项目根目录开两个终端,分别启动后端和前端:
pwsh -File ./scripts/project.ps1 serverpwsh -File ./scripts/project.ps1 web打开 http://127.0.0.1:5173,企业编码 DEMO,用户名 admin,初始密码见本机私有 .env 中的 ERP_DEV_ADMIN_PASSWORD。
密码不在文档里初始密码只写在你本机的
.env,不会出现在仓库和官网中。完成第一笔业务
- 选择公司并准备资料:维护仓库、客户、供应商、商品和结算账户,确认业务日期在开放的会计期间。
- 按需导入期初:已有库存或往来余额时,先录入期初并复核过账。
- 完成一笔采购:审批采购订单,收货过账,登记付款并与应付核销。
- 完成一笔销售:审批销售订单,发货并登记签收,收款后与应收核销。
- 按岗位核对结果:仓库看库存和收发记录,财务看应收应付和资金报表。
可选:启用 AI 服务
AI 模块是独立服务,不启用也不影响上面的流程。启用后可以导入知识文档、使用知识问答和智能查数。配置模型提供方、向量与重排模型的步骤见《人工智能使用与验收》。