Update ONTOLOGY.md

This commit is contained in:
Christian P. MOMON 2020-09-17 05:33:22 +02:00
parent 0850ab8da2
commit dbd0f2f975

View file

@ -1,89 +1,267 @@
# StatoolInfos # Section « File »
StatoolInfos is… Cette section regroupe des informations sur le fichier *properties*.
Data are stored in property files. Each entry line uses key defined by convention. ```
# [File]
## Primitive Types # Classe du fichier (valeur parmi Federation/Organization/Service/Device, obligatoire).
file.class = federation
| Type | Description | Pattern | Example | # Version de l'ontologie utilisée utilisé (type STRING, recommandé).
| ------ | ------ | ------ | ------ | file.protocol = ChatonsInfos-0.1
| DATE | A date in ISO format | ISO_DATE | 2020-07-06 |
| DATETIME | A date and time in ISO format | ISO_DATETIME | 2020-07-06T14:23:20 |
| DAYS | List of 366 NUMERIC separated by SEPARATOR | STU | 1;2;3;4;5;…;365 |
| EMAIL | An electronic address. | ^.+@.+$ | christian@momon.org |
| MONTHS | List of 12 NUMERIC separated by SEPARATOR | STU | 1;2;3;4;5;6;7;9;10;11;12 |
| NUMERIC | A numeric value | STU | -1234.567 |
| NUMERICS | List of NUMERIC separated by SEPARATOR | STU | 12.34;56.78;9 |
| SEPARATOR | The default separator character | `;` | Foo;foo;;foo |
| STATUS | A status. | ON/MAINTENANCE/DOWN/OFF/DRAFT | ON |
| STRING | Foo string. With `<br/>` or `\n`. | ^.*$ | Foo is foo. |
| URL | A web link | ^https?://.+\..+/+$ | https://foo.foo/ |
| VALUE | String not containg SEPARATOR character | Foo |
| VALUES | List of VALUE separated by SEPARATOR | STU | foo1;foo2;foo3 |
| WEEKS | List of 52 NUMERIC separated by SEPARATOR | STU | 1;2;3;4;5;…;51;52 |
Note for list: # Date et horaire de génération du fichier (type DATETIME, recommandé).
* empty value or null value are available; file.datetime = 2020-07-06T14:23:20
* shorter list designs empty values.
# Nom du générateur du fichier (type STRING, recommandé).
file.generator = Christian avec ses doigts
```
# Section « Federation »
Cette section regroupe des informations sur la fédération.
```
# [Federation]
# Nom de la fédération (type STRING, obligatoire).
federation.name= CHATONS
# Description de la fédération (type STRING, recommandé).
federation.description = CHATONS est le Collectif des Hébergeurs Alternatifs, Transparents, Ouverts, Neutres et Solidaires.
# Lien du site web de la fédération (type URL, recommandé).
federation.website = https://www.chatons.org/
# Lien du logo de la fédération (type URL, recommandé).
federation.logo = https://chatons.org/logo_chatons_v2.png
# Lien du favicon de la fédération (type URL, recommandé).
federation.favicon = https://chatons.org/sites/default/files/chatons_logo_tiny.png
# Lien de la page web de contact de la fédération (type URL, recommandé).
federation.contact.url = https://www.chatons.org/contact
# Courriel de contact de la fédération (type EMAIL, recommandé).
federation.contact.email = contact@chatons.org
# Lien de la page web des mentions légales de la fédération (type URL, recommandé).
federation.legal.url = https://www.chatons.org/page/mentions-l%C3%A9gales
# Lien de la documentation web de la fédération (type URL, recommandé).
federation.documentation.url = https://wiki.chatons.org/
# Lien de la documentation technique de la fédération (type URL, recommandé).
federation.documentation.technical.url =
# Lien des tutoriels web de la fédération (type URL, recommandé).
federation.documentation.tutorial.url =
# Date de naissance de la fédération (type DATE, recommandé).
federation.birthdate = 09/02/2016
```
# Section « Organisation »
Cette section regroupe des informations sur l'organisation.
```
# [Organisation]
# Nom de l'organisation (type STRING, obligatoire).
organization.name = Chapril
# Description de l'organisation (type STRING, recommandé).
organization.description = Chapril est le chaton de l'April
# Lien du site web de l'organisation (type URL, recommandé).
organization.website = httsp://www.chapril.org/
# Lien du logo de l'organisation (type URL, recommandé).
organization.logo = https://date.chapril.org/Chapril-banner/v1/chapril-logo-small.png |
# Lien du favicon de l'organisation (type URL, recommandé).
organization.favicon = https://date.chapril.org/favicon.png
# Nome du propriétaire de l'organisation (type STRING, optionnel).
organization.owner.name = April
# Lien du site web du propriétaire de l'organisation (type URL, optionnel).
organization.owner.website = https://www.april.org/
# Lien du logo du propriétaire de l'organisation (type URL, optionnel).
organization.owner.logo = https://www.april.org/sites/default/themes/zen_april/logo.png
# Lien du favicon du propriétaire de l'organisation (type URL, optionnel).
organization.owner.favicon = https://www.april.org/sites/default/themes/zen_april/favicon.ico
# Lien de la page web de contact de l'organisation (type URL, recommandé).
organization.contact.url = https://www.chapril.org/contact.html
# Courriel de contact de l'organisation (type EMAIL, recommandé).
organization.contact.email = contact@chapril.org
# Lien de la page des mentions légales de l'organisation (type URL, recommandé).
organization.legal.url = https://www.chapril.org/cgu.html
# Lien de la documentation technique de l'organisation (type URL, recommandé).
organization.documentation.technical.url = https://admin.chapril.org/
# Date de création de l'organisation (type DATE, recommandé).
organization.birthdate = 08/11/2018
# Date de fermeture de l'organisation (type DATE, recommandé).
organization.deathdate = 08/11/2018
```
# Section « service »
Cette section regroupe des informations sur un service.
```
# [Service]
## Sections # Nom du service (type STRING, obligatoire).
service.name = MumbleChaprilOrg
### Federation section # Description du service (type STRING, recommandé).
service.description = Service libre de conférence audio
| Field | Type | Mandatory | Description | Example | # Lien du site web du service (type URL, recommandé).
| ------ | ------ | ------| ------ | ------ | service.website = https://mumble.chapril.org/
| federation.name | STRING | Yes | Name of federation | CHATONS |
| federation.description | STRING | Yes | Desciption of the federation | Collectif CHATONS | # Lien de la page web des mentions légales du service (type URL, recommandé).
| federation.website | URL | Yes | Official website URL of the federation | https://www.chatons.org/ | service.legal.url = https://www.chapril.org/cgu.html
| federation.logo | URL | Wished | URL of the organization logo | https://chatons.org/logo_chatons_v2.png |
| federation.favicon | URL | Wished | URL of the organization favicon | https://chatons.org/sites/default/files/chatons_logo_tiny.png | # Lien de la documentation web du service (type URL, recommandé).
| federation.contact.url | URL | No | Contact webpage of the federation | https://www.chatons.org/contact | service.documentation.technical.url = https://admin.chapril.org/doku.php?id=admin:services:mumble.chapril.org
| federation.contact.email | EMAIL | Yes | Contact email of the federation | contact@chatons.org |
| federation.legal.url | URL | No | Legal webpage of the federation | https://www.chatons.org/page/mentions-l%C3%A9gales | # Lien des aides web pour le service (type URL, recommandé).
| federation.documentation.url | URL | No | Documentation webpage of the federation | https://wiki.chatons.org/ | service.documentation.tutorial = https://www.chapril.org/Mumble.html
| federation.documentation.technical.url | URL | No | Technical documentation webpage of the federation | |
| federation.documentation.tutorial.url | URL | No | Tutorial documentation webpage of the federation | | # Lien de la page de support du service (type URL, recommandé).
| federation.birthdate | DATE | No | Date of birth of the federation | 09/02/2016 | service.contact.url = https://www.chapril.org/contact.html
# Courriel du support du service (type EMAIL, recommandé).
service.contact.email = mumble-support@chapril.org
# Date d'ouverture du service (type DATE, recommandé).
service.birthdate = 20/03/2020 |
# Date de fermture du service (type DATE, optionnel).
service.deathdate =
# Statut du service (type STATUS, obligatoire).
service.status = ON
# Inscriptions requises pour utiliser le service (parmi None;Free;Member;Client, obligatoire).
service.registration = Free,Member
```
### File section # Section « Software »
| Field | Type | Mandatory | Description | Example | Cette section regroupe des information sur le logiciel utilisé par un service.
| ------ | ------ | ------ | ------ | ------ |
| file.class | Federation/Organization/Service/Device | Yes | Class of the content | Service | ```
| file.protocol | STRING | Yes | Version of the StatoolInfos schema | StatoolInfos-0.1 | # [Software]
| file.datetime | DATETIME | Yes | Date and time of the file build. | 2020-07-06T14:23:20 |
| file.generator | STRING | Yes | Generator of the file. | Cpm hands | # Nom du logiciel (type STRING, obligatoire).
| file.url | URL | Yes | Origin URL of the file. | Cpm hands | software.name = Firefox Send
# Lien du site web du logiciel (type URL, recommandé).
software.website = https://send.firefox.com/
# Lien web vers la licence du logiciel (type URL, obligatoire).
software.license.url = https://forge.april.org/Chapril/drop.chapril.org-firefoxsend/src/branch/chapril-v3.0.21/LICENSE
# Nom de la licence du logiciel (type STRING, obligatoire).
software.license.name = Mozilla Public License Version 2.0
# Version du logiciel (type STRING, recommandé).
software.version = Chapril-3.0.21
# Lien web vers les sources du logiciel (type URL, recommandé).
software.source.url = https://forge.april.org/Chapril/drop.chapril.org-firefoxsend/
```
# Section « Host » (expérimental)
Cette section regroupe des informations sur l'hébergeur.
```
# [Host]
# Nom de l'hébergeur (type STRING, obligatoire).
host.name = Foo
#
host.provider =
# Desription de l'hébergeur (type STRING, recommandé).
host.description =
# Type d'hébergement (un parmi VPS / CLOUD / LOCATEDSERVER / HOSTSERVER / HOMESERVER / RASPERRY, recommandé).
host.type =
# Pays de l'hébergeur (type STRING, recommandé).
host.country.name = France
# Code pays de l'hébergeur (type STRING, recommandé).
host.country.code = FR
```
# Section « Subs »
Cette section regroupe des liens vers des entités complémentaires.
Chaque chemin doit être différent mais pas nécessairement signifiant.
```
# [Subs]
# Un lien vers un fichier properties complémentaire (type URL, optionnel).
subs.foo = https://date.chapril.org/.well-known/datechaprilorg.properties
```
Exemple :
```
subs.01 = https://date.chapril.org/.well-known/datechaprilorg.properties
subs.07 = https://paste.chapril.org/.well-known/pastechaprilorg.properties
subs.dropchaprilorg = https://drop.chapril.org/.well-known/dropchaprilorg.properties
```
### Host section (dratf) # Section « Metrics »
| Field | Type | Mandatory | Description | Example | Cette section regroupe des informations de métrologie.
| ------ | ------ | ------ | ------ | ------ |
| host.name | STRING | Yes | Name of the host | foo |
| host.provider | STRING | Yes | Provider of the host | foo |
| host.description | STRING | Wished | Description of the host | The virtual machine called foo |
| host.type | VPS / CLOUD / LOCATEDSERVER / HOSTSERVER / HOMESERVER / RASPERRY | Wished | Type of the host | HOMESERVER |
| host.country.name | STRING | Wished | Country name of the host | France |
| host.country.code | STRING | Wished | ISO country code of the host | FR |
```
# [Metrics]
### Metrics section # Nom du métrique (type STRING, recommandé).
metrics.http.total.name = Nombre total de requêtes HTTP
| Field | Type | Mandatory | Description | Example | # Description du métriques (type STRING, recommandé).
| ------ | ------ | ------ | ------ | ------ | metrics.http.total.description = Somme des requêtes HTTP ipv4 et ipv6.
| metrics.foo1.foo2.name | STRING | Wished | Name of metric | visitor Ip |
| metrics.foo1.foo2.description | STRING | Wished | Description of metric | Nombre d'ip ayant visitées |
| metrics.foo1.foo2.2020 | NUMERIC | No | Count of foo1.foo2 | 123 |
| metrics.foo1.foo2.2020.months | MONTHS | No | Month count of foo1.foo2 for year 2020 | 100;200;300;;;; |
| metrics.foo1.foo2.2020.weeks | WEEKS | No | Week count of foo1.foo2 for year 2020 | 100;200;300;;;; |
| metrics.foo1.foo2.2020.days | DAYS | No | Day count of foo1.foo2 for year 2020 | 100;200;300;;;; |
Examples: # Métrique à valeur anuelle (type NUMERIC, optionnel).
metrics.http.total.2020 = 23232
# Métrique à valeur mensuelle (type MONTHS, optionnel).
metrics.http.total.2020.months=119417,122403,133108,148109,286762,334892
# Métrique à valeur hebdomadaire (type WEEKS, optionnel).
metrics.http.total.2020.months=1194,1224,1331,1481,2867,3348
# Métrique à valeur quotidienne (type DAYS, optionnel).
metrics.http.total.2020.days=11,12,13,14,28,33
```
Exemple :
``` ```
metrics.visitors.ipv4.2020=123 metrics.visitors.ipv4.2020=123
metrics.visitors.ipv6.2020=123 metrics.visitors.ipv6.2020=123
@ -101,102 +279,3 @@ metrics.visitors.ipv4.2020.days=123;456;
metrics.visitors.ipv6.2020.days=123;456; metrics.visitors.ipv6.2020.days=123;456;
metrics.visitors.total.2020.days=246;912; metrics.visitors.total.2020.days=246;912;
``` ```
### Organization section
| Field | Type | Mandatory | Description | Example |
| ------ | ------ | ------ | ------ | ------ |
| organization.name | STRING | Yes | Name of the organization | Chapril |
| organization.description | STRING | Wished | Description of the organization | Chapril est le chaton de l'April |
| organization.website | URL | Y | Official website of the organization | httsp://www.chapril.org/ |
| organization.logo | URL | Wished | Logo URL of the organization | https://date.chapril.org/Chapril-banner/v1/chapril-logo-small.png |
| organization.favicon | URL | Wished | Favicon URL of the organization | https://date.chapril.org/favicon.png |
| organization.owner.name | STRING | No | Name of the organization owner | April |
| organization.owner.website | URL | No | Official website of the organization owner | https://www.april.org/ |
| organization.owner.logo | URL | No | Logo URL of the organization owner | https://www.april.org/sites/default/themes/zen_april/logo.png |
| organization.owner.favicon | URL | No | Favicon URL of the organization owner | https://www.april.org/sites/default/themes/zen_april/favicon.ico |
| organization.contact.url | URL | Wished | Contact webpage of the organization | https://www.chapril.org/contact.html |
| organization.contact.email | EMAIL | Contact email of the organization | contact@chapril.org |
| organization.legal.url | URL | Wished | Legal webpage of the organization | https://www.chapril.org/cgu.html |
| organization.documentation.technical.url | URL | Wished | Technical documentation webpage of the organization | https://admin.chapril.org/ |
| organization.birthdate | DATE | Wished | Birth date of the organization | 08/11/2018 |
### Service section
| Field | Type | Mandatory | Description | Example |
| ------ | ------ | ------ | ------ | ------ |
| service.name | STRING | Yes | Service name. | MumbleChaprilOrg |
| service.description | STRING | Yes | Service description. | Service libre de conférence audio |
| service.organization.name | STRING | Yes | Organization name. | Chapril |
| service.website.url | URL | Wished | Website of the service | https://mumble.chapril.org/ |
| service.legal.url | URL | Wished | URL | Legal webpage of the organization | https://www.chapril.org/cgu.html |
| service.documentation.technical.url | URL | No | Technical documentation webpage of the service | https://admin.chapril.org/doku.php?id=admin:services:mumble.chapril.org |
| service.documentation.tutorial.url | URL | No | Tutorial documentation webpage of the service | https://www.chapril.org/Mumble.html |
| service.contact.url | URL | Wished | Contact webpage of the service | contact@chapril.org |
| service.contact.email | EMAIL | Wished | Contact email of the service | mumble-support@chapril.org |
| service.birthdate | DATETIME | Wished | Birth date of the service | 20/03/2020 |
| service.deathdate | DATETIME | No | Death date of the service | |
| service.status | STATUS | Yes | Service status. | ON |
| service.registration | None;Free;Member;Client | Yes | Registration requirement | Free; Member|
### Subs section
| Field | Type | Mandatory | Description | Example |
| ------ | ------ | ------ | ------ | ------ |
| subs.foo | URL | No | URL of a sub node. | Firefox Send |
Example:
```
subs.datechaprilorg=https://date.chapril.org/.well-known/datechaprilorg.properties
subs.pastechaprilorg=https://paste.chapril.org/.well-known/pastechaprilorg.properties
subs.dropchaprilorg=https://drop.chapril.org/.well-known/dropchaprilorg.properties
```
### Software section
| Field | Type | Mandatory | Description | Example |
| ------ | ------ | ------ | ------ | ------ |
| software.name | STRING | Yes | Name of the software | Firefox Send |
| software.website | URL | Yes | Offical website of the software | https://send.firefox.com/ |
| software.license.url | URL | Yes | Webpage of the software license | https://forge.april.org/Chapril/drop.chapril.org-firefoxsend/src/branch/chapril-v3.0.21/LICENSE |
| software.license.name | STRING | Yes | Name of the license | Mozilla Public License Version 2.0 |
| software.version | STRING | Yes | Version of the software | Chapril-3.0.21 |
| software.source.url | URL | Yes | URL of the software source | https://forge.april.org/Chapril/drop.chapril.org-firefoxsend/ |
## Classes
### Federation class
Federation = file + federation + subs + metrics
### Organization class
Organization = file + organization + subs + metrics
### Service class
Service = file + service + host + software + metrics + extras
### Device class
Device = file + device + system
# Draft
| Field | Type | Mandatory | Description |
| ------ | ------ | ------ | ------ |
| services.* | URL | Y | URL of the Statool file of the service |
| Field | Type | Mandatory | Description |
| ------ | ------ | ------ | ------ |
| services.urls.* | URL | Y | URL of services |