Guide de Contribution Talas

Comment contribuer au projet Talas — code, documentation, design, hardware, traductions. Dernière mise à jour : 27 mars 2026.

Bienvenue

Talas est un projet ouvert. Les schémas hardware sont sous CERN-OHL-W 2.0, la documentation sous CC BY-SA 4.0. Le code de Veza est propriétaire. Toute contribution qui respecte les valeurs du projet est la bienvenue.

Avant de contribuer, prends le temps de lire :

00_META/Manifeste/MANIFESTE_ETHIQUE_TALAS — Les engagements non-négociables
00_META/CHARTE_OPEN_CORE — Ce qui est commons vs commercial

Comment contribuer

Code (Veza)

Le code source vit dans /home/senke/git/talas/veza/ (monorepo).

Composant	Langage	Répertoire
Backend API	Go (Gin, GORM)	`veza-backend-api/`
Stream Server	Rust (Axum)	`veza-stream-server/`
Frontend	React 18, TypeScript, Tailwind	`apps/web/`
Desktop	Electron (wrapper)	`veza-desktop/`

Pour commencer :

Lire 03_APPS_&_SERVICES/ARCHITECTURE_VEZA pour comprendre l'architecture
Suivre le setup développeur dans 04_INFRA_DEPLOIEMENT/CI_CD/PROCEDURES_DEPLOIEMENT §2
Consulter les issues ouvertes sur Gitea/Forgejo

Documentation (ce knowledge base)

Ce dépôt (TG__Talas_Group/) est un graphe Logseq de ~80 fichiers markdown.

Conventions :

Tout en français
Utiliser wikilinks pour les références croisées (Logseq les résout)
Noms de fichiers principaux en MAJUSCULES (ex: ARCHITECTURE_VEZA.md)
Sous-dossiers pour les fichiers détaillés
Pas de fichiers dans 13_ARCHIVES/ (historique figé)
Pas de fichiers de code ici (le code est dans le repo Veza)

Design et UX

Système de design : Sumi V3 (voir 05_EXPERIENCE_UTILISATEUR/SUMI_V3_SPECIFICATION)
Outil : Penpot (self-hosted)
Direction artistique : 05_EXPERIENCE_UTILISATEUR/DIRECTION_ARTISTIQUE_TALAS

Traductions

Veza supporte 3 langues (EN/FR/ES) via i18next.

Fichiers : apps/web/src/locales/
Ajouter une langue : créer un dossier de locale, traduire les clés JSON

Hardware

Les schémas du microphone sont ouverts sous CERN-OHL-W 2.0.

Outil : KiCAD
Fichiers : 02_PRODUITS_PHYSIQUES/Microphone/Conception/
BOM : 02_PRODUITS_PHYSIQUES/Microphone/BOM/

Prérequis techniques

Pour le code Veza

Outil	Version	Installation
Go	1.24+	go.dev/dl
Rust + Cargo	Stable	rustup.rs
Node.js	20+	nodejs.org
Docker + Compose	24+	docs.docker.com
Make	—	Fourni par le système

Pour la documentation

Éditeur markdown (VS Code, Neovim, etc.)
Optionnel : Logseq pour naviguer le graphe visuellement

Pour le hardware

KiCAD 8+ pour les schémas et PCB
Multimètre et oscilloscope pour les tests (voir 10_QUALITE_TESTS/Tests_Hardware/PROTOCOLES_TESTS_HARDWARE)

Process de contribution

1. Créer une branche

git checkout -b feat/description-courte   # nouvelle fonctionnalité
git checkout -b fix/description-courte    # correction de bug
git checkout -b docs/description-courte   # documentation

2. Développer et tester

Lancer les tests avant de pousser : make test
Vérifier le lint : golangci-lint run / npm run lint / cargo clippy
Pour les docs : vérifier les wikilinks cassés

3. Commit

Format des messages :

type(scope): description courte

Corps optionnel expliquant le pourquoi.

Types : feat, fix, docs, refactor, test, chore Scopes : backend, stream, frontend, infra, docs, hardware

Exemples :

feat(backend): add stem upload endpoint
fix(frontend): fix playlist reorder drag-drop
docs(infra): add deployment procedures

4. Pull Request

Titre clair et concis (< 70 caractères)
Description : ce que fait la PR, pourquoi, comment tester
Lier à l'issue correspondante
Attendre la review avant merge

5. Review

Critères de review :

Le code fait ce qui est décrit
Les tests passent
Pas de régression de sécurité (OWASP top 10)
Cohérent avec l'architecture existante
Pas de dépendance cloud ajoutée (self-hosted only)

Code de conduite

Résumé des principes du 00_META/Manifeste/MANIFESTE_ETHIQUE_TALAS appliqués à la contribution :

Respect — Feedback constructif, pas de jugement personnel
Transparence — Expliquer ses choix techniques, documenter les décisions
Pas de dark patterns — Jamais de code manipulatif (fausse rareté, notifications FOMO, tracking comportemental)
Pas de tracking — Pas de Google Analytics, Facebook Pixel, ou équivalent. Jamais.
Self-hosted — Pas de dépendance à des services cloud tiers (pas d'AWS, Cloudflare, SaaS)
Vie privée — Collecte minimale de données. Export/suppression à tout moment.
Bienveillance — On part du principe que les gens sont là pour aider

Comportements inacceptables : harcèlement, discrimination, trolling, spam, publication de contenu inapproprié.

En cas de conflit : contacter le mainteneur principal. Les décisions de modération sont finales.

Licences

Élément	Licence	Implication
Code Veza	Propriétaire	Le code de Veza n'est pas open-source.
Hardware (schémas, PCB, BOM)	CERN-OHL-W 2.0	Weakly reciprocal : les modifications des fichiers doivent être partagées, mais les projets dérivés peuvent utiliser d'autres licences.
Documentation	CC BY-SA 4.0	Attribution + partage dans les mêmes conditions.
Samples et presets communautaires	CC BY-SA 4.0 ou CC0	Selon le choix du créateur.

Le détail complet de la frontière commons/commercial est dans 00_META/CHARTE_OPEN_CORE.

Règle d'or : un élément classé commons ne peut JAMAIS devenir commercial. L'inverse (ouvrir ce qui était commercial) est encouragé.

Voir aussi

00_META/Manifeste/MANIFESTE_ETHIQUE_TALAS — Engagements éthiques
00_META/CHARTE_OPEN_CORE — Frontière commons / commercial
03_APPS_&_SERVICES/ARCHITECTURE_VEZA — Architecture applicative
04_INFRA_DEPLOIEMENT/CI_CD/PROCEDURES_DEPLOIEMENT — Setup développeur et déploiement
00_META/Glossaire/GLOSSAIRE_TALAS — Glossaire des termes
12_DOCUMENTATION/INDEX_DOCUMENTATION — Index de toute la documentation