# uctooapp

**Repository Path**: patrickwang/uctooapp

## Basic Information

- **Project Name**: uctooapp
- **Description**: uctoo数据库管理APP是一款支持移动端管理数据库、图文、音视频等多媒体内容的开源CMS客户端应用。采用ArkUI/ArkTS技术选型的鸿蒙原生应用。
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2024-05-30
- **Last Updated**: 2024-05-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# uctooapp-starter-harmonyos

### 版本信息
#### v1.0.0 （OpenHarmony API 11）

### 简介
uctoo数据库管理APP是一款支持移动端管理数据库、图文、音视频等多媒体内容的开源CMS客户端应用。采用ArkUI/ArkTS技术选型的鸿蒙原生应用。

uctooapp-starter基础脚手架，实现了大量商用项目常见功能，支持可视化页面搭建，云端一体应用快速开发基本项目模版。

APP有很多通用的功能，比如登录注册、头像、设置、banner、... uctooapp-starter将这些功能都已经集成好。并且支持使用[https://gitee.com/UCT/uctoo-page-editor](https://gitee.com/UCT/uctoo-vue-editor) 进行可视化页面搭建（开发中）。  

项目采用了全栈模型同构的技术选型，使得前后端算法基本保持一致，为低代码、无代码、可视化代码生成等开发需求提供了更加规范化的架构风格和高效率的开发基础设施。  

虽然近年来采用文档型数据库的云开发技术选型愈加流行，但实际业务应用中有大量需要融合或集成已有关系型数据库等ICT基础设施的需求，本项目在兼容原有技术选型的基础上又提供了与云开发一致的开发体验。  

APP端实现了对鸿蒙技术体系中ArkData（方舟数据管理）所包含的关系型数据库（已实现）、键值型数据库（开发中）等进行可视化增删改查等操作管理，并示例了多种分布式数据同步和跨应用数据同步（通过标准化数据通路实现数据共享UDMF）等应用场景。

## 基础脚手架构成

1. [ArkUI](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V2/arkui-overview-0000001532577181-V2)，基础ui库
2. [Axios](https://gitee.com/openharmony-sig/ohos_axios) 封装全局API请求
3. [dataORM](https://gitee.com/openharmony-sig/dataORM) 数据库规范化模型。示例了全栈模型同构的编程模型，弱化API通信的存在感，简化业务逻辑算法，支持采用关系型数据库的项目与采用文档型数据库的项目有相似的前端操作数据库编程模型。  
4. [jwt](https://jwt.io/) 示例了采用标准化数据通路UDMF共享token，多端同步登录退出等。  
5. 支持国际化多语言  

## 项目运行

## 在DevEco studio中开发

1. 可在开发工具中的模拟机以及真机中完整运行。  
2. 开发工具中的previewer目前不支持数据库的模拟运行。  

### uctooapp-starter集成包括：
1. 用户管理：
	- 登录注册（用户名密码登录、手机号验证码登录、APP一键登录、第三方应用帐号登录）
	- 修改密码、忘记密码、头像更换（集成图片裁剪）、昵称修改、退出登录
	- APP、H5、小程序多端统一用户中心及权限体系
2. 系统设置：
	- 用户首选项设置  
    - 数据库初始化数据设置  
3. 数据库管理
    - 管理前端数据库  
    - 登录后可通过[UCToo](https://gitee.com/uctoo/uctoo) 服务器端headless CMS管理远程数据库  

* 部分页面由 https://gitee.com/openharmony-sig/dataORM 示例项目改编，更换为对接UCToo服务端API，更多功能模块会不断更新，欢迎持续关注本项目 

## 目录结构@catalogue
<pre>
uctooapp-starter
├─AppScope	AppScope目录由DevEco Studio自动生成，不可更改。
├─common	公共模块
│	├─datastore 前端数据库/数据服务子模块
│	|	└─index.ets 模块导出入口
│	├─src
│	│	├─main			公共模块
│	│	└─test	        公共模块测试
│	└─utils				通用工具模块
│	 	└─index.ets 模块导出入口
├─features	功能模块目录			
│	├─databaseManager 数据库管理模块(har类型)
│	├─login 登录模块(har类型)
│	└─....  其他更多模块
├─oh_modules	    ohpm依赖库目录	
├─products	    手机端应用入口目录	
│	└─entry      入口模块
│   	├─.preview    previewer预览器生成的相关文件		
│	    ├─build       项目编译输出相关目录
│	    ├─oh_modules      模块依赖库目录
│	    └─src      模块源码
│   	   ├─main    程序目录
│   	   ├─mock    模块mock数据目录
│   	   ├─ohosTest    OpenHarmony测试目录
│   	   ├─test        测试目录
│   	   ├─.gitignore        git忽略文件
│   	   ├─build-profile.json5        模块编译配置文件
│   	   ├─hvigorfile.ts        模块编译配置文件
│   	   ├─obfuscation-rules.txt        模块代码混淆配置文件
│   	   └─oh-package.json5        模块包管理配置文件
├─.gitignore        git忽略文件
├─build-profile.json5        工程编译配置文件
├─hvigorfile.ts        工程编译配置文件
├─LICENSE.txt           开源协议文件
├─local.properties      SDK配置参数
├─oh-package.json5	 	工程包管理配置文件
└─README.md				说明文档
</pre>

## Roadmap  
1. 与ArkUI/ArkTS/dataORM/Axios等项目功能需求路标对齐  

#### 参考资料
1. [harmonyos-guides](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V2/start-overview-0000001478061421-V2?catalogVersion=V2)  
2. [uctooapp](https://gitee.com/uctoo/uctooapp)