Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/chanmeng666/biosecurity

A Flask-based web application serving as a comprehensive biosecurity guide for agricultural pests and weeds in New Zealand. Features role-based access control, detailed pest/weed information management, and responsive design for agronomists, staff, and administrators.
https://github.com/chanmeng666/biosecurity

agriculture biosecurity bootstrap database-management flask mysql pest-management python role-based-access web-application

Last synced: 16 days ago
JSON representation

Host: GitHub
URL: https://github.com/chanmeng666/biosecurity
Owner: ChanMeng666
License: mit
Created: 2024-02-24T09:47:41.000Z (11 months ago)
Default Branch: main
Last Pushed: 2024-12-29T22:28:04.000Z (19 days ago)
Last Synced: 2024-12-29T23:20:28.063Z (19 days ago)
Topics: agriculture, biosecurity, bootstrap, database-management, flask, mysql, pest-management, python, role-based-access, web-application
Language: HTML
Homepage: https://1160210.pythonanywhere.com/
Size: 1.15 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

# Biosecurity Guide for Agricultural Pests and Weeds 🌱

https://github.com/user-attachments/assets/02908422-5bc5-40df-b3ed-6fe9e1e049e5

![screencapture-1160210-pythonanywhere-2024-12-08-13_07_57](https://github.com/user-attachments/assets/9f8960f2-e101-4faa-8e4f-041dd64923da)

![screencapture-1160210-pythonanywhere-auth-login-2024-12-08-13_08_37](https://github.com/user-attachments/assets/3a6b6675-4b95-41e2-b893-b2c865da6563)

![screencapture-1160210-pythonanywhere-admin-home-2024-12-08-13_08_57](https://github.com/user-attachments/assets/729a65b7-b711-424c-b4d2-2ae153eeed3a)

![screencapture-1160210-pythonanywhere-admin-admin-manage-staff-2024-12-08-13_09_12](https://github.com/user-attachments/assets/720678e8-4bbc-4247-9cfb-582dc2345b3e)

![屏幕截图 2024-12-08 131000](https://github.com/user-attachments/assets/9cb56746-a8aa-4ee4-8fe9-521e6ff2bb6d)

![screencapture-1160210-pythonanywhere-admin-admin-manage-guide-add-2024-12-08-13_10_20](https://github.com/user-attachments/assets/e35aa016-1a49-4fe0-8e43-e7090a19f636)

![screencapture-1160210-pythonanywhere-agronomist-agronomist-view-guide-2024-12-08-13_10_49](https://github.com/user-attachments/assets/b6994684-3a55-4772-ba0c-bf3fc51bbca3)

## Overview
A Flask-based web application that serves as a comprehensive biosecurity guide for agricultural pests and weeds. This platform provides targeted information and management capabilities for different user roles including Agronomists, Staff, and Administrators.

### Project Features:
- **User Role Management**: Distinct interfaces and capabilities for Agronomists, Staff, and Administrators
- **Comprehensive Guide**: Detailed information about agricultural pests and weeds
- **Responsive Design**: Mobile-friendly interface with Bootstrap CSS
- **Image Management**: Support for pest and weed image uploads and management
- **Secure Authentication**: Role-based access control and secure password handling

## Getting Started

### Prerequisites
- Python 3.8+
- MySQL Server
- Modern web browser

### Dependencies
```
Flask==3.0.2
mysql-connector-python==8.3.0
Werkzeug==3.0.1
WTForms==3.1.2
```

### Installation
1. Clone the repository:
```bash
git clone https://github.com/ChanMeng666/biosecurity.git
```
2. Install required packages:
```bash
pip install -r requirements.txt
```
3. Configure MySQL database:
```python
# config.py
class Config(object):
SECRET_KEY = '123456'
DATABASE_URI = 'mysql://root:123456@localhost/biosecurity'
```

## Features

### User Roles
- **Agronomists**: View and access detailed pest and weed information
- **Staff**: Manage guide content and agronomist profiles
- **Administrators**: Full system access including user management

### Database Design
- Role differentiation with specific permissions
- User management with role associations
- Efficient data handling and storage
- Support for image management

## Deployment
The application is deployed on PythonAnywhere and can be accessed at [1160210.pythonanywhere.com](https://1160210.pythonanywhere.com)

### Testing Accounts

#### Local Environment
| Role | Username | Password |
| ---------- | -------- | ---------- |
| Agronomist | agro1 | 123qweASD@ |
| Staff | staff1 | 123qweASD@ |
| Admin | admin1 | 123qweASD@ |

#### PythonAnywhere Environment
| Role | Username | Password |
| ---------- | -------- | ----------- |
| Admin | hello777 | 1234qweASD@ |
| Admin | admin0 | 123qweASD@ |
| Staff | staff1 | 123qweASD@ |
| Agronomist | agro1 | 123qweASD@ |

## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.

## License
This project is licensed under the MIT License - see the LICENSE file for details.

## Contact
PythonAnywhere: [1160210.pythonanywhere.com](https://1160210.pythonanywhere.com)

## 🙋‍♀ Author

Created and maintained by [Chan Meng](https://github.com/ChanMeng666).