add for-me

This commit is contained in:
Norbert Maciaszek
2025-12-29 15:13:22 +01:00
parent eb6fdadca9
commit 56c90fb567
26 changed files with 1237 additions and 24 deletions

24
spec.md
View File

@@ -21,7 +21,7 @@ Aplikacja wspomaga planowanie i śledzenie prezentów na dowolne okazje (święt
- Budżet: TBD
- Deadline MVP: TBD
- Zespół: TBD
- Geograficznie: Polska (Ceneo integration)
- Geograficznie: Polska (Market integration)
---
@@ -107,7 +107,7 @@ Baza rzeczywistych przedmiotów, które mogą być prezentami.
- `ean` / `sku`
- `imageUrl`
- `tags` (kategorie: kuchnia, gaming, itp.)
- `ceneoUrl` (link do porównywarki)
- `productUrl` (link do produktu / porównywarki)
- `globalMinPrice`, `globalMaxPrice` (z historii śledzenia)
---
@@ -165,12 +165,12 @@ Obliczone **automatycznie** na podstawie prezentów i okazji.
## 3. Secondary Features Phase 2 (Post-MVP)
### Price Tracking via Ceneo
### Price Tracking & Market Analysis
**Architecture:**
- User dodaje `url` do prezentu (dowolny link, np. ceneo.pl/...)
- User dodaje `url` do prezentu (dowolny link)
- Backend: cron job (raz dziennie lub częściej) + manualne "refresh" przez UI
- Pobieranie aktualnej ceny z API Ceneo / scrapingiem (Apify)
- Pobieranie aktualnej ceny z API sklepów / scrapingiem (Apify)
- Zapis snapshotu ceny do tabeli `PriceSnapshot(giftId, price, timestamp, source)`
**Pola Gift (extended):**
@@ -235,7 +235,7 @@ AI generuje personalizowane życzenia na podstawie szerokiego kontekstu:
- Wersjonowanie: migrations
- **External Services:**
- Ceneo API / Apify scraper (Phase 2)
- Market APIs / Apify scraper (Phase 2)
- OpenAI API lub self-hosted LLM (Phase 2)
- Email service (e.g., SendGrid, Resend) dla alertów (Phase 2)
@@ -292,7 +292,7 @@ Product
├── imageUrl
├── tags (JSON)
├── ean
├── ceneo_url
├── product_url
├── created_at
Gift (Planning Instance)
@@ -379,7 +379,7 @@ IndividualOccasion (Zrezygnowano - używamy tabeli Occasion)
#### 4. Karta Produktu (Product Master)
- Globalna historia ceny (wykres 30 dni)
- Porównywarka Ceneo (oferty sklepów)
- Porównywarka cenowa (oferty sklepów)
- Lista planów, w których występuje ten produkt (re-use)
#### 5. Gift Planning (Instance View)
@@ -418,7 +418,7 @@ Widok okazji podzielony na zakładki:
**Timeline:** ~48 weeks (team-dependent)
- Price tracking via Ceneo + PriceSnapshot table
- Price tracking + PriceSnapshot table
- Price alerts & notifications (email/push)
- AI gift recommendations (LLM integration)
- **Wyszukiwarka AI (AI Search)**: Globalna wyszukiwarka prezentów oparta na LLM z analizą dopasowania (match-making).
@@ -437,11 +437,11 @@ Widok okazji podzielony na zakładki:
- [ ] Single-user MVP (no collaboration) OK?
- [ ] Auth method: email/password or OAuth? (assuming email/pwd for MVP)
- [ ] Database: PostgreSQL assumption confirm?
- [ ] Ceneo integration: API lub web scraping? (Apify fallback)
- [ ] Market integration: API lub web scraping? (Apify fallback)
- [ ] AI model: OpenAI API czy local/self-hosted? (cost/privacy trade-off)
- [ ] Monetization:
- **Tokens**: Monthly allowance + top-ups for AI actions.
- **Pakiet "Oszczędzanie"**: 14.99 PLN / msc. Odblokowuje historię cen (Ceneo) i alerty cenowe.
- **Pakiet "Oszczędzanie"**: 14.99 PLN / msc. Odblokowuje historię cen (od momentu dodania produktu, do 30 dni wstecz) i alerty cenowe.
- **Pakiet "Kontrola budżetu"**: 6.99 PLN / msc. Odblokowuje zaawansowane analizy budżetowe, wykresy wydatków i prognozy.
- [ ] Mobile-first design czy desktop-first? (assuming mobile-responsive on MVP)
@@ -467,7 +467,7 @@ Widok okazji podzielony na zakładki:
### Technical
- Czy self-hosted czy cloud (Vercel, Railway)?
- Rate limits dla Ceneo API czy backup plan?
- Rate limits dla API sklepów czy backup plan?
- Jak long-term archivizować stare okazje?
### Product