资产管理 API
资产管理 API
概述
提供资产生命周期管理以及定位服务接口
资产类型
属性列表
| NAME | SORTABLE | TYPE | MAX | DESCRIPTION |
|---|---|---|---|---|
| id | - | ObjectId | - | 资产类型 ID |
| name | true | String | 32 | 资产类型名称 |
| code | true | String | 32 | 资产类型编号，只包含字母和数字 |
| icon | true | String | 32 | 资产类型图标，预留将来使用 |
| description | - | String | 100 | 资产类型描述 |
| created | true | Date | - | 创建日期 |
| updated | true | Date | - | 最后更新日期 |
查询列表
GET /assettype/list
添加
POST /assettype/add
修改
POST /assettype/update
删除
POST /assettype/del
供应商
属性列表
| NAME | SORTABLE | TYPE | MAX | DESCRIPTION |
|---|---|---|---|---|
| id | - | ObjectId | - | 供应商 ID |
| name | true | String | 32 | 供应商名称 |
| code | true | String | 32 | 供应商编号，只包含字母和数字 |
| description | - | String | 100 | 供应商简要描述 |
| created | true | Date | - | 创建日期 |
| updated | true | Date | - | 最后更新日期 |
查询列表
GET /vendor/list
添加
POST /vendor/add
修改
POST /vendor/update
删除
POST /vendor/del
品牌
属性列表
| NAME | SORTABLE | TYPE | MAX | DESCRIPTION |
|---|---|---|---|---|
| name | true | String | 32 | 名称 |
查询列表
GET /brand/list
返回包含所有品牌名称的列表
- 从资产列表中查询而来
存放地点
属性列表
| NAME | SORTABLE | TYPE | MAX | DESCRIPTION |
|---|---|---|---|---|
| name | true | String | 32 | 名称 |
查询列表
GET /location/list
返回包含所有存放地点名称的列表
- 从资产列表中查询而来
资产分类
属性列表
| NAME | SORTABLE | TYPE | MAX | DESCRIPTION |
|---|---|---|---|---|
| name | true | String | 32 | 名称 |
查询列表
GET /category/list
返回包含所有分类名称的列表
- 从资产列表中总结而来
- 具体项目还需要和用户最终确定
公司员工
属性列表
| NAME | SORTABLE | TYPE | MAX | DESCRIPTION |
|---|---|---|---|---|
| name | true | String | 32 | 员工名称 |
| uid | true | String | 32 | 员工工号 |
查询列表
GET /member/list
返回包含所有公司员工的列表
资产
属性列表
| NAME | SORTABLE | TYPE | MAX | DESCRIPTION | |
|---|---|---|---|---|---|
| id | - | ObjectId | - | 资产类型 ID | |
| name | true | String | 32 | 资产名称 | |
| ename | true | String | 32 | 资产英文名称 | |
| tid | true | String | 32 | 定位标签 ID | |
| saeId | true | String | 32 | 原厂编号 | |
| category | true | String | 32 | 资产分类 | |
| type | true | String | 32 | 资产类型 | |
| department | true | Object | 32 | 使用部门 | |
| user | true | Object | 32 | 使用人 | |
| brand | true | String | 32 | 品牌 | |
| model | true | String | 32 | 型号 | |
| sn | true | String | 32 | 序列号 | |
| location | true | String | 32 | 存放地点 | |
| code | true | String | 32 | 资产类型编号，只包含字母和数字 | |
| status | true | String | 32 | 状态(源自导入) | |
| state | true | String | - | 资产状态 | |
| remarks | - | String | 100 | 备注 | |
| description | - | String | 100 | 资产简要描述 | |
| ownerId | - | ObjectId | - | 所属公司账号 | |
| created | true | Date | - | 创建日期 | |
| updated | true | Date | - | 最后更新日期 | |
| utime | true | Date | - | 更新日期 (源自导入) | |
| rtime | true | Date | - | 入厂日期 | |
| qty | true | number | - | 数量 | |
| vendor | true | Object | - | 供应商 |
资产状态 - state
- idle 闲置, 一般是资产部新录入的资产
- use 使用中
- scrapped 已报废
- maintenance 维修中
- transferred 已转出
资产分类
- 东莞转入
- 赠送
- 外借
- B1
- B6
- 台湾转入
- 新视购入
- 办公类
- 生产类
- 仪器类
- 其他
查询列表
GET /asset/list
查询详情
GET /asset/get
添加
POST /asset/add
修改
POST /asset/update
删除
POST /asset/del
资产事务
属性列表
| NAME | SORTABLE | TYPE | MAX | DESCRIPTION |
|---|---|---|---|---|
| id | - | ObjectId | - | 资产事务 ID |
| type | true | String | 32 | 资产事务名称 |
| status | true | String | 32 | 资产事务状态 |
| user | - | Object | - | 操作用户信息 |
| data | - | Object | - | 详细数据 |
| activetime | - | - | - | - |
| remark | - | String | 100 | 备注消息 |
| assets | - | Object[] | - | 相关的资产列表 |
| ownerId | - | ObjectId | - | 所属公司 ID |
| created | true | Date | - | 创建日期 |
| updated | true | Date | - | 最后更新日期 |
事务状态
- pending 处理中
- fulfilled 完成的
- rejected 未完成的 (取消或拒绝的)
事务类型
领用
- checkOut 领用资产
- 创建事务后直接进入 fulfilled 状态
- 资产 ID (可多选, 可扫码输入)
- 操作人
- 登记日期 (可选)
- 领用人 - staff
- 名称 (可多选? 需要和用户确认)
- 工号（可选）
- 部门 (只填编号)
- 存放地点
- 备注
入库
- checkIn 资产入库
- 创建事务后直接进入 fulfilled 状态
- 资产 ID (可多选, 可扫码输入)
- 操作人
- 登记日期 (可选)
- 存放地点
- 备注
转移
- move 转移资产
- 部门间转移
- 创建事务后直接进入 fulfilled 状态
- 转移前使用部门
- 其他同 Check Out
- 外部转移
- 创建事务后首先进入 pending 状态，可选 fulfilled/rejected 来完成这个事务
- 操作人
- 登记日期 (可选)
- 供应商 - vendor
- 名称
- 编号
- 备注
- 具体流程待定, 需要和用户沟通
- 转出前状态
- 完成后, 资产为已转出状态
- recover 资产恢复
- 创建事务后直接进入 fulfilled 状态
- 操作人
- 登记日期 (可选)
- 备注
- 恢复后, 资产将恢复转出前的状态
- 部门间转移
报废
- dispose 资产报废
- 创建事务后直接进入 fulfilled 状态
- 操作人
- 登记日期 (可选)
- 报废前状态
- 备注
- 完成后, 资产为已报废状态
- recover 资产恢复
- 创建事务后直接进入 fulfilled 状态
- 操作人
- 登记日期 (可选)
- 备注
- 恢复后, 资产将恢复转出前的状态
维修
- maintain 资产维修
- 创建事务后首先进入 pending 状态，可选 fulfilled/rejected 来完成这个事务
- 操作人
- 登记日期 (可选)
- 完成日期 (可选)
- 维修前状态
- 备注
- 未完成时, 资产为正在维修状态
- 完成后, 资产将恢复转出前的状态
查询列表
GET /transaction/list
查询详情
GET /transaction/get
添加
POST /transaction/add
修改
POST /transaction/update
删除
POST /transaction/del
定位标签
属性列表
| NAME | SORTABLE | TYPE | MAX | DESCRIPTION |
|---|---|---|---|---|
| id | - | ObjectId | - | 资产类型 ID |
| name | true | String | 32 | 资产类型名称 |
| tid | true | String | 32 | 资产类型编号，只包含字母和数字 |
| locator | true | String | 最后所属定位器 ID | |
| locators | - | Object[] | 和其他定位器的关系 | |
| lastSeenOn | - | Date | 最后定位时间 | |
| floorId | - | ObjectId | - | 所属楼层 ID |
| assetId | - | ObjectId | - | 所属资产 ID |
| description | - | String | 100 | 资产类型描述 |
| ownerId | - | ObjectId | - | 所属公司 ID |
| created | true | Date | - | 创建日期 |
| updated | true | Date | - | 最后更新日期 |
locators
- key - 定位器 DID
- value - RSSI 值
查询列表
GET /tag/list
查询详情
GET /tag/get
添加
POST /tag/add
修改
POST /tag/update
删除
POST /tag/del
定位器
属性列表
| NAME | SORTABLE | TYPE | MAX | DESCRIPTION |
|---|---|---|---|---|
| id | - | ObjectId | - | 设备 ID |
| name | true | String | 32 | 设备名称 |
| did | true | String | 32 | 设备 DID |
| type | true | String | 32 | 设备类型 |
| key | true | String | 32 | 产品编号 |
| tags | - | Object[] | - | 附近标签列表 |
| properties | - | Object | - | 属性列表 |
| created | true | Date | - | 创建日期 |
| updated | true | Date | - | 最后更新日期 |
查询列表
GET /locator/list
查询详情
GET /locator/get
盘点
audit
reports
users
lookups
系统信息
统计分析
GET /system/stat
权限管理
- 系统管理员
- 资产分类管理
- 供应商管理
- 所有人
- 查询（没有限制)
- 内部资产转移（没有限制)
- 报废（限部门资产)
- 维修（限部门资产)
- 资产管理部
- 资产分类管理
- 供应商管理
- 资产录入
- 资产修改
- 资产转出确认
- 生产部
- 办公室