This repository has been archived on 2024-05-31. You can view files and clone it, but cannot push or open issues or pull requests.
devicehub-teal/docs/index.rst

61 lines
2.1 KiB
ReStructuredText
Raw Permalink Normal View History

2018-06-10 16:47:49 +00:00
.. title:: DeviceHub
.. image:: https://www.ereuse.org/files/2017/04/DeviceHub-logo-V2.svg
:height: 100px
:alt: DeviceHub logo
2018-06-10 16:47:49 +00:00
2018-11-17 16:03:03 +00:00
This is the documentation of the `eReuse.org Devicehub
2018-09-06 17:43:27 +00:00
<https://github.com/ereuse/devicehub-teal>`_.
2018-06-10 16:47:49 +00:00
2018-11-17 16:03:03 +00:00
Devicehub is a distributed IT Asset Management System focused in
reusing devices, created under the project
`eReuse.org <https://www.ereuse.org>`_.
Our main objectives are:
2019-03-26 09:55:38 +00:00
- To offer a common IT Asset Management for distributors, refurbishers,
receivers and other IT professionals so they can manage devices and exchange them.
This is, reusing —and ultimately recycling.
2018-11-17 16:03:03 +00:00
- To automatically recollect, analyse, process and share
(controlling privacy) metadata about devices with other tools of the
eReuse ecosystem to guarantee traceability, and to provide inputs for
the indicators which measure circularity.
2019-03-26 09:55:38 +00:00
The main entity of a Devicehub are :ref:`devices:Devices`, which is any object that
can be identified. Devices are divided in *types* (like ``Computer``),
and each one defines *properties*, like serial number, weight,
quality rating, pricing, or a list of owners.
2018-11-17 16:03:03 +00:00
2019-03-26 09:55:38 +00:00
We perform :ref:`actions:Actions` on devices, which are events that
change their *state* and *properties*. Examples are sales, reparations,
quality diagnostics, data wiping, and location.
Actions are stored in the traceability log of the device.
Devicehub is decentralized, and each instance is an inventory. We can
share and exchange devices between inventories —like in real live between
organizations.
:ref:`tags:Tags` identify devices through those organizations and their
internal systems. With Devicehub we can manage and print smart tags with
QR and NFC capabilities, operating devices by literally scanning them.
Devicehub is a REST API built with `Teal <https://github.com/ereuse/teal>`_ and
`Flask <http://flask.pocoo.org>`_ using `PostgreSQL <https://www.postgresql.org>`_.
`DevicehubClient <https://github.com/ereuse/devicehubclient>`_ is the
frontend that consumes this API.
.. toctree::
:maxdepth: 2
api
2018-11-06 13:49:16 +00:00
devices
actions
2019-03-26 09:55:38 +00:00
states
tags
2018-09-18 16:45:29 +00:00
lots
* :ref:`genindex`
* :ref:`modindex`
2018-06-10 16:47:49 +00:00
* :ref:`search`