西湖项目非功能性要求

概述

该项目在 MVP 阶段定义了明确的非功能性约束，覆盖性能、安全、审计、可用性、兼容性与日志规范，作为研发与测试的统一基线。

性能要求

接口响应时长：P95 <= 500ms
海报生成时长：P95 <= 5s
列表分页：
- 默认每页 10-20 条
- 首屏返回体积不超过 300KB

安全要求

传输安全：全链路 HTTPS
身份鉴权：Token 鉴权 + 服务端权限校验
支付安全：
- 微信支付回调验签
- 订单金额由服务端校验
敏感信息保护：
- 手机号、地址需加密存储
- 日志中需脱敏展示
接口安全：
- 高频接口需限流
- 关键接口需支持幂等键

审计要求

业务审计

以下业务必须可追溯：

打卡
积分
抽奖
订单
退款
核销

操作审计

后台对以下对象的修改必须记录操作人与时间：

景点
路线
商品
奖池
库存
物流

财务审计

现金支付与积分扣减均需支持对账

可用性要求

核心链路可用性：登录、打卡、订单、支付月度可用性不低于 99.9%（AI假设项 A1）
降级策略：天气、宜忌等第三方服务异常时，不阻塞首页与漫游主流程
容灾策略：消息、海报、统计类服务允许异步补偿，不影响交易主链路

兼容性要求

小程序版本：兼容微信最新稳定版及近两个大版本
机型兼容：覆盖主流 Android / iPhone
NFC 能力边界：
- NFC 打卡与图鉴解锁仅作为 Android + NFC 可用设备 的验收能力
- iPhone 仅验证浏览、提示与降级体验
权限差异处理：定位、相册、NFC、分享权限不足时，必须提供清晰引导

日志要求

客户端日志

需记录：

页面曝光
点击行为
请求耗时
错误码
设备信息

服务端日志

需记录：

traceId
请求参数摘要
返回码
耗时
操作对象 ID

异常日志

以下异常必须上报：

打卡失败
支付异常
库存冲突
售后处理失败