应用配置

应用的创建、维护与进入工作区。

概述

在 开发中心 → 应用管理 中可以管理所有应用。应用是实体对象的集合，一个应用通常对应一套较为完整的业务场景，是开发者在平台上组织业务模块的顶层容器。

应用管理界面包含两个页签：

页签	说明
我的应用	以卡片或列表方式展示当前用户可见的应用，点击即可进入应用工作区
应用列表	以表格方式展示应用的分页列表，支持查询、新建、编辑与查看详情

定位说明

应用只负责组织实体对象，数据权限、审批流程、表单、视图列表等配置都在实体对象上完成，与应用的划分无关。应用与菜单也没有强制绑定关系。

配置项

应用本身只有少量基础属性，分为「基本信息」与「系统属性」两类。

配置项	说明
名称	应用显示名称，必填
编码	应用唯一编码，必填，用于程序侧标识应用
图标	应用图标，在应用选择器中展示
描述	应用的功能说明，建议填写业务范围

标识与外观

名称：面向用户的显示名，出现在应用选择器、工作区标题等位置。
编码：面向程序的唯一标识，创建后不可修改，建议使用小写下划线风格（如 book_management），便于在脚本、接口中引用。
图标：通过图标选择器设置，保存的是图标标识串；展示时由前端渲染为对应图标，未设置时回落为默认图标。

我的应用

「我的应用」以更友好的方式展示应用，便于快速进入：

支持卡片视图与列表视图两种展示模式，可通过搜索框右侧的设置按钮切换，切换结果会保存在浏览器本地（localStorage）。
支持按应用名称关键字搜索。
点击任意应用即可进入该应用的工作区，工作区默认落地到该应用下的实体对象列表。

应用列表

「应用列表」提供表格化的管理能力：

操作	说明
新建应用	填写名称、编码、图标、描述后创建，创建成功后自动进入新应用的工作区
编辑	修改应用的名称、图标、描述（编码在创建后不可修改）
查看详情	以抽屉方式展示应用的全部属性
查询	支持按名称、编码模糊查询，支持按编码排序

创建后自动跳转

只有「新建」操作会在创建成功后自动进入新应用的工作区；编辑操作停留在当前列表。

应用划分建议

建议按独立的业务模块拆分应用，这样便于后续以 SaaS 方式按需分发、按最小化原则开通。例如「图书管理」「客户管理」「项目管理」分别作为独立应用。

详细的划分理念可参考应用概念文档。

下一步

对象配置 - 在应用下创建实体对象

属性明细

以下内容面向技术实现与 AI 检索，逐个说明应用属性的类型、含义与存储。

应用属性表

属性名	类型	含义	取值/存储值
`_id`	string(GUID)	应用主键	例：`9f1c0b2e-...`
`Code`	string	应用编码，必填	业务唯一编码，创建后不可修改
`Name`	string	应用名称，必填	显示名称
`Icon`	string	应用图标	图标标识串，前端由 `IconDisplayCmp` 渲染
`Description`	string	应用描述	纯文本，可为空
`Customized`	bool	是否被自定义过	系统内置应用被修改后置为 `true`
`CustomCreated`	bool	是否由用户自定义创建	用户新建的应用为 `true`
`VisitCount`	int	访问次数	整型计数

通用实体属性

应用继承自 EntityBase，同时具备以下通用属性：

属性名	类型	含义
`IsDeleted`	bool	是否已删除（逻辑删除）
`CreatedBy` / `CreatedTime`	string / datetime	创建人 / 创建时间
`ModifiedBy` / `ModifiedTime`	string / datetime	修改人 / 修改时间
`Organization`	string(GUID)	所属组织

存储示例

应用数据存储在数据表 system_metaapp 中：

{
  "_id": "9f1c0b2e-2d3a-4e6f-9c11-0f7a5b8d2e10",
  "Code": "book_management",
  "Name": "图书管理系统",
  "Icon": "BookOutlined",
  "Description": "图书借阅与归还管理",
  "Customized": false,
  "CustomCreated": true,
  "VisitCount": 12,
  "IsDeleted": false,
  "CreatedBy": "admin",
  "CreatedTime": "2026-01-05T09:12:30"
}

接口	说明
`GET /api/MetaApp/GetAppLiteList`	获取轻量应用列表（仅 `_id`/`Name`/`Description`/`Icon`）
`POST /api/MetaApp/GetAppList`	分页获取应用列表
`POST /api/MetaApp/Create`	新建应用
`POST /api/MetaApp/Edit`	编辑应用
`GET /api/MetaApp/Get`	获取应用详情

约束说明

Code 在 POST /api/MetaApp/Edit 中不参与修改，仅在创建时写入。
Icon 为空时前端使用默认图标渲染，不影响数据存储。
只有「新建」操作会在创建成功后自动进入新应用的工作区。

概述​

配置项​

标识与外观​

我的应用​

应用列表​

应用划分建议​

下一步​

属性明细​

应用属性表​

通用实体属性​

存储示例​

相关接口​

约束说明​

概述

配置项