Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
re-organise translations, add french (#1922)
- Loading branch information
Showing
14 changed files
with
632 additions
and
29 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,82 @@ | ||
# Contribuer à Hasura graphql-engine | ||
|
||
*Premièrement*: si vous n'êtes pas certain ou avez des craintes au sujet de quoi que ce soit, | ||
il vous suffit de poser une question, ou de soumettre une issue ou pull request malgré tout. | ||
Personne ne vous grondera alors que vous faites de votre mieux. | ||
Le pire serait que l'on vous demande poliment de modifier quelque chose. | ||
Nous apprécions toute contribution, et ne voulons pas qu'une muraille de règles entrave cela. | ||
|
||
Cependant, pour ceux qui souhaitent un peu plus d'accompagnement sur la meilleure | ||
manière de contribuer au projet, lisez plus loin. Ce document traite du sujet qui | ||
vous intéresse. En répondant à tous les critères que nous recherchons, les chance que | ||
nous puissions intégrer ou traiter vos contributions augmenteront. | ||
|
||
## Vue d'ensemble | ||
|
||
[hasura/graphql-engine](https://github.com/hasura/graphql-engine) est un mono-repo | ||
consistant en 3 composants. Chacun ayant son propre guide de contribution: | ||
|
||
1. [Server (Haskell)](../server/CONTRIBUTING.md) | ||
2. [CLI (Go)](../cli/CONTRIBUTING.md) | ||
3. [Console (JavaScript)](../console/README.md#contributing-to-hasura-console) | ||
|
||
Chacun de ces trois composants possède une version unique, désignée soit par le tag git, soit par une | ||
combinaison du nom de la branche et du SHA de commit git. | ||
|
||
Pour toutes les contributions, un CLC (Contat de Licence de Contributeur) doit être signé [ici](https://cla-assistant.io/hasura/graphql-engine) avant (ou après) que la pull request ait été soumise. Un bot demandera si nécessaire aux contributeurs de signer le CLC au moyen d'un commentaire de pull request. | ||
|
||
|
||
### Documentation | ||
|
||
Le guide de contribution pour la documentation peut être trouvé sur [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md). | ||
|
||
### Contenu communautaire | ||
|
||
Il n'existe aucun guide spécifique pour la contribution au contenu communautaire. | ||
N'importe quoi pouvant aider la communauté ou les utilisateurs du GraphQL Engine | ||
peut faire partie de cette section. Nous avons identifié [boilerplates](../community/boilerplates), | ||
[sample-apps](../community/sample-apps) et [outils](../community/tools) comme candidats principaux. | ||
N'hésitez pas à soumettre une pull request si vous avez quelque chose à ajouter (n'appartenant | ||
pas forcément aux sections mentionnées ci-dessus). | ||
|
||
## Problèmes | ||
|
||
### Rapporter un Problème | ||
|
||
- Soyez certains de tester avec la dernière version disponible. Il est possible que | ||
le bug que vous rencontrez ait déja été corrigé. | ||
|
||
- Précisez les étapes à suivre pour reproduire le problème, en incluant la version | ||
de Postgres, la version de graphql-engine et la plateforme sur laquelle vous les | ||
exécutez (Heroku, Docker, etc ...). | ||
|
||
- Veuillez inclure les logs du server, si nécessaire. | ||
|
||
|
||
## Directives communes | ||
|
||
- Soyez certain qu'il y a une issue associée avec le travail que vous êtes en train de réaliser. | ||
|
||
- Si vous travaillez sur une issue, veuillez commenter ce que vous faites pour éviter une duplication | ||
du travail par d'autres. | ||
|
||
- Veuillez "squasher" vos commits et ajouter une référence à l'issue en ajoutant `fix #<issue-no>` | ||
ou `close #<issue-no>` dans le message de commit, à la fin. | ||
Par exemple `resolve answers to everything (fix #42)` ou `resolve answers to everything, fix #42` | ||
|
||
- Rebasez master avec votre branche avant de soumettre une pull request. | ||
|
||
## Messages de commit | ||
|
||
- La première ligne doit être un résumé des changements, ne dépassant pas 50 caractères, suivi | ||
par une section optionnelle contenant plus de détails au sujet des modifications. | ||
Référez vous à [ce lien](https://github.com/erlang/otp/wiki/writing-good-commit-messages) | ||
pour plus d'informations à propos de l'écriture de bons messages de commit. | ||
|
||
- Utilisez l'impératif présent: "add/fix/change", et non "added/fixed/changed" ou "adds/fixes/changes". | ||
|
||
- Ne mettez pas la première lettre de la ligne de résumé en majuscule. | ||
|
||
- N'ajoutez pas de point (.) à la fin de la ligne de résumé. | ||
|
||
(Credits: Certaines sections sont adaptées de https://github.com/PostgREST/postgrest/blob/master/.github/CONTRIBUTING.md) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,197 @@ | ||
# Hasura GraphQL Engine | ||
|
||
[![Docs](https://img.shields.io/badge/docs-v1.0-brightgreen.svg?style=flat)](https://docs.hasura.io) | ||
[![CircleCI](https://circleci.com/gh/hasura/graphql-engine.svg?style=shield)](https://circleci.com/gh/hasura/graphql-engine) | ||
|
||
|
||
<a href="https://discord.gg/vBPpJkS"><img src="https://img.shields.io/badge/chat-discord-brightgreen.svg?logo=discord&style=flat"></a> | ||
<a href="https://twitter.com/intent/follow?screen_name=HasuraHQ"><img src="https://img.shields.io/badge/Follow-HasuraHQ-blue.svg?style=flat&logo=twitter"></a> | ||
<a href="https://eepurl.com/dBUfJ5"><img src="https://img.shields.io/badge/newsletter-subscribe-yellow.svg?style=flat"></a> | ||
|
||
Hasura GraphQL Engine est un serveur GraphQL ultra-rapide qui vous permet de créer **instantanément, des APIs GraphQL basées sur Postgres**, avec des [**déclencheurs de webhoook**](event-triggers.french.md) pour la logique métier. | ||
|
||
Hasura vous aide à construire des applications GraphQL basées sur Posgres ou à adopter graduellement GraphQL pour des applications existantes utilisant Postgres. | ||
|
||
|
||
Plus d'informations sur [hasura.io](https://hasura.io) et dans la [documentation](https://docs.hasura.io). | ||
|
||
------------------ | ||
|
||
![Démo Hasura GraphQL Engine](../assets/demo.gif) | ||
|
||
------------------ | ||
|
||
![Démo Hasura GraphQL Engine Realtime](../assets/realtime.gif) | ||
|
||
------------------- | ||
|
||
## Fonctionnalités | ||
|
||
* **Réalisez des requêtes avancées**: filtrage intégré, pagination, recherche par patterns, mutations d'insertions en masse, mises-à-jour et suppression. | ||
* **Temps réel**: Convertissez n'importe quelle requête GraphQL en requête temps-réel en uttilisant les `subscriptions`. | ||
* **Fusionnez des schémas distants**: Accédez à vos propres schémas GraphQL pour votre logique métier, via un point d'accès GraphQL unique. [Plus d'informations](remote-schemas.french.md). | ||
* **Déclenchez des webhooks ou des fonctions serverless**: En réactions aux évènements Postgres insert/update/delete ([Plus d'informations](event-triggers.french.md)) | ||
* **Fonctionne avec les bases de données existantes**: Pointez GraphQL Engine vers une base de données Postgres existante afin d'obtenir instantanément une API GraphQL prête à l'emploi. | ||
* **Contrôle d'accès détaillé**: Contrôle d'accès dynamique qui s'intègre avec votre système d'authentification (ex: auth0, firebase-auth) | ||
* **Haute performance & faible impact**: Image Docker de ~15MB; ~50MB RAM @ 1000 req/s; prise en compte du multi-core | ||
* **Interface d'administration & Migrations**: Interface d'administration & migrations de schéma à la Rails | ||
* **Postgres** ❤️: Supporte les types Postgres (PostGIS/geo-location, etc.), transforme les vues en *graphs*, déclenche des procédures ou fonctions stockées via les mutations | ||
|
||
Plus d'informations sur [hasura.io](https://hasura.io) et dans la [documentation](https://docs.hasura.io). | ||
|
||
## Table des matières | ||
<!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-refresh-toc --> | ||
**Table des matières** | ||
|
||
- [Démarrage rapide](#quickstart) | ||
- [Déploiement sur Heroku en un click](#one-click-deployment-on-heroku) | ||
- [Autres méthodes de déploiement](#other-deployment-methods) | ||
- [Architecture](#architecture) | ||
- [Outils côté client](#client-side-tooling) | ||
- [Ajout de logique métier](#add-business-logic) | ||
- [Schémas distants](#remote-schemas) | ||
- [Déclenchez des webhooks sur des evènements de base de donnée](#trigger-webhooks-on-database-events) | ||
- [Demos](#demos) | ||
- [Applications temps-réel](#realtime-applications) | ||
- [Videos](#videos) | ||
- [Support & Dépannage](#support--troubleshooting) | ||
- [Contribuer](#contributing) | ||
- [Elements de marque](#brand-assets) | ||
- [Licence](#license) | ||
|
||
<!-- markdown-toc end --> | ||
|
||
## Démarrage rapide: | ||
|
||
### Déploiement sur Heroku en un click | ||
|
||
La manière la plus rapide d'essayer Hasura est via Heroku. | ||
|
||
1. Cliquez sur le bouton ci-dessous pour déployer GraphQL Engine sur Heroku avec l'add-on Postgres gratuit: | ||
|
||
[![Déployer sur Heroku](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/hasura/graphql-engine-heroku) | ||
|
||
2. Ouvrez la console Hasura | ||
|
||
Visitez `https://<app-name>.herokuapp.com` (*remplacez \<app-name\> par le nom de votre application*) pour ouvrir la console d'administration. | ||
|
||
3. Réalisez votre première requête GraphQL | ||
|
||
Créez une table et réalisez votre première requête. Suivez ce [guide](https://docs.hasura.io/1.0/graphql/manual/getting-started/first-graphql-query.html). | ||
|
||
### Autres méthodes de déploiement | ||
|
||
Pour les méthodes de déploiement basées sur Docker et les options de configuration avancées, consultez les [guides de déploiement](https://docs.hasura.io/1.0/graphql/manual/getting-started/index.html) ou les [manifestes d'installation](../install-manifests). | ||
|
||
## Architecture | ||
|
||
Hasura GraphQL Engine se place en frontal d'une base de données Postgres et peut accepter les requêtes GraphQL de vos applications clientes. Il peut être configuré pour fonctionner avec votre système d'authentification existant et peut gérer le contrôle d'accès au niveau des champs grâce a des règles, avec des variables dynamiques provenant du système d'authentification. | ||
|
||
Vous pouvez également fusionner des schémas GraphQL distants et fournir une API GraphQL unifiée. | ||
|
||
![Architecture de Hasura GraphQL Engine](../assets/hasura-arch.svg) | ||
|
||
## Outils côté client | ||
|
||
Hasura fonctionne avec n'importe quel client GraphQL. Nous recommandons l'utilisation d'[Apollo Client](https://github.com/apollographql/apollo-client). Consultez [awesome-graphql](https://github.com/chentsulin/awesome-graphql) pour une liste de clients. | ||
|
||
## Ajout de logique métier | ||
|
||
GraphQL Engine fournit plusieurs méthodes claires, évolutives et performantes pour ajouter votre propre logique métier à votre backend: | ||
|
||
### Schémas distants | ||
|
||
Ajoutez vos propres resolvers dans un schéma distant en plus du schéma dérivé de Postgres d'Hasura. Idéal pour des cas d'utilisation tels que l'implémentation d'une API de paiement, ou le requêtage de donnée ne se trouvant pas dans votre base de données - [plus d'informations](remote-schemas.french.md). | ||
|
||
### Déclenchez des webhooks sur des évènements de base de données | ||
|
||
Ajoutez de la logique métier asynchrone, déclenchée par des évènements de base de données. | ||
Idéal pour les notifications, les pipelines de données de Postgres ou les | ||
traitements asynchrones - [plus d'informations](event-triggers.french.md). | ||
|
||
### Données dérivée ou transformations de données | ||
|
||
Transformez les données dans Postgres ou exécutez de la logique métier dessus pour en deriver un autre jeu de données qui peut être requêté à l'aide de GraphQL Engine - [plus d'informations](https://docs.hasura.io/1.0/graphql/manual/queries/derived-data.html). | ||
|
||
## Démos | ||
|
||
Consultez toutes les applications d'example dans le répertoire | ||
[community/sample-apps](../community/sample-apps). | ||
|
||
### Applications temps-réel | ||
|
||
- Application de messagerie de groupe développée avec React, incluant un indicateur de frappe, les utilisateurs connectés & les | ||
notifications de nouveaux messages. | ||
- [Essayez la](https://realtime-chat.demo.hasura.app/) | ||
- [Tutoriel](../community/examples/realtime-chat) | ||
- [Explorez les APIs](https://realtime-chat.demo.hasura.app/console) | ||
|
||
- Application de localisation en temps-réel montrant un véhicule dont les coordonnées GPS évoluent | ||
se déplacer sur une carte. | ||
- [Essayez la](https://realtime-location-tracking.demo.hasura.app/) | ||
- [Tutoriel](../community/examples/realtime-location-tracking) | ||
- [Explorez les APIs](https://realtime-location-tracking.demo.hasura.app/console) | ||
|
||
- Un tableau de bord temps-réel pour l'aggrégation de données en constante évolution. | ||
- [Essayez la](https://realtime-poll.demo.hasura.app/) | ||
- [Tutoriel](../community/examples/realtime-poll) | ||
- [Explorez les APIs](https://realtime-poll.demo.hasura.app/console) | ||
|
||
### Vidéos | ||
|
||
* [Ajoutez GraphQL à une instance GitLab auto-hébergée](https://www.youtube.com/watch?v=a2AhxKqd82Q) (*3:44 mins*) | ||
* [Application de liste de tâches avec Auth0 et un backend GraphQL](https://www.youtube.com/watch?v=15ITBYnccgc) (*4:00 mins*) | ||
* [API GraphQL sur GitLab intégrée avec l'authentification GitLab](https://www.youtube.com/watch?v=m1ChRhRLq7o) (*4:05 mins*) | ||
* [Tableau de bord pour 10 millions de trajets avec géolocalisation (PostGIS, Timescale)](https://www.youtube.com/watch?v=tsY573yyGWA) (*3:06 mins*) | ||
|
||
## Support & Dépannage | ||
|
||
La documentation et la communauté vous aideront à résoudre la plupart des problèmes. Si vous avez rencontré un bug ou avez besoin de nous contacter, vous pouvez nous joindre au travers des canaux suivants: | ||
|
||
* Support & retours: [Discord](https://discord.gg/vBPpJkS) | ||
* Problèmes & remontées de bugs: [GitHub issues](https://github.com/hasura/graphql-engine/issues) | ||
* Suivez les mise à jour du produit: [@HasuraHQ](https://twitter.com/hasurahq) | ||
* Parlez nous sur la [messagerie du site Web](https://hasura.io) | ||
|
||
Nous nous impliquons dans le développement d'un environnement ouvert et accueillant dans la communauté. Veuillez consulter le [Code de Conduite](code-of-conduct.french.md). | ||
|
||
|
||
Si vous souhaitez rapporter un problème de sécurité, veuillez [lire ceci](SECURITY.french.md). | ||
|
||
## Contribuer | ||
|
||
Consultez notre [guide de contribution](CONTRIBUTING.french.md) pour plus de détails. | ||
|
||
## Elements de marque | ||
|
||
Les élements de marque Hasura (logos, mascotte Hasura, badges "powered by" etc...) peuvent être | ||
trouvés dans le répertoire [assets/brand](../assets/brand). N'hésitez pas à les utiliser dans votre | ||
application/site Web etc... Nous serions ravis si vous ajoutiez le badge "Powered by Hasura" | ||
à votre application développée à l'aide d'Hasura. ❤️ | ||
|
||
<div style="display: flex;"> | ||
<img src="../assets/brand/powered_by_hasura_black.svg" width="150px"/> | ||
<img src="../assets/brand/powered_by_hasura_white.svg" width="150px"/> | ||
</div> | ||
|
||
```html | ||
<!-- Pour les fonds clairs --> | ||
<a href="https://hasura.io"> | ||
<img width="150px" src="https://graphql-engine-cdn.hasura.io/img/powered_by_hasura_black.svg" /> | ||
</a> | ||
|
||
<!-- Pour les fonds foncés --> | ||
<a href="https://hasura.io"> | ||
<img width="150px" src="https://graphql-engine-cdn.hasura.io/img/powered_by_hasura_white.svg" /> | ||
</a> | ||
``` | ||
|
||
## Licence | ||
|
||
Le GraphQL Engine est disponible sous [Apache License | ||
2.0](https://www.apache.org/licenses/LICENSE-2.0) (Apache-2.0). | ||
|
||
Tous les **autres contenus** (à l'exception de ceux dans les répertoires | ||
[`server`](../server), [`cli`](../cli) et [`console`](../console)) sont | ||
disponibles sous [Licence MIT](../LICENSE-community). Cela inclut tout le | ||
contenu des répertoires [`docs`](../docs) et [`community`](../community). |
Oops, something went wrong.