# Mall

**Repository Path**: zhangkede/mall

## Basic Information

- **Project Name**: Mall
- **Description**: Mall：一个专注于电商领域的开源项目，提供全面的前后端解决方案，包括商品管理、订单处理、用户管理等功能，助力开发者快速搭建电商平台。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-03
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BNPL (Buy Now Pay Later) 分期系统

## 项目概述

BNPL 是一个基于 Kotlin Multiplatform (KMP) 和 Clean Architecture 的全球化分期付款平台。该项目支持印尼、越南、菲律宾、泰国和马来西亚五国市场，提供完整的分期付款解决方案。

## 技术架构

### 核心技术栈

- **Kotlin Multiplatform (KMP)** - 跨平台开发框架
- **Compose Multiplatform (CMP)** - 跨平台 UI 框架
- **Clean Architecture** - 领域驱动设计
- **Ktor** - 服务端框架
- **Kotlin Coroutines & Flow** - 异步编程
- **Kotlin Serialization** - 数据序列化

### 项目结构

```
BNPL/
├── app/
│   ├── androidApp/          # Android 应用
│   └── shared/              # 共享代码
│       └── src/main/kotlin/com/pragmatic/bnpl/
│           └── ui/          # UI 层
│               ├── components/  # 可复用组件
│               ├── screens/      # 页面
│               └── theme/        # 主题
├── core/
│   └── src/commonMain/kotlin/com/pragmatic/bnpl/core/
│       ├── domain/          # 领域层
│       │   ├── model/       # 数据模型
│       │   ├── service/    # 业务服务
│       │   ├── security/   # 安全模块
│       │   ├── i18n/       # 国际化
│       │   └── repository/  # 仓储
│       └── data/           # 数据层
│           ├── remote/     # 远程API
│           └── local/      # 本地存储
└── server/                 # 服务端模块
    └── src/main/kotlin/com/pragmatic/bnpl/server/
        ├── api/            # API 路由
        ├── service/       # 服务
        └── repository/    # 数据仓储
```

## 核心功能

### 1. 用户认证与 KYC

- 手机号注册和登录
- OTP 验证码验证
- KYC 信息提交和验证
- 生物识别认证支持

### 2. 分期付款

- 额度申请和管理
- 分期计算器
- 分期计划生成
- 还款调度
- 逾期管理

### 3. 支付处理

- 多支付渠道集成 (GoPay, OVO, Dana, Bank Transfer)
- 支付验证
- 交易历史

### 4. 全球化支持

- 5 种语言: 印尼语、越南语、菲律宾语、泰语、马来语
- 区域合规配置
- 多币种支持
- 本地化格式化

### 5. 营销功能

- 促销活动
- 优惠券系统
- 推荐计划
- 推送通知

### 6. 商户后台

- 仪表盘
- 交易管理
- 结算管理
- 产品管理

### 7. 安全与风控

- AES-256 加密
- API 请求签名
- 设备指纹采集
- 环境检测 (Root/Emulator/VPN)
- 交易风控分析
- 定时任务调度

### 8. 智能客服与帮助中心

- **智能问答机器人**
  - 聊天式对话界面（消息气泡样式）
  - 关键词匹配自动回复
  - 预设快捷问题入口
  - 对话历史记录保存
  - 无法解答时转人工客服

- **FAQ知识库**
  - 8大分类：账户、账单、还款、信用、额度、安全、使用指南、其他
  - 50+预设问答对
  - 全文搜索功能（实时搜索）
  - 问题折叠/展开展示
  - 有用/无用反馈按钮
  - 相关问题推荐

- **工单系统**
  - 问题类型选择（功能建议、Bug反馈、投诉、其他）
  - 工单创建表单（标题、描述、图片上传）
  - 工单编号自动生成
  - 状态追踪（待处理、处理中、已解决、已关闭）
  - 工单回复与互动

- **帮助文档中心**
  - 新手指南专区
  - 视频教程列表
  - 文档收藏功能
  - 文档分享功能

