一键拍最美证件照产品系统Vibe Coding

1. 立项原因（旨在解决的产品问题）
传统证件照制作存在明显痛点：用户需专程前往照相馆排队拍摄，费用较高且时间不灵活；拍摄后对背景色、尺寸的调整空间极小，难以自助满足不同证件规范；在政务办理、考试报名、求职入职等紧急场景下，往往难以及时获取符合要求的证件照。本项目旨在将专业级 AI 人像分割能力与移动端 Canvas 图像合成技术相结合，让用户随时随地通过手机即可完成"拍照—抠图—换底色—排版导出"全流程，显著降低证件照获取的时间与经济成本，解决"办证难、办证慢、调整不灵活"的核心产品问题。

2. 行业场景与业务背景
证件照是政务服务（居住证、驾驶证、护照申请）、教育考试（报名注册、毕业存档）、求职招聘、签证办理等高频刚需场景的必备材料，用户基数庞大且需求持续稳定。随着移动互联网普及与 AI 图像处理技术成熟，"在线证件照制作"已成为便民服务与实用工具类应用的重要细分赛道，各类小程序、App 纷纷入局。本项目面向学生、职场人士及广大办事群众，覆盖微信小程序、H5、App 多端触达渠道，契合数字化便民服务趋势，同时支持 6 寸相纸排版冲印输出，兼顾电子版与实体冲印需求，具备良好的用户基础与商业落地价值。

1. 项目有哪些具体功能模块
项目从架构上划分为后端服务与前端应用两大层次，后端（id-photo-admin）包含登录鉴权模块、人像分割模块、图像压缩处理模块、接口限流模块四大核心模块；前端（小程序与 uni-app 多端）包含证件类型选择模块、照片上传模块、AI 抠图调用模块、背景色切换与实时预览模块、人像智能定位模块、单张与 6 寸排版导出模块、图片质量选择模块、相册保存与权限处理模块。各模块之间通过 HTTP 接口与 Canvas 2D API 协同工作，实现从照片采集到成品导出的完整闭环。
2. 项目的主要功能描述
系统主要功能是为用户提供一站式智能证件照制作服务：用户首先在首页选择证件类型（一寸、二寸、小一寸、大一寸等常用规格），通过拍照或相册上传照片后，系统调用腾讯云人像分割 API 自动去除原图背景，得到透明背景人像；随后进入编辑页，用户可在红、蓝、白、淡蓝等标准背景色之间实时切换预览，系统通过扫描人像包围盒实现智能居中定位与比例自适应填充，避免人像变形；最后在保存页选择单张保存或 6 寸相纸排版保存（自动计算横排、竖排最大排列数量），并按高清、标准、压缩三档质量将成品保存至手机相册，兼顾电子版使用与实体冲印需求。

1. "我"负责的具体任务
我作为本项目的核心开发，独立负责从后端服务到多端前端的完整研发工作。后端方面，我设计并实现了 Spring Boot 登录鉴权服务（兼容微信小程序、App、H5 三种平台）、人像分割接口封装、图像自适应压缩处理，以及基于拦截器的双层限流机制；前端方面，我完成了微信原生小程序与 uni-app 多端两个版本的开发，包括证件类型选择、照片上传、AI 抠图调用、背景色切换与实时预览、人像智能定位、单张与 6 寸排版导出、相册保存与权限处理等全部页面与逻辑；同时独立开发了微信云函数 segmentPortrait，负责云端的限流配额、文件校验与腾讯云 API 调用。

2. 技术栈、架构、实现亮点与难点
技术栈 ：后端采用 Spring Boot 3.3.5 + Java 17 + Thumbnailator + 腾讯云 SDK Java BDA；小程序采用微信原生框架 + 微信云开发（云函数/云存储）；多端前端采用 uni-app + Vue3 + Vite + Canvas 2D API；外部服务接入腾讯云人像分割（SegmentPortraitPic）与微信开放平台 jscode2session。

架构 ：采用三子项目并行、前后端分离架构，后端为多端提供统一鉴权与分割 API；前端通过条件编译（#ifdef）实现一套代码适配微信小程序、H5、App 三端，环境配置通过 .env 文件区分。

实现亮点 ：一是端侧人像包围盒检测，通过扫描 Canvas 像素 alpha 通道计算人像边界，实现智能居中与比例自适应填充；二是 6 寸排版算法，按 300 DPI 换算像素并自动比较横排、竖排方案取最大排列数；三是后端多档位自适应图像压缩，保证 base64 ≤ 5MB 的同时兼顾清晰度；四是双层限流（单用户频率 + 全局日额度）+ 服务