# InfyVCardSaaS - 多用户电子名片生成器SaaS平台
## 项目概述
- **项目类型**:Web应用(SaaS平台)
- **主要功能**:多租户电子名片生成、vCard下载、二维码生成、自定义模板、订阅管理
- **技术栈**:
- 后端:Laravel 10 + PHP 8.1+
- 前端:Laravel Blade + Livewire 3 + Alpine.js
- 样式:Tailwind CSS + Sass
- 数据库:MySQL/PostgreSQL
- 工具:Laravel Modules(模块化架构)
## 模块结构
```
vcards/
├── app/
│ ├── Console/ # 命令行工具
│ ├── Exceptions/ # 异常处理
│ ├── Exports/ # 数据导出
│ ├── Http/ # HTTP层
│ │ ├── Controllers/ # 控制器
│ │ ├── Middleware/ # 中间件
│ │ └── Requests/ # 表单请求验证
│ ├── Jobs/ # 队列任务
│ ├── Livewire/ # Livewire组件
│ ├── Mail/ # 邮件模板
│ ├── Models/ # Eloquent模型
│ ├── Providers/ # 服务提供者
│ ├── Repositories/ # 仓库模式
│ ├── Services/ # 业务服务
│ ├── Traits/ # 特性类
│ └── View/ # 视图组件
├── Modules/ # 功能模块(Test模块示例)
├── database/
│ ├── migrations/ # 数据库迁移
│ └── seeders/ # 数据填充
├── resources/
│ ├── views/ # Blade模板
│ ├── js/ # JavaScript资源
│ └── theme/ # 主题资源
├── routes/ # 路由定义
├── config/ # 配置文件
└── tests/ # 测试用例
```
## 核心业务逻辑
### 1. 多租户系统
- 基于stancl/tenancy实现多租户架构
- 每个租户独立数据库或共享数据库隔离
- 子域名或自定义域名绑定
### 2. 电子名片生成
- **模板系统**:支持多种预设模板
- **自定义字段**:姓名、电话、邮箱、社交媒体、公司信息等
- **实时预览**:Livewire实现无刷新编辑预览
- **vCard格式**:标准vCard .vcf文件生成与下载
### 3. 二维码功能
- 自动生成名片二维码
- 支持自定义二维码样式
- 扫码后直接保存联系人
### 4. 订阅与支付
- 多层级订阅计划(免费/基础/高级)
- 集成支付网关:Stripe、PayPal、Razorpay等
- 订阅管理与续费提醒
### 5. 管理后台
- 租户管理
- 模板管理
- 用户管理
- 订阅与收入统计
- 系统设置
## 核心代码分析
### 后端架构
- **框架**:Laravel 10(PHP 8.1+)
- **模块化**:nwidart/laravel-modules实现功能模块化
- **前端组件**:Livewire 3实现动态交互
- **样式引擎**:Tailwind CSS + 自定义Sass
### 关键依赖
```json
{
"laravel/framework": "^10.18",
"livewire/livewire": "^3.6",
"stancl/tenancy": "^3.7", // 多租户
"spatie/laravel-permission": "^5.8", // 权限管理
"spatie/laravel-medialibrary": "^10.7", // 媒体管理
"barryvdh/laravel-dompdf": "^3.1", // PDF生成
"simplesoftwareio/simple-qrcode": "^4.2" // 二维码
}
```
### 目录结构特点
- **app/Repositories/**:仓库模式,数据访问层抽象
- **app/Services/**:业务逻辑层
- **app/Livewire/**:Livewire组件(表单、列表等)
- **Modules/**:可插拔的功能模块
### 前端技术
- **Alpine.js**:轻量级JavaScript框架
- **Tailwind CSS**:原子化CSS框架
- **Chart.js**:数据图表
- **Select2**:下拉选择组件
- **Quill/Summernote**:富文本编辑器
### 安全特性
- Laravel Sanctum API认证
- Google reCAPTCHA集成
- 2FA双因素认证(pragmarx/google2fa-laravel)
- 角色权限控制(spatie/laravel-permission)
### 第三方集成
- **支付**:Stripe、PayPal、Razorpay、Paystack、MercadoPago
- **存储**:AWS S3、本地存储
- **通知**:Slack、邮件
- **社交登录**:Laravel Socialite
---
*版本:14.7.6*