- **联系我们**
  - 客服热线（一键拨打）
  - 客服邮箱（一键发送）
  - 社交媒体链接（微信、微博）
  - 工作时间展示
  - 公司地址信息

### 9. 个人消费分析与智能报表

- **消费总览**
  - 本月消费金额统计
  - 待还金额/已还金额展示
  - 消费变化率计算

- **消费趋势分析**
  - 近7天/30天/90天趋势切换
  - 折线图可视化展示
  - 消费峰值标注

- **分类消费统计**
  - 环形图/饼图展示
  - 消费类别占比分析
  - 分类消费排行榜

- **预算管理**
  - 月度总预算设置
  - 分类预算细分
  - 预算进度可视化（进度条）
  - 超支预警提醒
  - 智能预算建议

- **信用健康**
  - 信用评分展示（0-100分）
  - 评分等级（优秀、良好、一般、较差）
  - 评分维度分解（还款记录、使用率、信用历史等）
  - 信用提升建议
  - 信用变化趋势图

- **还款分析**
  - 还款日历视图（标记还款日期）
  - 待还款列表与详情
  - 还款历史统计
  - 提前还款计算器

### 10. AR虚拟试穿与智能穿搭

- **虚拟试穿功能**
  - 服饰试穿（上衣、裤子、裙子、外套）
  - 眼镜试穿（太阳镜、近视镜）
  - 配饰试穿（项链、耳环、帽子）
  - 美妆试色（口红、眼影）

- **智能穿搭推荐**
  - 基于身材的穿搭建议
  - 基于风格的穿搭推荐
  - 场景穿搭推荐（日常、职场、约会、运动）

- **试穿管理**
  - 试穿记录保存
  - 试穿对比功能
  - 试穿分享功能
  - 一键购买同款

- **身材管理**
  - 身材数据录入（身高、体重、体型）
  - 身材类型识别（苹果型、梨型、沙漏型）
  - 肤色选择

### 11. 社交电商与好友动态

- **动态Feed流**
  - 好友动态列表（无限滚动）
  - 动态分类（全部、关注、推荐）
  - 下拉刷新与上拉加载
  - 动态卡片展示（图文、视频、商品）

- **内容发布**
  - 发布图文动态（支持多图）
  - 发布商品种草（关联商品链接）
  - 动态内容编辑（文字描述、标签）
  - 发布设置（公开、仅好友可见、私密）

- **互动功能**
  - 点赞功能（点赞/取消点赞）
  - 评论功能（发表、回复、删除）
  - 收藏功能（收藏/取消收藏）
  - 转发功能
  - 分享到外部平台

- **社交关系**
  - 关注用户（关注/取消关注）
  - 推荐关注列表
  - 粉丝/关注列表查看
  - 用户主页（资料、动态、关注数据）

- **商品种草**
  - 动态中展示关联商品
  - "买了同款"标签
  - 点击商品跳转详情页

### 12. 订阅制服务

- **会员订阅计划**
  - 多种订阅方案（月度、季度、年度）
  - 订阅价格展示
  - 订阅权益对比

- **订阅管理**
  - 自动续费开关
  - 订阅到期提醒
  - 订阅变更/取消

- **会员权益**
  - 专属折扣优惠
  - 优先客服通道
  - 积分加倍
  - 生日礼包

### 13. 直播购物

- **直播列表**
  - 正在直播推荐
  - 直播预告
  - 主播排行榜

- **直播间功能**
  - 实时视频播放
  - 点赞互动
  - 弹幕评论
  - 礼物打赏

- **直播商品**
  - 商品列表展示
  - 一键购买
  - 商品优惠券
  - 限时特价

- **主播系统**
  - 主播关注/取消关注
  - 主播主页
  - 直播回放

### 14. 礼品卡与心愿单

- **礼品卡**
  - 礼品卡购买（多种面额）
  - 礼品卡赠送（选择接收人）
  - 礼品卡余额查询
  - 礼品卡使用记录

- **心愿单**
  - 创建心愿单
  - 添加商品到心愿单
  - 心愿单分享
  - 好友送礼功能

### 15. 手势密码与应用锁

