Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fauna-labs/fauna-market
A market for Emoji goods, to demonstrate global consistency in FaunaDB
https://github.com/fauna-labs/fauna-market
Last synced: about 1 month ago
JSON representation
A market for Emoji goods, to demonstrate global consistency in FaunaDB
- Host: GitHub
- URL: https://github.com/fauna-labs/fauna-market
- Owner: fauna-labs
- Created: 2017-08-22T18:07:35.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2023-01-23T20:39:08.000Z (over 1 year ago)
- Last Synced: 2024-05-21T01:54:27.387Z (4 months ago)
- Language: JavaScript
- Homepage: https://fauna-market.netlify.com/
- Size: 455 KB
- Stars: 19
- Watchers: 21
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-fauna - fauna-market - A market for Emoji goods, to demonstrate global consistency in Fauna (Open source example apps / React)
README
# Fauna Market
A distributed store example for FaunaDB.
## About the demo
In this demo, selling an item involves updating a handful of database records.
If any one of these updates were to fail, it could leave the database in an
inconsistent state. When you are buying and selling, you have to be able to
trust your database.
The transaction includes these operations:
* Check the credit balance of the purchasing player to ensure they have available funds.
* Check that the item is for sale.
* Update the balances of the selling player and the purchasing player.
* Update the item with the new owner.
* Write a purchase record.
If any one of these operations fails, for instance because the player is
making multiple trades at the same time and exceeds their balance, the
entire transaction must fail. This also holds true in cases of hardware or
network failure. So you know that any data you read or write to FaunaDB
is consistent, taking the guesswork out of writing correct applications.
## Running your own copy
Just clone this repo, install the dependencies, and launch the server.
```sh
git clone [email protected]:fauna/fauna-market.git
cd fauna-market
npm install
npm start
```
This will launch a server at `http://localhost:3000/` with the app running. If
you change any files, it will recompile the application and reload your browser.
### Session service (optional)
The app requires a FaunaDB backend database to run. The database for each session
is provisioned by a serverless script run in AWS Lambda. The repo ships pointed at
a copy of this service maintained by Fauna.
It's cool with us if you use our serverless endpoint and run your own code on top of the schema. However, if you want to make schema changes, you'll probably want to work on your own database root, so you'll need to set up the session service by following the readme in `session-service/`.
### React App
This project was bootstrapped with [Create React App](https://github.com/facebookincubator/create-react-app).
You can find the most recent version of the Create React App guide [here](https://github.com/facebookincubator/create-react-app/blob/master/packages/react-scripts/template/README.md).