# 五金小店

**Repository Path**: johnson191008/hardware-store

## Basic Information

- **Project Name**: 五金小店
- **Description**: 为五金零售商家设计并开发了一款智能小程序，核心解决传统门店产品型号复杂、客户查找困难的问题。项目集成了商品展示、多维度检索与创新的以图识图功能，显著提升了店铺的数字化服务水平与客户体验。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-25
- **Last Updated**: 2025-11-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: PHP, Laravel

## README

# 五金商店

## 关于本项目

这是一个基于 [Laravel](https://laravel.com) 框架开发的硬件商品管理系统。项目分为前后端两部分，前端为微信小程序，后端基于 Laravel 框架实现，提供了商品管理、分类管理、用户认证、图像识别搜索等功能。

## 项目结构

- **Rear-end**：后端 Laravel 项目，提供 RESTful API 和管理后台。
- **Rear-front**：微信小程序前端，用于用户交互。
- **dl-service**：图像识别服务，提供基于图像特征提取的搜索功能。

## 主要功能

### 后端 (Laravel)

- **管理后台**
  - 用户认证 (登录、登出)
  - 商品管理 (增删改查)
  - 分类管理 (增删改查、分类树展示)
  - 仪表盘 (展示低库存商品等统计信息)

- **API 接口**
  - 商品列表与搜索
  - 图像上传与识别
  - 用户认证

- **图像识别**
  - 使用 `dl-service` 提供的图像特征提取接口，实现基于图像的相似商品搜索。

### 前端 (微信小程序)

- 首页与商品展示
- 图像搜索功能
- 用户登录
- 联系页面

## 技术栈

- **后端**：PHP + Laravel 框架
- **前端**：微信小程序 (WXML, WXSS)
- **图像识别**：Python + Flask 提供特征提取服务
- **数据库**：MySQL
- **缓存与队列**：Redis（用于图像识别任务队列）

## 安装与部署

### 后端部署

1. 克隆项目：
   ```bash
   git clone https://gitee.com/johnson191008/hardware-store.git
   cd Rear-end
   ```

2. 安装依赖：
   ```bash
   composer install
   ```

3. 配置数据库：
   修改 `.env` 文件，配置数据库连接信息。

4. 数据库迁移与填充：
   ```bash
   php artisan migrate
   php artisan db:seed
   ```

5. 启动服务：
   ```bash
   php artisan serve
   ```

### 微信小程序部署

1. 使用微信开发者工具导入项目。
2. 修改 `app.js` 中的 `API_BASE_URL` 为后端服务地址。
3. 编译并运行。

### 图像识别服务部署

1. 进入 `dl-service` 目录：
   ```bash
   cd dl-service
   ```

2. 安装依赖：
   ```bash
   pip install -r requirements.txt
   ```

3. 启动服务：
   ```bash
   python feature_extractor.py
   ```

## 贡献与维护

欢迎提交 Issue 和 Pull Request。请遵循项目的 [代码规范](https://laravel.com/docs/contributions#code-of-conduct)。

## 安全漏洞

如发现安全漏洞，请发送邮件至 [taylor@laravel.com](mailto:taylor@laravel.com)。

## 许可证

本项目基于 [MIT License](https://opensource.org/licenses/MIT) 开源。