# Smart POS SaaS - 多店零售商 POS 系统
## 项目概述
**Smart POS SaaS** 是一个基于 Laravel 构建的多店零售商 POS 系统。该系统提供完整的销售点管理功能，支持多租户架构，适合连锁店和多个零售店使用。
## 主要功能
### 核心功能
- **多租户架构** - 支持多个商店/租户
- **POS 销售** - 快速结账和销售
- **库存管理** - 实时库存跟踪
- **产品管理** - 产品目录管理
- **客户管理** - 客户信息和历史
- **员工管理** - 员工账号和权限
- **报告统计** - 销售和库存报告
- **发票打印** - 热敏打印机支持
- **条码扫描** - 条码生成和扫描
- **二维码支持** - 支付二维码
### 支付网关
- Stripe
- Razorpay
- PayPal
- 现金支付
### 用户角色
- **管理员** - 系统全面管理
- **店长** - 单店管理
- **收银员** - 收银操作
- **库存管理员** - 库存管理
## 技术栈
### 后端
- **框架**: Laravel 10.23
- **PHP 版本**: ^8.1
- **数据库**: MySQL
- **多租户**: stancl/tenancy ^3.8
### 主要依赖包
- Laravel Framework ^10.23
- Laravel Sanctum ^3.2 (API 认证)
- Spatie Laravel Permission ^5.8 (权限管理)
- Spatie Laravel Media Library ^10.7 (媒体管理)
- Spatie Laravel Query Builder ^5.1
- Spatie Laravel JSON API Paginate ^1.12
- Stripe PHP ^16.4
- Razorpay ^2.9
- PayPal SDK ^3.0
- Twilio SDK ^8.8 (短信)
- Vonage Client ^4.2
- Paystack PHP ^2.2
- Laravel DOMPDF ^2.0 (PDF)
- Laravel Excel ^3.1
- Bacon QR Code ^3.0
- PHP Barcode Generator ^2.2
- Google 2FA Laravel ^2.3 (双因素认证)
- AWS S3 Flysystem ^3.0
- Prettus Repository ^2.9
- InfyOm Laravel Generator ^6.0
- InfyOm AdminLTE Templates ^6.0
- Laravel Dotenv Editor ^2.2
### 前端
- **CSS**: Bootstrap, AdminLTE
- **JavaScript**: Vue.js, jQuery
- **构建**: Webpack, Laravel Mix
## 文件结构
```
codecanyon-57441492-smart-pos-saas-for-multistore-retailers-built-on-laravel/
├── docs/ # 文档目录
│ ├── assets/
│ ├── css/
│ ├── docs/
│ ├── fonts/
│ ├── images/
│ ├── js/
│ ├── releases/
│ ├── upgrade/
│ ├── index.html
│ └── README.md
├── pos-saas/ # 主项目
│ ├── app/
│ ├── bootstrap/
│ ├── config/
│ ├── database/
│ ├── lang/
│ ├── public/
│ ├── resources/
│ │ └── views/
│ ├── routes/
│ ├── storage/
│ ├── tests/
│ ├── vendor/
│ ├── composer.json
│ ├── package.json
│ ├── webpack.mix.js
│ ├── webpack-rtl.config.js
│ └── artisan
└── PROJECT_ANALYSIS.md
```
## 安装说明
### 系统要求
- PHP ^8.1
- MySQL
- Composer
- Node.js 和 npm
### 安装步骤
1. 进入 `pos-saas` 目录
2. 运行 `composer install` 安装 PHP 依赖
3. 运行 `npm install` 安装 Node 依赖
4. 复制 `.env.example` 为 `.env` 并配置数据库
5. 运行 `php artisan key:generate` 生成应用密钥
6. 运行 `php artisan migrate` 迁移数据库
7. 运行 `npm run dev` 或 `npm run build` 构建前端
8. 配置虚拟主机指向 `public` 目录
## 亮点特色
1. **多租户架构** - stancl/tenancy 实现真正的多租户
2. **现代化技术栈** - Laravel 10 + PHP 8.1
3. **完整的 POS 功能** - 从销售到库存的全流程
4. **多种支付方式** - Stripe、Razorpay、PayPal、现金
5. **条码/二维码** - 完整的条码生成和扫描支持
6. **双因素认证** - Google 2FA 安全保护
7. **权限管理** - Spatie Permission 细粒度权限控制
8. **媒体管理** - Spatie Media Library 文件管理
9. **报告导出** - Excel 和 PDF 导出
10. **响应式设计** - 适配各种设备
11. **热敏打印** - 支持小票打印机
12. **云存储** - AWS S3 支持
