-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Browse files
Browse the repository at this point in the history
* Revert "ft: Generate API Documentation (#146)" This reverts commit fa2bf88. * updated .env.example
- Loading branch information
1 parent
2223abf
commit 8ef534d
Showing
17 changed files
with
35 additions
and
808 deletions.
There are no files selected for viewing
This file contains 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
This file contains 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,114 +1,40 @@ | ||
|
||
# DevPulse Backend | ||
# atlp-devpulse-bn | ||
|
||
## Introduction | ||
|
||
DevPulse is an innovative platform designed to handle ratings for companies in the **Ed-tech** industry, with its first paying customer being **Andela**. It is currently under development using modern web technologies that prioritize speed and security. This repository contains the codebase for the backend part of the platform, which utilizes **GraphQL, Apollo, and MongoDB**. | ||
|
||
## Table of Contents | ||
|
||
- [Hosted Link](#hosted-link) | ||
- [Features](#features) | ||
- [Technologies](#technologies) | ||
- [Getting Started](#getting-started) | ||
- [Prerequisites](#prerequisites) | ||
- [Installation](#installation) | ||
- [Usage](#usage) | ||
- [API Documentation](#api-documentation) | ||
- [Contributing](#contributing) | ||
- [Contact](#contact) | ||
Pulse is a platform designed to handle ratings for the companies in the **Ed-tech** industries with the its first paying customer being **Andela**. It is currently under development using modern web technologies that prioritize speed and security. This repo holds the codebase for the backend part of the platform which uses **Graphql, Apollo and mongoDB**. | ||
|
||
## Hosted Link | ||
|
||
The backend is currently hosted at: [https://atlp-devpulse-bn.onrender.com/](https://atlp-devpulse-bn.onrender.com/) | ||
|
||
## Features | ||
|
||
- Real-time performance metrics tracking | ||
- Advanced attendance management | ||
- Dynamic application cycle overview | ||
- Secure authentication and authorization | ||
- Scalable GraphQL API | ||
|
||
## Technologies | ||
|
||
To successfully navigate and contribute to the codebase, you should have an understanding of the following technologies: | ||
|
||
- [GraphQL](https://graphql.org/): A query language for APIs | ||
- [TypeScript](https://www.typescriptlang.org/): A typed superset of JavaScript | ||
- [Apollo Server](https://www.apollographql.com/docs/apollo-server/): A GraphQL server | ||
- [MongoDB](https://www.mongodb.com/): A NoSQL database | ||
- [Node.js](https://nodejs.org/): A JavaScript runtime | ||
- [Express](https://expressjs.com/): A web application framework for Node.js | ||
|
||
## Getting Started | ||
|
||
### Prerequisites | ||
|
||
Before running this project, make sure you have the following installed: | ||
https://andela-devpulse-backend.devpulse.co/ | ||
|
||
- [Node.js](https://nodejs.org/) (version 14 or later) | ||
- [Git](https://git-scm.com/) | ||
- [MongoDB](https://www.mongodb.com/try/download/community) (local installation or a cloud-hosted instance) | ||
## How to run | ||
|
||
### Installation | ||
To run this project on your local machine make sure that all the following are checked | ||
|
||
1. Clone the repository: | ||
```bash | ||
git clone https://github.com/atlp-rwanda/atlp-devpulse-bn.git | ||
``` | ||
- [ ] Nodejs installed on your computer ([MacOS](https://nodejs.org/en/download/), [Windows](https://nodejs.org/en/download/), [Linux](https://nodejs.org/en/download/)) | ||
- [ ] Git installed on your computer | ||
|
||
2. Navigate to the project directory: | ||
```bash | ||
cd atlp-devpulse-bn | ||
``` | ||
Use the following commands to get started with the project | ||
|
||
3. Install dependencies: | ||
```bash | ||
npm install | ||
``` | ||
```js | ||
git clone https://github.com/atlp-rwanda/atlp-devpulse-bn.git | ||
cd atlp-devpulse-bn | ||
npm install | ||
npm run dev | ||
|
||
4. Set up environment variables: | ||
- Copy the `.env.example` file to `.env` | ||
- Fill in the required environment variables | ||
|
||
5. Start the development server: | ||
```bash | ||
npm run dev | ||
``` | ||
### Other scripts and their usages | ||
- `npm run build` is used to build the production ready version of the projects. | ||
Used during deployment | ||
|
||
## Usage | ||
|
||
### Available Scripts | ||
|
||
- `npm run dev`: Starts the development server using nodemon | ||
- `npm start`: Starts the production server | ||
- `npm test`: Runs the test suite using Jest | ||
- `npm run build`: Builds the production-ready version of the project using TypeScript compiler | ||
- `npm run seed`: Runs the database seeding script | ||
|
||
## API Documentation | ||
|
||
For detailed information about the API endpoints and how to use them, please refer to our [API Documentation](https://atlp-devpulse-bn.onrender.com/graphql). | ||
|
||
## Contributing | ||
|
||
We welcome contributions to the DevPulse project! Please follow these steps to contribute: | ||
|
||
1. Fork the repository | ||
2. Create a new branch (`git checkout -b feature/AmazingFeature`) | ||
3. Make your changes | ||
4. Commit your changes (`git commit -m 'Add some AmazingFeature'`) | ||
5. Push to the branch (`git push origin feature/AmazingFeature`) | ||
6. Open a Pull Request | ||
|
||
Please make sure to update tests as appropriate and adhere to the [Contributor Covenant](https://www.contributor-covenant.org/) code of conduct. | ||
|
||
|
||
## Contact | ||
## Technologies | ||
|
||
DevPulse Team - [[email protected]](mailto:[email protected]) | ||
To successfully navigate the codebase of the project, you will need undertanding | ||
of the following technologies that are being used to develop this application: | ||
|
||
Project Links: | ||
- [https://github.com/atlp-rwanda/atlp-devpulse-bn](https://github.com/atlp-rwanda/atlp-devpulse-bn) | ||
- https://atlp-devpulse-bn.onrender.com/ | ||
- GraphQl | ||
- Typescript | ||
- Apollo server | ||
- MongoDB | ||
``` |
This file contains 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
Binary file not shown.
This file was deleted.
Oops, something went wrong.
Binary file not shown.
Binary file not shown.
This file was deleted.
Oops, something went wrong.
This file was deleted.
Oops, something went wrong.
Binary file not shown.
Binary file not shown.
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.