门店服装展示销售APP—女装大屏产品系统

项原因旨在解决什么产品问题：

1、行业业务背景： 服装零售是典型的重线下、高 SKU、高复购行业，国内大量女装属于夫妻店或 1~3 人小店，普遍没有数字化预算和专职运维。门店日常痛点集中在三处：一是陈列展示靠衣架和海报，新款、促销信息触达不到顾客；二是导购一个个讲解效率低，老板不在场顾客很难自助了解款式；三是经营靠本子记账，每天卖了多少钱、赚了多少、哪件好卖全凭记忆，月度盈亏算不清。同时门店常遇到断网、只有手机没有电脑、老平板配置低等现实条件，市面上的 SaaS 收银/进销存系统既要联网又要年费，小店用不起来。

2、本项目要解决的产品问题：（1）把「展示屏」做成装在自有手机/平板上的 APP，替代昂贵的大屏硬件和播放器，老旧安卓设备也能跑；（2）解决「无人讲解」问题——每件衣服可自动语音播报面料、版型、价格，并支持外接蓝牙音响，顾客自助浏览；（3）解决「不联网就不能用」的问题——把商品、促销、账本、统计整套业务后端内置进 APP，断网、无电脑场景照样录入和查看；（4）解决「账目不清」问题——收款、成本、支出一体化记录，自动算出日/月/年毛利、净利润与同比，帮店主判断盈利还是亏损；（5）解决「上货慢」问题——拍照即上架，自动压缩图片、自动生成播报话术，支持促销到点生效、到期自动恢复原价。

3、典型使用场景： 女装实体店（可复用至男装、童装、运动品牌店），店内平板挂墙做展示大屏，店主用手机后台随时上新款和记账，盘点季导出 CSV 对账。

1、立项背景和目标：实体服装门店缺少数字化展示和经营工具，导购靠口头介绍、顾客试穿体验差，店主对每日销量、利润没有清晰账目。本项目目标是做一款装在手机/平板上就能用的门店大屏 + 店主后台一体化 APP：顾客在大屏上翻款式、听语音介绍、扫码付款，店主在后台完成上货、促销、记账和经营统计，全程不需要电脑、不依赖网络也能使用。
2、软件功能和核心功能模块：
（1）大屏展示模块：款式轮播、分类浏览、多图详情、语音播报、促销角标、微信/支付宝收款码、官方小程序码引流；
（2）店主后台模块：拍照上架（支持多张实拍图、自动压缩）、商品管理、促销活动（限时特价、秒杀、清仓、批量折扣、到期自动恢复原价）、经营账本（记录卖出与支出）、日/月/年经营统计（毛利、净利润、同比、未来推算、CSV 导出）；
（3）离线引擎模块：整套业务后端内置到 APP 内，SQLite 本地存储，离线可完整使用全部功能；
（4）音频模块：蓝牙/有线音响自动路由、手机自带 TTS 离线合成播报语音并缓存为音频文件。
3、业务流程和功能路径：店主打开 APP → 长按或点底部「店主后台」进入管理页 → 拍照/相册上传新款（自动生成播报话术）→ 设置促销与营业时间 → 回到大屏给顾客展示；顾客点画面进入自助选款，点款式看多图详情、点播报听语音介绍，扫码付款后店主在账本记一笔，统计页自动算出当日/当月盈亏。

1、整体架构和设计思路：采用「WebView 壳 + 本地业务引擎」架构。前端为原生 HTML5/JS 单页（大屏页 + 后台页），通过 JS Bridge 与 Android 原生层通信；数据层在手机端用 SQLite 实现完整业务后端（商品、促销、账本、统计），媒体文件存本地文件系统；联网时可选连接 PC 端 FastAPI+SQLite 服务实时同步，离线时全部功能由本地引擎承担，两端数据结构完全一致。
2、我负责的模块和结果：独立完成需求分析、架构设计、前后端全部编码、Android 打包与真机联调。产出可安装 APK（约 6.7MB，兼容 Android 8~15 手机与平板），支持整站离线运行；经营统计口径与真实门店对齐（毛利=收款−成本、净利=毛利−支出）；语音播报实现蓝牙音响自动路由与离线 TTS 合成缓存；用 38 条自动化测试覆盖本地引擎核心业务逻辑，全部通过。
3、遇到的难点、坑和解决方案：
（1）老设备白屏闪退：Android 8 WebView 内核不支持 ?.、?? 等新语法，导致整个 JS 文件语法错误、页面全白——全部改写为 ES2017 兼容写法并建立发版前语法扫描清单；拍照原图 4000×3000 直接解码导致内存溢出闪退——上传前 Canvas 压缩到长边 1280，浏览列表分页 + 懒加载，并声明 largeHeap。
（2）长时间使用卡死：多处重试定时器只增不清形成「定时器雪崩」，几十个启动任务并发把主线程占死——统一「先清再设」，并加 90 秒心跳看门狗自动恢复界面，数据在本地库不丢失。
（3）离线播报无录音：新款没有服务端合成录音，改用手机自带 TTS 离线合成语音，播报后自动缓存为 wav 文件，二次播报秒出声，且自动路由到蓝牙音响。