📄 Source: README.md
===========================================
InboxZero AI v3.0 - Documentație tehnică
===========================================
Autor: Mugur Alexandru-Florian
Liceul Teoretic "Emil Racoviță", Baia Mare
Data: 20 Mai 2026
===========================================
1. DESCRIEREA PROIECTULUI
===========================================
InboxZero AI este un asistent inteligent pentru gestionarea emailurilor,
care folosește inteligența artificială locală (Ollama + TinyLlama) pentru
a răspunde la întrebări în limbaj natural despre emailuri.
Problema rezolvată: Oamenii primesc zeci de emailuri pe zi și pierd timp
căutând mesaje importante. InboxZero AI permite utilizatorilor să întrebe:
"Am emailuri de la Steam?", "Care este ultimul email?" sau "Listează-mi
toate emailurile de la Microsoft".
===========================================
2. TEHNOLOGII FOLOSITE
===========================================
- Backend: PHP 8.3
- Frontend: HTML5, CSS3, JavaScript (vanilla)
- Baza de date: SQLite3 (stocare conversații și emailuri)
- AI: Ollama + TinyLlama (1.1 GB, rulează local pe CPU)
- Autentificare: Google OAuth 2.0
- API: Google Gmail API
===========================================
3. ARHITECTURA APLICAȚIEI
===========================================
- index.php - Interfața principală
- chat_handler.php - Procesare mesaje și integrare AI
- oauth2callback.php - Autentificare Google
- fetch_emails.php - Obținere emailuri (din cache local sau Gmail)
- get_email.php - Vizualizare conținut email
- database.php - Stocare conversații și emailuri (SQLite)
- sync_emails.php - Sincronizare emailuri în baza de date locală
- cleanup.php - Ștergere automată emailuri vechi (>90 zile)
- mark_read.php - Marcare emailuri ca citite
===========================================
4. COMPONENTE EXTERNE (NEREALIZATE DE AUTOR)
===========================================
Următoarele resurse nu au fost create de autor:
Biblioteci PHP (instalate prin Composer):
- google/apiclient (2.19.2) - Integrare API Gmail
- masterminds/html5 (2.9.0) - Parsare HTML pentru emailuri
Modele AI:
- TinyLlama (1.1B) - Model open-source de la Hugging Face
- Ollama - Platformă pentru rulare modele locale
Altele:
- Fonturi: OpenAI Sans (CDN)
- Icoane: Emoji standard
===========================================
5. INSTALARE ȘI CONFIGURARE
===========================================
Cerințe sistem:
- PHP 8.3+
- SQLite3
- Ollama (https://ollama.com)
Pași instalare:
1. git clone https://github.com/ezyalex700/InboxZeroAI
2. cd InboxZeroAI/v3
3. composer install
4. ollama pull tinyllama
5. ollama serve
6. Configurare OAuth în Google Cloud Console
7. php sync_emails.php
===========================================
6. FUNCȚIONALITĂȚI
===========================================
✓ Autentificare Google OAuth 2.0
✓ Listare emailuri (cele mai noi primele)
✓ Căutare emailuri după expeditor
✓ Vizualizare conținut email
✓ Chat AI în limbaj natural (engleză/română)
✓ Reminder cu notificări browser
✓ Dark/Light theme
✓ Conversații multiple
✓ Stocare locală emailuri (cache)
✓ Marcare emailuri citite/necitite
✓ Curățare automată emailuri vechi
===========================================
7. COMANDE SUPORTATE
===========================================
- "list emails" - afișează ultimele 10 emailuri
- "list all emails" - afișează toate emailurile
- "emails from [expeditor]" - caută emailuri
- "latest email" - arată cel mai recent email
- "how many emails" - numără emailurile
- "help" - afișează comenzile disponibile
===========================================
8. LIMITĂRI ȘI ÎMBUNĂTĂȚIRI VIITOARE
===========================================
Limitări curente:
- Suportă doar un singur utilizator pe sesiune
- Răspunsurile AI durează 2-10 secunde pe CPU
Îmbunătățiri planificate:
- Răspuns la emailuri direct din aplicație
- Integrare Google Calendar
- Aplicație mobilă nativă
===========================================
9. DECLARAȚIE DE ORIGINALITATE
===========================================
Prin prezenta declar că această lucrare a fost realizată
integral de mine, Mugur Alexandru-Florian, și nu conține
elemente plagiate. Sursele externe utilizate sunt listate
la secțiunea 4.
Data: 20 Mai 2026
===========================================
← Back