- **应用锁**
  - 启动应用时验证手势
  - 后台切换时锁定

- **手势设置**
  - 设置手势密码
  - 修改手势密码
  - 手势图案确认

- **安全找回**
  - 手势忘记找回
  - 验证问题设置
  - 密码重置

### 16. 积分商城

- **积分获取**
  - 消费返积分（按比例返还）
  - 每日签到获取积分
  - 邀请好友注册奖励
  - 首次下单奖励
  - 评价商品奖励

- **积分商城**
  - 商品分类浏览（优惠券、实物、虚拟礼品、服务）
  - 积分兑换操作
  - 兑换记录查询
  - 商品搜索功能

- **积分管理**
  - 积分余额展示
  - 积分明细记录（获取、消耗、过期）
  - 积分有效期管理
  - 积分过期提醒

- **签到系统**
  - 签到日历展示
  - 连续签到奖励
  - 签到进度统计

### 17. 物流追踪

- **物流状态追踪**
  - 订单物流状态实时查询
  - 物流时间线展示
  - 预计送达时间显示
  - 物流商信息展示

- **物流轨迹可视化**
  - 简化地图展示
  - 物流轨迹线绘制
  - 途经城市标记
  - 当前位置指示器

- **物流问题反馈**
  - 问题类型选择（延迟、丢失、破损、其他）
  - 问题描述表单
  - 图片上传（证据）
  - 工单生成

- **物流FAQ**
  - 常见问题列表
  - 问题搜索功能
  - 折叠/展开展示

### 18. 商户管理平台

- **商户入驻**
  - 商户注册表单（基本信息、营业执照、银行账户）
  - 入驻进度指示
  - 审核状态查询

- **商户仪表盘**
  - 销售数据卡片（今日销售额、订单数、转化率）
  - 订单状态统计
  - 销售趋势图表
  - 快速操作入口

- **商品管理**
  - 商品列表（搜索、筛选）
  - 商品上架/下架
  - 商品编辑/创建
  - 库存管理

- **订单管理**
  - 订单列表（按状态Tab筛选）
  - 订单详情查看
  - 发货操作
  - 退款处理

- **结算管理**
  - 结算账单列表（日/周/月）
  - 账单详情查看
  - 提现申请
  - 提现记录

- **营销活动**
  - 优惠券创建
  - 限时折扣活动
  - 满减活动配置
  - 活动效果统计

### 19. 售后保障

- **退货申请**
  - 退货原因选择（质量问题、尺寸不合适、商品损坏等）
  - 问题描述输入
  - 图片上传（证据）
  - 申请提交

- **换货申请**
  - 换货商品选择
  - 换货原因选择
  - 规格选择
  - 申请提交

- **退款申请**
  - 退款原因选择
  - 退款金额显示
  - 申请提交

- **售后进度追踪**
  - 售后状态展示
  - 进度时间线
  - 下一步操作指引
  - 取消申请

- **售后记录**
  - 售后申请列表
  - 状态筛选（待审核、处理中、已完成）
  - 详情查看

- **售后政策**
  - 退货政策说明
  - 换货政策说明
  - 退款政策说明
  - FAQ问答

### 20. 品牌专区

- **品牌专区首页**
  - 精选品牌轮播
  - 品牌分类导航（时尚服饰、数码电子、美妆护肤、家居生活、运动户外、食品饮料）
  - 热门品牌列表（网格布局）
  - 品牌搜索功能

- **品牌详情页**
  - 品牌头部信息（Logo、名称、粉丝数）
  - 品牌故事展示
  - 品牌商品列表
  - 品牌活动列表
  - 品牌优惠券列表
  - 关注/取消关注按钮

- **品牌活动专区**
  - 品牌筛选功能
  - 活动列表（限时折扣、新品发布、品牌日、专属优惠）
  - 活动时间标签
  - 活动类型标签

- **关注品牌管理**
  - 关注品牌列表
  - 取消关注功能
  - 空状态提示

### 21. 限时秒杀

