-
Notifications
You must be signed in to change notification settings - Fork 2
Vocabulary
🇬🇧 English version below
Grottocenter, en tant que base de données open source et gratuite de spéléologie, a un vocabulaire bien spécifique. Ce vocabulaire est principalement inspiré de celui de la spéléologie mais avec quelques spécificités. Regardons-ça ensemble !
- Une cavité correspond, en base de données, à une seule entrance (le point d'entrée) + une cave' (ce qui est derrière ce point d'entrée). Un objet entrance sans cave ne peut pas exister. Le contraire non plus !
- Un réseau il s'agit en base de données d'une cave qui est associée à plusieurs entrances.
Une entrée (entrance) est un point à partir duquel une cavité est accessible depuis l'extérieur. C'est son interface avec "l'air extérieur" en somme.
Très simple: un grotto EST une organization. On a juste changé le terme utilisé. Une organisation peut désigner de nombreuses entités dans Grottocenter : un club de spéléo, un éditeur, une librairie, une université etc.
"Grotto" est encore utilisé dans certaines parties du code à cause du schéma de base de données (la table t_grotto).
➡️ Toujours utilisé le terme organization lors des nouveaux développements.
Entrance est utilisé pour désigner l'entrée d'une cavité. Entry était une erreur de traduction du mot français "entrée".
➡️ Toujours utilisé le terme entrance lors des nouveaux développements.
'Person' désigne une personne qui existe dans Grottocenter. Les personnes sont listées dans la table t_caver. Il faut distinguer deux catégories de personnes :
- Les utilisateurs qui ont créé un compte a partir d'un email unique dans Grottocenter et d'un mot de passe. Les utilisateurs peuvent créer et éditer le contenu, être déclaré auteur d'un document par les autres utilisateurs ou par eux-même, s'associer à des organisations ou a des cavités.
- les auteurs qui ont été créés par des utilisateurs afin de pouvoir les déclarer auteur d'un document alors qu'ils ne faisaient pas encore partie des personnes existantes dans Grottocenter. Les auteurs ont un mail de la forme
[email protected]et n'ont pas de mot de passe. Ils ne peuvent qu'être associé à un document comme auteur.
Une personne peut avoir 0, 1 ou plusieurs rôles (table t_group). À chaque rôle, on associe différents droits.
- Les administrateurs ont des droits associés à la gestion de l'application (par exemple gestion des droits des utilisateurs)
- Les modérateurs ont des droits associés à la gestion du contenu du site (par exemple validation des documents qui sont proposés par les utilisateurs).
- Les leaders ont des droits associés à des responsabilités sur des secteurs géographiques ou sur une organisation (par exemple réception de notifications quand des modifications interviennent sur un secteur géographique déterminé).
- Les utilisateurs ont des droits associés à la création et édition d'entité sur Grottocenter.
Grottocenter, as a speleological open source and free database, has a very specific vocabulary. This vocabulary is inspired by the speleological one mainly but has its own particularities too. Let's dive into it!
- A cave corresponds, in the database, to one entrance (the entrance point) and one cave (what is behind this entry point). An entrance object without a cave cannot exist. Not the opposite either!
- When we talk about a network, it is, in the database, a cave which is associated with several entrance (at least 2).
An entrance is a point from which a cavity is accessible from the outside, its an interface with the air.
Very simple: a grotto IS an organization. We just changed the term used. An organization can refer to many entities in Grottocenter: a caving club, a publisher, a bookshop, an university etc.
Grotto is always used in some parts of the code because of the database schema (t_grotto table).
➡️ Always use "organization" when developing new features.
Entrance is now used to mean "the entrance of a cave". Entry was a bad translation of the french word "entrée", which can be translated by entry and entrance (depending on the context).
➡️ Always use "entrance" when developing new features.
'Person' means a person that exists in Grottocenter. Persons are listed in the t_caver table. There are two categories of persons to be distinguished:
- The users who have created an account using a unique email in Grottocenter and a password. Users can create and edit content, be declared author of a document by other users or by themselves, associate with organizations or cavities.
- The authors that have been created by users in order to declare them author of a document while they were not yet part of the existing people in Grottocenter. Authors have an email in the form
[email protected]and do not have a password. They can only be associated to a document as an author.
A person can have 0, 1 or more roles (t_group table). Each role has different rights associated with it.
- The administrators have rights associated with the management of the application (e.g. management of user rights).
- The moderators have rights associated with the management of the site's content (e.g. validation of documents submitted by users).
- The leaders have rights associated with responsibilities for geographic areas or an organization (e.g., receiving notifications when changes occur in a specific geographic area).
- The users have rights associated with the creation and editing of entities on Grottocenter.