# 青商城 · HarmonyOS
_🛍️ 基于 ArkTS 与 ArkUI 的鸿蒙电商应用_
[](https://github.com/Joker-x-dev/CoolMallArkTS)
[](https://gitee.com/Joker-x-dev/CoolMallArkTS)
[](https://coolmall.apifox.cn)
[](https://deepwiki.com/Joker-x-dev/CoolMallKotlin)
## 📖 项目简介
这是一个基于 ArkTS 和 ArkUI 打造的开源电商学习项目，旨在展示如何运用现代 HarmonyOS
开发技术构建一个完整的电商应用。项目涵盖用户认证、商品展示、购物车、订单支付等核心流程，适合开发者学习参考现代
HarmonyOS 开发技术。
作为热爱技术的个人开发者，我将工作之外半年多的时间都投入到这个项目中。每一个功能的实现、每一次代码的优化，都是我在闲暇时间精心打磨的成果。尽管进度可能不如专职团队那么快，而且某些功能的实现还不够完善，但我会持续改进，不断完善。如果你对
HarmonyOS 开发感兴趣，无论是学习还是共同创造，都欢迎加入。
> 如果项目对您有帮助，请给个 Star 支持 ⭐ 这对我来说很重要，能给我带来长期更新维护的动力！
## 📍 项目地址
- **GitHub 地址**：[https://github.com/Joker-x-dev/CoolMallArkTS](https://github.com/Joker-x-dev/CoolMallArkTS)
- **Gitee 地址**：[https://gitee.com/Joker-x-dev/CoolMallArkTS](https://gitee.com/Joker-x-dev/CoolMallArkTS)
### 相关文档
- **青商城 API 接口文档**：[在线查看](https://coolmall.apifox.cn)
- 接口文档会随着项目开发进度同步更新，主要包含各接口的请求参数和返回数据示例
- **IBest-UI-V2 组件库文档**：[在线查看](https://ibestui-v2.ibestservices.com)
- 组件库使用说明与参数配置，包含常用组件示例
- **IBest-ORM 数据库文档**：[在线查看](https://ibest-orm.ibestservices.com/)
- 本地数据库能力与实体定义说明，包含基础使用示例
## 🛠️ 技术栈
### 核心技术
| 类别 | 技术选型 | 说明 |
|-------|--------------------------------|------------------------|
| 编程语言 | ArkTS | HarmonyOS NEXT 主流语言 |
| UI 框架 | ArkUI | 声明式 UI 框架 |
| 架构模式 | MVVM | View + ViewModel 分离 |
| 导航框架 | Navigation | 路由与页面导航管理 |
| 状态管理 | V2（ObservedV2/AppStorageV2） | 新版状态管理能力 |
| 组件库 | IBest-UI-V2 | 业务组件库与基础控件封装 |
### 功能模块
| 类别 | 技术选型 | 说明 |
|-------|-----------|---------------|
| 网络请求 | Axios | 网络客户端与拦截器封装 |
| 数据库 | IBest-ORM | 本地数据库能力 |
## ✨ 项目特点
- **现代化架构**: 采用模块化设计，各功能模块高度解耦
- **声明式 UI**: 使用 ArkUI 构建现代化用户界面
- **主题适配**: 完整支持浅色/深色主题动态切换
- **国际化**: 支持中英文语言切换，便于全球化推广
- **响应式编程**: 基于 V2 状态管理的响应式编程范式
- **完整的测试覆盖** `计划中`
- **屏幕适配**: 支持平板 / 折叠屏 / 手机
## 📚 资源与参考
- **资源说明**: 项目中的部分素材来自网络，仅用于学习交流
- **图标来源**: 项目使用的图标库来自[图鸟 Icon](https://github.com/tuniaoTech)
## 📱 功能模块目录
> **状态说明：**
> - `已完成` - 功能页面已完整实现并可以正常使用
> - `待完善` - 功能页面基本实现，但还需要进一步优化和完善
> - `待优化` - 功能页面已实现，但需要性能优化或体验优化
> - `仅页面` - 只完成了页面UI，功能逻辑尚未实现
> - `待开发` - 功能页面尚未开发，陆续实现中
- **主模块 (main)**
- 首页 (home) `待完善`
- 分类 (category) `待完善`
- 购物车 (cart) `待开发`
- 我的 (me) `待开发`
- **认证模块 (auth)**
- 登录主页 (login) `待开发`
- 账号密码登录 (account-login) `待开发`
- 注册页面 (register) `待开发`
- 找回密码 (reset-password) `待开发`
- 短信登录 (sms-login) `待开发`
- **用户体系模块 (user)**
- 个人中心 (profile) `待开发`
- 收货地址列表 (address-list) `待开发`
- 收货地址详情 (address-detail) `待开发`
- 用户足迹 (footprint) `待开发`
- **订单模块 (order)**
- 订单列表 (list) `待开发`
- 确认订单 (confirm) `待开发`
- 订单详情 (detail) `待开发`
- 订单支付 (pay) `待开发`
- 退款申请 (refund) `待开发`
- 订单评价 (comment) `待开发`
- 订单物流 (logistics) `待开发`
- **商品模块 (goods)**
- 商品搜索 (search) `待开发`
- 商品详情 (detail) `待开发`
- 商品评价 (comment) `待开发`
- 商品分类页面 (category) `待开发`
- **营销模块 (market)**
- 优惠券管理 (coupon) `待开发`
- **客服模块 (cs)**
- 客服聊天 (chat) `待开发`
- **反馈模块 (feedback)**
- 反馈列表 (list) `待开发`
- 提交反馈 (submit) `待开发`
- **通用模块 (common)**
- 关于我们 (about) `待开发`
- WebView 页面 (web) `待开发`
- 应用设置 (settings) `待开发`
- 用户协议 (user-agreement) `待开发`
- 隐私政策 (privacy-policy) `待开发`
- 贡献者列表 (contributors) `待开发`
- **启动流程模块 (launch)**
- 启动页 (splash) `待开发`
- 引导页 (guide) `待开发`
## 项目结构
```
AppScope/ # 应用配置
entry/ # 应用入口模块
core/ # 核心模块
│ ├── base/ # 基类
│ ├── data/ # 数据层
│ ├── database/ # 数据库
│ ├── datastore/ # 数据存储
│ ├── designsystem/ # 设计系统
│ ├── ibestui/ # IBest UI 组件库
│ ├── model/ # 数据模型
│ ├── navigation/ # 导航
│ ├── network/ # 网络层
│ ├── result/ # 结果处理
│ ├── state/ # 全局状态
│ ├── ui/ # UI组件
│ └── util/ # 工具类
feature/ # 功能模块
│ ├── auth/ # 认证模块
│ ├── common/ # 公共模块
│ ├── cs/ # 客服模块
│ ├── feedback/ # 反馈模块
│ ├── goods/ # 商品模块
│ ├── launch/ # 启动模块
│ ├── main/ # 主模块
│ ├── market/ # 营销模块
│ ├── order/ # 订单模块
│ └── user/ # 用户模块
```
## 🚀 开发计划
这是一个由个人持续投入的学习型项目，当前优先完善鸿蒙端基础能力与核心流程，逐步拓展功能模块并提升稳定性与体验。
### 🔧 近期重点
1. **主流程完善**：完善首页与分类页面的核心交互与数据链路
2. **基础能力建设**：统一网络层、数据层、状态管理与公共组件
3. **体验优化**：完善空态、加载、错误处理等基础体验
### 🚀 中长期规划
4. **业务模块扩展**：逐步补齐认证、商品、订单、用户等业务模块
5. **质量提升**：补充测试与性能优化，提升可维护性
6. **文档完善**：持续更新开发文档与使用说明
## 👥 加入群聊
欢迎加入青商城开发者交流群，一起分享学习心得，讨论技术问题！