- **秒杀专区首页**
  - 秒杀活动Banner轮播
  - 场次Tab（正在进行、即将开始）
  - 实时倒计时显示
  - 秒杀商品网格列表
  - 抢购进度条展示

- **秒杀商品详情**
  - 商品大图展示
  - 价格对比（原价格线、秒杀价高亮）
  - 折扣标签显示
  - 实时库存显示
  - 已售数量统计
  - 每人限购提示
  - 抢购按钮/已售罄状态

- **秒杀记录**
  - 抢购记录列表
  - 状态筛选（全部、成功、失败）
  - 订单跳转功能

### 22. 预售功能

- **预售商品列表**
  - 预售商品展示（预售标签、预计发货时间）
  - 预售进度条（已预售数量/目标数量）
  - 预售价格展示（定金、尾款）
  - 预售倒计时

- **预售订单流程**
  - 定金支付
  - 尾款提醒
  - 尾款支付
  - 订单状态追踪

### 23. 买家秀功能

- **买家秀Feed流**
  - 用户晒单列表
  - 图文/视频展示
  - 点赞、评论互动
  - 商品关联展示

- **买家秀发布**
  - 图片/视频上传
  - 文字描述
  - 商品关联
  - 标签添加

### 24. 邀请好友/推荐奖励

- **邀请码分享**
  - 个人邀请码生成
  - 分享渠道（微信、短信、二维码）
  - 邀请链接生成

- **奖励规则**
  - 好友注册奖励
  - 好友首单奖励
  - 多级推荐奖励
  - 奖励明细查询

### 25. 金融银行功能

- **银行卡管理**
  - 添加银行卡
  - 银行卡列表
  - 银行卡验证
  - 默认支付方式设置

- **转账功能**
  - 账户余额查询
  - 转账到银行卡
  - 转账记录查询

- **还款功能**
  - 自动还款设置
  - 手动还款
  - 还款提醒

- **信用报告**
  - 个人信用评分
  - 信用记录查询
  - 信用提升建议

### 26. 活动中心

- **活动日历**
  - 活动时间轴展示
  - 活动分类筛选
  - 活动提醒设置

- **抽奖活动**
  - 大转盘抽奖
  - 锦鲤抽奖
  - 抽奖记录

- **活动规则**
  - 活动详情展示
  - 参与资格检查
  - 活动奖品展示

### 27. 本地生活服务

- **美食外卖**
  - 附近餐厅推荐
  - 在线点餐
  - 订单配送追踪

- **生活服务**
  - 家政服务预约
  - 上门服务列表
  - 服务评价

### 28. 健康管理

- **运动打卡**
  - 每日运动记录
  - 运动目标设置
  - 运动统计

- **健康提醒**
  - 喝水提醒
  - 休息提醒
  - 用药提醒

- **健康挑战**
  - 挑战活动参与
  - 挑战进度追踪
  - 挑战奖励

### 29. 教育培训

- **课程学习**
  - 课程列表浏览
  - 在线视频学习
  - 学习进度追踪

- **电子阅读**
  - 电子书列表
  - 在线阅读
  - 阅读记录

- **学习计划**
  - 学习目标设置
  - 计划进度追踪
  - 学习提醒

### 30. 合规模块

- **隐私合规**
  - 隐私政策展示
  - 数据授权管理（位置、相机、通讯录等权限）
  - 数据导出功能
  - 账号注销（7天等待期、可撤销）
  - Cookie设置管理

- **内容合规**
  - 举报系统（垃圾信息、色情低俗、人身攻击等）
  - 社区规范展示
  - 违规记录查询
  - 敏感内容检测

- **支付合规**
  - 支付安全中心（支付密码、指纹/面容支付）
  - 交易风控（异常交易监测、风险验证）
  - 资金安全保障（保险金额、赔付限额）
  - 支付协议管理

## 构建与部署

### 环境要求

- JDK 17+
- Android Studio / IntelliJ IDEA
- Gradle 8.x

### 构建命令

