文档 / 开始使用

快速开始

两种方式任选:直接安装 2.0 候选版部署包,或者在 Windows 上从源码运行。只想先看看效果,可以用在线演示,无需安装。

安装 2.0 候选版

从发布页下载部署包和校验文件,先校验再解压。

文件说明
qiheng-erp-2.0.0-rc.1.zip后端、前端、移动端和数据库迁移脚本
qiheng-erp-2.0.0-rc.1.zip.sha256SHA-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 server
pwsh -File ./scripts/project.ps1 web

打开 http://127.0.0.1:5173,企业编码 DEMO,用户名 admin,初始密码见本机私有 .env 中的 ERP_DEV_ADMIN_PASSWORD。

密码不在文档里初始密码只写在你本机的 .env,不会出现在仓库和官网中。

完成第一笔业务

  1. 选择公司并准备资料:维护仓库、客户、供应商、商品和结算账户,确认业务日期在开放的会计期间。
  2. 按需导入期初:已有库存或往来余额时,先录入期初并复核过账。
  3. 完成一笔采购:审批采购订单,收货过账,登记付款并与应付核销。
  4. 完成一笔销售:审批销售订单,发货并登记签收,收款后与应收核销。
  5. 按岗位核对结果:仓库看库存和收发记录,财务看应收应付和资金报表。

可选:启用 AI 服务

AI 模块是独立服务,不启用也不影响上面的流程。启用后可以导入知识文档、使用知识问答和智能查数。配置模型提供方、向量与重排模型的步骤见《人工智能使用与验收》。