https://github.com/nna301023/seagrow

FINAL PROJECT ELEKTRO 2021
https://github.com/nna301023/seagrow

iot machine-learning microcontroller time-series

Last synced: 6 months ago
JSON representation

FINAL PROJECT ELEKTRO 2021

• Host: GitHub
• URL: https://github.com/nna301023/seagrow
• Owner: NnA301023
• License: apache-2.0
• Created: 2024-12-07T03:03:19.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2024-12-10T12:07:19.000Z (about 1 year ago)
• Last Synced: 2025-06-06T03:41:03.783Z (8 months ago)
• Topics: iot, machine-learning, microcontroller, time-series
• Language: HTML
• Homepage:
• Size: 1.26 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🌊 Aquaculture Monitoring System

## Overview

A cutting-edge, real-time monitoring and control system designed to revolutionize aquaculture management. This comprehensive solution leverages modern web technologies to provide seamless, intelligent monitoring of aquatic environments.

![System Architecture](https://img.shields.io/badge/Architecture-Microservices-blue)

![Python Version](https://img.shields.io/badge/Python-3.8+-green)

![Docker](https://img.shields.io/badge/Containerization-Docker-blue)

![License](https://img.shields.io/badge/License-MIT-yellow)

## 🚀 Key Features

### Real-Time Environmental Monitoring

- **Comprehensive Sensor Tracking**

  - Water temperature monitoring

  - Salinity level detection

  - Acidity (pH) measurement

  - Instant alerts for parameter deviations

### Advanced Control Capabilities

- Interactive web-based control panel

- Precision parameter adjustments

- Automated scheduling for aquaculture cycles

### Data Management

- Robust historical data logging

- Comprehensive data visualization

- WebSocket-powered real-time updates

## 🛠 Tech Stack

| Category | Technologies |

|----------|--------------|

| Backend | ![Flask](https://img.shields.io/badge/Flask-Framework-red) ![SocketIO](https://img.shields.io/badge/SocketIO-Realtime-green) |

| Message Broker | ![Redis](https://img.shields.io/badge/Redis-MessageQueue-red) |

| Frontend | ![HTML5](https://img.shields.io/badge/HTML5-Markup-orange) ![JavaScript](https://img.shields.io/badge/JavaScript-ES6-yellow) |

| Containerization | ![Docker](https://img.shields.io/badge/Docker-Containers-blue) |

## 🔧 Prerequisites

Before you begin, ensure you have the following installed:

- 🐳 Docker & Docker Compose

- 🐍 Python 3.8 or higher

- 📦 Redis server

## 💻 Installation & Setup

### Quick Start with Docker

```bash

# Clone the repository

git clone https://github.com/yourusername/aquaculture-monitoring.git

cd aquaculture-monitoring

# Build and launch containers

docker-compose up -d

```

### Local Development Setup

```bash

# Install dependencies

pip install -r requirements.txt

# Run the application

python app.py

```

## 📂 Project Structure

```

aquaculture-monitoring/

│

├── app.py                 # Main application entry point

├── data_generator.py      # Simulated sensor data generation

├── docker-compose.yml     # Docker service configurations

├── requirements.txt       # Python package dependencies

│

└── src/

    └── templates/         # Web interface templates

        ├── monitoring.html

        ├── control.html

        └── input_schedule.html

```

## 🌐 API Endpoints

| Endpoint | Method | Description |

|----------|--------|-------------|

| `/api/parameters` | GET | Retrieve current sensor parameters |

| `/api/parameters` | POST | Update sensor parameters |

| `/api/schedules` | GET | Fetch all aquaculture schedules |

| `/api/schedules` | POST | Create a new schedule |

| `/api/schedules` | DELETE | Reset all schedules |

| `/api/sensor_history` | GET | Access historical sensor data |

## 🔌 WebSocket Events

- `connect`: Establishes client connection

- `sensor_data`: Streams real-time sensor updates

- `disconnect`: Handles client disconnection

## 🌍 Configuration

### Environment Variables

No additional configuration required. Default Redis connection: `localhost:6379`

## 🤝 Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository

2. Create a feature branch (`git checkout -b feature/innovative-improvement`)

3. Commit changes (`git commit -m 'Add groundbreaking feature'`)

4. Push to branch (`git push origin feature/innovative-improvement`)

5. Open a Pull Request

## 📄 License

Distributed under the MIT License. See `LICENSE` for more information.

## 🙏 Acknowledgments

- Flask & Flask-SocketIO Communities

- Redis Open Source Project

- Passionate Aquaculture Innovators

---

**Built with ❤️ for the Future of Sustainable Aquaculture**