```bash
# 构建 Debug APK
./gradlew :app:androidApp:assembleDebug

# 构建 Release APK
./gradlew :app:androidApp:assembleRelease

# 运行测试
./gradlew test

# 运行 Android 测试
./gradlew :app:androidApp:connectedDebugAndroidTest

# 构建 iOS (macOS only)
./gradlew :app:ios:build

# 构建服务端
./gradlew :server:build
```

### 部署脚本

```bash
# Windows
deploy.bat debug
deploy.bat release
deploy.bat staging

# Linux/macOS
./deploy.sh debug
./deploy.sh release
./deploy.sh staging
```

## 配置

### 应用配置

主要配置文件位于 `app/shared/buildConfig.json`：

- `version` - 版本信息
- `features` - 功能开关
- `security` - 安全配置
- `limits` - 业务限制
- `regions` - 区域配置

### 安全配置

ProGuard 规则位于 `app/androidApp/proguard-rules.pro`

### 测试配置

测试配置位于 `config/test-config.json`

## API 文档

### 认证 API

```
POST /api/v1/auth/request-otp     # 请求 OTP
POST /api/v1/auth/verify-otp      # 验证 OTP
POST /api/v1/auth/refresh-token   # 刷新 Token
POST /api/v1/auth/logout          # 登出
```

### 用户 API

```
GET  /api/v1/user/profile          # 获取用户信息
PUT  /api/v1/user/profile          # 更新用户信息
POST /api/v1/user/kyc/submit      # 提交 KYC
GET  /api/v1/user/kyc/status       # 获取 KYC 状态
```

### 额度 API

```
GET  /api/v1/credit/limit          # 获取额度
POST /api/v1/credit/apply          # 申请额度
```

### 分期 API

```
POST /api/v1/installment/calculate # 计算分期
POST /api/v1/installment/create    # 创建分期
GET  /api/v1/installment/{id}      # 获取分期详情
GET  /api/v1/installment/list      # 获取分期列表
```

### 支付 API

```
POST /api/v1/payment/validate      # 验证支付
POST /api/v1/payment/execute      # 执行支付
GET  /api/v1/payment/history      # 支付历史
```

### 账单 API

```
GET  /api/v1/billing/statement     # 获取账单
GET  /api/v1/billing/due           # 获取待还账单
POST /api/v1/billing/pay          # 还款
```

### 预售 API

```
GET    /api/v1/presale/products          # 获取预售商品列表
GET    /api/v1/presale/products/{id}     # 获取商品详情
POST   /api/v1/presale/orders           # 创建预售订单
GET    /api/v1/presale/orders           # 获取我的预售订单
POST   /api/v1/presale/orders/{id}/pay-deposit   # 支付定金
POST   /api/v1/presale/orders/{id}/pay-balance  # 支付尾款
```

### 买家秀 API

```
GET    /api/v1/buyer-show/posts         # 获取买家秀列表
POST   /api/v1/buyer-show/posts         # 发布买家秀
POST   /api/v1/buyer-show/posts/{id}/like    # 点赞
GET    /api/v1/buyer-show/posts/{id}/comments  # 获取评论
POST   /api/v1/buyer-show/posts/{id}/comments  # 发表评论
```

### 邀请奖励 API

```
GET    /api/v1/referral/code           # 获取邀请码
POST   /api/v1/referral/invite         # 邀请好友
GET    /api/v1/referral/rewards        # 获取奖励记录
GET    /api/v1/referral/stats          # 获取邀请统计
```

### 金融银行 API

```
GET    /api/v1/finance/cards           # 获取银行卡列表
POST   /api/v1/finance/cards           # 添加银行卡
GET    /api/v1/finance/transactions    # 获取交易记录
GET    /api/v1/finance/credit/report   # 获取信用报告
```

### 活动中心 API

```
GET    /api/v1/activity/list           # 获取活动列表
POST   /api/v1/activity/lottery/draw   # 抽奖
GET    /api/v1/activity/koi/score      # 获取锦鲤值
```

### 本地生活 API

```
GET    /api/v1/local-life/restaurants   # 获取餐厅列表
GET    /api/v1/local-life/housekeeping # 获取家政服务
POST   /api/v1/local-life/reservations # 创建预约
```

