docs: wymagania feature'u horoskop AI (LOG-29..32, PRE-14/15) #8

Merged

gitea merged 1 commits from docs/llm-prompt-requirements into master 2026-07-21 15:28:28 +00:00

Conversation 0 Commits 1 Files Changed 1

gitea commented 2026-07-21 14:47:16 +00:00

Owner

Copy Link

Copy Source

Feature

Generowanie promptow do ChatGPT/Claude z naszych wyliczen i wolanie modelu:

• ekran Interpretacje -> horoskop urodzeniowy
• ekran Kalendarz -> horoskop na wybrany okres

Na razie same wymagania do przegladu — bez kodu.

Warstwa logiczna

ID	Rzecz	Prio
LOG-29	Generator promptow: profile natal/okresowy, prompt i wynik PL, struktura (rola -> dane horoskopu -> wskazania z baz wg wagi -> instrukcje -> zastrzezenie). Kazda teza MUSI byc podparta konkretnym sygnifikatorem; zakaz konfabulacji poza dostarczonymi danymi. Deterministyczny.	Should
LOG-30	Ograniczanie rozmiaru: dedup -> grupowanie z licznikiem -> sortowanie wg punktacji sily (LOG-21) -> obciecie ogona -> skracanie opisow. Jednostka obciecia = cale wskazanie. Raportuje, ile pominieto i jaki byl prog.	Should
LOG-31	Pluggable LLMProvider (jak EphemerisEngine/LOG-24): OpenAI + Anthropic, wybor przez ENV. Klucz tylko z sekretu, timeout/retry/429, twardy limit tokenow i kosztu. POST /chart/horoscope zwraca horoskop + uzyty prompt + metryki. Prompt zwracany takze przy bledzie.	Should
LOG-32	Poufnosc — bramka prawna. Prompt niesie ORYGINALNE opisy z baz wspolpracownika (jego wlasnosc) i dane urodzeniowe (dane osobowe; bazy medyczne dotykaja zdrowia). Wymaga zgody wlasciciela baz, API zamiast czatu konsumenckiego, minimalizacji, podgladu przed wyslaniem, trybu bez pelnych opisow, zakazu logowania promptow.	Must

Warstwa prezentacji

• PRE-14 — przycisk generowania na obu ekranach, wybor budzetu (zwiezly/sredni/obszerny), rozwijany podglad promptu PRZED wyslaniem z licznikiem znakow/tokenow, kopiowanie promptu i wyniku. Prompt da sie skopiowac takze przy wylaczonej wysylce (praca reczna zawsze mozliwa).
• PRE-15 — transparentnosc: dostawca+model, ile wskazan pominieto (z podpowiedzia zwiekszenia budzetu), zastrzezenie ze to nie porada medyczna/finansowa, ostrzezenie przed pierwsza wysylka.

Pytania otwarte (do decyzji)

