# uctoo

**Repository Path**: xiaozichen/uctoo

## Basic Information

- **Project Name**: uctoo
- **Description**: UCToo是一套AI驱动的全栈应用开发基础设施。采用开源、通用、厂商中立的技术选型。内置众多开发者效率工具，可快速进行全栈应用的开发和运营，适合作为CMS、APP、小程序等产品的起始项目。V3.0版支持多端一致的ORM模型及API代码生成。已支持鸿蒙原生应用等最新技术体系。
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 176
- **Created**: 2026-03-02
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UCToo  
UCToo是一套AI驱动的全栈应用开发基础设施。采用开源、通用、厂商中立的技术选型。内置众多开发者效率工具，可快速进行全栈应用的开发和运营，适合作为CMS、APP、小程序等产品的起始项目。  

## 概述
UCToo是一系列实现AI驱动的分布式应用开发的最佳实践的技术体系。以下UCToo技术体系架构请参考，并随业界技术发展持续迭代。遵循UMI全栈模型同构规范，支持从任意数据库结构生成多端一致的ORM模型和API代码，实现可编程的数据模型层分布式软总线，结合AI编程助手和框架内置的提示词工程有效提高AI代码生成的准确度和代码质量。  

![UCToo技术体系架构](https://gitee.com/UCT_admin/materials/raw/master/uctoo/Tech%20Architect.png)  
![UCTooV3技术体系架构](https://gitee.com/UCT_admin/materials/raw/master/uctoo/V3techArch.png)  


本代码库主要包含了UCToo技术体系各子项目的索引和简介。系统采用monorepo项目结构，使用pnpm进行包管理，包含以下主要部分：
- 后端服务 (backend)
- 小程序端 (miniapp)
- 技术体系 (uctoo)
- web前端应用 (uctoo-app-client-pc)
- uctooapp (HarmonyOS端应用)
- AgentSkills-runtime (智能体运行时)
- 核心组件库和工具包 (packages目录)

## AI驱动的全栈开发框架最佳实践    
1. **统一技术栈原则**：优先采用可支持一致技术栈实现全平台应用开发的编程语言，便于应用统一的编程规范和降低AI学习成本。  
2. **Monorepo架构优化**：采用monorepo组织工程的代码管理方案，便于AI IDE及大模型全面获取工程信息，实现更精准的代码生成。 
3. **CLI友好设计**：开发框架功能均可通过CLI命令行工具实现，便于与AI IDE及大模型的集成和互操作，支持自动化工作流。  
4. **AI Native原则**：原生智能化、天生全场景、高性能、强安全，符合AI Native的发展趋势，内置AI增强功能。  
5. **模型同构规范**：遵循UMI全栈模型同构规范，为确定性代码生成和AI辅助代码生成提供良好基础设施。  
6. **AI生态集成**：支持MCP、Function Call等AI生态主流协议和开发范式，确保与主流AI工具链的兼容性。

``` markdown 
added by TRAE+SeepSeek R1
7. 建立AI代码生成质量评估体系，通过单元测试覆盖率（≥85%）和SonarQube静态扫描保障代码质量
8. 实现CI/CD全流程AI辅助，使用AI生成测试用例并自动执行流水线（如GitHub Actions/Jenkins）
9. 内置MLOps基础设施，支持模型版本管理（MLflow）和AI服务监控（Prometheus+Grafana）
10. 强化AI安全规范，遵循OWASP AI安全指南，实施RBAC权限控制和数据脱敏处理
11. 构建知识图谱驱动的开发文档体系，实现API文档与代码实时同步（Swagger/Redoc）
12. 采用微服务化AI能力部署，通过Service Mesh（Istio）实现AI服务动态编排
13. 建立多维度可观测体系，集成日志分析（ELK）、链路追踪（Jaeger）和异常检测（AIops）
14. 实施用户体验量化管理，通过AB测试平台（Optimizely）和埋点分析（Mixpanel）持续优化
15. 构建开发者社区生态，建立RFC提案机制和Contribution GPT代码审查助手
补充实践着重于：

- AI代码生成的质量保障体系
- 智能化运维监控能力
- 开发者体验持续优化机制
- 安全合规的AI服务部署
- 开放协同的社区生态建设
```

``` markdown 
added by CodeBuddy+GPT-5 
7. 人机协同开发流程
以“人设目标、AI产草稿、人做评审与合并”为主线，定义每次迭代的验收标准和回滚策略。
复杂任务拆小步，给AI明确上下文、边界条件与评估口径，避免一次性超大变更。
统一的代码与提示工程规范
8. 统一编码规范、提交规范(Commitlint)、分支策略、目录结构；在仓库中提供“提示词模板与负样例库”，约束AI生成风格与安全边界。
为常见任务（CRUD、表单校验、权限门禁、接口封装）提供可复用Prompt Snippet。
9. 可测试的AI产出
单测/集成测试/契约测试覆盖AI生成模块，优先对数据模型、API契约、权限与幂等性做测试。
引入快照测试防回归，针对AI易变区域（UI渲染、文案、多语言）设置基线。
10. 强化安全与合规
对AI生成代码做SAST/DAST/依赖漏洞扫描；引入Secrets扫描与生成阶段密钥屏蔽。
后端默认零信任：鉴权在网关/中间件层，最小权限访问；对AI调用外部包做来源校验与许可证合规检查。
11. 数据与隐私治理
敏感数据最小化出境：提示词脱敏与分级；训练或微调使用脱敏样本。
设计“数据可追溯”链路：从需求-提示-生成-上线全链路留痕，满足审计与复现。
12. 观测与可解释性
接入日志、指标、分布式追踪；对AI相关关键路径做埋点（提示长度、模型版本、延迟、错误率）。
对生成结果提供“决策依据”或“来源链接”，便于人工复核与故障排查。
13. 依赖与模型版本治理
明确模型与依赖的版本矩阵；设灰度/金丝雀发布策略，允许按项目/环境快速切换模型。
给AI工具链（代码生成器、Lint、格式化器）也做版本锁定与变更日志。
14. 领域模型优先与契约驱动
先固化Domain Model与API契约，再驱动AI生成实现与前后端类型；用OpenAPI/JSON Schema/Protobuf做单一事实源。
通过代码生成器在多端同步类型，减少手写与漂移。
15. Prompt 即基础设施
将高价值Prompt抽象为“可测试、可发布、可版本化”的资源（如以文件/配置管理），支持回滚与A/B。
为关键Prompt建立性能基准与质量门槛（正确率、覆盖率、延迟）。
16. 人工评审与自动质量闸
在CI中设质量闸：静态检查、测试覆盖、Bundle大小、性能阈值、可访问性分数。
关键变更（安全、支付、数据导出）必须双人评审；AI建议仅作参考，不可越权合并。
17. 开发者体验与脚手架
提供一键初始化脚手架：内置目录规范、环境变量模板、示例Prompt、测试与CI配置。
常见业务基元（列表-详情、搜索-分页、表单-校验、权限-菜单）沉淀为可复用蓝图供AI调用。
18. 渐进式引入与风险控制
从低风险区域开始引入AI（文档、测试、样式、重复性脚本），逐步扩展到核心业务。
为AI生成变更设置隔离分支与特性开关；关键路径保留人工Fallback。
19. 性能与成本优化
在前端采用增量编译、按需加载、边缘缓存；在后端引入连接池、批处理、幂等重试。
对AI调用做缓存与去重；统一计费与用量监控，设超额预警与熔断策略。
20. 多环境一致性与基础设施即代码
Dev/Staging/Prod 配置分离且可追溯；用IaC（如Terraform）管理云资源与权限。
数据库迁移（如Prisma/Knex/Flyway）与Seed数据自动化，确保环境可复现。

```

``` markdown 
added by Qoder
新增的9条最佳实践：
提示词工程化 - 内置结构化提示词模板，提高AI代码生成准确度
代码即文档 - 自描述的代码结构，便于AI理解和维护
渐进式AI增强 - 支持平滑过渡到AI辅助开发
智能依赖管理 - 自动优化依赖关系，减少冲突
上下文感知生成 - 基于项目上下文生成一致性代码
多模态支持 - 支持多种输入形式的AI交互
持续学习机制 - 建立项目级别的AI优化反馈循环
安全第一原则 - 内置安全代码模式和漏洞检测
可解释性设计 - AI生成代码包含决策路径，便于理解和维护
这15条最佳实践涵盖了：
技术架构层面：统一技术栈、Monorepo、CLI友好设计
AI集成层面：AI Native、生态集成、提示词工程
开发体验层面：渐进式增强、上下文感知、多模态支持
质量保障层面：持续学习、安全优先、可解释性
维护性层面：代码即文档、智能依赖管理

```

## UCToo技术体系索引  

1. [https://gitee.com/uctoo/uctoo](https://gitee.com/uctoo/uctoo) UCToo APP server是一款无头内容管理系统(Headless CMS)的服务端应用，可便捷的对数据库数据、多媒体内容等进行所见即所得的管理。 采用nodejs技术选型，提供了完善的API以及开放平台特性，可快速与第三方系统集成。支持一键部署至主流公有云的云原生运行环境，具备良好的可管理、可运营、可拓展性以及透明可自由选择的资费体系。
2. [https://gitee.com/UCT/uctoo-backend](https://gitee.com/UCT/uctoo-backend) UCToo server是Headless CMS的服务器端应用,技术选型为Hyper-express + postgreSQL。Hyper-express是nodejs生态中运行效率最高的一款开发框架。postgreSQL用于保存CMS数据和内容。通过集成[prisma ORM](https://prisma.org)、[axios](https://axios-http.com/) 、[jwt](https://jwt.io/)等开源项目，以及遵循UMI全栈模型同构规范，实现低代码headless CMS的基础设施。  
3. [https://gitee.com/UCT/uctoo-app-client-pc](https://gitee.com/UCT/uctoo-app-client-pc) UCToo app client pc是Headless CMS的PC端应用，支持PC端设备的内容管理后台应用界面。技术选型为[vben admin](https://github.com/vbenjs/vue-vben-admin)、 [pinia ORM](https://github.com/CodeDredd/pinia-orm)、TypeScript。     
4. [https://gitee.com/UCT/uctooapp](https://gitee.com/UCT/uctooapp) UCTooAPP是Headless CMS的APP移动端应用，支持HarmonyOS/iOS/Android多端多规格设备的内容管理移动端应用。技术选型为[ArkUI](https://developer.harmonyos.com/cn/develop/arkUI)、 [ArkTS](https://developer.harmonyos.com/cn/develop/arkts)、[ArkTS-x](https://gitee.com/arkui-x) ，具体可参考UCTooAPP readme文档及[UCToo CodeLabs](https://gitee.com/UCT/codelabs) 项目的应用示例。     
5. [UCToo Codelabs](https://gitee.com/UCT/codelabs) Codelabs 开源项目是fork自HarmonyOS官方codelabs库的示例项目。UCToo添加了UMI-ORM示例端云API调用，持续迭代多媒体内容展示、注册、登录、用户权限体系等常用通用功能。
6. [UCToo Vue Editor](https://gitee.com/UCT/uctoo-vue-editor) 模块是一个可视化动态页面搭建独立项目。UCToo线上运营版本地址 https://vueeditor.uctoo.com ，帐号与 www.uctoo.com 帐号相同。开源项目地址[https://gitee.com/UCT/uctoo-vue-editor](https://gitee.com/UCT/uctoo-vue-editor)。实践了全栈模型同构的理念，为低代码、无代码、可视化代码生成等开发需求提供了更加规范化的架构风格和高效率的开发基础设施。已实现vue技术栈，ArkUI/ArkTS技术栈开发中。  
7. [UCToo uni starter](https://gitee.com/UCT/uctoo-uni-starter-vue2) 是一个uctoo-uniapp移动端基础脚手架，实现了大量商用项目常见功能，支持可视化页面搭建，云端一体应用快速开发基本项目模版。uniapp技术栈已不再维护，V3版本后采用ArkUI/ArkTS技术栈。
8. [UCToo docker](https://gitee.com/UCT/uctoo-docker) 云原生分布式部署UCToo APP server 应用实例的容器项目，支持UCToo SaaS应用实例一键部署至公有云平台。已支持腾讯云cloudbase云原生部署，V3版本支持华为云一键部署特性开发中。
9. [SaaS共享数据模型](https://gitee.com/UCT/uctoo-backend/blob/master/docs/uctoo%E6%95%B0%E6%8D%AE%E5%BA%93%E8%AE%BE%E8%AE%A1%E6%96%87%E6%A1%A3.md) 符合多商户多应用、全栈模型同构、多端统一用户身份的一套SaaS共享数据模型，[UCToo](https://gitee.com/uctoo/uctoo)已内置开源版
10. [UCToo应用市场](https://appstore.uctoo.com) 支持云原生分布式SaaS应用进行商业化分发的应用市场,连接开发者和商户的开放式交易平台
11. [微用户小程序](https://gitee.com/UCT/miniprogram-demo) 开发者服务小程序，提供开源项目商业化全流程运营支撑，开源版本修改自[微信官方Demo小程序](https://github.com/wechat-miniprogram/miniprogram-demo)，提供开发者UCToo开发示例  
12. [www.uctoo.com](https://www.uctoo.com) UCToo产品官网，采用UCToo APP server 开发的，支持云原生分布式的新一代SaaS服务运营支撑平台。  
13. [AgentSkills-runtime](https://atomgit.com/UCToo/agentskills-runtime) AgentSkills Runtime 是一个基于仓颉编程语言实现的 Agent Skills 标准运行时环境。它是对 AgentSkills 开放标准的国产技术栈实现，提供了安全、高效的 AI 智能体技能运行环境。同时提供了多语言SDK适配各种技术栈。旨在让 AgentSkills 能够在任何地方运行。    
  
## 主要特性  

  本项目的设计目标是通过面向AI开发进行特定优化，使得人人都可以通过自然语言进行应用开发。开发框架支持服务器端、Web管理后台、移动应用、小程序等采用一致技术栈快速生成多端兼容的数字化系统和应用，并可进行灵活的二次开发。

  
1.  先进技术，主流应用，开源开放。 
2.  模块可拆卸，系统只保留核心的功能，其余功能通过扩展模块来实现。 
3.  支持云原生应用开发，支持多商户多应用管理SaaS平台特性，可在多数云平台环境独立安装部署，支持云原生部署。 
4.  支持HarmonyOS/iOS/Android多系统多端多规格设备。 
5.  支持ArkUI/ArkTS等国产技术栈。 

## 产品架构
1.  系统融合了众多优秀开源项目，采纳通用技术，每周持续集成业界最佳实践。
2.  产品采用了[全栈模型同构(UMI)的编程理念](https://mp.weixin.qq.com/s/ja0jfsfkyIK2hdW6bDg2Ow)，UMI是一种在分布式系统间一致性同步状态的设计规范(Uniform Model Isomorphism)，项目实现了UMI-ORM以在前端应用（客户端缓存或客户端数据库）与服务端应用（云端数据库）之间高效便捷的同步数据。


```diff
- UCToo V3 技术选型采用了ArkUI/ArkTS等多端兼容技术栈，与V2 数据库结构一致，服务端可最小成本从V2 升级至V3 。 V3 已于2024年9月开源。
  同时集成公有云云原生部署环境，
  可实现SaaS应用实例模板去中心化部署，
  使得本项目符合Level 5 级SaaS产品的主要特性
```

## 安装教程

可通过以下开源项目进行二次开发。

1. [UCToo-docker项目源码](https://gitee.com/UCT/uctoo-docker)  https://gitee.com/UCT/uctoo-docker


## 问题反馈
  开发者交流QQ群984748053
  更多信息请关注UCToo官网 https://www.uctoo.com   

## 参考资料：
   官网 https://www.uctoo.com
            
     
## 版权信息  
UCToo遵循Apache2开源协议发布，并提供免费使用。

本项目包含的第三方源码和二进制文件之版权信息另行标注。

版权所有Copyright © 2014-2025 by UCToo (https://www.uctoo.com)

All rights reserved