Aide:Ontologie autoconstruction

Cette page d'aide décrit le développement ontologique lié au Portail de l'autoconstruction, pour assurer sa cohérence avec la structure ontologique globale du Wiki maraîcher.

Info sur l'alignement ontologique avec le standard Open Know-how

Le standard de méta-données Open Know How (OKW) est utilisé comme base de modélisation des pages de modèles d'équipements et de leurs instructions de fabrication.

Les tableaux suivants exposent les propriétés descriptives du standard et comment les liens ont été établis entre le Wiki maraîcher et le standard.

Pour le moment, la déclaration publique des propriétés ne se fait qu'avec l'ontologie de l'autoconstruction. Éventuellement, la publication des fiches avec l'ontologie du standard OKH pourra être ajouté en créant une requête en format approprié (.json, .csv, autre) pour pouvoir être publiée à l'externe.

Propriétés descriptives OKW et Modèles de machines
L'info dans les colonnes au titre en italique provient de la norme

Title (OKH)	Propriété (WM)	Intégré	Notes	Numéro	Fieldname	Purpose	Format requis	Rules
Title	Nom du modèle	X	OK	4.6.1.	title	A title to identify the thing.	Text.	Required.
Description	Description	X	OK	4.6.2.	description	Describes the thing.	Paragraph.	Required.
Intended use	Usage attendu	X	OK	4.6.3.	intended-use	Informs the maker for what purpose the designer intends the thing to be used. In particular, make reference to the context and type of users.	Paragraph.	Recommended.
Keywords	Mot-clé	X	OK	4.6.4.	keywords	Provides a small number of terms that can be used to help identify.	Array of text.	At least one keyword is recommended.
Project Homepage	Page du projet	X	OK Set automatique avec mot magique Fullurl.	4.6.5.	project-link	Where the thing or associated project has a web presence that is separate from the documentation (e.g. a marketing page), links to the web resource.	Absolute path.	At least one of the project-link or documentation-home fields is required.
Health and safety notice	Notes santé et sécurité	X	OK	4.6.6.	health-safety-notice	Highlight health and safety risks and/or necessary precautions that the maker should be aware of as part of the decision to make the thing.	Paragraph	Not an exhaustive list of all risks associated with the thing, but a summary of the most important risks and hazards associated with making, using, maintaining or disposing. Knowledge of such issues could influence the decision to make the thing.
Primary contact	Pilote du développement	X	OK	4.6.7.	contact	Provides a point of contact for people who wish to discuss the thing.	Voir norme pour les specs	Where used, provide at least one email address or social media user handle.
Contributors	Contributeur au développement	X	OK	4.6.8.	contributors	Credits the contributors to the know-how. May include people who designed, produced documentation, tested the documentation by making, reviewed and/or edited documentation, or made another contribution as deemed valued by the project or manifest-author.	List of contributors Voir norme pour les specs	Recommended. A name is required for each contributor listed.
Image	Image	À ajouter	Passer résultat par requête si photos taguées avec sémantique?	4.6.9.	image	Provides a graphical representation of the thing.	Absolute or relative path to image file.	Recommended.
Thing version	Version	X	OK	4.6.10.	version	Defines the version of the thing that is represented by this manifest.	Text.
Stage of development	Statut de développement	X	OK	4.6.11.	development-stage	Indicates the maturity of the design and documentation development. (Note: The Open Know-How Working Group intends to develop recommended values for this field to support commonality across manifest files. This is likely to be made by reference to a external standard.)	Text
Has been made	A été fabriqué	X	OK Set automatique si statut de développement : A été fabriqué=Oui	4.6.12.	made	Indicates whether the thing has been made and verifies that it is makeable.	Boolean – “true” or “false“
Has been made independently	A été fabriqué indépendamment	À ajouter	Comment attribue-t-on cette propriété? Est-ce qu'on donne un statut Fabriqué indépendamment en 4.11 qu'on active quand on sait que qqun a réalisé l'équipement sans avoir participé à une corvée d'autoconstruction de la CAPÉ?	4.6.13.	made-independently	Indicates whether the thing has been made using the documentation by someone who was not a contributor to the design or documentation and, therefore, verifies that the documentation is sufficient to make the thing.	Boolean – “true” or “false“
Standards used	Standards utilisés	?	Est-ce pertinent et important? Publie-t-on des plans signés par un·e ingénieur·e?	4.6.14.	standards-used	Indicates any standards that have been used in developing the design or documentation.	Array of arrays. Voir norme pour les specs	Do not list standards to be used by the maker or user, instead these should be referenced in the relevant documentation.
Derivative of	Dérivé de	X	OK	4.6.15.	derivative-of	Where the thing is a derivative of a different thing (e.g. the documentation has been forked), links to the original thing.	Voir norme pour les specs	Where derivative-of used, the title sub-field is required.
Variant of	Variante de	X	OK	4.6.16.	variant-of	Where the thing is a variant, links to the original.	Voir norme pour les specs
Sub-thing	Composante	À ajouter		4.6.17.	sub	Where the design uses sub-components, sub-assemblies etc that are also available as open know-how, links to the documentation.	List of sub-things Voir norme pour les specs
License	Licence	X	OK Licence matériel + Licence documentation + Licence logiciel.	4.6.18.	License	States the licenses under which the thing is made available.	Voir norme pour les specs	Rules: At least one license is required. All three license types are recommended. The format should be an SPDX identifier [3]. See https://spdx.org/licenses/
Licensor	Licenceur	?	En évaluation : à ajouter? Comment nommer et comment opérer?	4.6.19.	licensor	States who is licensing the thing.	Voir norme pour les specs