• Q-12 — zgoda wlasciciela baz na wysylke oryginalnych opisow. Blokuje LOG-31/32 w trybie pelnych opisow; do czasu zgody domyslnie tryb bez opisow.
• Q-13 — dostawca/model domyslny + twardy limit kosztow (i czy cache'owac wyniki).

Decyzje przyjete w tym PR (z czatu)

Integracja API od razu · pelne teksty z baz w promptcie · prompt i horoskop po polsku ·
budzet jako suwak w UI.

Uwaga, ktora chce podkreslic

Wybor pelnych opisow z baz oznacza, ze wlasnosc wspolpracownika wychodzi do zewnetrznego
dostawcy. Dlatego LOG-32 ma priorytet Must, a Q-12 jest blokujace. Istotna roznica:
API OpenAI/Anthropic domyslnie nie trenuje na przesylanych danych, konsumenckie
chatgpt.com/claude.ai dzialaja na innych warunkach — dlatego wymaganie wprost narzuca API.

Plik: docs/astrololo_wymagania.xlsx (zachowane formatowanie, zaktualizowane liczniki
w arkuszu Przeglad i zakresy autofiltrow).

## Feature Generowanie **promptow do ChatGPT/Claude z naszych wyliczen** i wolanie modelu: - ekran **Interpretacje** -> horoskop **urodzeniowy** - ekran **Kalendarz** -> horoskop **na wybrany okres** Na razie **same wymagania** do przegladu — bez kodu. ## Warstwa logiczna | ID | Rzecz | Prio | |---|---|---| | LOG-29 | Generator promptow: profile natal/okresowy, prompt i wynik PL, struktura (rola -> dane horoskopu -> wskazania z baz wg wagi -> instrukcje -> zastrzezenie). Kazda teza MUSI byc podparta konkretnym sygnifikatorem; zakaz konfabulacji poza dostarczonymi danymi. Deterministyczny. | Should | | LOG-30 | Ograniczanie rozmiaru: dedup -> grupowanie z licznikiem -> sortowanie wg punktacji sily (LOG-21) -> obciecie ogona -> skracanie opisow. Jednostka obciecia = cale wskazanie. Raportuje, ile pominieto i jaki byl prog. | Should | | LOG-31 | Pluggable `LLMProvider` (jak EphemerisEngine/LOG-24): OpenAI + Anthropic, wybor przez ENV. Klucz tylko z sekretu, timeout/retry/429, twardy limit tokenow i kosztu. `POST /chart/horoscope` zwraca horoskop + **uzyty prompt** + metryki. Prompt zwracany takze przy bledzie. | Should | | **LOG-32** | **Poufnosc — bramka prawna.** Prompt niesie ORYGINALNE opisy z baz wspolpracownika (jego wlasnosc) i dane urodzeniowe (dane osobowe; bazy medyczne dotykaja zdrowia). Wymaga zgody wlasciciela baz, API zamiast czatu konsumenckiego, minimalizacji, podgladu przed wyslaniem, trybu bez pelnych opisow, zakazu logowania promptow. | **Must** | ## Warstwa prezentacji - **PRE-14** — przycisk generowania na obu ekranach, wybor budzetu (zwiezly/sredni/obszerny), **rozwijany podglad promptu PRZED wyslaniem** z licznikiem znakow/tokenow, kopiowanie promptu i wyniku. Prompt da sie skopiowac takze przy wylaczonej wysylce (praca reczna zawsze mozliwa). - **PRE-15** — transparentnosc: dostawca+model, ile wskazan pominieto (z podpowiedzia zwiekszenia budzetu), zastrzezenie ze to nie porada medyczna/finansowa, ostrzezenie przed pierwsza wysylka. ## Pytania otwarte (do decyzji) - **Q-12** — zgoda wlasciciela baz na wysylke oryginalnych opisow. **Blokuje** LOG-31/32 w trybie pelnych opisow; do czasu zgody domyslnie tryb bez opisow. - **Q-13** — dostawca/model domyslny + twardy limit kosztow (i czy cache'owac wyniki). ## Decyzje przyjete w tym PR (z czatu) Integracja API od razu · pelne teksty z baz w promptcie · prompt i horoskop po polsku · budzet jako suwak w UI. ## Uwaga, ktora chce podkreslic Wybor *pelnych opisow z baz* oznacza, ze **wlasnosc wspolpracownika wychodzi do zewnetrznego dostawcy**. Dlatego LOG-32 ma priorytet **Must**, a Q-12 jest blokujace. Istotna roznica: **API** OpenAI/Anthropic domyslnie nie trenuje na przesylanych danych, konsumenckie chatgpt.com/claude.ai dzialaja na innych warunkach — dlatego wymaganie wprost narzuca API. Plik: `docs/astrololo_wymagania.xlsx` (zachowane formatowanie, zaktualizowane liczniki w arkuszu Przeglad i zakresy autofiltrow).

gitea added 1 commit 2026-07-21 14:47:16 +00:00

docs: wymagania feature'u horoskop AI (LOG-29..32, PRE-14/15, Q-12/13) ... 2892b71be3

Nowy feature: generowanie promptow do ChatGPT/Claude z naszych wyliczen i
wolanie modelu — horoskop urodzeniowy (ekran Interpretacje) oraz horoskop
na wybrany okres (ekran Kalendarz).

Warstwa logiczna:
- LOG-29 generator promptow (profile natal + okresowy), prompt i wynik PL,
  obowiazek odnoszenia kazdej tezy do konkretnego sygnifikatora
- LOG-30 ograniczanie rozmiaru: dedup -> grupowanie -> sortowanie wg wagi
  (LOG-21) -> obciecie ogona -> skracanie; raportuje ile pominieto
- LOG-31 pluggable LLMProvider (OpenAI/Anthropic) + POST /chart/horoscope;
  klucz tylko z sekretu, limity kosztu/tokenow, prompt zwracany zawsze
- LOG-32 (Must) poufnosc: prompt niesie WLASNOSC wspolpracownika i dane
  urodzeniowe -> zgoda wlasciciela baz, API zamiast czatu konsumenckiego,
  minimalizacja, podglad przed wyslaniem, tryb bez pelnych opisow

Warstwa prezentacji:
- PRE-14 przycisk generowania + budzet promptu + podglad promptu przed
  wyslaniem + kopiowanie (prompt dziala takze bez wysylki do API)
- PRE-15 transparentnosc: dostawca/model, ile wskazan pominieto,
  zastrzezenie ze to nie porada medyczna, ostrzezenie przed wysylka

Pytania otwarte: Q-12 (zgoda wlasciciela baz — blokuje tryb pelnych opisow),
Q-13 (dostawca/model i limit kosztow).

Zaktualizowane liczniki w arkuszu Przeglad i zakresy autofiltrow.
Decyzje wg ustalen w czacie: integracja API, pelne opisy z baz, PL, suwak.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

gitea merged commit 2892b71be3 into master 2026-07-21 15:28:28 +00:00

gitea deleted branch docs/llm-prompt-requirements 2026-07-21 15:28:29 +00:00

gitea referenced this pull request 2026-07-21 15:32:21 +00:00

feat(logic): generator promptow do LLM + budzetowanie (LOG-29, LOG-30) #9

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

gitea

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: gitea/astrololo#8