NocoBase 教程体系全解析从 IT 工单系统到 AI 员工实践的无代码搭建指南【免费下载链接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobaseNocoBase 是一个开源的、极易扩展的 AI 无代码开发平台其官方教程体系docs/docs/cn/tutorials/index.md围绕搭建系统、搭建技巧、AI 员工三大学习方向组织内容帮助零基础用户循序渐进地掌握数据建模、页面搭建、工作流和仪表盘等核心能力。本文将完整梳理这套教程的导航结构与学习路径并结合仓库中 V2 教程 与 V1 教程 的 7 章与 24 章实战内容深入讲解两张表搭建 IT 工单系统的完整过程同时补充 搭建技巧 与 AI 员工实践方向让你读完即可规划自己的 NocoBase 学习路线并动手搭建第一个业务系统。教程中心三大学习方向的导航枢纽docs/docs/cn/tutorials/index.md是 NocoBase 中文教程的导航首页。该页面使用pageType: home布局通过features字段定义了三条相互独立又层层递进的学习路径其_meta.jsondocs/docs/cn/tutorials/_meta.json将内容组织为两个版本目录教程系列侧边栏标签定位V2 教程V2 教程IT 工单系统面向新版界面的完整入门教程案例为极简 IT 工单系统V1 教程V1 教程旧版默认折叠旧版界面以任务管理系统为案例的进阶教程三大学习方向1. 搭建系统链接至 V2 教程跟随完整业务教程从数据建模、页面搭建到工作流和业务交互逐步完成一个可用系统。这是教程体系的主干。V2 教程以IT 工单系统HelpDesk为贯穿案例仅用 2 张数据表即可覆盖数据建模、页面搭建、表单设计、权限控制、工作流和仪表盘等核心功能最终交付一个包含工单提交、分类管理、变更追踪、权限控制和数据看板的可用系统。2. 搭建技巧链接至 operations-dashboard学习页面设计、数据展示、筛选联动和跨区块交互等可复用的实战技巧。对应文档为 用 NocoBase 搭建可联动的运营仪表盘以工单运营仪表盘为例讲解图表区块、筛选区块与 JS 区块的组合用法实现统一筛选、KPI 统计、图表下钻和自定义样式。3. AI 员工链接至 AI 员工实践把 AI 员工接入真实业务页面和工作流完成分析、调研、翻译等业务任务。在仓库中这一方向对应 AI 员工快速上手 等文档覆盖 AI 员工的内置能力、权限配置、知识库与工作流接入等主题是 NocoBase 2.0 AI 融入业务理念的落地路径。V2 教程的 7 章学习路径V2 教程的章节编排见 docs/docs/cn/tutorials/v2/_meta.json构成了一条完整的从安装到看板的主线#章节核心要点1认识 NocoBaseDocker 安装、配置模式 vs 使用模式2数据建模Collection/Field、普通表与树表、多对一关联3搭建页面Block 区块、表格区块、筛选排序4表单与详情表单区块、字段联动、记录历史5用户与权限角色、菜单权限、数据权限6工作流自动通知、状态变更触发7仪表盘饼图/折线图/柱状图、Markdown 区块教程定位明确目标读者为业务人员、技术人员或任何对 NocoBase 感兴趣的人建议具备一定计算机背景知识预计耗时2-3 小时非技术人员、1-1.5 小时技术人员版本为 NocoBase 2.0。第 1 章实战Docker 一键安装并跑通首个界面教程建议采用最简单的 Docker 安装 方式。前置条件为本机已安装 Docker 与 Docker Compose 并确保服务运行Windows / Mac / Linux 均支持。安装步骤如下# 创建项目目录并进入 mkdir my-project cd my-project # 下载 docker-compose.yml默认使用 PostgreSQL curl -fsSL https://static-docs.nocobase.com/docker-compose/cn/latest-postgres.yml -o docker-compose.yml # 拉取镜像 docker compose pull # 后台启动首次会自动执行安装 docker compose up -d # 查看日志确认启动成功 docker compose logs -f app不同数据库的下载链接对应关系为PostgreSQL推荐为latest-postgres.ymlMySQL 为latest-mysql.ymlMariaDB 为latest-mariadb.yml版本可选latest稳定版、beta测试版、alpha开发版。看到日志输出 NocoBase server running at: http://localhost:13000/即表示启动成功。仓库 docker/app-postgres/docker-compose.yml 展示了同类编排文件的完整结构app服务使用nocobase/nocobase:latest镜像通过环境变量配置APP_KEY应用密钥、ENCRYPTION_FIELD_KEY字段加密密钥、DB_DIALECTpostgres、DB_HOST、DB_DATABASE、DB_USER、DB_PASSWORD等数据库连接信息将宿主端口13000映射到容器80并通过 volume 将./storage挂载为持久化存储目录postgres服务则负责承载数据库且启用了wal_levellogical以支持逻辑复制。仓库还提供了 MySQL、MariaDB、SQLite 等数据库的对应编排文件方便按需选择。启动后访问http://localhost:13000使用默认账号登录账号adminnocobase.com密码admin123首次登录后请及时修改配置模式 vs 使用模式登录后进入的界面分为两种模式这是理解 NocoBase 一切操作的关键模式说明谁用使用模式普通用户日常使用的界面所有人配置模式搭建和调整界面的设计模式管理员切换方式点击右上角的「界面配置UI Editor」按钮荧光笔图标。开启配置模式后页面元素周围会出现橙色高亮框每个可配置元素右上角都有小图标点击即可设置。记住这条规律想修改画面就进入配置模式找到对应元素右上角的小图标点击即可。界面由三个区域组成顶部导航栏放置一级菜单切换模块、左侧菜单 group分组菜单下的二级菜单组织页面层级、内容区域页面的主体放置各种区块 Block 来展示和操作数据。第 2 章实战数据建模——两张表搞定工单系统教程强调数据模型是系统的地基并用 Excel 类比帮助理解工作表 ≈ 数据表Collection列标题 ≈ 字段Field每一行 ≈ 记录Record。数据表类型选择NocoBase 支持多种数据表类型教程docs/docs/cn/tutorials/v2/02-data-modeling.md与数据表文档docs/docs/cn/data-sources/data-modeling/collection.md相互印证不同类型自带不同能力表类型适合场景举例普通表大多数业务数据工单、订单、客户树表有层级关系的数据分类目录、部门组织架构日历表带时间范围的日期事件会议、排班文件表附件元信息管理文档、图片评论表围绕业务记录的讨论内容任务评论、审批意见数据库视图 / SQL 表复用数据库既有视图或查询结果报表、聚合统计在数据表Collection层面NocoBase 将其定义为业务对象的数据结构——它统一描述数据保存在哪里主库表、外部库、SQL 结果、视图、REST API 等、有哪些字段、以及如何被页面区块、权限、工作流、API 和关系字段使用。工单系统将用到普通表工单和树表工单分类。创建工单表普通表在左下角进入「数据源管理」→「主数据源」点击「创建数据表」选择「普通表」命名为tickets标题工单。创建时系统默认勾选一组系统字段自动记录每条数据的元信息字段说明ID主键分布式唯一标识创建日期记录的创建时间创建人谁创建了这条记录最后修改日期最后一次更新时间最后修改人最后一次更新的用户随后通过「配置字段Configure fields」→「添加字段Add field」添加基础字段教程中给出了四个字段的完整配置1. 标题单行文本字段名title标题「标题」并添加「必填」验证规则。2. 描述Markdown(Vditor)字段名description。「Media」分类下三种类型对比——Markdown基本样式、Rich Text富文本 附件上传、Markdown(Vditor)功能最丰富支持所见即所得、即时渲染、源码编辑三种模式教程选用后者。3. 状态下拉菜单-单选字段名status选项值/标签/颜色如下选项值选项标签颜色pending待处理Orange日暮in_progress处理中Blue拂晓蓝completed已完成Green极光绿保存选项后再次编辑该字段即可在「默认值」中选择「待处理」。使用下拉单选是因为状态是固定几个值可防止随意填写、保证数据规范。4. 优先级下拉菜单-单选字段名priority选项为 low/中/medium/high/urgent其中 high 用 Orange日暮、urgent 用 Red薄暮。创建分类树表并建立关联分类可能存在子分类硬件问题下有显示器键盘打印机因此选择树表创建categories标题工单分类。树表自动携带Parent和Children两个关系字段无需手动维护父子关系即可实现如下层级硬件问题 ← 一级分类 ├── 显示器 ← 二级分类 ├── 键盘鼠标 └── 打印机 软件故障 ├── 办公软件 └── 系统问题 网络问题 账号权限分类表添加两个字段分类名称name单行文本必填与颜色color颜色字段用于界面标识。回到工单表添加多对一M2O关系字段。关系字段不像标题那样直接存文字而是存储另一张表某条记录的 ID通过 ID 精准定位对应记录——界面上看到的是名称网络问题张三背后就是 ID 关联。配置项说明配置项说明怎么填源数据表当前表自动填好不用改目标数据表要关联到哪张表选择对应的表外键存在当前表里的关联列名填一个有意义的名字目标数据表标识字段默认id保持默认即可ON DELETE目标记录被删除时的处理方式保持默认即可教程提示外键默认生成随机名如f_xxxxx建议改为有意义的名字用小写字母加下划线如category_id。最终添加工单表的三个关联字段分类目标表工单分类外键category_id、提交人目标表用户外键submitter_id、处理人目标表用户外键assignee_id。NocoBase 内置用户表直接关联即可。至此完整数据模型为工单表tickets4 个基础字段 3 个关联字段工单分类表categories2 个自定义字段 自动的 Parent/Children 字段。第 3 章实战搭建页面——让数据看得见数据模型就绪后教程docs/docs/cn/tutorials/v2/03-building-pages.md进入页面搭建环节核心概念是区块Block——页面上的积木类型用途表格Table以行列形式展示多条数据表单Form让用户输入或编辑数据详情Details展示单条记录的完整信息筛选表单Filter Form提供筛选条件过滤其他区块的数据图表Chart饼图、折线图等可视化展示Markdown放一段自定义文字或说明操作流程进入配置模式 → 顶部导航栏「添加菜单项」→「添加分组」命名「工单管理」→ 点击该菜单后在左侧分组菜单添加两个「新版页面v2」子页面工单列表、工单分类→ 在页面中「创建区块」选择「数据区块 → 表格」并选择「工单」表。表格区块添加后通过「配置操作Configure actions」勾选「新建Add new」按钮并在弹窗中「添加区块 → 表单新增→ 当前数据表」勾选标题、状态、优先级等字段并开启「提交」按钮即可录入测试数据。配置显示列点击表头右侧「字段Fields」勾选展示字段标题、状态、优先级、分类、提交人、处理人字段顺序可通过拖拽调整。关联字段显示 ID 的修复勾选「分类」后表格默认显示 ID 而非名称两种修复方式方式一仅当前表格生效在「分类」列的配置项中将「标题字段Title field」从 ID 改为「名称」方式二全局生效推荐在「设置 → 数据源 → 数据表 → 分类表」中将「标题字段」改为「名称」修改后需回到页面重新添加该字段。添加筛选排序在页面「创建区块」→「筛选区块 → 筛选表单」v2 页面无需选择数据表点击「字段Fields」即可看到当前页面所有可被筛选的数据区块如Table: 工单 #c48b后缀为区块 UID勾选后即可实现按状态、分类、优先级等条件过滤工单。第 4-7 章概览表单、权限、工作流与仪表盘V2 教程的后续章节在前三章基础上继续完善系统第 4 章 表单与详情深入表单区块配置包括新增/编辑表单、字段联动如根据分类动态显示字段以及记录历史功能第 5 章 用户与权限创建角色、分配菜单权限与数据权限实现普通用户只看自己的工单管理员看全部的典型需求第 6 章 工作流配置自动通知与状态变更触发例如工单状态变化时通知处理人这是 NocoBase 自动化的核心亮点第 7 章 仪表盘通过饼图/折线图/柱状图实时统计工单状态分布与趋势配合 Markdown 区块补充说明文字。搭建技巧方向可联动的运营仪表盘在三大学习方向的搭建技巧分支operations-dashboard 文档 给出了一套可复用的组合思路让原生区块负责标准能力让 JS 区块补足个性化体验而不是全部配置或全部写代码的二选一。以一个工单运营看板为例页面按职责拆分为四层顶部筛选区时间、服务组、请求类型、优先级、SLA 状态使用系统自带的筛选区块KPI 统计区Open backlog、Unassigned、SLA warning 等使用 JS 区块图表分析区趋势、状态、SLA、优先级分布使用原生图表区块下钻明细区使用 JS 区块。筛选区块同时影响图表区块与 JS 区块图表点击后将下钻条件传给 JS 明细区块。图表区块可先用 Query builder 定义统计口径再用自定义 ECharts option 调整样式。该方法同样适用于 CRM、设备运维、项目管理、审批流等业务场景。AI 员工方向把 AI 融入真实业务AI 员工是 NocoBase 2.0 教程体系的重要方向。在仓库中AI 员工快速上手 及其目录下的 built-in内置能力、configuration配置、permission权限、knowledge-base知识库、workflow工作流、scenarios场景等文档共同构成了完整的实践路径。AI 员工可以接入真实业务页面与工作流执行分析、调研、翻译、录入等业务任务与 V2 教程中内置 AI 员工的理念一致是教程体系从搭建系统迈向智能系统的进阶选择。V1 教程以任务管理系统为案例的进阶路线V1 教程首页 从企业常见痛点切入业务需求频繁变化、开发交付紧迫、无代码平台能力有限、数据隐私与集成困难等说明 NocoBase 的设计目标是在易用性、功能强大与低复杂度之间取得平衡并以插件机制支撑高度自定义扩展。V1 系列以任务管理系统为贯穿案例从初级功能任务创建、评论互动、管理权限、通知设置逐步扩展到项目管理平台核心概念与任务的结合点包括数据表任务、用户、评论、区块多展示样式的数据呈现与评论插件扩展、操作增删改查及管理控制、插件扩展Markdown 与评论插件、工作流任务负责人提醒。依据 docs/docs/cn/tutorials/v1/_meta.jsonV1 共 24 章覆盖从初识 NocoBase、设计系统、任务数据管理、插件、标签页与动态区块、用户与权限、工作流到项目管理平台概览、知识库树表、任务看板与图表、看板筛选与条件、子任务与工时计算、会议室预订、用户注册审核、CRM 线索转化、Markdown 技巧、CRM 销售云、API Keys 数据获取、Markdown 模板变量、快速部署、销售管道可视化与 Demo 部署等进阶内容是深入学习多表建模、复杂权限与自动化场景的完整案例库。常见问题与学习建议教程docs/docs/cn/tutorials/v2/index.md针对初学者最常见的疑问给出明确答案NocoBase 适合什么场景企业内部工具、数据管理系统、审批流程、CRM、ERP 等需要灵活定制的场景支持私有化部署完成教程需要什么基础不需要编程但建议具备一定计算机基础知识有数据库或 Excel 使用经验更容易上手教程中的系统可以扩展吗可以。教程只用了 2 张表但 NocoBase 支持复杂的多表关联、外部 API 集成、自定义插件等需要什么部署环境推荐 DockerDocker Desktop 或 Linux 服务器最低 2 核 4GB 内存也支持 Git 源码运行仅体验学习可使用官方在线 Demo有效期 24 小时无需安装免费版有什么限制核心功能完全免费开源商业版提供额外高级插件和技术支持。从技术栈看NocoBase 2.0 基于 React Ant Design 5.0前端、Node.js Koa后端构建数据库默认支持 PostgreSQL也支持 MySQL、MariaDB部署方式涵盖 Docker 与 Kubernetes。仓库中 docker 目录下提供了 app-postgres、app-mysql、app-mariadb、app-sqlite 四套编排文件可据此快速搭建不同数据库组合的运行环境。学习路径建议零基础用户可从 V2 教程第 1 章开始跟随 7 章主线在 2-3 小时内完成首个工单系统有旧版使用经验的读者可参考 V1 任务管理系统教程深化多表建模与自动化能力完成基础搭建后通过运营仪表盘技巧掌握筛选联动与 JS 区块组合最后接入 AI 员工为系统注入智能能力——这正是 NocoBase 教程体系从完整系统到专项技巧再到 AI 员工实践的完整进阶逻辑。【免费下载链接】nocobaseNocoBase is an open-source AI no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考