Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/tombreit/django-dlcdb

Device Live Cycle Database. The DLCDB manages the life cycle of IT assets. With a little help of a customized Django admin interface.
https://github.com/tombreit/django-dlcdb

asset-management django inventory-management

Last synced: about 1 month ago
JSON representation

Device Live Cycle Database. The DLCDB manages the life cycle of IT assets. With a little help of a customized Django admin interface.

Awesome Lists containing this project

README

        

# ♻ DLCDB

*Device Live Cycle Database*

The DLCDB manages the life cycle of IT assets. With a little help of a [Django](https://www.djangoproject.com/) admin interface.

⚡Not yet fully translated. Application and documentation are work in progress.⚡

## 🔥 Features

- Tracking records of devices: a finite number of records/states (*lent*, *removed*, *inroom* etc.) exists, and a device can only have one record at a time. In the life cycle of the device the device collects records.
- Lending management
- Inventory
- REST-API
- UDB integration
- Reporting
- ...

## 👉 Getting started

The DLCD is a Django project, works with [Python 3](https://www.python.org/downloads/) and [nodejs](https://nodejs.org/en/download/) on Debian Linux.

To get started using the DLCDB, run the following in a virtual python environment (development setup, not to be used in production):

```bash
npm install
npm run prod
pip install -r requirements/dev.txt
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver
```

[Detailed setup and installation docs](https://dlcdb.pages.gwdg.de/django-dlcdb/betrieb/setup.html)

## 📖 Documentation

`docs/` or [https://dlcdb.pages.gwdg.de/django-dlcdb/](https://dlcdb.pages.gwdg.de/django-dlcdb/)

## 📡 REST-API

The DLCDB exposes some data via its REST-API:

* [API docs](https://dlcdb.pages.gwdg.de/django-dlcdb/betrieb/api.html)
* Endpoint: `https://fqdn/api/v2/`

## ⚠️ Tests

```bash
# ⚡ jep, tests are missing
pytest # or
make tests
```

## 📌 Compatibility

DLCDB supports:

- Python 3.9+
- any Django supported database backends, runs fine with SQLite in production

## ⚖️ License

[EUPL-1.2](https://gitlab.gwdg.de/t.breitner/django-dlcdb/-/blob/main/LICENSE) - The EUPL is a reciprocal (or copyleft) licence, meaning that distributed contributions and improvements (called "derivatives") will be provided back or shared with the licensor and all other users. At the same time (and unlike other copyleft licences like the GPL or AGPL), the EUPL is compatible with most other open reciprocal licences and is interoperable. [Source](https://joinup.ec.europa.eu/collection/eupl/introduction-eupl-licence)