Inventar de Provizii de Urgență

✨ Funcții

Gestionarea Inventarului

• Operațiuni CRUD complete — adăugați, editați și ștergeți articole de inventar cu categorii, subcategorii, cantități, unități, rate de consum zilnic și date de expirare
• Zile rămase calculate automat — sistemul calculează câte zile durează fiecare articol pe baza stocului curent și a consumului zilnic per membru al gospodăriei
• Indicatori de status — articolele sunt automat marcate ca Critic (sub stoc minim), Avertisment (sub țintă) sau Suficient
• Filtrare pe categorii — faceți clic pe o pilulă de categorie pentru a filtra instantaneu tabelul; pilulele sunt codate pe culori după statusul agregat
• Tabel sortabil — faceți clic pe un antet de coloană pentru sortare ascendentă/descendentă
• Căutare — căutare în timp real pe nume de articole, categorii și subcategorii
• Export backup — export JSON cu un clic al întregului inventar pentru păstrare offline

Autentificare Admin

• Model cu un singur admin — un cont de admin este creat la prima configurare; nu sunt necesare conturi multiple
• Hashing BCrypt pentru parole (factor de cost 12) — parolele nu sunt niciodată stocate în text clar
• Autentificare prin sesiuni PHP — sesiunile sunt stocate într-un director sessions/ protejat, nu în folderul temporar al sistemului
• Mod vizitator — vizitatorii neautentificați pot doar citi
• Schimbare parolă — adminul poate schimba parola oricând din Setări
• Protecție .htaccess — accesul URL direct la fișierele de date JSON și sesiuni este blocat

Rețete de Supraviețuire

• 16 rețete optimizate pentru supraviețuire — concepute special pentru ingredientele urmărite în inventar
• Niveluri de prioritate — Folosiți Întâi (perisabil), Folosiți Curând sau Oricând
• Indicatori de cost combustibil — Zero (fără gătit), Scăzut (<10 min) sau Mediu (10-20 min)
• Rețete doar pentru urgențe — clar marcate pentru situații critice
• Rețete de confort/normalitate — mese care ridică moralul în situații de urgență prelungite
• Versiuni pentru copii — instrucțiuni adaptate pentru copii mici (de la 5 ani)
• Sfaturi de supraviețuire — tehnici de economisire a apei, strategii de substituire a ingredientelor și scurtături de gătit
• Gata de printare — stylesheet de printare optimizat pentru copii fizice sau "Salvare ca PDF"

📁 Structura Fișierelor

Cerințe

• Server web — Apache (cu suport .htaccess) sau Nginx
• PHP 8.x — cu extensiile json și posix (posix este opțional dar oferă diagnostic mai bun)
• Permisiuni de scriere — utilizatorul serverului web (de obicei www-data) trebuie să poată scrie în data/ și sessions/
• Fără bază de date — toate datele sunt stocate în fișiere JSON
• Fără npm/build — HTML, CSS și JavaScript pur; fără compilare sau bundling necesar

🛠 Instalare

Alegeți metoda de instalare care corespunde sistemului de operare și configurării dumneavoastră.

sudo cp -r ./emergency-prep-inventory /var/www/html/tools/emergency-prep-inventory

sudo bash setup-permissions.sh /var/www/html/tools/emergency-prep-inventory

