扫码支付 HTTP 超时时间配置实施计划

执行要求：使用 subagent-driven-development 或 executing-plans 按任务执行并保留检查点。

目标：为当前 5 个可达支付页面增加可配置的扫码支付 HTTP 读取超时，默认 30 秒，允许输入 1～100 秒，其他请求继续使用原有 5 秒超时。

架构：设置页通过独立配置类持久化和校验；扫码支付通过专用 OkHttp 客户端工厂只覆盖 readTimeout。保留原支付请求重载，确保 NewQuotaActivity 和 PaymentManager 不改动。

技术栈：Android Java、SharedPreferences、Retrofit 2.1.0、OkHttp 3.9.0、RxJava 2、JUnit 4、XML Layout。

文件结构

新增源码

QrcodePaymentTimeoutConfig.java：默认值、范围、配置读写和异常回退。
QrcodePaymentHttpClientFactory.java：创建只覆盖读取超时的扫码支付客户端。
InputQrcodePaymentTimeoutPop.java：校验 1～100 秒输入，不直接持久化。
input_qrcode_payment_timeout_pop_layout.xml：输入弹框布局。
两组 JUnit 测试：配置边界和客户端隔离。

修改源码

Constants、RetrofitClient、RetrofitRequest。
FragmentPayment、支付设置布局和字符串资源。
MainActivity、QuotaActivity、QuotaNoKeyboardActivity、FreeActivity、FreeNoKeyboardActivity。

明确不修改

NewQuotaActivity。
PaymentManager。
扫码弹框 5/10 秒倒计时和 MQTT 5 秒倒计时。

Task 1：建立扫码支付超时配置策略

文件：Constants.java、新增 QrcodePaymentTimeoutConfig.java 和对应测试。

先写测试，验证默认值 30、边界 1/100 合法、0/101 非法、异常存储值回退 30。
运行目标测试，确认因配置类不存在而失败。
在 Constants 增加统一支付类型常量和偏好键。
实现配置类，集中维护 MIN=1、MAX=100、DEFAULT=30、读写和校验。
重新运行测试并执行 git diff --check。

./gradlew :app:testDebugUnitTest --tests com.cpt.cusumption.utils.QrcodePaymentTimeoutConfigTest

Task 2：建立扫码支付专用 HTTP 客户端

文件：新增 QrcodePaymentHttpClientFactory.java 和测试，修改 RetrofitClient.java。

先写客户端隔离测试：专用客户端 connect/write 保持 5 秒、read 改为 30 秒、基础客户端仍为 5 秒。
实现基于 baseClient.newBuilder() 的专用客户端工厂，非法超时回退 30 秒。
在 RetrofitClient 增加 createApiWithReadTimeout，不写入全局 Retrofit 缓存。
运行配置和客户端两组测试。

./gradlew :app:testDebugUnitTest \
  --tests com.cpt.cusumption.utils.QrcodePaymentTimeoutConfigTest \
  --tests com.cpt.cusumption.network.QrcodePaymentHttpClientFactoryTest

Task 3：让当前 5 个页面显式选择扫码支付超时

文件：RetrofitRequest.java 和 5 个当前可达支付页面。

保留原三参数 orderPayment，内部转发到新四参数重载并默认不使用扫码超时。
新重载接收 useQrcodePaymentTimeout，扫码时读取最新配置并创建专用 API。
MainActivity 改用 Constants.PAYMENT_TYPE_QR_CODE。
5 个页面调用 HTTP 支付时传入是否为扫码支付。
确认 NewQuotaActivity 和 PaymentManager 无差异。
执行 Java 编译。

git diff -- app/src/main/java/com/cpt/cusumption/activity/NewQuotaActivity.java \
  app/src/main/java/com/cpt/cusumption/utils/PaymentManager.java
./gradlew :app:compileDebugJavaWithJavac

Task 4：实现 1～100 秒输入弹框

文件：新增输入弹框 Java/XML，修改字符串资源。

增加设置标题、输入标题、提示、校验错误和秒数格式字符串。
复用人脸阈值弹框的尺寸、背景和按钮资源，数字输入限制三位。
弹框通过 newInstance 接收当前值，非法参数回退 30。
确认时使用配置类校验，失败不关闭，成功只回调数值。
类注释明确弹框不负责持久化。
执行 Java 编译。

Task 5：在支付设置页接入配置

文件：fragment_payment_layout.xml、FragmentPayment.java。

增加“扫码支付超时时间”设置行和当前秒数显示。
进入页面时读取配置，默认显示“30秒”。
点击设置行时避免重复弹框并显示当前值。
确认后由 Fragment 保存配置并刷新；取消不修改。
执行 Java 编译。

Task 6：完成回归验证

运行两组新增单元测试。
运行完整 :app:testDebugUnitTest。
运行 :app:compileDebugJavaWithJavac。
执行 git diff --check，检查排除文件无差异。
检查新增文件 UTF-8 无 BOM。
人工验证默认 30、边界 1/100、非法值、配置持久化、超过 5 秒不提前失败、超过配置值显示“请求超时”。
确认刷卡、人脸和其他接口仍为原 5 秒行为。

Task 7：更新提示工程变更记录

在 zhctprompt/work_android/CusumptionMachine/change_records/ 创建同名 Markdown 和 HTML，记录背景、实际文件、配置边界、5 个覆盖页面、排除项、验证结果和限制。

生成 2026-09-16-qrcode-payment-http-timeout-config.md。
生成同名 HTML，确保标题和结论一致。
检查 UTF-8 无 BOM。
检查源码仓库和提示工程仓库状态，只保留本次文件，不暂存、不提交、不推送。

Git 边界

每个任务只执行只读状态和差异检查。不要暂存、提交或推送，除非用户后续明确授权。