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

added wiki page #148

Open
wants to merge 1 commit into
base: feature/wiki-docs
Choose a base branch
from
Open
Show file tree
Hide file tree
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
1 change: 0 additions & 1 deletion Water-Monitoring-System.wiki
Submodule Water-Monitoring-System.wiki deleted from 45a645
191 changes: 191 additions & 0 deletions Water-monitoring-system-wiki.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,191 @@
1. [Introduction](#introduction)
1. [Goals](#goals)
1. [Hardware used](#hardware-used)
1. [Tech Stack](#tech-stack)
1. [Contribution Guidelines](#contribution-guidelines)
1. [Open Source Programs](#open-source-programs)
1. [Frequently Asked Questions(FAQs) for GSSoC'20](#frequently-asked-questionsfaqs-for-gssoc20)
1. [Additional Info](#additional-info)
1. [Team](#team)
1. [Useful Resources](#useful-resources)

# Introduction
Water Monitoring System is an IOT based Liquid Level Monitoring system that has mechanisms to keep the user alerted in case of liquid overflow or when tank depletes. The water tanks can be fixed with ultrasonic sensors that are placed over the container. The ultrasonic sensor is used to measure, compare container depth and liquid level.

The status of the system could be monitored by an LCD screen or a web page that provides a brilliant graphical representation. Colors are used to depict various scenarios with respect to the amount of liquid in the tanks or containers, and the buzzer buzzes when the limit exceeds the permissible quantity of fill.

# Goals
The primary goal of this project is to make efficient use of water across the city. This project will help us to make use of technology for conserving natural resources.
We can use this system to keep track of the water consumption and depletion over some time, and thus analyze its usage.

# Hardware Used

* AVR family microcontroller
* LCD screen
* Wifi modem
* A buzzer
* 12V transformer

# Tech Stack
* HTML
* CSS
* JavaScript
* JQuery
* Arduino

# How to get started

1. Fork [this](https://github.com/vinitshahdeo/Water-Monitoring-System) repository.

1. Clone the forked repository. <br/>
`git clone https://github.com/<your-github-username>/Water-Monitoring-System`

1. Navigate to the project directory. <br/>
`cd Water-Monitoring-System`

1. Create a new branch.<br/>
`git checkout -b <your_branch_name>`

1. Make changes in source code.

1. Commit your changes.

` git add .`<br/>
` git commit -m "<your_commit_message>"`

1. Push your local branch to the remote repository.<br/>
`git push -u origin <your_branch_name>`

1. Create a PR!

Congratulations! Sit and relax, you've made your contribution to Water Monitoring System project.

# Contribution Guidelines

![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/vinitshahdeo/Water-Monitoring-System?logo=git&logoColor=white) ![GitHub contributors](https://img.shields.io/github/contributors/vinitshahdeo/Water-Monitoring-System?logo=github) [![Vinit Shahdeo](https://img.shields.io/badge/[email protected]?colorA=gray&colorB=dodgerblue&logo=github)](https://github.com/vinitshahdeo/)

- Write clear meaningful git commit messages (Do read [this](http://chris.beams.io/posts/git-commit/)).

- Make sure your PR's description contains GitHub's special keyword references that automatically close the related issue when the PR is merged. (Check [this](https://github.com/blog/1506-closing-issues-via-pull-requests) for more info)

- When you make very very minor changes to a PR of yours (like for example fixing a text in the button, minor changes requested by reviewers) make sure you squash your commits afterward so that you don't have an absurd number of commits for a very small fix. (Learn how to squash at [here](https://davidwalsh.name/squash-commits-git))

- When you're submitting a PR for a UI-related issue, it would be really awesome if you add a screenshot of your change or a link to a deployment where it can be tested out along with your PR. It makes it very easy for the reviewers and you'll also get reviews quicker.

- Please follow the [PR Template](https://github.com/vinitshahdeo/Water-Monitoring-System/blob/master/.github/PULL_REQUEST_TEMPLATE.md) to create the PR.

- Always create PR to `develop` branch.

- Please read our [Code of Conduct](https://github.com/vinitshahdeo/Water-Monitoring-System/blob/master/CODE_OF_CONDUCT.md).

- Refer [this](https://github.com/vinitshahdeo/Water-Monitoring-System/blob/master/CONTRIBUTING.md) for more.

# Open Source Programs

This project is part of the following Open Source programs:

- [GirlScript Summer of Code 2020](https://www.gssoc.tech/)
- [Rails Girls Summer of Code 2020](http://railsgirlssummerofcode.org/)
- [JGEC Winter of Code 2020](https://jwoc.tech/)


# Frequently Asked Questions(FAQs) for [GSSoC'20](https://www.gssoc.tech/)

> This project is accepting contributions under [GirlScript Summer of Code 2020](https://www.gssoc.tech/) - three months long Open Source program conducted by [GirlScript Foundation](https://www.gssoc.tech/).

[![GSSoC](https://raw.githubusercontent.com/GirlScriptSummerOfCode/MentorshipProgram/master/GSsoc%20Type%20Logo%20Black.png)](https://www.gssoc.tech/)

#### *1. How to start as a beginner so as to contribute to the project?*
*There are many beginner level issues to begin with, which include documentation, development, and design. Also, feel free to make issues for features as well as for reporting bugs. Participants can claim an issue by commenting that they are interested in it. We are also open to new ideas and suggestions.*


#### *2. Is this a hardware/IoT project?*
*Yes, it is a hardware/IoT + software project. There would be maximum tasks related to frontend, backend, design and documentation of the website and later, it would be integrated with the real-time data from the sensors.*

#### *3. How to communicate with us?*
*All communication will happen on the Slack channel for this project. Mentors can also be reached through GitHub. Avoid DMs and unnecessary mentions on slack and GitHub both. *Checkout [this](https://github.com/vinitshahdeo/Water-Monitoring-System/issues/15) issue for more.**

#### *4. What is the Tech Stack for this project?*

- ***Frontend:** React*

- ***Backend:** Django, Node.js*

#### *5. What is the deadline for any task submission?*

*Mentors can assign issues to participants and also mention a deadline before which the issue is to be resolved. They can reassign issues in case of any delay, so be active and complete your tasks within the negotiated duration.*

# Additional Info

- If you're interested in contributing for **documentation**, please checkout `feature/documentation` branch.

- If you're interested in contributing for **backend**, please checkout the following branch according to the tech stack:

- **Django**: `feature/backend-django`
- **Node.js**: `feature/backend-node`

- If you're interested in contributing for **frontend**, please checkout `feature/frontend` branch.

> **Note:** Are you an **absolute beginner?** Please [check the issues](https://github.com/vinitshahdeo/Water-Monitoring-System/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only) labeled with `first-timers-only`. These issues might _let your Open Source journey begin_ - **Welcome onboard!**

# Team
## Mentors

[![Open Source Love](https://badges.frapsoft.com/os/v2/open-source.svg?v=103)](https://github.com/vinitshahdeo) ![GitHub pull requests](https://img.shields.io/github/issues-pr-closed-raw/vinitshahdeo/Water-Monitoring-System?logo=git&logoColor=white)

| GitHub Usernames | Domain |
|---|---|
| [@vinitshahdeo](https://github.com/vinitshahdeo) | Full Stack + Documentation |
| [@ShreyaAnand](https://github.com/ShreyaAnand) | Full Stack |
| [@YashMeh](https://github.com/YashMeh) | Backend |
| [@PragatiVerma18](https://github.com/PragatiVerma18) | Backend + Documentation |
| [@ramanaditya](https://github.com/ramanaditya) | Backend + Hardware |
| [@ArpitKotecha](https://github.com/ArpitKotecha) | Backend |
| [@Manvityagi](https://github.com/Manvityagi) | APIs + Cloud |
| [@jainpawan21](https://github.com/jainpawan21) | Frontend |

[![](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/images/0)](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/links/0)[![](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/images/1)](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/links/1)[![](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/images/2)](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/links/2)[![](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/images/3)](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/links/3)[![](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/images/4)](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/links/4)[![](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/images/5)](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/links/5)[![](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/images/6)](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/links/6)[![](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/images/7)](https://sourcerer.io/fame/vinitshahdeo/vinitshahdeo/Water-Monitoring-System/links/7)

## Project Admin

[![Relative date](https://img.shields.io/date/1577392258?color=important&label=started&logo=github)](https://github.com/vinitshahdeo/) [![Maintenance](https://img.shields.io/maintenance/yes/2020?color=green&logo=github)](https://github.com/vinitshahdeo/)

| <a href="https://fayz.in/stories/s/1522/0/?ckt_id=ZGL1ZGVk&title=story_of_vinit_shahdeo"><img src="assets/vinit-shahdeo.jpg" width=150px height=150px /></a> |
|:---:|
| **[Vinit Shahdeo](https://www.linkedin.com/in/vinitshahdeo/)** |
| <a href="https://twitter.com/Vinit_Shahdeo"><img src="assets/twitter.png" width="32px" height="32px"></a> <a href="https://www.facebook.com/vinit.shahdeo"><img src="assets/facebook.png" width="32px" height="32px"></a> <a href="https://www.linkedin.com/in/vinitshahdeo/"><img src="assets/linkedin.png" width="32px" height="32px"></a> |

# Useful Resources

- [Django Docs](https://docs.djangoproject.com/en/3.0/)
- [React Docs](https://reactjs.org/docs/getting-started.html)
- [Node.js Docs](https://nodejs.org/api/)
- [Git and GitHub](https://www.digitalocean.com/community/tutorials/how-to-use-git-a-reference-guide)

---

```javascript
/**
*
* {thisRepo.url} = https://github.com/vinitshahdeo/Water-Monitoring-System/
*
*/
if (thisRepo.isAwesome()) {
thisRepo.fork(); // waiting for your awesome contributions :)
thisRepo.star(); // thanks in advance :p
thisRepo.watch((bug) => {
if(!doesIssueExists(bug)) {
createNewIssue(bug); // wow, that's a nice catch
}
else {
checkIssueTracker(bug); // comment there
}
});
thisRepo.share(); // sharing is caring :D
}

```

---

[![built with love](https://forthebadge.com/images/badges/built-with-love.svg)](https://github.com/vinitshahdeo/) [![powered by water](https://forthebadge.com/images/badges/powered-by-water.svg)](https://github.com/vinitshahdeo/) [![smile please](https://forthebadge.com/images/badges/makes-people-smile.svg)](https://github.com/vinitshahdeo/)