---
phase: 06-task-title-ai
plan: 01
type: execute
wave: 1
depends_on: []
files_modified:
- config.php
- autoload/Domain/Tasks/TaskTitleGenerator.php
- autoload/controls/class.Tasks.php
- templates/tasks/task_popup.php
autonomous: false
delegation: off
---
## Goal
Dodac w popupie edycji zadania przycisk generowania propozycji tytulu zadania przez OpenAI na podstawie tresci zadania.
## Purpose
Uzytkownik `biuro@project-pro.pl` ma szybciej nadawac czytelne tytuly zadaniom bez recznego streszczania opisu.
## Output
- Przycisk AI obok istniejacego przycisku edycji tytulu w `task_popup`.
- Osobny endpoint AJAX zwracajacy wygenerowana propozycje tytulu.
- Serwis domenowy do komunikacji z OpenAI, uzywajacy taniego i szybkiego modelu `gpt-5-nano`.
- Konfiguracja modelu tytulow niezalezna od importu maili.
- **[Widocznosc]** - Czy `biuro@project-pro.pl` oznacza zalogowanego uzytkownika czy zadania przypisane do tego uzytkownika?
-> Odpowiedz: tylko zalogowany uzytkownik z tym emailem widzi przycisk.
- **[Zapis]** - Czy AI ma od razu nadpisac tytul w bazie czy tylko wstawic propozycje do pola?
-> Odpowiedz: opcja A, wstawic propozycje do pola tytulu i zapisac dopiero istniejacym przyciskiem.
- **[Model]** - Czy uzyc `gpt-5-nano` jako tani/szybki model?
-> Odpowiedz: tak.
## Project Context
@.paul/PROJECT.md
@.paul/ROADMAP.md
@.paul/STATE.md
## Source Files
@config.php
@autoload/Domain/Tasks/MailToTaskImporter.php
@autoload/controls/class.Tasks.php
@templates/tasks/task_popup.php
@templates/tasks/main_view.php
## External References
- OpenAI model docs: https://developers.openai.com/api/docs/models/gpt-5-nano
- `gpt-5-nano` supports `v1/chat/completions` and is documented as the fastest/cheapest GPT-5 option for summarization/classification-style work.
## AC-1: Przycisk widoczny tylko dla biuro
```gherkin
Given zalogowany uzytkownik ma email biuro@project-pro.pl
When otwiera popup zadania
Then obok przycisku edycji tytulu widzi przycisk generowania tytulu AI
```
## AC-2: Brak przycisku dla innych uzytkownikow
```gherkin
Given zalogowany uzytkownik ma inny email niz biuro@project-pro.pl
When otwiera popup zadania
Then przycisk generowania tytulu AI nie jest renderowany
And endpoint generowania odrzuca zadanie bez wywolania OpenAI
```
## AC-3: AI generuje propozycje bez zapisu do bazy
```gherkin
Given uzytkownik biuro@project-pro.pl otwiera popup zadania z trescia
When klika przycisk generowania tytulu AI
Then system pobiera tresc zadania i zwraca krotka propozycje tytulu
And propozycja trafia do pola edycji tytulu
And tytul w bazie nie zmienia sie przed kliknieciem istniejacego przycisku zapisu
```
## AC-4: Obsluga bledow OpenAI jest czytelna
```gherkin
Given brakuje klucza API OpenAI albo OpenAI zwroci blad
When uzytkownik klika generowanie tytulu
Then popup pokazuje czytelny komunikat bledu
And aktualny tytul zadania nie zostaje zmieniony
```
Task 1: Dodac serwis generowania tytulu przez OpenAI
config.php, autoload/Domain/Tasks/TaskTitleGenerator.php
Dodac konfiguracje `openai_task_title_model` z domyslna wartoscia `gpt-5-nano`.
Utworzyc klase domenowa `Domain\Tasks\TaskTitleGenerator`, ktora:
- przyjmuje klucz API i model z konfiguracji,
- usuwa HTML z tresci zadania przed wyslaniem,
- wysyla krotki prompt do `https://api.openai.com/v1/chat/completions`,
- wymusza pojedynczy, krotki tytul bez JSON i bez dodatkowego komentarza,
- ogranicza dlugosc wejscia i wyjscia,
- zwraca tablice sukces/blad bez rzucania nieobslugiwanych wyjatkow.
Reuzyc wzorce z `MailToTaskImporter`, ale nie uzalezniac nowej funkcji od importera maili.
Dla modeli `gpt-5*` uzyc parametru `max_completion_tokens`; dla pozostalych zostawic kompatybilny fallback.
C:\xampp\php\php.exe -l autoload/Domain/Tasks/TaskTitleGenerator.php
AC-3 i AC-4 maja pokrycie po stronie integracji OpenAI
Task 2: Dodac endpoint AJAX dla propozycji tytulu
autoload/controls/class.Tasks.php
Dodac metode kontrolera np. `task_generate_title`, ktora:
- wymaga zalogowanego uzytkownika,
- sprawdza `strtolower($user['email']) === 'biuro@project-pro.pl'`,
- pobiera `task_id` jako int i odczytuje zadanie przez `factory\Tasks::task_details`,
- odrzuca brak zadania lub pusta tresc komunikatem JSON,
- wywoluje `TaskTitleGenerator`,
- zwraca JSON `{status: "success", title: "..."}` albo `{status: "error", msg: "..."}`.
Endpoint nie moze zapisywac `tasks.name`; zapis pozostaje w istniejacym `/tasks/task_change_title/`.
Uzyc medoo/prepared statements przez istniejace metody lub medoo API, bez skladania SQL.
C:\xampp\php\php.exe -l autoload/controls/class.Tasks.php
AC-2, AC-3 i AC-4 spelnione po stronie backendu
Task 3: Dodac przycisk i obsluge UI w popupie zadania
templates/tasks/task_popup.php
Rozszerzyc widok tytulu w popupie:
- wyrenderowac przycisk AI tylko gdy `$this->user['email']` to `biuro@project-pro.pl`,
- ustawic przycisk obok istniejacego przycisku edycji tytulu,
- po kliknieciu pokazac stan ladowania i wywolac `/tasks/task_generate_title/`,
- po sukcesie otworzyc inline edycje tytulu i wpisac propozycje do `.task-title-input`,
- nie klikac automatycznie `.task-title-save`,
- po bledzie pokazac komunikat i zostawic aktualny tytul bez zmian.
Zachowac istniejacy mechanizm recznej edycji i zapisu tytulu.
Escapowac dane w widoku; nie wprowadzac logiki OpenAI do widoku.
C:\xampp\php\php.exe -l templates/tasks/task_popup.php
AC-1, AC-2 i AC-3 spelnione w UI
Przycisk AI w popupie zadania oraz generowanie propozycji tytulu do pola edycji.
1. Zaloguj sie jako `biuro@project-pro.pl`.
2. Otworz liste zadan i popup zadania z niepusta trescia.
3. Kliknij przycisk AI obok edycji tytulu.
4. Potwierdz, ze pole edycji tytulu wypelnia sie propozycja, ale tytul zapisuje sie dopiero po kliknieciu istniejacego przycisku zapisu.
5. Sprawdz u innego uzytkownika, ze przycisk nie jest widoczny.
Napisz "approved", jesli dziala, albo opisz blad do poprawy.
## DO NOT CHANGE
- Nie zmieniac istniejacego endpointu `/tasks/task_change_title/` poza ewentualna minimalna walidacja, jesli bedzie konieczna.
- Nie zmieniac importu maili w `MailToTaskImporter`.
- Nie dodawac nowych bibliotek ani zaleznosci Composer.
- Nie zmieniac schematu bazy danych.
## SCOPE LIMITS
- Funkcja dotyczy tylko popupu zadania, nie pelnego formularza `task_edit`.
- AI generuje tylko propozycje tytulu; nie generuje ani nie zmienia tresci zadania.
- Przycisk jest dostepny tylko dla zalogowanego `biuro@project-pro.pl`.
- Brak automatycznego zapisu tytulu po generowaniu.
Before declaring plan complete:
- [ ] `C:\xampp\php\php.exe -l config.php`
- [ ] `C:\xampp\php\php.exe -l autoload/Domain/Tasks/TaskTitleGenerator.php`
- [ ] `C:\xampp\php\php.exe -l autoload/controls/class.Tasks.php`
- [ ] `C:\xampp\php\php.exe -l templates/tasks/task_popup.php`
- [ ] Reczna proba jako `biuro@project-pro.pl`: przycisk widoczny i generuje propozycje do pola.
- [ ] Reczna proba jako inny uzytkownik: przycisk niewidoczny, endpoint odrzuca dostep.
- [ ] Reczna proba potwierdza, ze baza zmienia tytul dopiero po istniejacym zapisie.
- [ ] Wszystkie AC spelnione.
- `biuro@project-pro.pl` moze wygenerowac krotki tytul z tresci zadania w popupie.
- Wygenerowany tytul jest tylko propozycja w polu edycji, bez automatycznego zapisu.
- Inni uzytkownicy nie widza przycisku i nie moga uzyc endpointu.
- Bledy OpenAI nie psuja popupu i nie zmieniaja danych.