### 健康管理 API

```
GET    /api/v1/health/workout          # 获取运动记录
POST   /api/v1/health/workout          # 添加运动记录
GET    /api/v1/health/reminders        # 获取健康提醒
POST   /api/v1/health/challenges/{id}/join  # 参与挑战
```

### 教育培训 API

```
GET    /api/v1/education/courses       # 获取课程列表
GET    /api/v1/education/books         # 获取图书列表
PUT    /api/v1/education/progress      # 更新学习进度
POST   /api/v1/education/plans         # 创建学习计划
```

### 合规模块 API

```
GET    /api/v1/compliance/privacy/policy       # 获取隐私政策
GET    /api/v1/compliance/privacy/authorizations  # 获取授权列表
POST   /api/v1/compliance/content/report      # 举报内容
GET    /api/v1/compliance/payment/security    # 获取支付安全设置
```

## 性能优化

### 缓存机制
- **内存缓存**: 使用LRU缓存策略，支持自动过期清理（默认5分钟）
- **响应缓存**: 根据API端点配置不同的缓存时间
- **缓存管理**: 支持缓存统计和手动失效

### 请求限流
- **API限流**: 限制单IP请求频率（默认100次/分钟）
- **细分限流**: 对高频接口单独设置限制
- **限流头部**: 返回 `X-RateLimit-Limit` 和 `X-RateLimit-Remaining`

### 响应压缩
- **Gzip压缩**: 自动压缩响应内容（大于1KB）
- **Deflate压缩**: 备选压缩算法

### 性能监控
- **请求计时**: 记录每个API请求的响应时间
- **性能统计**: 计算平均响应时间、P95、P99
- **热点分析**: 统计访问最频繁的端点

## 增强功能模块

### 1. 数据可视化仪表盘
- **统计卡片**: 收入、订单、用户、转化率实时统计
- **收入趋势图表**: 7天收入趋势柱状图
- **品类分布**: 饼图展示各品类销售占比
- **热销商品**: 商品销量排行榜
- **订单状态**: 待付款/已发货/已送达/已取消统计

### 2. 客服工单系统
- **工单创建**: 用户提交问题工单
- **工单分类**: 订单/支付/发货/商品/账户/退款
- **优先级管理**: 低/中/高/紧急优先级
- **工单处理**: 分配、处理、回复工单
- **工单统计**: 待处理/处理中/已解决/已关闭统计

### 3. 商家入驻系统
- **申请入驻**: 商家提交入驻申请
- **资质审核**: 营业执照、税务登记证审核
- **商家管理**: 查看、激活、暂停商家
- **审核记录**: 审批历史和拒绝原因

### 4. 优惠券管理
- **优惠券创建**: 固定金额/百分比/包邮券
- **使用规则**: 最低消费、每人限用次数
- **发放核销**: 优惠券发放和使用记录
- **统计分析**: 发放数量、使用数量、折扣总额

### 5. 智能推荐系统
- **个性化推荐**: 基于用户行为的推荐
- **热门推荐**: 热销商品推荐
- **相似推荐**: 相似商品推荐
- **新品推荐**: 新品上市推荐
- **推荐统计**: 点击率、转化率统计

### 6. 供应链管理
- **库存管理**: 库存数量、库存状态监控
- **采购订单**: 创建、跟踪采购订单
- **供应商管理**: 供应商信息和评分
- **库存预警**: 低库存预警提醒

### 7. 用户行为分析
- **事件追踪**: 页面浏览、商品查看、加购、购买等事件
- **会话分析**: 用户会话时长、页面访问次数
- **用户统计**: 活跃用户、新用户统计
- **转化率分析**: 各环节转化率统计

### 8. 营销活动管理
- **活动创建**: 闪购/折扣/捆绑销售/礼品卡
- **活动调度**: 定时开始、结束活动
- **目标受众**: 全体用户/新用户/会员
- **预算管理**: 活动预算和花费统计

## 国际化支持

