Skip to content

Vocabulary

Urien edited this page Apr 13, 2022 · 18 revisions

🇫🇷 French version

🇬🇧 English version below

Introduction

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 !

Entrances / Caves / Networks

  • 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.

Grotto / Organization

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 / Entry

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

'Person' est utilisé pour désigner une personne qui existe dans Grottocenter. 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 n'ont pas de mail unique ni de mot de passe ils ne peuvent qu'être associé à un document comme auteur.

Il existe des utilisateurs avec des droits particuliers :

  • Les administrateurs ont des droits associés à la gestion de l'application (par exemple gestion des droits des utilisateurs)
  • Les responsables 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 modérateurs ont des droits associé à la gestion du contenu du site (par exemple validation des documents qui sont proposés par les utilisateurs)

🇬🇧 English version

Introduction

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!

Entrances / Caves / Networks

  • 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.

Grotto / Organization

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 / Entry

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.

Clone this wiki locally