This repository was archived by the owner on Jun 24, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 4
Update README.md #126
Open
yujiaxie000
wants to merge
1
commit into
master
Choose a base branch
from
delivery-doc-reformat
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Update README.md #126
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or 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 | ||||
|---|---|---|---|---|---|---|
| @@ -1,35 +1,9 @@ | ||||||
| [](https://circleci.com/gh/jvt/Brainy-Kids) | ||||||
|
|
||||||
| # 8108 - Brainy Kids Administration panel and Analytics Platform | ||||||
| # 8108 - Brainy Kids Administration panel and Analytics Platform v1.0.0 | ||||||
|
|
||||||
| This is the codebase for the Brainy Kids backend and administration panel. This repository also includes the code required for ingesting analytics from the various applications. Keep in mind that this application has to be running only on a single computer/server. All other teachers, administrators, etc will access it through the web. | ||||||
|
|
||||||
| ## Pre-requisites | ||||||
|
|
||||||
| 1. Make sure you have Node.js installed (Make sure `node --version` prints out a version number) | ||||||
| 2. Make sure you have the latest version of MongoDB set up either locally or point it to a remote server (see "Getting Started") | ||||||
| 3. If you want to install this for actual use, make sure you install it on a server that can be accessed by any computer that wants to use it. This usually means the server should have a static IP address and correct port forwarding/firewall configuration. | ||||||
| 4. You must have npm installed. Run `npm --version` in your terminal and expect to see a version number printed out | ||||||
|
|
||||||
| ## Getting started | ||||||
|
|
||||||
| 1. Clone this repository (`git clone git@github.com:jvt/Brainy-Kidz.git`) | ||||||
| 2. Open the repository (`cd Brainy-Kidz`) | ||||||
| 3. Install the dependencies (`npm install`) | ||||||
| 4. Duplicate `.env.example` and rename it to `.env` | ||||||
| 5. Open the `.env` file and add a JWT_SECRET. It should be a random series of letters / numbers. This string is used to encrypt all the tokens for access to the site. | ||||||
| 6. Also set `MONGODB_URI` to either point to your local machine or wherever your MongoDB is. | ||||||
| 7. Make sure your instance of MongoDB is running | ||||||
| 8. Start the application with `npm run dev` | ||||||
| 9. Navigate your browser to `localhost:3000` | ||||||
|
|
||||||
| Now other users should be able to access the application by navigating to it in their web-browser. | ||||||
|
|
||||||
| ## Common issues | ||||||
|
|
||||||
| 1. The program will exit on startup if it is unable to find an instance of MongoDB running at the set URI. Be sure that the instance of MongoDB is running before you start the program. | ||||||
| 2. If the program crashes on startup with error messages mentioning the word "dependicies" run `npm install` in the root directory of the project again. | ||||||
|
|
||||||
| ## Release Notes November 30th: v1.0.0 | ||||||
| ### New Features | ||||||
| 1. Various REST API endpoints is available now to access and manipulate information for student, focus items, program, analytics. | ||||||
|
|
@@ -45,19 +19,49 @@ Now other users should be able to access the application by navigating to it in | |||||
|
|
||||||
| ### Known Bugs | ||||||
| [None] | ||||||
| ## Developer notes | ||||||
|
|
||||||
| ### Viewing the Redux store | ||||||
| ## Install Guide Novermbre 30th: v1.0.0 | ||||||
| ### Pre-requisites | ||||||
|
Owner
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
| 1. Make sure you have Node.js installed (Make sure `npm --version` prints out a version number) | ||||||
| 2. Make sure you have npm installed (Make sure | ||||||
| 3. Make sure you have the latest version of MongoDB set up either locally or point it to a remote server (see "Getting Started") | ||||||
| 4. If you want to install this for actual use, make sure you install it on a server that can be accessed by any computer that wants to use it. This usually means the server should have a static IP address and correct port forwarding/firewall configuration. | ||||||
|
|
||||||
| ### Download | ||||||
| Launch a new terminal and run `git clone git@github.com:jvt/Brainy-Kidz.git` to clone the repository | ||||||
|
|
||||||
| ### Dependencies | ||||||
| 1. In the same ternimal, navigate to the root directory of the repository (`cd Brainy-Kidz`) | ||||||
| 2. Run `npm install` to install all dependencies | ||||||
|
|
||||||
| ### Build | ||||||
| No build necessary for this application. | ||||||
|
|
||||||
| ### Installation | ||||||
| 1. Duplicate `.env.example` and rename it to `.env` | ||||||
| 2. Open the `.env` file and add a JWT_SECRET. It should be a random series of letters / numbers. This string is used to encrypt all the tokens for access to the site | ||||||
| 3. Also set `MONGODB_URI` to either point to your local machine or wherever your MongoDB is | ||||||
|
|
||||||
| ### Running Application | ||||||
| 1. Make sure your instance of MongoDB is running | ||||||
| 2. In the same terminal, run `npm run dev` to start the application | ||||||
| 3. Navigate your browser to `localhost:3000` | ||||||
|
|
||||||
| Now other users should be able to access the application by navigating to it in their web-browser | ||||||
|
|
||||||
| ### Troubleshooting | ||||||
| 1. The program will exit on startup if it is unable to find an instance of MongoDB running at the set URI. Be sure that the instance of MongoDB is running before you start the program | ||||||
| 2. If the program crashes on startup with error messages mentioning the word "dependicies" run `npm install` in the root directory of the project again | ||||||
|
|
||||||
| ## Developer notes | ||||||
| ### Viewing the Redux store | ||||||
| 1. From any page on the website, press `CTRL + h` (Configured in `/frontend/components/DevTools.js`) to open the Redux DevTools panel | ||||||
| 2. From here, you can view the global state of the application. | ||||||
| 2. From here, you can view the global state of the application | ||||||
| 3. To move the window around, press `CTRL + w` | ||||||
|
|
||||||
| ### Running API Tests | ||||||
|
|
||||||
| 1. From a terminal window, run `npm run test` or `npm test` (both do the same thing) | ||||||
| 2. Let the tests run, it will generate a coverage window in the terminal once all the tests have completed running | ||||||
|
|
||||||
| ### Continuous Integration | ||||||
|
|
||||||
| CI is provided by CircleCI and runs on every pull request to ensure tests pass. Merging is disabled until tests pass. | ||||||
| CI is provided by CircleCI and runs on every pull request to ensure tests pass. Merging is disabled until tests pass | ||||||
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.