• 开发者可通过平台提供的角色/用户管理接口创建需要的用户或将其他平台用户同步到ICC平台完成
• 开发者可通过用户登录接口到平台完成认证授权，根据登录返回的授权信息来调用平台提供的业务接口完成和平台的业务对接

• ICC平台已成功安装并正常运行
• 相关业务子系统已安装

• Step1: 调用获取鉴权信息 接口获取认证信息;

• Step2: 获取角色id,可以调用角色新增接口或者角色信息分页查询接口获取角色id;

• Step3: 如果新增用户不用绑定人员,则跳过该步骤;如果新增用户需要绑定人员,则需要准备人员信息,可以通过人员信息分页获取 或者通过证件号码获取人员详情或者人员新增 来准备人员信息。

• Step4: 调用用户新增 接口添加新用户,用户信息中必须绑定角色,人员可以选择是否绑定;

• 开发者可通过平台组织设备树结构信息查询接口按需获取当前平台特定设备和组织的层级关系树，为自身业务提供组织设备树状目录
• 开发者可按通过组织、设备管理接口来维护平台组织/设备信息，通过查询接口获取组织/设备详细信息列表

• ICC平台已成功安装并正常运行
• 相关业务子系统已安装

• Step1: 调用获取鉴权信息 接口获取认证信息;

• Step2: 使用组织分页查询 根据条件获取平台已存在组织信息列表,选择添加组织的父组织;

• Step3: 使用组织新增 接口或者使用组织批量新增

• Step1: 调用获取鉴权信息 接口获取认证信息;

• Step2: 调用设备详情查询 接口获取设备详细信息 或者使用设备分页查询 接口按条件获取设备信息列表 或者使用设备通道分页查询 接口获取设备通道信息

• Step1: 调用获取鉴权信息 接口获取认证信息;

• Step2: 使用设备树查询 接口按当前用户权限获取组织/设备目录树，包括组织、设备、设备通道三种节点，支持按组织、设备、通道类型及能力集对节点过滤，为开发者提供层级化的组织/设备信息展示。开发者业务存在【组织/设备】和【自定义逻辑节点/业务实体】绑定关系，需要在组织/设备目录树中加入自定义节点时，可通过对设备树查询结果二次封装来提供更多类型数据节点树状展示

• 开发者可通过部门、人员管理接口来维护平台部门/人员信息，通过查询接口获取部门/人员详细信息列表及目录树展示

• ICC平台已成功安装并正常运行

部门节点区分于组织节点，部门节点主要关联人员、卡片、车辆等信息，为组织机构纬度的逻辑节点；组织节点主要关联设备信息，主要按照地理区域位置划分

• Step1: 调用获取鉴权信息 接口获取认证信息;

• Step2: 使用部门全局id生成 接口生成新部门的ID,也可以使用批量部门ID可以使用新增部门ID批量获取 接口批量生成部门id

• Step3: 获取的部门id后，使用部门新增 接口创建部门或者通过部门批量新增 接口批量创建部门

• Step1: 调用获取鉴权信息 接口获取认证信息;

• Step2: 调用人员全局id生成接口生成新增人员ID或者调用人员全局id批量生成 批量获取人员ID;

• Step3: 如果新增人员不包含头像跳过该步骤;如果需要包含头像,则调用人员图片上传接口上传头像，获取存储路径

• Step4: 如果新增人员的同时不新增卡片和车辆,调用人员新增 接口新增人员或者人员批量新增 接口批量新增人员;如果需要同时新增卡片、车辆信息,则调用人员（包含车辆、卡片信息）新增 接口新增人员，人员信息可以包含人员的卡片、车辆

• Step1: 调用获取鉴权信息 接口获取认证信息;

• Step2: 使用部门/人员目录树查询 接口获取部门/人员按树状层级返回

• 编程示例点击下载

• 开发者可通过平台卡片管理相关接口完成卡片相关业务

• ICC平台已成功安装并正常运行

• Step1: 调用获取鉴权信息 接口获取认证信息;

• Step2: 使用卡片全局id生成 接口获取卡片ID

• Step3: 使用卡片新增 接口接口完成开卡，卡片不绑定人员，开的是空白卡

• Step1: 调用获取鉴权信息 接口获取认证信息;

• Step2: 使用卡片全局id生成 接口获取卡片ID

• Step3: 使用人员详情信息获取(根据人员证件号获取) 接口或者使用人员信息分页获取 接口获取需要绑定的人员的id

• Step4: 使用卡片新增 接口接口完成开卡，卡片需要绑定人员信息，开的是激活卡

• Step1: 调用获取鉴权信息 接口获取认证信息;

• Step2: 使用卡片全局id批量生成

• Step3: 如果开空白卡，则跳过该步骤;如果开激活卡,需要使用人员详情信息获取(根据人员证件号获取) 接口或者使用人员信息分页获取 接口获取需要绑定的人员的id

• Step4: 使用卡片批量新增 接口进行空白卡(不绑定人员id)和激活卡(绑定人员id)的批量开卡

• Step1: 调用获取鉴权信息 接口获取认证信息

• Step2: 使用卡片信息分页查询 接口获取空白卡

• Step3: 获得的空白卡可通过卡片激活 接口给空白卡绑定人员来使卡片变为正常使用的卡片

• Step1: 调用获取鉴权信息 接口获取认证信息

• Step2: 使用卡片信息分页查询 接口获取需要进行换卡的激活卡

• Step3: 获取到的激活卡，可以使用换卡 接口完成换卡操作，被换的卡变为注销卡。

• Step4: 注销卡可通过卡片回收接口进行回收后变为空白卡再使用或者注销卡可以通过卡片删除接口进行删除

• Step1: 调用获取鉴权信息 接口获取认证信息

• Step2: 使用卡片信息分页查询 接口获取需要进行退卡的激活卡

• Step3: 获取到的激活卡，可以使用批量退卡 接口退卡，将卡片变为空白卡

• Step4: 空白卡可以使用卡片删除进行卡片删除,非空白卡/注销卡不能直接删除

• Step1: 调用获取鉴权信息 接口获取认证信息

• Step2: 使用卡片信息分页查询 接口获取需要进行挂失的激活卡

• Step3: 获取到的激活卡，可以使用卡片挂失 接口进行卡片挂失

• Step4: 挂失后的卡片可以通过卡片解挂 接口来解挂

• 开发者可通过平台车辆管理相关接口完成车辆信息管理

• ICC平台已成功安装并正常运行

• Step1: 调用获取鉴权信息 接口获取认证信息

• Step2: 如果车辆不需要绑定车主,则跳过该步骤;如果车辆需要绑定车主,则使用人员详情信息获取(根据人员证件号获取) 接口或者使用人员信息分页获取 接口获取需要绑定的人员的id

• Step3: 使用车辆新增 接口新增车辆信息或者使用车辆批量新增 接口批量添加车辆信息到平台,可以选择是否绑定人员

• 开发者可通过基础资源服务的基础数据同步接口和事件中心的消息订阅流程完成平台基础数据到第三方平台的实时同步

• ICC平台已成功安装并正常运行

• ICC平台基础数据包括【用户】【角色】【组织】【部门】【设备】【人员】【卡片】【车辆】

• 对接系统和ICC平台对基础数据的对接流程分【系统间全量数据同步】和 【实时数据感知】

• 对接系统需要同步ICC平台全量的基础数据，同时ICC平台基础数据有变更需要实时推送到对接系统

• 通过对应类型基础数据同步接口（分页查询接口见上图）从基础资源同步当前全量数据

• 从事件中心订阅该数据的实时变更消息