K钢使用场景流程

业务场景

以下是演示EMS系统安装部署及使用

准备工作

请确保您的本地计算机安装了以下软件：

• Docker
• VS Code (推荐安装 Python 插件)
• Node.js (版本 20 或以上)
• Python 3.12.5 (注意：README建议避免使用 3.12.6 或更高版本)
• DBeaver (或类似的数据库连接工具)

接下来，请按照 README.md 中的步骤完成环境准备：

1. 下载 Docker 镜像包: 根据 README.md 的说明，使用 docker-compose 或直接 docker pull/tag 命令准备 postgres:16 和 redis:latest 镜像。

   # 示例 (具体命令请参考 README.md)
   # docker-compose -f mes-compose.yml -p easy up -d

2. 拷贝环境变量文件:

   cp .env.template dev.env

   • 您可以根据需要修改 dev.env 文件中的环境变量。
3. 启动基础服务 (PostgreSQL 和 Redis):

   docker-compose -f mes-compose.yml -p easy up -d
   # 或者参考 README.md 中的其他启动方式

   • 启动后，请检查容器是否成功运行，并尝试使用 DBeaver 连接数据库。

启动系统服务

1. 安装后端依赖:
   • 确保 pip 是最新版本：pip install --upgrade pip
   • 安装项目依赖：

     pip install -e .
     # 或者使用阿里云镜像加速：
     # pip install -e . -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

2. 数据库初始化:
   • 在 VS Code 中，确保选择了正确的 Python 解释器 (3.12.5)。
   • 打开 VS Code 的 Debug 视图。
   • 选择并运行名为 Server Cli - init-test 的调试配置。
3. 运行后端服务:
   • 在 VS Code 的 Debug 视图中。
   • 选择并运行名为 Web API Server - 8000 的调试配置。服务将在 8000 端口启动。
4. 安装前端依赖:

   npm install
   # 或者
   # yarn install

5. 启动前端服务:

   npm run dev

6. 访问系统:
   • 在浏览器中打开 http://localhost:8881 (或根据您的配置确定的地址)。