|
1 |
| - |
2 |
| -# DevPulse Backend |
| 1 | +# atlp-devpulse-bn |
3 | 2 |
|
4 | 3 | ## Introduction
|
5 | 4 |
|
6 |
| -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**. |
7 |
| - |
8 |
| -## Table of Contents |
9 |
| - |
10 |
| -- [Hosted Link](#hosted-link) |
11 |
| -- [Features](#features) |
12 |
| -- [Technologies](#technologies) |
13 |
| -- [Getting Started](#getting-started) |
14 |
| - - [Prerequisites](#prerequisites) |
15 |
| - - [Installation](#installation) |
16 |
| -- [Usage](#usage) |
17 |
| -- [API Documentation](#api-documentation) |
18 |
| -- [Contributing](#contributing) |
19 |
| -- [Contact](#contact) |
| 5 | +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**. |
20 | 6 |
|
21 | 7 | ## Hosted Link
|
22 | 8 |
|
23 |
| -The backend is currently hosted at: [https://atlp-devpulse-bn.onrender.com/](https://atlp-devpulse-bn.onrender.com/) |
24 |
| - |
25 |
| -## Features |
26 |
| - |
27 |
| -- Real-time performance metrics tracking |
28 |
| -- Advanced attendance management |
29 |
| -- Dynamic application cycle overview |
30 |
| -- Secure authentication and authorization |
31 |
| -- Scalable GraphQL API |
32 |
| - |
33 |
| -## Technologies |
34 |
| - |
35 |
| -To successfully navigate and contribute to the codebase, you should have an understanding of the following technologies: |
36 |
| - |
37 |
| -- [GraphQL](https://graphql.org/): A query language for APIs |
38 |
| -- [TypeScript](https://www.typescriptlang.org/): A typed superset of JavaScript |
39 |
| -- [Apollo Server](https://www.apollographql.com/docs/apollo-server/): A GraphQL server |
40 |
| -- [MongoDB](https://www.mongodb.com/): A NoSQL database |
41 |
| -- [Node.js](https://nodejs.org/): A JavaScript runtime |
42 |
| -- [Express](https://expressjs.com/): A web application framework for Node.js |
43 |
| - |
44 |
| -## Getting Started |
45 |
| - |
46 |
| -### Prerequisites |
47 |
| - |
48 |
| -Before running this project, make sure you have the following installed: |
| 9 | +https://andela-devpulse-backend.devpulse.co/ |
49 | 10 |
|
50 |
| -- [Node.js](https://nodejs.org/) (version 14 or later) |
51 |
| -- [Git](https://git-scm.com/) |
52 |
| -- [MongoDB](https://www.mongodb.com/try/download/community) (local installation or a cloud-hosted instance) |
| 11 | +## How to run |
53 | 12 |
|
54 |
| -### Installation |
| 13 | +To run this project on your local machine make sure that all the following are checked |
55 | 14 |
|
56 |
| -1. Clone the repository: |
57 |
| - ```bash |
58 |
| - git clone https://github.com/atlp-rwanda/atlp-devpulse-bn.git |
59 |
| - ``` |
| 15 | +- [ ] Nodejs installed on your computer ([MacOS](https://nodejs.org/en/download/), [Windows](https://nodejs.org/en/download/), [Linux](https://nodejs.org/en/download/)) |
| 16 | +- [ ] Git installed on your computer |
60 | 17 |
|
61 |
| -2. Navigate to the project directory: |
62 |
| - ```bash |
63 |
| - cd atlp-devpulse-bn |
64 |
| - ``` |
| 18 | +Use the following commands to get started with the project |
65 | 19 |
|
66 |
| -3. Install dependencies: |
67 |
| - ```bash |
68 |
| - npm install |
69 |
| - ``` |
| 20 | +```js |
| 21 | +git clone https://github.com/atlp-rwanda/atlp-devpulse-bn.git |
| 22 | +cd atlp-devpulse-bn |
| 23 | +npm install |
| 24 | +npm run dev |
70 | 25 |
|
71 |
| -4. Set up environment variables: |
72 |
| - - Copy the `.env.example` file to `.env` |
73 |
| - - Fill in the required environment variables |
74 | 26 |
|
75 |
| -5. Start the development server: |
76 |
| - ```bash |
77 |
| - npm run dev |
78 |
| - ``` |
| 27 | +### Other scripts and their usages |
| 28 | +- `npm run build` is used to build the production ready version of the projects. |
| 29 | +Used during deployment |
79 | 30 |
|
80 |
| -## Usage |
81 |
| - |
82 |
| -### Available Scripts |
83 |
| - |
84 |
| -- `npm run dev`: Starts the development server using nodemon |
85 |
| -- `npm start`: Starts the production server |
86 |
| -- `npm test`: Runs the test suite using Jest |
87 |
| -- `npm run build`: Builds the production-ready version of the project using TypeScript compiler |
88 |
| -- `npm run seed`: Runs the database seeding script |
89 |
| - |
90 |
| -## API Documentation |
91 |
| - |
92 |
| -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). |
93 |
| - |
94 |
| -## Contributing |
95 |
| - |
96 |
| -We welcome contributions to the DevPulse project! Please follow these steps to contribute: |
97 |
| - |
98 |
| -1. Fork the repository |
99 |
| -2. Create a new branch (`git checkout -b feature/AmazingFeature`) |
100 |
| -3. Make your changes |
101 |
| -4. Commit your changes (`git commit -m 'Add some AmazingFeature'`) |
102 |
| -5. Push to the branch (`git push origin feature/AmazingFeature`) |
103 |
| -6. Open a Pull Request |
104 |
| - |
105 |
| -Please make sure to update tests as appropriate and adhere to the [Contributor Covenant](https://www.contributor-covenant.org/) code of conduct. |
106 |
| - |
107 |
| - |
108 |
| -## Contact |
| 31 | +## Technologies |
109 | 32 |
|
110 |
| - |
| 33 | +To successfully navigate the codebase of the project, you will need undertanding |
| 34 | +of the following technologies that are being used to develop this application: |
111 | 35 |
|
112 |
| -Project Links: |
113 |
| -- [https://github.com/atlp-rwanda/atlp-devpulse-bn](https://github.com/atlp-rwanda/atlp-devpulse-bn) |
114 |
| -- https://atlp-devpulse-bn.onrender.com/ |
| 36 | +- GraphQl |
| 37 | +- Typescript |
| 38 | +- Apollo server |
| 39 | +- MongoDB |
| 40 | +``` |
0 commit comments