### 支持语言
- **中文 (zh)**: 简体中文
- **English (en)**: 英语
- **Indonesian (id)**: 印尼语
- **Vietnamese (vi)**: 越南语
- **Filipino (fil)**: 菲律宾语
- **Thai (th)**: 泰语
- **Malay (ms)**: 马来语

### 国际化功能
- **语言切换**: 支持动态切换应用语言
- **翻译资源**: 集中管理所有文本翻译
- **字符串键**: 使用统一的字符串键管理
- **自动回退**: 未翻译内容自动回退到英文
- **语言状态**: 监听语言变化事件

### 使用方式
```kotlin
// 获取翻译
I18n["common.ok"]  // 返回 "确定" 或 "OK"

// 带参数翻译
I18n["welcome", "用户"]  // 返回 "欢迎用户"

// 扩展函数
"common.ok".i18n()

// 切换语言
I18n.setLanguage("zh")
```

### 翻译文件结构
- `I18nKeys.kt` - 字符串键定义
- `TranslationManager.kt` - 翻译管理器
- `EnglishTranslations.kt` - 英文翻译
- `ChineseTranslations.kt` - 中文翻译
- `IndonesianTranslations.kt` - 印尼语翻译

## UI细化

### 动画效果
- **入场动画**: 淡入+滑动组合动画
- **出场动画**: 淡出+滑动组合动画
- **缩放动画**: 按钮点击缩放效果
- **脉冲动画**: 无限循环脉冲效果
- **骨架屏**: 加载时的骨架屏动画

### 主题扩展
- **扩展颜色**: 状态色、功能色、渐变色
- **形状系统**: 卡片、按钮、输入框形状
- **字体系统**: 价格、标签、徽章字体样式
- **间距系统**: xs/sm/md/lg/xl/xxl标准间距

### UI组件
- **渐变按钮**: 支持渐变背景的按钮
- **动画按钮**: 点击时自动缩放的按钮
- **骨架加载**: 数据加载时的占位组件
- **空状态**: 多种场景的空状态展示
- **错误状态**: 网络/服务器/权限错误展示
- **徽章组件**: 数字徽章、折扣标签、热门标签

### 加载状态
- **加载指示器**: 小/中/大尺寸
- **加载遮罩**: 半透明遮罩层
- **骨架卡片**: 商品卡片骨架屏
- **骨架列表**: 列表项骨架屏
- **三点加载**: 动态三点加载动画

## 安全说明

### 加密

- 传输加密: HTTPS/TLS 1.3
- 数据加密: AES-256-GCM
- 密码哈希: SHA-256

### 签名

所有 API 请求都需要签名：

```
X-Timestamp: {timestamp}
X-Signature: SHA256(payload + timestamp + app_key)
X-Request-ID: {unique_id}
```

### 风控

- 设备指纹
- 环境检测
- 交易限额
- 频率限制

## 测试

### 运行测试

```bash
# 运行所有测试
run-tests.bat

# 运行单元测试
./gradlew test

# 运行集成测试
./gradlew :app:androidApp:connectedDebugAndroidTest
```

### 性能基准

- 冷启动: < 2s
- 热启动: < 500ms
- 内存占用: < 150MB
- APK 大小: < 30MB

## CI/CD

GitHub Actions 配置位于 `.github/workflows/ci-cd.yml`

触发条件：
- Push 到 main 分支
- Pull Request
- 手动触发

## 开发指南

### 代码规范

- 遵循 Kotlin 编码规范
- 使用有意义的命名
- 保持函数简短 (< 50 行)
- 编写文档注释

### Git 规范

- 使用 Feature Branch Workflow
- 提交信息格式: `type: description`
- Types: feat, fix, docs, style, refactor, test, chore

### Code Review

- 所有 PR 需要至少 1 人 review
- 确保测试通过
- 确保构建成功

## 许可证

Proprietary - All Rights Reserved

## 联系方式

### 技术支持
- 邮箱: 834959743@qq.com
- 手机: 16657156689

### 商务合作
- 邮箱: business@bnpl.example.com

### 开发团队
- GitHub: https://github.com/bnpl-team
- 官方网站: https://www.bnpl.com