graphile / graphile/graphile.github.io
Postgraphile Sandbox/Playground
- 主要言語
- SCSS
- スター
- 27
- フォーク
- 126
- PR マージ指標
- 30日以内にマージされた PR はありません
説明
### Feature description
Make a new repo with a [Deploy to Heroku button](https://devcenter.heroku.com/articles/heroku-button) for easily playing around with postgraphile without having to install anything or do toilsome setup.
It should come with postgres, pgadmin and postgraphile installed and running within a docker container, probably with one or more example databases installed.
It should be running with a variety of recommended plugins and settings for development, like `--enhance-graphiql` and `--allow-explain`.
By default, it should run the CLI, but it should also have a JS-driven example included with a easy switch to use that, so you can fork, write a custom plugin, and deploy with a click.
(Note that it should not use heroku's built-in postgres because it doesn't allow CREATE ROLE and could get expensive if a malicious actor spotted a free, world-configurable database).
Inspired by [this discussion](https://github.com/graphile/persisted-operations/issues/6#issuecomment-822695546)
### Motivating example
1. Have one official playground running that prospective users can play with, to see what postgraphile is like in the wild. (This should probably be completely cleared and rebooted at regular intervals, perhaps with a bit of automation from the heroku api and a stable subdomain).
2. Allow postgraphile users to quickly spin up their own playgrounds to explore prototyping concepts.
3. Allow postgraphile users to to demonstrate a minimal repro case for a bug or issue by running DDL, inserting data, and running a gql query.
### Breaking changes
None
### Supporting development
I intend to build this myself over the next week or two, but who knows life happens sometimes, so I wanted to file as an issue in case I don't get to it and someone else wants to come along and build it.
I [tick all that apply]:
- [x] am interested in building this feature myself
- [ ] am interested in collaborating on building this feature
- [x] am willing to help testing this feature before it's released
- [ ] am willing to write a test-driven test suite for this feature (before it exists)
- [x] am a [Graphile sponsor](https://www.graphile.org/sponsor/) ❤️
- [ ] have an active [support or consultancy contract](https://www.graphile.org/support/) with Graphile
コントリビューションガイド
このリポジトリのコントリビューションガイドは索引されていません
調査の方向性
まず、Heroku Button のドキュメントと、issue で説明されている提案済みの Docker ベースのセットアップを確認します。これには、PostGraphile CLI と JavaScript の例も含まれます。新しいリポジトリから、Postgres、pgAdmin、PostGraphile、サンプルデータ、推奨される開発設定、および JavaScript の例に切り替える方法を備えた、動作する playground をデプロイできれば完了です。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- docker, graphql, javascript, postgres
- 領域
- backend-api-design, databases, developer-experience, devops
- issue の種類
- 機能追加
- 難易度
- 5/5
- 見積もり時間
- 1週間以上
- 活発さ
- 停滞
- 明瞭さ
- 説明が足りない
- 初心者へのやさしさ
- 25/100