Important

🚧 V2 Migration in Progress

The application is currently migrating to v2. This includes:

• Full migration from AngularJS to React
• Rewrite of all editors
• Bug fixes and usability improvements
• New NoSQL modeling support

This repository is temporarily out of sync with the live application at app.brmodeloweb.com.

Until the migration is complete (over the next few weeks), we will not be updating this public repository nor accepting external contributions. Once the migration is finalized, the repo will be updated with the new version.

Thank you for your patience!

app.brmodeloweb.com

Web application for database modeling and teaching

Released under the Apache License 2.0

Dependencies

To run this application you'll need:

• EditorConfig
• Node.js version 20.x (Strongly recommended to install it via nvm or n)
• Yarn version 1.x
• MongoDB Community Edition version 4.x (Check installation guides)

Running application

1. Install dependencies: yarn install
2. Duplicate .env.example and rename it to .env
3. Make sure you have MongoDB running (To know more: MacOS, Windows, CentOS, Ubuntu or Debian)
4. Start frontend: yarn start:frontend
5. Start server: yarn start:dev
6. Access it: http://localhost:9000/

Running with docker-compose

Note: Docker setup is still a work in progress and does not offer a good developer experience. For now we recommend you to run the project locally following the instructions listed above. If you still want to use docker, here's how:

1. Make sure you have Docker Desktop running
2. Start docker: docker-compose up or docker-compose up -d
3. Access it: http://localhost:9000/
4. Once your done, finish docker: docker-compose down

Tests

Setup tests

1. Duplicate cypress.env.example.json and rename it to cypress.env.json
2. Update cypress.env.json with valid user credentials (Username and password)

Warning

The data from the accound you set in cypress.env.json will be wiped out after the tests run. So, don't use your real account here!

E2E tests

To run E2E tests you have two options:

1. Run headless mode in your terminal window: yarn test:cy
2. Run interactive mode: yarn cy:open

Unit Tests

To run the unit tests you have two options:

• yarn test to run all the tests and collect the coverage report. Or;
• Execute in a watch mode by running yarn test:watch

Production environments

• Stable: https://app.brmodeloweb.com
• Staging: https://brmodelo-stage.herokuapp.com

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Milton Bittencourt de Souza Neto 💻 ⚠️ 🐛 🚧	Idmar Ramos Junior (Id) 💻 🎨 📆 🚧	Felipe de Souza da Costa 💻 🚇 👀	Márcio Santos 💻 👀	Telmo "Trooper" 💻	Arthur Mota 💻 👀	joaomfiumari 💻 🚇
Walmyr ⚠️	Tárliton Basso de Godoy 💻 🚇	John Fercher 💵	Henrique Ferraz 💵	Paulo Ricardo Stradioti 💵	Salim Nabbout 💵	Justin Ferraz 💵
walissonkuper 💵	David de Souza 💵	Jeverson misael da cruz filho 💵	João Marcelo de Oliveira Delfino 💻	Estéfano Tuyama Gerassi 💻	Felipecluiz 💻	Eduardo Castro 💵
claudiosanavria 💵	TBMFOCABR 💵	fabriciocore 💵	Julianna Lemos 💵	VIVIANECOELHO1 💵

This project follows the all-contributors specification. Contributions of any kind are welcome — please note that external contributions are temporarily paused while the v2 migration is in progress (see the notice at the top of this README).