mkdir -p /var/www/html/tools/emergency-prep-inventory/data
mkdir -p /var/www/html/tools/emergency-prep-inventory/sessions
sudo chown -R www-data:www-data /var/www/html/tools/emergency-prep-inventory
find /var/www/html/tools/emergency-prep-inventory -type d -exec chmod 755 {} \;
chmod 750 /var/www/html/tools/emergency-prep-inventory/data
chmod 700 /var/www/html/tools/emergency-prep-inventory/sessions
chmod 640 /var/www/html/tools/emergency-prep-inventory/*.php
chmod 644 /var/www/html/tools/emergency-prep-inventory/*.html
chmod 644 /var/www/html/tools/emergency-prep-inventory/*.css
chmod 660 /var/www/html/tools/emergency-prep-inventory/data/*.json

location /data/ {
    deny all;
}
location /sessions/ {
    deny all;
}

cp -r ./emergency-prep-inventory /Applications/XAMPP/xamppfiles/htdocs/emergency-prep-inventory

mkdir -p /Applications/XAMPP/xamppfiles/htdocs/emergency-prep-inventory/data
mkdir -p /Applications/XAMPP/xamppfiles/htdocs/emergency-prep-inventory/sessions
sudo chown -R daemon:daemon /Applications/XAMPP/.../data
sudo chown -R daemon:daemon /Applications/XAMPP/.../sessions

cp -r ./emergency-prep-inventory /Applications/MAMP/htdocs/emergency-prep-inventory

mkdir -p /Applications/MAMP/htdocs/emergency-prep-inventory/data
mkdir -p /Applications/MAMP/htdocs/emergency-prep-inventory/sessions
chmod 777 /Applications/MAMP/htdocs/emergency-prep-inventory/data
chmod 777 /Applications/MAMP/htdocs/emergency-prep-inventory/sessions

🔌 Referință API

API-ul de backend (api.php) folosește un model simplu de rutare bazată pe acțiuni. Toate cererile returnează răspunsuri JSON.

Endpoint-uri Publice (Fără Autentificare)

Endpoint-uri Protejate (Autentificare Admin Necesară)

Exemple Cerere/Răspuns

Autentificare:

{ "action": "login", "username": "admin", "password": "your-password" }

Salvare inventar:

{ "action": "save_inventory", "data": [{ "itemName": "Rice", "category": "Grains", "currentQuantity": 5, "unit": "kg", "dailyConsumption": 0.1 }] }

📖 Ghid de Utilizare

Prima Configurare

1. Creați contul de admin — alegeți un nume de utilizator (minim 2 caractere) și o parolă (minim 6 caractere)
2. Configurați gospodăria — setați numărul de bărbați adulți, femei adulte, copii și zilele țintă de pregătire

După configurare, veți fi automat autentificat ca admin.

Gestionarea Articolelor de Inventar

• Adăugați un articol nou — faceți clic pe butonul "Articol Nou" (doar admin)
• Editați un articol — faceți clic pe pictograma creion din coloana Acțiuni (doar admin)
• Ștergeți un articol — faceți clic pe pictograma coș de gunoi (doar admin)
• Adăugați categorii/unități noi — fiecare dropdown are un buton "+"
• Exportați backup — faceți clic pe "Export Backup" pentru a descărca inventarul ca fișier JSON

Vizualizare ca Invitat

Vizitatorii care nu se autentifică pot răsfoi inventarul în mod doar-citire. Pot:

• Vizualiza toate articolele de inventar și statusurile lor
• Filtra după categorie și căuta
• Schimba limbile
• Accesa pagina de rețete

Nu pot adăuga, edita sau șterge articole.

Rețete de Supraviețuire

Faceți clic pe butonul "Rețete" pentru a deschide pagina de rețete de supraviețuire. Fiecare rețetă include:

• Insignă de prioritate — când să folosiți această rețetă pe baza perisabilității ingredientelor
• Insignă de cost combustibil — cât combustibil de gătit este necesar
• Cost apă — consum estimat de apă pentru rețetă
• Lista de ingrediente — cu cantități potrivite inventarului dumneavoastră
• Instrucțiuni pas cu pas — pași de gătit numerotați
• Versiune pentru copii — instrucțiuni adaptate pentru hrănirea copiilor mici
• Sfat de supraviețuire — sfaturi practice pentru conservarea resurselor

Folosiți butonul "Printare / Salvare ca PDF" pentru a crea o copie fizică de rezervă a tuturor rețetelor.

🔧 Depanare

Erori de Permisiuni

Dacă vedeți erori despre accesul de scriere la fișiere:

1. Rulați endpoint-ul de verificare a permisiunilor: api.php?action=check_permissions
2. Acesta va afișa utilizatorul PHP, proprietarul fișierului și detaliile permisiunilor
3. Rulați din nou scriptul de configurare: sudo bash setup-permissions.sh /calea/proiectului
4. Dacă problema persistă, verificați manual proprietarul — fișierele ar trebui să fie deținute de www-data:www-data cu permisiuni 660 pentru fișierele JSON

Probleme de Sesiune

Dacă autentificarea nu persistă:

• Asigurați-vă că directorul sessions/ există și este inscriptibil de www-data
• Verificați că directorul are permisiuni 700 și este deținut de www-data
• Verificați că browserul acceptă cookie-uri de la domeniu

API Returnează 500 la Configurare

Aceasta înseamnă de obicei că directorul data/ sau fișierele JSON nu sunt inscriptibile. Răspunsul API va include informații de diagnostic:

• php_user — utilizatorul sub care rulează PHP
• file_perms — permisiunile curente ale fișierului
• file_owner — proprietarul curent al fișierului
• fix — comanda exactă de rulat pentru a rezolva problema

🛡 Considerații de Securitate

• Fișierele de date JSON sunt protejate de acces HTTP direct prin reguli .htaccess (Apache) sau blocuri de locație Nginx
• Credențialele de admin sunt stocate cu hashing BCrypt (cost 12) — parolele nu sunt niciodată stocate în text clar
• Fișierele de sesiune sunt stocate într-un director dedicat cu permisiuni restrictive (700), nu în directorul /tmp al sistemului
• Fișierele PHP au permisiuni 640 — citibile doar de utilizatorul și grupul serverului web, nu de toți
• Fără token-uri CSRF — această aplicație este concepută pentru utilizare de un singur admin într-o rețea de încredere. Dacă o expuneți la internetul public, luați în considerare adăugarea protecției CSRF
• Fără limitare de rată — protecția brute-force nu este implementată. Folosiți fail2ban sau instrumente similare dacă este expus public

⚙️ Stack Tehnologic

Suport Browser

• Chrome / Edge (ultimele 2 versiuni)
• Firefox (ultimele 2 versiuni)
• Safari (ultimele 2 versiuni)
• Browsere mobile (Chrome pentru Android, Safari pentru iOS)

📄 Licență

Acest proiect este furnizat ca atare pentru pregătirea de urgență personală a gospodăriei. Contact: marundaliliana@gmail.com pentru implementări personalizate sau întrebări.