Propriétés de la Documentation OKW et Modèles de machines
L'info dans les colonnes au titre en italique provient de la norme

Title (OKH)	Propriété (WM)	Intégré	Notes	Numéro	Fieldname	Purpose	Format requis	Rules
Entry point to documentation		Non	Même que project link donc pas nécessaire.	4.8.1.	documentation-home	Provides a URL entry point to the documentation.	Absolute path.	At least one of the project-link or documentation-home fields is required.
Documentation archive	Archive de la documentation	Non	Développements futurs	4.8.2.	archive-download	Links to a location from which the full documentation can be downloaded as an archive (e.g. zip file).	Absolute or relative path.
Design Files	Fichiers du design	À ajouter	Modèle d'équipement	4.8.3.	design-files	Links to design files.	Absolute or relative path. Voir norme pour les specs	Rules: Recommended. May either refer to a location in which files are stored or can list and link to design files individually. In the former case, the title field is not required.
Schematics	Schémas	À ajouter	Modèle d'équipement	4.8.4.	schematics	Links to schematics. Includes all types of engineering drawings.	Absolute or relative path Voir norme pour les specs
Bill of Materials	Liste des composantes	À ajouter	Instruction de fabrication	4.8.5.	bom	Links to the bill of materials.	Absolute or relative path.	Recommended. Should be provided as a single file.
List of Tools	Liste des outils	À ajouter	Instruction de fabrication	4.8.6.	tool-list	Links to a list of tools required to make the thing.	Absolute or relative path.	Recommended. Should be provided as a single file.
Assembly Instructions	Instructions de fabrication	À ajouter	Instruction de fabrication	4.8.7.	making-instructions	Links to the making instructions, e.g. assembly instructions.	Absolute or relative path. Voir norme pour les specs	Recommended. May include more than one assembly instructions, e.g. where the instructions are provided in different formats.
Manufacturing files	Fichiers de fabrication	À ajouter	Instruction de fabrication	4.8.8.	manufacturing-files	Links to the manufacturing files, such as 3D printing files.	Absolute or relative path. Voir norme pour les specs	Recommended where applicable.
Risk Assessment	Analyse de risque	À ajouter	Modèle d'équipement	4.8.9.	risk-assessment	Links to the risk assessment.	Absolute or relative path. Voir norme pour les specs	Recommended. May include more than one, e.g. where different assessments cover different aspects or making, operation, maintenance and disposal.
Tool settings and documentation	Paramètres et documentation machine	À ajouter	Instruction de fabrication	4.8.10.	tool-settings	Links to settings for tools and machines.	Absolute or relative path.	Recommended where applicable. May include more than one.
Quality control instructions	Instructions de contrôle qualité	À ajouter	Instruction de fabrication	4.8.11.	quality-instructions	Links to instructions for testing and/or quality management.	Absolute or relative path. Voir norme pour les specs	Recommended. May include more than one.
Operating instructions	Instructions d'opération	À ajouter	Modèle d'équipement	4.8.12.	operating-instructions	Links to instructions for operating the thing.	Absolute or relative path. Voir norme pour les specs	Recommended.
Maintenance instructions	Instruction d'entretien	À ajouter	Modèle d'équipement	4.8.13.	maintenance-instructions	Links to instructions for maintaining the thing.	Absolute or relative path. Voir norme pour les specs	Recommended.
Disposal instructions	Instruction de disposition	À ajouter	Modèle d'équipement	4.8.14.	disposal-instructions	Links to instructions for disposing the thing at the end of its life.	Absolute or relative path. Voir norme pour les specs	Recommended.
Software	Logiciel	À ajouter	Modèle Instruction de fabrication	4.8.15.	software	Links to source code repository or software executables used by the thing.	Absolute or relative path. Voir norme pour les specs	Recommended where applicable. May include more than one.