🌾 AgroManager Pro

Komplex mezőgazdasági vállalatirányítási rendszer WordPress-hez

Országos szintű, mezőgazdálkodással foglalkozó cégek számára fejlesztett WordPress plugin, amely egyetlen admin felületen biztosítja a teljes gazdasági tevékenység nyomon követését – a földterületektől a pénzügyekig.

✨ Funkciók

🗺️ Földterület-kezelés

• Parcellák nyilvántartása (név, méret hektárban, helyszín)
• GPS koordináták tárolása
• Talajminőség értékelés (1-10 skála, vizuális indikátorral)
• Művelési ágak: szántó, rét, legelő, szőlő, gyümölcsös, kert, erdő stb.
• Státuszkezelés: aktív, pihentetett, bérbe adva, inaktív

🌱 Növénykultúra-nyilvántartás

• Kultúrák parcellákhoz kötése
• Vetési és betakarítási dátumok
• Várható és tényleges hozam követés (tonnában)
• Státusz: tervezett → elvetve → növekedésben → betakarítva

🚜 Géppark & Eszközkezelés

• Gépek leltára: traktor, kombájn, permetező, vetőgép, eke stb.
• Gyártó, rendszám, üzemóra nyilvántartás
• Állapotjelzés: üzemképes, karbantartás alatt, meghibásodott, kivonva
• Szerviz figyelmeztetések – automatikus jelzés a közelgő karbantartásokról

🌤️ Időjárás-integráció

• Open-Meteo API (ingyenes, API kulcs nem szükséges)
• Aktuális időjárás: hőmérséklet, csapadék, szél, páratartalom
• 7 napos előrejelzés vizuális kártyákkal
• Parcella GPS koordináta alapú lekérdezés
• 1 órás transient cache a teljesítmény érdekében

💰 Pénzügyi modul

• Bevételek és kiadások nyilvántartása
• Kategóriák: vetőmag, műtrágya, üzemanyag, szerviz, munkabér, értékesítés, támogatás stb.
• Parcellához és kultúrához rendelés
• Éves összesítők – bevétel, kiadás, eredmény
• Chart.js havi diagramok a dashboardon

👷 Dolgozó-kezelés

• Munkatársak nyilvántartása (név, beosztás, telefon, email)
• Munkaidő napló – dátum, kezdés/befejezés, tevékenység, parcella
• Automatikus óraszám számítás

📊 Dashboard

• KPI kártyák: összes terület, kultúrák, gépek, aktív dolgozók
• Pénzügyi összesítő éves bontásban
• Havi bevétel/kiadás oszlopdiagram (Chart.js)
• Időjárás widget
• Közelgő szervizek figyelmeztetés lista

📦 Telepítés

Manuális telepítés

1. Klónozd a repót vagy töltsd le ZIP-ként:

   git clone https://github.com/your-username/agromanager-pro.git

2. Másold a mappát a WordPress plugins könyvtárba:

   cp -r agromanager-pro/ /path/to/wordpress/wp-content/plugins/agromanager-pro/

3. Aktiváld a plugint:
   WordPress Admin → Bővítmények → AgroManager Pro → Aktiválás

4. Keresd az 🌾 AgroManager menüpontot az admin oldalsávban

Első lépések

1. Navigálj: ⚙️ Beállítások → állítsd be a pénznemet és az alapértelmezett helyszínt
2. Adj hozzá parcellákat GPS koordinátákkal
3. Hozz létre kultúrákat és rendeld hozzá a parcellákhoz
4. Vezesd be a gépeket és a dolgozókat
5. A Dashboard automatikusan összesíti az adatokat

📁 Projekt struktúra

agromanager-pro/
├── agromanager-pro.php                    # Fő plugin fájl
├── readme.txt                             # WordPress.org readme
├── README.md                              # GitHub readme
│
├── admin/
│   ├── class-agromanager-admin.php        # Admin menü, dashboard, beállítások, routing
│   ├── css/
│   │   └── agromanager-admin.css          # Prémium admin stílusok
│   └── js/
│       └── agromanager-admin.js           # Animációk, Chart.js integráció
│
└── includes/
    ├── class-agromanager-activator.php    # DB táblák létrehozása (6 tábla)
    ├── class-agromanager-deactivator.php  # Cleanup (adatok megmaradnak)
    ├── class-agromanager-parcels.php      # Földterület modul
    ├── class-agromanager-crops.php        # Kultúra modul
    ├── class-agromanager-machines.php     # Géppark modul
    ├── class-agromanager-weather.php      # Időjárás modul
    ├── class-agromanager-finances.php     # Pénzügyi modul
    └── class-agromanager-workers.php      # Dolgozó modul

🗄️ Adatbázis

A plugin 6 egyedi táblát hoz létre aktiváláskor:

Megjegyzés: A plugin deaktiválása nem törli az adatbázis táblákat, így az adatok megmaradnak.

🔒 Biztonság

• ✅ Nonce alapú CSRF védelem minden űrlapon
• ✅ $wpdb::prepare() – SQL injection elleni védelem
• ✅ sanitize_text_field(), sanitize_textarea_field(), sanitize_email() – input tisztítás
• ✅ esc_html(), esc_attr(), esc_url() – output escaping
• ✅ current_user_can() – jogosultság ellenőrzés (manage_options)

🛠️ Követelmények

Külső függőségek

• Chart.js v4.4 (CDN) – pénzügyi diagramok
• Open-Meteo API – időjárási adatok (ingyenes, regisztráció nélkül)
• Google Fonts – Inter – admin tipográfia

🤝 Közreműködés

1. Fork-old a repót
2. Hozz létre egy feature branch-et: git checkout -b feature/uj-funkcio
3. Commitolj: git commit -m 'Új funkció hozzáadása'
4. Push-old: git push origin feature/uj-funkcio
5. Nyiss egy Pull Request-et

📄 Licenc

Ez a projekt a GPL v2 or later licenc alatt áll.