Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

🔥 rewrite and modification for the readme / rebranding to Kashafty #67

Merged
merged 6 commits into from
Jan 26, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 47 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,40 @@
# Scout Management System
# ![Logo](READMEImages/logo-ex.png) Kashafty

![Logo](READMEImages/logo-ex.png)
This is Kashafty! An SPA for managing all the scout groups needs. Attendance, finance, activities you name it! we got it! 😉

## About the Project
<!-- Scout management system is a website implemented using **PERN stack**. This project is a 2nd year CUFE project for practicing on the fundamental rules of database system management. -->

Scout management system is a website implemented using **PERN stack**. This project is a 2nd year CUFE project for practicing on the fundemental rules of database system management.
<!-- TODO: replace with an image that have Kashafty on it or maybe a GIF -->

![Landing Page](READMEImages/Landing%20Page%20Cropped.png)
## 🤔 But why?

- Have you ever tried to record the attendance of over 500 person using only a paper and a pen? Well, we did and it was a mess!
- Have you ever had to make reports on something and found yourself in the face of a huge pile of papers that is impossible to handle? guess what, we did too!
- as a leader, have you ever found yourself in a headache trying to manage the mess of data and reports that come from every direction with no clear structure? we totally understand you!

So we made `Kashafty` the solution for all scout groups' problems. It is a website that helps you manage all your scouts' data, activities, finance and much more!

<!-- ## Our website is now on air🔥 -->

## Our website is now on air🔥
<!-- We deployed our website, although, it is still in progress so you might find some missing functionalities. -->

We deployed our website, although, it is still in progress so you might find some missing functoinalities.
<!-- To login as a general captain use: -->

To login as a general captain use:
<!-- > email: [email protected] -->
<!-- > pass: 1234 -->

> email: [email protected]
> pass: 1234
## 🚀 Quick start

🔥[Website Link](https://scouts-managment-system-development.onrender.com/)🔥
To get started navigate to [Kashafty demo](https://scouts-managment-system-development.onrender.com/) and use this account to try out the Main functionalities:

> - email:[[email protected]]([email protected])
> - pass: 1234

you can also create your own account and try out the system as a regular captain.

![Landing Page](READMEImages/Landing%20Page%20Cropped.png)

## Why do you have to use this website?
## 📖 Documentation and features

This website is based on a well structured database and a user friendly app, which helps in providing the best managerial experience to the scout captains. It helps them in:

Expand Down Expand Up @@ -52,6 +67,16 @@ This website is based on a well structured database and a user friendly app, whi
- Providing graphs for better analysis
- Getting reports on the current system status

## 🧰 Tech Stack

- **Frontend**

<img src="https://img.icons8.com/color/48/000000/react-native.png"/> <img src="https://img.icons8.com/color/48/000000/redux.png"/> <img src="https://img.icons8.com/color/48/000000/javascript.png"/> <img src="https://img.icons8.com/color/48/000000/sass.png"/> <img src="https://img.icons8.com/color/48/000000/figma.png">

- **Backend**

<img src="https://img.icons8.com/color/48/000000/nodejs.png"/> <img src="https://img.icons8.com/color/48/000000/express-js.png"/> <img src="https://img.icons8.com/color/48/000000/postgreesql.png"/>

## Pre-implementation phase

### Database design
Expand All @@ -74,17 +99,22 @@ We have designed a complete UX design for all system pages: about 40 pages

[User Stories](https://drive.google.com/file/d/1RwYU0OpM7EVVqLCTXDNxmlU7WgaKOdvz/view?usp=sharing)

## How to run?
## How to run locally?

run the following commands in the terminal
after filling the `.env` file as required. run the following commands in the terminal

```
```bash
npm i
npm run dev
```

## Contributers
## Contributors

| ![Abdelruhman](https://avatars.githubusercontent.com/u/121282837?v=4) | ![Amir](https://avatars.githubusercontent.com/u/88613195?v=4) | ![Akram](https://avatars.githubusercontent.com/u/109467185?v=4) | ![Ahmed](https://avatars.githubusercontent.com/u/104217693?v=4) |
<!-- | ![Abdelruhman](https://avatars.githubusercontent.com/u/121282837?v=4) | ![Amir](https://avatars.githubusercontent.com/u/88613195?v=4) | ![Akram](https://avatars.githubusercontent.com/u/109467185?v=4) | ![Ahmed](https://avatars.githubusercontent.com/u/104217693?v=4) |
| --------------------------------------------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------- |
| [AbdelruhmanSamy](https://github.com/AbdelruhmanSamy/) | [amir-kedis](https://github.com/amir-kedis/) | [akramhany](https://github.com/akramhany/) | [AhmedHamed3699](https://github.com/AhmedHamed3699) |
-->

| <img src="https://avatars.githubusercontent.com/u/121282837?v=4" width="100px" alt="Abdelruhman"> | <img src="https://avatars.githubusercontent.com/u/88613195?v=4" width="100px" alt="Amir"> | <img src="https://avatars.githubusercontent.com/u/109467185?v=4" width="100px" alt="Akram"> | <img src="https://avatars.githubusercontent.com/u/104217693?v=4" width="100px" alt="Ahmed"> |
| ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| [AbdelruhmanSamy](https://github.com/AbdelruhmanSamy/) | [amir-kedis](https://github.com/amir-kedis/) | [akramhany](https://github.com/akramhany/) | [AhmedHamed3699](https://github.com/AhmedHamed3699) |