资产管理 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

权限管理

  • 系统管理员
    • 资产分类管理
    • 供应商管理
  • 所有人
    • 查询（没有限制)
    • 内部资产转移（没有限制)
    • 报废（限部门资产)
    • 维修（限部门资产)
  • 资产管理部
    • 资产分类管理
    • 供应商管理
    • 资产录入
    • 资产修改
    • 资产转出确认
  • 生产部
  • 办公室
image-modal