快速入门

本指南将帮助您在本地机器上搭建 Nodesify Admin 的开发环境。

前提条件

在开始之前，请确保您已安装以下软件：

• Node.js：20.12.0 或更高版本。
• pnpm：10.0.0 或更高版本。
• Docker：用于运行数据库 (PostgreSQL) 和缓存 (Valkey/Redis)。

安装步骤

1. 克隆仓库：

   git clone https://github.com/your-org/nodesify-admin.git
   cd nodesify-admin

2. 安装依赖：

   pnpm install

启动基础架构

1. 启动 Docker 服务： 我们使用 Docker Compose 来管理 PostgreSQL 数据库和 Valkey (Redis) 缓存。

   cd docker
   # 在后台启动服务
   docker compose up -d

   • PostgreSQL：映射端口 54331
   • Valkey：映射端口 63791

2. 初始化数据库： 运行设置脚本以生成 Prisma 客户端、执行迁移并播种默认数据。

   cd ../apps/backend-api
   pnpm db:setup

   • 这将创建默认用户（如 nodesify, admin），初始密码为 123456。

运行应用

返回根目录以启动开发环境。

# 返回根目录
cd ../..

# 同时启动前端和后端
pnpm dev

• 前端界面：http://localhost:5555
• 后端 API：http://localhost:5320
• 文档中心：http://localhost:5173 (如果运行 pnpm dev:docs)

常用命令

命令	描述
pnpm dev	启动全栈环境（前端 + 后端）。
pnpm dev:ele	仅启动前端项目 (apps/web-ele)。
pnpm dev:docs	启动文档服务器 (apps/docs)。
pnpm build	为生产环境构建所有应用。
pnpm check	在整个 monorepo 中运行类型检查和 lint 检查。
pnpm clean	移除 node_modules 和构建产物。

默认账号

数据库已预置以下账号（密码均为 123456）：

• 超级管理员：nodesify
• 管理员：admin
• 普通用户：jack
• 财务用户：finance_user
• HR 用户：hr_user
• 仓库用户：warehouse_user