mirror of
https://github.com/hasura/graphql-engine.git
synced 2024-12-14 17:02:49 +03:00
fd5b61cda6
GITHUB_PR_NUMBER: 9742 GITHUB_PR_URL: https://github.com/hasura/graphql-engine/pull/9742 PR-URL: https://github.com/hasura/graphql-engine-mono/pull/9725 Co-authored-by: LW <5601392+llllvvuu@users.noreply.github.com> GitOrigin-RevId: 9f16b267e190c44bc17e77ca4db714d3aba4df47
213 lines
12 KiB
Markdown
213 lines
12 KiB
Markdown
# Hasura GraphQL Engine
|
|
|
|
[](https://hasura.io/docs)
|
|
[](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 je nevjerovatno brzi GraphQL server koji vam nudi **trenutne, API-je GraphQL API-ja preko Postgres-a**, sa [**webhook pokretačima**](../event-triggers.md) na dešavanja u bazi podataka, i [**udaljenim šemama**](../remote-schemas.md) za poslovnu logiku.
|
|
|
|
Hasura vam pomaže da napravite GraphQL aplikacije podržane Postgres-om ili postepeno pređite na GraphQL za postojeće aplikacije pomoću Postgres-a.
|
|
|
|
Pročitajte više na [hasura.io](https://hasura.io) i [dokumentima](https://hasura.io/docs).
|
|
|
|
------------------
|
|
|
|
|
|
|
|
------------------
|
|
|
|
|
|
|
|
-------------------
|
|
|
|
## Značajke
|
|
|
|
* **Napravite snažne upite**: Ugrađeno filtriranje, prelistavanje, pretraživanje po uzorcima, grupno ubacivanje, ažuriranje, brisanje mutacija
|
|
* **U stvarnom vremenu**: Pretvorite bilo koji GraphQL upit u živi upit koristeći pretplate
|
|
* **Spajanje udaljenih šema**: Pristupite prilagođenim GraphQL šemama za poslovnu logiku putem jedne krajnje tačke GraphQL Engine-a. [**Pročitaj više**](../remote-schemas.md).
|
|
* **Okinite webhook ili funkcije bez servera**: Na Postgres sačuvaj/ažuriraj/izbriši dešavanjima ([pročitaj više](../event-triggers.md))
|
|
* **Radi s postojećim, aktivnim bazama podataka**: Usmjerite ga na postojeću Postgres bazu podataka da odmah dobijete spreman na korištenje GraphQL API
|
|
* **Fina kontrola pristupa**: Dinamička kontrola pristupa koja se integriše na vaš sistem pristupa (npr: auth0, firebase-auth)
|
|
* **Visoke performanse i mali tragovi**: ~15MB docker slika; ~50MB RAM @ 1000 zahtjeva/s; više jezgra
|
|
* **Administratorsko sučelje & Migracije**: Administratorska ploča & Rails-inspirisana migracija šeme
|
|
* **Postgres** ❤️: Podržava Postgres tipove (PostGIS/geo-location, i sl.), pretvara poglede u *grafikone*, pokreće pohranjene funkcije ili procedure s mutacijama
|
|
|
|
Pročitaj više na [hasura.io](https://hasura.io) i [dokumentima](https://hasura.io/docs).
|
|
|
|
## Tabela sadržaja
|
|
<!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc-refresh-toc -->
|
|
**Tabela sadržaja**
|
|
|
|
- [Brzi početak:](#brzi-početak)
|
|
- [Implementacija jednim klikom na Heroku](#implementacija-jednim-klikom-na-heroku)
|
|
- [Ostale metode implementacije](#ostale-metode-implementacije-jednim-klikom)
|
|
- [Arhitektura](#arhitektura)
|
|
- [Klijentski alati](#alati-na-klijentskoj-strani)
|
|
- [Dodavanje poslovne logike](#dodavanje-poslovne-logike)
|
|
- [Daljinske šeme](#daljinske-šeme)
|
|
- [Pokretanje webhook-ova na dešavanjima u bazi podataka](#pokrenite-webhook-na-dešavanja-u-bazi-podataka)
|
|
- [Demo](#demo)
|
|
- [Aplikacije u stvarnom vremenu](#stvarne-aplikacije)
|
|
- [Video](#video)
|
|
- [Podrška & Rješavanje problema](#podrška--rješavanje-problema)
|
|
- [Doprinos](#doprinos)
|
|
- [Brendirani sadržaj](#brendirani-sadržaj)
|
|
- [Licenca](#licenca)
|
|
- [Prijevodi](#prijevodi)
|
|
|
|
<!-- markdown-toc end -->
|
|
|
|
## Brzi početak:
|
|
|
|
### Implementacija jednim klikom na Heroku
|
|
|
|
Najbrži način da isprobate Hasura je putem Heroku-a.
|
|
|
|
1. Klikni na link ispod da postaviš GraphQL Engine na Heroku uz besplatan Postgres dodatak:
|
|
|
|
[](https://heroku.com/deploy?template=https://github.com/hasura/graphql-engine-heroku)
|
|
|
|
2. Otvori Hasura konzolu
|
|
|
|
Posjeti `https://<app-name>.herokuapp.com` (*zamijeni \<app-name\> sa nazivom svoje aplikacije*) da otvoriš administratorsku konzolu.
|
|
|
|
3. Napravi prvi GraphQL upit
|
|
|
|
Kreiraj tabelu i odmah isprobaj svoj prvi upit. Prati ovaj [jednostavni vodič](https://hasura.io/docs/latest/graphql/core/getting-started/first-graphql-query.html).
|
|
|
|
### Ostale metode implementacije jednim klikom
|
|
|
|
Pogledaj instrukcije za ostale mogućnosti implementacije jednim klikom:
|
|
|
|
| **Infra provajder** | **Veza** | **Dodatne informacije** |
|
|
|:------------------:|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------:|
|
|
| DigitalOcean | [](https://marketplace.digitalocean.com/apps/hasura?action=deploy&refcode=c4d9092d2c48&utm_source=hasura&utm_campaign=readme) | [docs](https://hasura.io/docs/latest/graphql/core/guides/deployment/digital-ocean-one-click.html#hasura-graphql-engine-digitalocean-one-click-app) |
|
|
| Azure | [](https://portal.azure.com/#create/Microsoft.Template/uri/https%3a%2f%2fraw.githubusercontent.com%2fhasura%2fgraphql-engine%2fmaster%2finstall-manifests%2fazure-container-with-pg%2fazuredeploy.json) | [docs](https://hasura.io/docs/latest/graphql/core/guides/deployment/azure-container-instances-postgres.html) |
|
|
|
|
### Ostale metode implementacije
|
|
|
|
Za Docker-baziranu implementaciju i napredne konfiguracije, pogledajte [implementacijski vodič](https://hasura.io/docs/latest/graphql/core/getting-started/index.html) ili
|
|
[instalirajte manifest](../install-manifests).
|
|
|
|
## Arhitektura
|
|
|
|
Hasura GraphQL Engine frontira se na Postgres instancu i prihvata GraphQL zahtjeve sa vaših klijentskih aplikacija. Može se konfigurisati da koristi vaš postojeći sistem autentikacije i može upravljati kontrolom pristupa koristeći pravila na razini polja s dinamičkim varijablama vašeg sistema autentikacije.
|
|
|
|
Također možete spojiti daljinske GraphQL šeme i pružiti objedinjeni GraphQL API.
|
|
|
|
|
|
|
|
## Alati na klijentskoj strani
|
|
|
|
Hasura radi sa bilo kojim GraphQL klijentom. Mi preporučujemo [Apollo Client](https://github.com/apollographql/apollo-client). Pogledajte [awesome-graphql](https://github.com/chentsulin/awesome-graphql) listu klijenata.
|
|
|
|
## Dodavanje poslovne logike
|
|
|
|
GraphQL Engine pruža jednostavne, skalabilne i izvodljive metode za dodavanje prilagođene poslovne logike u vaš backend:
|
|
|
|
### Daljinske šeme
|
|
|
|
Dodajte prilagođene razrešivače u daljinsku šemu pored Hasura-ine Postgres-bazirane GraphQL šeme. Idealno za slučajeve upotrebe poput implementacije API-ja za plaćanje, ili upita za podatke koji nisu u vašoj bazi podataka - [pročitaj više](../remote-schemas.md).
|
|
|
|
### Pokrenite webhook na dešavanja u bazi podataka
|
|
|
|
Dodajte asinhronu poslovnu logiku koja se pokreće na osnovu događaja u bazi podataka.
|
|
Idealno za obavijesti, propust podataka iz Postgres-a ili asinhronu
|
|
obradu - [pročitaj više](../event-triggers.md).
|
|
|
|
### Izvedeni podaci ili transformacije podataka
|
|
|
|
Pretvorite podatke u Postgres ili pokrenite poslovnu logiku na njemu da biste dobili drugi skup podataka koji se može zatražiti koristeći GraphQL Engine - [pročitaj više](https://hasura.io/docs/latest/graphql/core/queries/derived-data.html).
|
|
|
|
## Demo
|
|
|
|
Pogledajte sve primjere dostupne u
|
|
[hasura/sample-apps](https://github.com/hasura/sample-apps/tree/main) mapi.
|
|
|
|
### Stvarne aplikacije
|
|
|
|
- Aplikacija za grupno dopisivanje koja koristi React, uključuje pokazatelj tipkanja, online korisnike & obavijesti o novim porukama.
|
|
- [Isprobajte odmah](https://realtime-chat.demo.hasura.io/)
|
|
- [Tutorijal](https://github.com/hasura/sample-apps/tree/main/realtime-chat)
|
|
- [Pogledaj API](https://realtime-chat.demo.hasura.io/console)
|
|
|
|
- Aplikacija za praćenje lokacije vozila uživo koja prikazuje GPS koordinate dok se vozilo kreće po mapi..
|
|
- [Isprobajte odmah](https://realtime-location-tracking.demo.hasura.io/)
|
|
- [Tutorijal](https://github.com/hasura/sample-apps/tree/main/realtime-location-tracking)
|
|
- [Pogledaj API](https://realtime-location-tracking.demo.hasura.io/console)
|
|
|
|
- Nadzorna ploča u stvarnom vremenu koja objedinjuje podatke o kontinuirano mijenjanim podacima.
|
|
- [Isprobajte odmah](https://realtime-poll.demo.hasura.io/)
|
|
- [Tutorijal](https://github.com/hasura/sample-apps/tree/main/realtime-poll)
|
|
- [Pogledaj API](https://realtime-poll.demo.hasura.io/console)
|
|
|
|
### Video
|
|
|
|
* [Dodajte GraphQL u samostojeću GitLab instancu](https://www.youtube.com/watch?v=a2AhxKqd82Q) (*3:44 min*)
|
|
* [Todo aplikacija sa Auth0 i GraphQL backendom](https://www.youtube.com/watch?v=15ITBYnccgc) (*4:00 min*)
|
|
* [GraphQL na GitLab-u integrirana sa GitLab autentikacijom](https://www.youtube.com/watch?v=m1ChRhRLq7o) (*4:05 min*)
|
|
* [Nadzorna ploča za 10 miliona vožnji sa geografskom lokacijom (PostGIS, Timescale)](https://www.youtube.com/watch?v=tsY573yyGWA) (*3:06 min*)
|
|
|
|
|
|
## Podrška & Rješavanje problema
|
|
|
|
Dokumentacija i zajednica će vam pomoći da riješite mnogo problema. Ako pronađete grešku ili želite da nas kontaktirate, možete nas pronaći na kanalima ispod:
|
|
|
|
* Podrška & povratne informacije: [Discord](https://discord.gg/vBPpJkS)
|
|
* Problem & praćenje gresaka: [GitHub issues](https://github.com/hasura/graphql-engine/issues)
|
|
* Pratite ažuriranja o proizvodima: [@HasuraHQ](https://twitter.com/hasurahq)
|
|
* Pričajte s nama na [nasoj web lokaciji](https://hasura.io)
|
|
|
|
Zalažemo se za njegovanje otvorenog i dobrodošlog okruženja u zajednici. Molimo da pogledate [kodeks ponašanja](../code-of-conduct.md).
|
|
|
|
Ako želite prijaviti sigurnosni propust, molimo [pročitajte ovo](../SECURITY.md).
|
|
|
|
## Doprinos
|
|
|
|
Pogledajte naš [vodič za doprinos](../CONTRIBUTING.md) za više detalja.
|
|
|
|
## Brendirani sadržaj
|
|
|
|
Hasura brendirani sadržaj (logo, Hasura maskota, powered by bedževi i slično.) mogu biti pronađeni u [assets/brand](../assets/brand) mapi. Slobodno ih možete koristiti u vašoj aplikaciji/web stranici. Biti će nam drago i ako dodate "Pokreće Hasura" bedž na vašu aplikaciju koju ste napravili uz pomoć Hasura-e. ❤️
|
|
|
|
<div style="display: flex;">
|
|
<img src="../assets/brand/powered_by_hasura_blue.svg" width="150px"/>
|
|
<img src="../assets/brand/powered_by_hasura_white.svg" width="150px"/>
|
|
</div>
|
|
|
|
```html
|
|
<!-- Za svijetle pozadine -->
|
|
<a href="https://hasura.io">
|
|
<img width="150px" src="https://graphql-engine-cdn.hasura.io/img/powered_by_hasura_blue.svg" />
|
|
</a>
|
|
|
|
<!-- Za tamne pozadine -->
|
|
<a href="https://hasura.io">
|
|
<img width="150px" src="https://graphql-engine-cdn.hasura.io/img/powered_by_hasura_white.svg" />
|
|
</a>
|
|
```
|
|
|
|
## Licenca
|
|
|
|
GraphQL Engine je dostupan pod [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0) (Apache-2.0).
|
|
|
|
Sav **ostali sadržaj** (osim onog u [`server`](../server), [`cli`](../cli) i
|
|
[`console`](../console) mapama) su dostupni pod [MIT License](../LICENSE-community).
|
|
To uključuje sve u [`docs`](../docs) i [`community`](../community)
|
|
mapama.
|
|
|
|
## Prijevodi
|
|
|
|
Ova stranica je dostupna u sljedećim jezicima:
|
|
|
|
- [Japanski :jp:](../translations/README.japanese.md) (:pray: [@moksahero](https://github.com/moksahero))
|
|
- [Francuski :fr:](../translations/README.french.md) (:pray: [@l0ck3](https://github.com/l0ck3))
|
|
- [Grčki 🇬🇷](../translations/README.greek.md) (:pray: [@MIP2000](https://github.com/MIP2000))
|
|
- [Engleski :uk:](../translations/README.md)
|
|
|
|
Prijevodi za ostale fajlove mogu biti pronađeni [ovdje](../translations).
|