---
title: "核心概念"
description: "理解平台、租户、应用和消费者数据域。"
canonical_url: "https://docs.mcent.cn/qicore/concepts"
---
# 核心概念

> 理解平台、租户、应用和消费者数据域。

## 平台

平台管理租户和已安装应用。安装应用与授予某个租户使用该应用是不同的操作；实际访问由服务端核验当前装配、租户绑定与授权状态。

## 租户

租户拥有独立的站点、配置与业务数据。后台账号可以关联多个站点，访问权限按站点分别授予，不能将账号身份等同于某一租户的全部权限。

每个租户最多绑定一个当前应用。取消或更换当前应用时，保留历史配置和记录，并处理尚未完成的业务任务。

## 应用

应用是独立交付的业务单元，拥有独立源码、版本、模型和迁移。不同应用可以声明相同的业务页面路径，由宿主按服务端核验后的当前租户应用分发。

应用模型和物理表必须全局唯一；新应用使用自己的命名空间。

## 业务身份与组件身份

<table>
<thead>
  <tr>
    <th>
      字段
    </th>
    
    <th>
      含义
    </th>
    
    <th>
      示例
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        key
      </code>
      
       / <code>
        applicationKey
      </code>
    </td>
    
    <td>
      业务应用身份，用于路由、租户绑定和消费者范围
    </td>
    
    <td>
      <code>
        notes-app
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        packageKey
      </code>
      
       / <code>
        licensePackageKey
      </code>
    </td>
    
    <td>
      授权、安装和发行组件身份
    </td>
    
    <td>
      <code>
        app_notes_demo
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        version
      </code>
    </td>
    
    <td>
      该应用自己的发行版本
    </td>
    
    <td>
      <code>
        0.1.0
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        namespace
      </code>
    </td>
    
    <td>
      插件在所属应用中的扩展命名空间
    </td>
    
    <td>
      <code>
        notesExport
      </code>
    </td>
  </tr>
</tbody>
</table>

业务身份与组件身份持久对应。改显示名称、改变源码目录、卸载或重装都不表示旧身份可以交给另一包使用。

应用版本、SDK npm 包版本、SDK API 版本和宿主版本分别维护，不能把相同数字当作兼容证明。完整字段见[应用描述与入口](https://docs.mcent.cn/qicore/application-manifest)。

## 插件

插件通过 `qicore-plugin-v1` 声明所属业务应用和命名空间。它扩展已有数据域，不成为租户的当前应用，也不占用应用坑位。

应用插件指定业务 `applicationKey`；框架插件以 `*` 声明，在各当前应用数据域分别运行，零应用时使用宿主 `system` 域。权限与路由经装配检查后接入，不能覆盖原应用或宿主的处理器。详见[插件开发](https://docs.mcent.cn/qicore/plugin-development)。

## 消费者身份

消费者身份与相关数据必须完整限定在以下组合中：

```text
tenantId / applicationKey / userId
```

不要只凭 `userId` 查询跨租户或跨应用数据，不要从客户端传入的应用编号推导授权。

## system 公共数据域

`system` 是宿主保留的公共数据域，不属于已安装应用，不占租户应用授权位置。它有独立的公共客户端权限，不能替代任何应用的授权，也不能合并不同数据域的消费者数据。

## 代码已加载与业务可访问

源码已装配、组件已安装、软件授权有效、租户已选应用、当前账号有操作权限，是不同的判断。

一次业务访问仍须核验当前会话、租户状态、应用绑定和权益，以及具体资源的完整范围。后台统计权限不自动授予消费者身份，浏览器选择提示也不能充当授权。

继续阅读[开发规范](https://docs.mcent.cn/qicore/development-standards)和[HTTP 接口](https://docs.mcent.cn/qicore/http-api)。


## Sitemap

See the full [sitemap](https://docs.mcent.cn/sitemap.md) for all pages.