https://github.com/douaa1819/citronix

Citronix is a farm management system built with Spring Boot, designed to help farmers manage farms, fields, trees, harvests, and sales. It allows efficient tracking of tree growth, seasonal harvests, and sales revenue, all while optimizing farm productivity.🌱👨‍🌾
https://github.com/douaa1819/citronix

java maven mockito postgresql restful-api spring-boot unit-testing

Last synced: 26 days ago
JSON representation

Citronix is a farm management system built with Spring Boot, designed to help farmers manage farms, fields, trees, harvests, and sales. It allows efficient tracking of tree growth, seasonal harvests, and sales revenue, all while optimizing farm productivity.🌱👨‍🌾

• Host: GitHub
• URL: https://github.com/douaa1819/citronix
• Owner: Douaa1819
• Created: 2024-11-16T12:11:17.000Z (about 2 months ago)
• Default Branch: master
• Last Pushed: 2024-11-28T10:12:17.000Z (about 1 month ago)
• Last Synced: 2024-12-07T23:12:15.461Z (26 days ago)
• Topics: java, maven, mockito, postgresql, restful-api, spring-boot, unit-testing
• Language: Java
• Homepage:
• Size: 107 KB
• Stars: 5
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 🍋 **Citronix** - Agricultural Management System 🌱

**Citronix** is a comprehensive platform designed for farmers and agricultural professionals. It provides advanced tools to manage farms, track fields, monitor trees, record harvests, and optimize sales. Whether you are managing a small farm or a large-scale operation, **Citronix** aims to enhance farm productivity and streamline operations.

---

## 🚀 **Features**

- **🌾 Farm Management:** Create and manage farms with detailed information (name, location, size, etc.).

- **🪴 Field Management:** Add and track fields, ensuring adherence to size constraints and field-to-farm allocation.

- **🌳 Tree Tracking:** Record tree plantation details and automatically calculate the age of trees. 

- **🌟 Harvest Management:** Organize harvests by season and track progress throughout the year.

- **💰 Sales Optimization:** Register sales and calculate revenues based on harvest quantity and price.

- **📊 Analytics & Reports:** Generate statistics for better decision-making and efficient farm management.

---

## 🛠️ **Technologies Used**

- **Backend:** Java with Spring Boot.

- **Database:** MySQL or PostgreSQL (configured in `application.properties`).

- **API:** RESTful API architecture for easy interaction and integration.

- **Validation:** Spring annotations for robust data validation.

- **Build Tool:** Maven for project compilation and dependency management.

- **Unit Testing:** JUnit and Mockito for unit testing.

---

## ⚙️ **Installation**

To get started with **Citronix**, follow these simple steps:

### 1. Clone the repository

```bash

git clone https://github.com/Douaa1819/Citronix.git

```

### 2. Navigate to the project folder :  

   ```bash

   cd Citronix

```

###  3.Configure the database in application.properties

Ensure that you have a MySQL or PostgreSQL instance running. Configure your database connection in the application.properties file

### 4. Compile and run the project :

Use Maven to build and start the application

```bash

 mvn spring-boot:run

 ```