完整流程#

1
双击 ColorVision.exe
2
  -> 启动本地 FastAPI
3
  -> 托管 Vue 生产页面
4
  -> 自动打开默认浏览器
5
  -> 初始化 CameraService 并检测摄像头
6
  -> 摄像头实时画面 -> 拍照与 ROI 框选
7
  -> RGB / LAB / HEX -> Mock 或真实 API 上传

技术栈#

核心功能#

• 取色与识别：拍照后在图片上拖动 ROI，输出 RGB、CIELAB、HEX；ROI 采样先剔除过暗 / 过亮像素，再用中位数 + MAD 去除高光、阴影与 JPEG 噪声离群点，最后取均值
• 色彩精度：不做软件端二次白平衡，按设备 sRGB 输出走 BGR → RGB → CIELAB 标准转换；LAB 使用 float32 sRGB + D65 白点，避免 OpenCV uint8 LAB 的量化与偏移误差
• 摄像头容错：前端启动与摄像头初始化解耦——无设备、被占用、运行中断开均不影响服务启动；initializing / available / not_found / open_failed / busy / disconnected / read_failed / mock 八态机，重新检测串行释放旧设备，连续全黑帧判定为无效摄像头
• Mock 双模式：Mock Camera 提供动态测试画面（不依赖 USB 摄像头），Mock Upload 模拟上传响应，两者独立
• 上传日志与隐私：日志全部留在本机（SQLite + 图片目录），按北京时间倒序展示原图 / ROI 图 / 颜色参数 / 请求 ID，支持单条删除、清空、保留天数与最大条数策略；日志永不外发
• 真实 API 上传：multipart/form-data 携带 original_image / roi_image / rgb / lab / hex / roi / camera_id / timestamp，Bearer Token 鉴权，覆盖超时、非 2xx 与无效 JSON 异常
• 工程化：自动化测试覆盖健康检查、纯红 / 绿 / 蓝 / 白 / 黑基准值、ROI 稳健采样、各摄像头状态、多分辨率元数据、PyInstaller 打包资源路径；构建脚本自动读取版本号生成 ZIP，升级时保留用户 config/ 与 data/

系统架构#

• Android App：通过 USB Host + usb-serial-for-android 驱动 CH340 串口，控制 LCUS-1 继电器
• Web Client：Chrome / Edge 通过 Web Serial API 直接驱动 CH340 串口
• Spring Boot：REST 管理设备、状态和事件；WebSocket 实时广播变更
• CH340 + LCUS-1：已验证硬件组合（VID 1A86 / PID 7523，9600 8N1）

技术栈#

核心功能#

• 多客户端实时状态同步，AUTH 帧鉴权 + sequence gap replay
• relay_state 记录每设备最新指令状态，relay_event append-only 审计日志
• hardware_event 独立记录 USB 插拔 / 连接 / 断开 / 失败
• 测试覆盖：Backend 42/42 passed、Frontend Vitest 125/125 passed、Android Gradle BUILD SUCCESSFUL

核心价值#

LemonGo 刻意保持小体量，用 用户、商品、购物车、订单 + 模拟支付 拼出一条真实可操作的业务闭环，把主要精力放在让每一个请求都可解释、可追踪、可问责：

1. 可解释 —— TraceFilter 透传或生成 X-Request-Id，贯穿响应头、统一响应体、MDC 日志、数据库日志四者。
2. 可追踪 —— ChainTraceAspect 通过 AOP 无侵入采集 Controller / Service / Mapper 分层耗时，请求结束时统一落库。
3. 可问责 —— sys_api → sys_module → sys_developer 三张表维护”接口归谁管”的责任链，异常发生时一路定位到负责人。

一句话总结：业务制造流量，链路解释流量，责任追责到人。

技术栈#

核心功能#

• JWT 登录注册、用户 / 商品 / 购物车 / 订单模块、模拟支付
• 五类模拟异常接口（400/404/500/database/service）验证”异常落库 → 责任定位 → 前端错误页”闭环
• 监控台：Dashboard、实时链路（WebSocket 广播 REQUEST_COMPLETED）、请求日志与链路详情、接口注册表、异常日志、用户活跃度、模块与开发者责任监控
• 日志体系：MySQL 结构化日志（永久）+ Redis 实时计数（2 天过期）+ Logback 文件日志（15 天 / 2GB）

技术栈#

核心功能#

• 用户端：注册登录（防暴力破解逐级冻结）、疫苗浏览（46 种含品牌/剂量/工艺）、在线预约（自动区分工作日/周六半天/周日休息）、我的预约、接种记录、个人设置、实名认证（身份证派生性别）、用户名年度修改
• 管理端：预约审核、疫苗管理（上下架/库存/图片）、用户管理、管理员管理、接种记录、数据概览
• 可靠性：BCrypt 加密、JWT 无状态认证、Redis 分布式锁防超卖（降级本地锁）、Vaccine 库存 @Version 乐观锁、CORS 跨域防护、ROLE_USER / ROLE_ADMIN 二级权限

部署#

支持 Docker 一键部署（MySQL + Redis + Backend + Nginx）、开发模式前后端分离、单体 JAR 部署三种方式。

技术栈#

核心业务链路#

房东入驻申请 → 管理员审核 → 发布房源 → 租客预约 → 房东审批 → 看房完成 → 通知中心

核心功能#

• 房东入驻审核：landlord_application 申请表，管理员审核通过后房东才能发布房源
• 房源管理：发布/编辑/上下架/删除，多图上传，公开搜索（关键词/类型/城区/价格/面积），收藏
• 预约审批闭环：幂等键 requestId 防重复提交，乐观锁 version 防并发覆盖，appointment_flow 完整时间线
• 通知中心：事务 Outbox 保证状态变更与通知入队同事务，NotificationOutboxProcessor 定时投递 WebSocket，失败自动重试