storaji 的安装和配置教程

项目的基础介绍和主要的编程语言

storaji 是一个轻量级、响应式的库存管理系统，适用于 Windows、macOS 和 Linux 操作系统。该项目旨在为小型至中型企业提供现代且直观的库存管理解决方案。storaji 的主要编程语言包括 PHP 和 Vue.js，它结合了后端的 Laravel 框架和前端的 Angular 框架。

项目使用的关键技术和框架

• Electron: 用于将前端应用打包成桌面应用程序。
• Angular: 前端框架，用于构建单页面应用程序（SPA）。
• Laravel: 后端 PHP 框架，提供路由、会话、数据库迁移等功能。
• UIkit: 前端组件库，用于快速开发响应式界面。
• Tus: 用于实现文件上传功能。
• Highcharts: 用于数据可视化和图表。

项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保您的系统中安装了以下依赖项：

1. Node.js（版本 ^8 或更高）
2. PHP（版本 ^7 或更高）
3. PHP Composer

对于 Linux 用户，还需要安装以下命令行工具：

sudo apt install -y icnsutils graphicsmagick

安装步骤

后端安装

1. 克隆项目到本地机器：

git clone https://github.com/IndomaximTechID/storaji.git

2. 打开终端，并进入克隆的文件夹：

cd storaji

3. 安装依赖项：

composer install

4. 复制环境变量文件：

cp .env.example .env

5. 修改 .env 文件，配置数据库信息。

6. 生成应用密钥：

php artisan key:generate

7. 迁移数据库：

php artisan migrate

8. 安装 OAuth 访问令牌：

php artisan passport:install

9. 启动 PHP 内置服务器：

php artisan serve

现在，后端已经准备好接受来自前端的请求，通常是在 https://localhost:8000/api。

前端安装

1. 克隆前端项目到本地机器：

git clone https://github.com/IndomaximTechID/storaji-ui.git

2. 打开终端，并进入克隆的文件夹：

cd storaji-ui

3. 修改 src/app/shared/classes/app.ts 文件中的 api 变量，将其设置为本地 API 服务器地址，通常是 api: 'https://localhost:8000/api'。

4. 安装依赖项：

npm install

5. 以 Web 形式运行应用：

npm run ng:serve

应用将在 https://localhost:4200 上运行。

6. 若在桌面应用上测试，运行：

npm start

进行构建并作为桌面应用运行。

7. 进行代码检查和测试：

npm test

确保所有代码通过检查和测试。

按照上述步骤操作，您应该能够成功安装和配置 storaji 项目。如果在安装过程中遇到任何问题，可以通过查看项目的 README 文件或访问相关社区寻求帮助。