8
0
Fork 0
mirror of https://gitlab.federez.net/re2o/re2o synced 2024-07-15 02:35:04 +00:00
Go to file
chapeau ee7c426f5e Merge branch 'update-chapeau' into 'master'
Changement de prénom

See merge request re2o/re2o!630
2022-12-07 21:24:29 +00:00
api Changement de prénom 2022-02-27 14:12:37 +00:00
cotisations fix: 🐛 Fix voucher_pdf function (#315) 2021-01-24 16:37:10 +01:00
docs_utils Graph re2o sources dia (archi) 2017-10-12 20:03:38 +02:00
freeradius_utils Ça se dit Rézo Metz 'tain 2021-01-24 16:37:09 +01:00
install_utils Update schema.ldiff, limit de recherche à 50000 2018-08-09 11:04:47 +02:00
ldap_sync feat: Integrate the removal of LDAP to migration squash. 2021-01-24 16:37:10 +01:00
logs fix: Potential information leak in serviceuser history 2021-01-24 16:37:10 +01:00
machines feat(trans): Translate remaining fuzzy translations 2021-01-24 16:37:10 +01:00
multi_op chore(trans): Regenerate all django.po file 2021-01-24 16:37:10 +01:00
preferences chore(trans): Regenerate all django.po file 2021-01-24 16:37:10 +01:00
re2o Changement de prénom 2022-02-27 14:12:37 +00:00
search chore(trans): Regenerate all django.po file 2021-01-24 16:37:10 +01:00
static Make switch port list horizontally scrollable in topology 2021-01-24 16:37:09 +01:00
templates fix: typo in french translation of "home" 2021-01-24 16:37:10 +01:00
test_utils Ça se dit Rézo Metz 'tain 2021-01-24 16:37:09 +01:00
themes Add custom themes 2021-01-24 16:37:09 +01:00
tickets chore(trans): Regenerate all django.po file 2021-01-24 16:37:10 +01:00
topologie fix: Wrong url path for interface autocomplete on port edition form 2021-01-26 20:10:38 +01:00
users fix: Indentation and variable name issues in users/models.py 2021-01-24 16:37:10 +01:00
.gitignore Add custom themes 2021-01-24 16:37:09 +01:00
.gitlab-ci.yml Update .gitlab-ci.yml 2017-12-17 16:31:21 +01:00
.mailmap Changement de prénom 2022-02-27 14:12:37 +00:00
apt_requirements.txt Update apt_requirements.txt 2021-01-24 16:36:16 +01:00
apt_requirements_radius.txt Missing new line in apt requirements radius 2021-01-24 16:36:16 +01:00
CHANGELOG.md fix: Links in CHANGELOG.md 2021-01-24 16:37:10 +01:00
install_re2o.sh Fix sql command when using mysql on remote machine 2021-01-24 16:36:16 +01:00
LICENSE Add license file (GPLv2) 2017-01-15 18:00:42 -05:00
manage.py initial comit 2016-06-30 01:39:31 +02:00
pip_dev_requirements.txt Pip requirements for dev are in a separate file 2018-06-23 16:02:58 +00:00
pip_requirements.txt Pin specific version 2021-01-24 16:37:09 +01:00
README.md Ça se dit Rézo Metz 'tain 2021-01-24 16:37:09 +01:00

Note: English version below.

Re2o

GNU public license v2.0

Avant propos

Re2o est un logiciel d'administration développé initialement au Rézo Metz. Il se veut agnostique au réseau considéré, de manière à être installable et configurable facilement.

Il utilise le framework django avec python3. Il permet de gérer les adhérents, les machines, les factures, les droits d'accès, les switchs et la topologie du réseau. Il est possible d'activer très facilement des services qui améliorerons les possibilités de Re2o pour convenir au mieux aux besoins de chaque association.

Installation

Un tutoriel pour installer le projet est disponible sur le wiki.

Fonctionnement Général

Re2o utilise le Framework Django et suit donc le principe de toutes les applications Django. Les différents composants sont les models (qui définissent les entrées de la base de données), les templates (qui définissent les pages), les views (qui génèrent les templates avec les données pertinentes), et les forms (qui définissent les pages de modification des objets). Ce framework permet de manipuler les données comme des objets Python.

Tous ces composants sont regroupés en apps (users, machines, topologie,...). Certaines de ces apps constituent le coeur de Re2o et sont indispensables à son fonctionnement. Certaines autres apps sont optionnelles et peuvent être activées en fonction des besoins de chaque association.

API Rest

Les données stockées dans Re2o sont disponibles via un API Rest. Les services installés sur d'autres machines (dhcp, dns, firewall,...) utilisent cet API pour avoir accès aux données des utilisateurs et fonctionner.

Wiki

Le Wiki est accessible sur le gitlab de Federez. Il regroupe les informations et instructions pour la plupart des composants de Re2o.


Re2o

GNU Public license v2.0

Foreword

Re2o is a management software initially developed at Rézo Metz. It is now in use in several student organizations. It aims to remain agnostic of the organization that uses it and be easy to setup.

Re2o is based on the Django framework and Python3. Its core functionalities include managing the members, their machines, their invoices and their rights to the network but also the topology of the network and its devices. On top of this, it is possible to plug services to enhance the possibilities and fit the need of each organization.

Setup

A tutorial is available on the Wiki to describe the setup process.

General Functioning

Re2o follow the general functioning of a Django project and split its components between the models (describe the database objects), the templates (that define the front end), the views (that populate and serve the templates) and the forms (that provide front end object edition/creation/removal). This framework provide an abstraction layer to manipulate SQL objects as Python objects.

Functionalities are grouped in apps (users, machines, topologie,...). Along the core functionalities, optional functionalities are available and can be activated in the preferences.

Rest API

Re2o provide a Rest API to allow external services (dhcp, dns, firewall,...) installed on remote machines to access database informations in Json format. Those services are optional and should be installed and activated to fit each organization needs.

Wiki

The Wiki is available to provide information and instruction for most components of Re2o.