# StartAW

**Repository Path**: httpxiaohou/start-aw

## Basic Information

- **Project Name**: StartAW
- **Description**: 个人桌面端
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-17
- **Last Updated**: 2025-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 证件照制作系统

这是一个基于 Spring Boot + Vue3 + Electron 开发的证件照制作系统。系统支持证件照的拍摄、裁剪、美化和打印等功能。

## 项目结构

- `ymj-server/`: 后端服务
  - 基于 Spring Boot 2.7.5
  - 提供 RESTful API
  - 集成 OpenCV 进行图像处理
  - 支持多种图像处理算法
  
- `src/`: 前端应用
  - 基于 Vue 3 + Element Plus
  - 使用 Electron 构建桌面应用
  - 支持实时预览和编辑
  - 响应式设计，支持不同分辨率

## 运行环境要求

- JDK 8 或以上
- Node.js 16 或以上
- pnpm 包管理器
- 内存：4GB 以上
- 硬盘空间：500MB 以上
- 操作系统：Windows 10/11、macOS、Linux

## 详细安装步骤

1. 克隆项目：
   ```bash
   git clone [项目地址]
   cd [项目目录]
   ```

2. 安装后端依赖：
   ```bash
   cd ymj-server
   # Windows
   .\mvnw.cmd clean install
   # Linux/macOS
   ./mvnw clean install
   ```

3. 安装前端依赖：
   ```bash
   # 安装 pnpm（如果未安装）
   npm install -g pnpm
   
   # 安装项目依赖
   pnpm install
   ```

4. 配置环境：
   - 复制 `ymj-server/src/main/resources/application.yml.example` 到 `application.yml`
   - 根据实际情况修改配置文件中的参数
   - 确保 OpenCV 相关依赖正确安装

## 启动说明

1. 启动后端服务：
   ```bash
   cd ymj-server
   # Windows
   .\mvnw.cmd spring-boot:run
   # Linux/macOS
   ./mvnw spring-boot:run
   ```

2. 启动前端应用：
   ```bash
   # 开发环境
   pnpm run electron:dev
   
   # 生产环境打包
   pnpm run electron:build
   ```

## 主要功能

- 证件照拍摄和导入
  - 支持摄像头实时拍摄
  - 支持本地图片导入（支持格式：JPG、PNG、BMP）
  - 支持图片拖拽导入
  
- 智能人脸检测
  - 自动检测人脸位置
  - 智能调整人像位置和大小
  - 支持多人脸场景
  
- 多种证件照尺寸支持
  - 预设多种标准证件照尺寸
  - 支持自定义尺寸
  - 支持批量转换不同尺寸
  
- 背景颜色更换
  - 智能抠图
  - 多种标准背景色（白色、蓝色、红色等）
  - 支持自定义背景色
  
- 照片美化
  - 智能美颜
  - 亮度/对比度调节
  - 肤色美化
  - 去斑去痘
  
- 批量打印
  - 支持多种打印尺寸
  - 自动排版
  - 支持自定义边距和间距

## 证件照规格

支持以下规格的证件照制作：
- 一寸（25×35mm）- 适用于简历、证件等
- 二寸（35×49mm）- 适用于简历、证件等
- 小一寸（22×32mm）- 适用于各类证件
- 大一寸（33×48mm）- 适用于各类证件
- 护照（33×48mm）- 符合护照照片标准
- 签证（33×48mm）- 符合各国签证要求

## 常见问题

1. 启动失败
   - 检查 JDK 版本是否正确
   - 检查端口 8080 是否被占用
   - 检查 Maven 依赖是否完整

2. 拍照功能异常
   - 检查摄像头权限是否开启
   - 检查摄像头驱动是否正确安装

3. 打印问题
   - 确保打印机已正确安装和连接
   - 检查打印纸张设置是否正确

## 技术支持

如果您在使用过程中遇到问题，可以通过以下方式获取帮助：

1. 提交 Issue
2. 查阅 [在线文档]
3. 联系技术支持团队

## 开发团队

- 前端开发：[开发者名称]
- 后端开发：[开发者名称]
- UI 设计：[设计师名称]
- 项目经理：[经理名称]

## 版本历史

- v1.0.0 (2024-01-17)
  - 首次发布
  - 支持基本的证件照制作功能
  - 集成人脸检测和美化功能

## 许可证

本项目采用 MIT 许可证。详细信息请参阅 [LICENSE](LICENSE) 文件。