From 0a3f2f451bab2cec043ef948c6cf1dfff5857171 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rados=C5=82aw=20Gierwia=C5=82o?= Date: Sun, 24 Aug 2025 15:49:50 +0200 Subject: [PATCH] Initial version --- .../internal/public/business_analysis.md | 587 ++++++++++++++++++ .../public/business_analysis_summary.md | 157 +++++ .../src/context_restoration_instructions.md | 57 ++ .../internal/src/conversation_history.md | 312 ++++++++++ documentation/internal/src/questionnaire.md | 190 ++++++ 5 files changed, 1303 insertions(+) create mode 100644 documentation/internal/public/business_analysis.md create mode 100644 documentation/internal/public/business_analysis_summary.md create mode 100644 documentation/internal/src/context_restoration_instructions.md create mode 100644 documentation/internal/src/conversation_history.md create mode 100644 documentation/internal/src/questionnaire.md diff --git a/documentation/internal/public/business_analysis.md b/documentation/internal/public/business_analysis.md new file mode 100644 index 0000000..e5c4737 --- /dev/null +++ b/documentation/internal/public/business_analysis.md @@ -0,0 +1,587 @@ +# Analiza Biznesowa - System AdRoute + +## Informacje o dokumencie +- **Projekt:** AdRoute - Platforma wynajmu miejsc reklamowych +- **Data utworzenia:** 2025-08-19 +- **Wersja:** 1.0 +- **Status:** W trakcie opracowania +- **Autor:** Analityk Biznesowy +- **Zleceniodawca:** CTO + +--- + +## 1. Streszczenie wykonawcze + +### 1.1 Wizja produktu +AdRoute to innowacyjna platforma internetowa umożliwiająca właścicielom miejsc reklamowych oferowanie swoich powierzchni reklamowych, oraz reklamodawcom wyszukiwanie i wynajmowanie billboardów, bannerów i innych form reklamy zewnętrznej wzdłuż konkretnych ulic, dróg krajowych i tras komunikacyjnych. + +### 1.2 Cel biznesowy +Stworzenie centralnej platformy internetowej łączącej właścicieli miejsc reklamowych z reklamodawcami, umożliwiającej efektywne wyszukiwanie, rezerwację i zarządzanie powierzchniami reklamowymi wzdłuż ulic, dróg krajowych i tras komunikacyjnych w Polsce. + +### 1.3 Kluczowe korzyści +- Centralizacja rynku reklamy zewnętrznej +- Ułatwienie procesu wyszukiwania miejsc reklamowych +- Automatyzacja procesu wynajmu i płatności +- Geolokalizacja i mapowanie miejsc reklamowych + +--- + +## 2. Analiza interesariuszy + +### 2.1 Właściciele miejsc reklamowych +**Profil użytkownika:** Zróżnicowana grupa obejmująca: +- Firmy outdoor i agencje reklamowe +- Właściciele nieruchomości (prywatni i komercyjni) +- Jednostki samorządowe (gminy, miasta) +- Osoby prywatne posiadające powierzchnie reklamowe + +**Wymagania weryfikacyjne:** +- Brak wymogu posiadania licencji reklamowej +- Obowiązkowa weryfikacja każdego oferowanego miejsca reklamowego +- System uploadowania dokumentów weryfikacyjnych przez platformę +- Proces akceptacji/odrzucenia przez moderatorów systemu + +**Potrzeby i cele:** +- Monetyzacja posiadanych miejsc reklamowych +- Łatwe zarządzanie ofertami i dostępnością +- Możliwość delegacji obsługi do agencji reklamowych +- Transparentny system rozliczeń + +**Pain points:** +- Trudność w dotarciu do potencjalnych reklamodawców +- Brak centralnego systemu zarządzania ofertami +- Konieczność osobistego zarządzania każdą rezerwacją + +### 2.2 Reklamodawcy +**Profil użytkownika:** Zróżnicowana grupa obejmująca: +- Agencje reklamowe i marketingowe +- Firmy (małe, średnie, duże przedsiębiorstwa) +- Osoby prywatne (np. lokalni przedsiębiorcy, osoby promocyjne) + +**Wymagania rejestracyjne:** +- Obowiązkowa rejestracja w systemie +- Konieczność określenia typu konta: + - **Konto firmowe:** dla firm i agencji (wymagane dane firmy, NIP, REGON) + - **Konto prywatne:** dla osób fizycznych (dane osobowe, opcjonalnie działalność gospodarcza) +- Weryfikacja tożsamości na etapie rejestracji + +**Ograniczenia i limity:** +- Obecnie brak określonych limitów dla różnych typów reklamodawców +- Możliwość wprowadzenia w przyszłości (np. limity wydatków, liczby aktywnych kampanii) + +**Potrzeby i cele:** +- Łatwe wyszukiwanie miejsc reklamowych w określonych lokalizacjach +- Porównywanie cen i dostępności +- Szybki proces rezerwacji i płatności +- Różne sposoby płatności w zależności od typu konta + +**Pain points:** +- Trudność w znalezieniu dostępnych miejsc reklamowych +- Brak transparentności cenowej +- Skomplikowane procesy negocjacji i rezerwacji + +### 2.3 Agencje reklamowe +**Profil użytkownika:** Profesjonalne agencje działające w imieniu właścicieli miejsc reklamowych na podstawie delegacji uprawnień. + +**Potrzeby i cele:** +- Zarządzanie wieloma kontami właścicieli jednocześnie +- Profesjonalne narzędzia do optymalizacji ofert +- System raportowania dla klientów (właścicieli) + +**Funkcjonalności:** +- Dostęp do kont właścicieli na podstawie udzielonych uprawnień +- Zarządzanie ofertami w imieniu właścicieli +- Własny panel z przeglądem wszystkich zarządzanych kont + +### 2.4 Administrator systemu +**Rola:** Zarządzanie platformą, moderacja treści, wsparcie techniczne. + +**Odpowiedzialności:** +- Moderacja i weryfikacja ofert +- Zarządzanie użytkownikami i uprawnieniami +- Monitoring systemu i rozwiązywanie problemów technicznych + +### 2.5 Moderatorzy/weryfikatorzy ofert +**Rola:** Specjaliści odpowiedzialni za weryfikację prawdziwości i zgodności ofert z regulaminem. + +**Odpowiedzialności:** +- Weryfikacja dokumentów i zdjęć miejsc reklamowych +- Sprawdzanie zgodności z lokalnymi przepisami +- Zatwierdzanie lub odrzucanie ofert + +--- + +## 3. Wymagania funkcjonalne + +### 3.1 System wyszukiwania i mapowanie + +#### 3.1.1 Wyszukiwanie lokalizacji +**Funkcjonalność:** System umożliwia wyszukiwanie miejsc reklamowych na podstawie lokalizacji geograficznej z wykorzystaniem 5 głównych metod wyszukiwania. + +**Metody wyszukiwania:** +1. **Wpisywanie adresu/nazwy ulicy** + - Pole tekstowe z autouzupełnianiem + - Obsługa adresów częściowych + - Integracja z bazą adresową + +2. **Wskazywanie na mapie** + - Interaktywna mapa z możliwością kliknięcia + - Przeciągnij i upuść marker + - Zoom i nawigacja po mapie + +3. **Wyszukiwanie po kodzie pocztowym** + - Pole dedykowane dla kodu pocztowego + - Walidacja formatu kodu + - Pokrycie całej Polski + +4. **Wyszukiwanie tras (punkt A do punktu B)** + - Możliwość określenia trasy przejazdu + - Wyszukiwanie miejsc reklamowych wzdłuż całej trasy + - Optymalizacja dla różnych rodzajów tras (miejskie, krajowe, autostradowe) + +5. **Wyszukiwanie w promieniu X km od punktu** + - Regulowany promień wyszukiwania za pomocą suwaka (1-50 km) + - Domyślny zasięg: 5 km + - Wizualizacja obszaru na mapie w czasie rzeczywistym + - Filtrowanie wyników według odległości + +**Zasięg i precyzja:** +- **Domyślny zasięg wyszukiwania:** 5 km od wybranego punktu +- **Regulacja zasięgu:** Suwak umożliwiający ustawienie zasięgu od 1 km do 50 km +- **Lokalizacja GPS:** Wszystkie miejsca reklamowe muszą być zlokalizowane według precyzyjnych współrzędnych GPS +- **Precyzja:** Dokładność lokalizacji na poziomie metrów + +**Kryteria akceptacji:** +- Wszystkie 5 metod wyszukiwania działają poprawnie +- Szybkość odpowiedzi systemu poniżej 3 sekund +- Intuicyjny interfejs użytkownika dla każdej metody +- Suwak zasięgu działa płynnie z podglądem na żywo +- Obowiązkowe współrzędne GPS dla wszystkich miejsc reklamowych + +#### 3.1.2 Filtry wyszukiwania +**Funkcjonalność:** System zaawansowanych filtrów umożliwiający precyzyjne wyszukiwanie miejsc reklamowych według kluczowych kryteriów. + +**Dostępne filtry:** + +1. **Typ miejsca reklamowego** + - Billboard (duże powierzchnie przydrożne) + - Citylight (oświetlane powierzchnie miejskie) + - LED (wyświetlacze elektroniczne) + - Plakat (małe powierzchnie reklamowe) + - **Opcja dodania nowego typu** - rozszerzalny system kategorii + - Wielokrotny wybór typów + +2. **Rozmiar/format** + - Standardowe wymiary (np. 6x3m, 12x5m, A1, A0) + - Możliwość wyszukiwania według niestandardowych wymiarów + - Filtr min/max szerokość i wysokość + +3. **Zakres cenowy** + - Suwak zakresu cenowego (min - max) + - Wybór okresu cenowego (za dzień/tydzień/miesiąc) + - Filtrowanie według budżetu kampanii + +4. **Okres dostępności** + - Kalendarz "od - do" + - Wyszukiwanie miejsc dostępnych w konkretnych terminach + - Opcja "dostępne teraz" i "dostępne w przyszłości" + +5. **Podświetlenie** + - Podświetlane (LED, neon, reflektory) + - Niepoświetlane (standardowe, naturalne oświetlenie) + - Filtr typu oświetlenia + +#### 3.1.3 Integracja z mapami +**Funkcjonalność:** Kompleksowa integracja z Google Maps zapewniająca pełen pakiet funkcji mapowych dla platformy AdRoute. + +**Dostawca map:** Google Maps API + +**Funkcje mapowe:** +1. **Zdjęcia satelitarne** + - Widok satelitarny wysokiej rozdzielczości + - Możliwość przełączania między widokiem mapy i satelitarnym + - Aktualne zdjęcia terenu dla lepszej oceny lokalizacji + +2. **Google Street View** + - Integracja z Street View dla podglądu miejsc reklamowych + - Możliwość "spaceru" wokół lokalizacji + - Weryfikacja rzeczywistego wyglądu miejsca przez reklamodawców + +3. **Informacje o natężeniu ruchu** + - Dane o ruchu w czasie rzeczywistym + - Historyczne dane natężenia ruchu + - Analiza popularności lokalizacji w różnych porach + +4. **Pomiar odległości** + - Narzędzie do mierzenia odległości między punktami + - Kalkulacja tras i czasów przejazdu + - Pomoc w planowaniu kampanii reklamowych + +**Wymagania techniczne:** +- Google Maps JavaScript API +- Places API dla wyszukiwania lokalizacji +- Directions API dla tras i odległości +- Street View Static API dla podglądów +- Traffic Layer API dla danych o ruchu + +### 3.2 Zarządzanie ofertami + +#### 3.2.1 Dodawanie miejsc reklamowych +**Funkcjonalność:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +**Wymagane informacje:** +- **Dokładna lokalizacja:** Obowiązkowy adres + precyzyjne współrzędne GPS +- **@TODO** Zdjęcia miejsca: Wymaga ustalenia liczby zdjęć (min/max), formatów, rozdzielczości +- **@TODO** Wymiary: Wymaga ustalenia standardów wymiarów, tolerancji, jednostek miary +- **@TODO** Cena: Wymaga ustalenia modelu cenowego (za dzień/tydzień/miesiąc), waluta, promocje +- **@TODO** Opis: Wymaga ustalenia długości opisu, wymaganych informacji, moderacji treści +- **@TODO** Kalendarz dostępności: Wymaga ustalenia mechanizmu blokowania dat, aktualizacji dostępności + +#### 3.2.2 Weryfikacja ofert +**Proces weryfikacji:** System dwuetapowej weryfikacji miejsca reklamowego przed publikacją oferty na platformie. + +**Etapy weryfikacji:** +1. **Upload dokumentów przez właściciela:** + - System umożliwia przesłanie dokumentów bezpośrednio przez platformę + - Obsługa różnych formatów plików (PDF, JPG, PNG, DOC) + - Możliwość dodania komentarzy do przesłanych dokumentów + +2. **Weryfikacja przez moderatorów:** + - Przegląd dokumentów przez wykwalifikowanych weryfikatorów + - Sprawdzenie zgodności z lokalnymi przepisami + - Weryfikacja autentyczności miejsca (lokalizacja, zdjęcia, wymiary) + - Decyzja: akceptacja lub odrzucenie z uzasadnieniem + +**Kryteria weryfikacji:** +- Zgodność lokalizacji z dokumentami +- Autentyczność zdjęć miejsca reklamowego +- Sprawdzenie wymiarów i specyfikacji technicznych +- **@TODO** Weryfikacja uprawnień do oferowania danego miejsca - wymaga określenia wymaganych dokumentów + +### 3.3 Proces rezerwacji i płatności + +#### 3.3.1 Proces rezerwacji +**Przepływ procesu:** Dwuetapowy proces rezerwacji z wykorzystaniem kalendarza dostępności i systemu akceptacji przez właściciela. + +**Kroki procesu:** +1. **Przeglądanie dostępności** + - Reklamodawca widzi widget kalendarza z dostępnymi datami + - Wyświetlanie cen dla poszczególnych okresów + - Podgląd dostępności w czasie rzeczywistym + +2. **Wybór okresu wynajmu** + - Minimalny okres wynajmu: 2 tygodnie + - Gradacja rezerwacji: co 1 tydzień (2 tygodnie, 3 tygodnie, 4 tygodnie, itp.) + - Brak górnego limitu czasu wynajmu + - Wybór konkretnych dat rozpoczęcia i zakończenia + +3. **Złożenie oferty rezerwacji** + - Wypełnienie formularza z detalami kampanii + - Przesłanie oferty do właściciela miejsca + - Automatyczne generowanie podsumowania oferty + +4. **Akceptacja przez właściciela** + - Właściciel otrzymuje powiadomienie o nowej ofercie + - **Czas na odpowiedź: 48 godzin** + - Opcje: akceptacja lub odrzucenie z uzasadnieniem + +5. **Finalizacja rezerwacji** + - Po akceptacji - automatyczne przejście do płatności + - Po odrzuceniu - powiadomienie reklamodawcy z możliwością modyfikacji oferty + +**Zasady czasowe:** +- **Minimalny okres wynajmu:** 2 tygodnie +- **Maksymalny okres wynajmu:** Bez ograniczeń +- **Gradacja rezerwacji:** Co 1 tydzień (2, 3, 4, 5... tygodni) +- **Czas odpowiedzi właściciela:** 48 godzin +- **Możliwość przedłużenia:** Tak, z ponowną akceptacją właściciela + +#### 3.3.2 System płatności +**Obsługiwane metody płatności:** Różnicowane według typu konta użytkownika z wykorzystaniem bramki Przelewy24.pl. + +**Dla osób prywatnych (przez Przelewy24.pl):** +- Karty płatnicze (Visa, Mastercard) +- BLIK +- Przelewy bankowe +- Płatności mobilne +- Portfel Google Pay / Apple Pay +- Płatność natychmiastowa po akceptacji oferty + +**Dla firm (wszystkie powyższe + dodatkowe opcje):** +- Faktury pro-forma z odroczeniem płatności +- Przelew bankowy tradycyjny (z terminem płatności) +- Możliwość negocjacji terminów płatności +- Automatyczne generowanie dokumentów księgowych + +**Model płatności:** +- **Osoby prywatne:** Płatność z góry po akceptacji oferty przez właściciela +- **Firmy:** Opcja płatności z góry lub faktury pro-forma z odroczeniem + +**Szczegóły rozliczeń:** +- **@TODO** Prowizja platformy: Wymaga ustalenia % prowizji, kto ponosi koszty, różne stawki dla różnych typów użytkowników +- Harmonogram płatności: Natychmiastowo lub zgodnie z fakturą pro-forma +- Faktury: Automatyczne generowanie dla firm, opcjonalne dla osób prywatnych +- **@TODO** Zwroty: Wymaga zdefiniowania polityki zwrotów i anulacji rezerwacji + +### 3.4 Panele użytkowników + +#### 3.4.1 Panel właściciela miejsc reklamowych +**Funkcjonalności:** + +1. **Zarządzanie ofertami** + - Dodawanie nowych miejsc reklamowych + - Edycja istniejących ofert (cena, opis, zdjęcia) + - Usuwanie/dezaktywacja ofert + - Podgląd statusu ofert (aktywne, nieaktywne, w weryfikacji) + +2. **Kalendarz dostępności** + - Wizualny kalendarz z dostępnością miejsc + - Blokowanie dat (maintenance, prywatne zajęcie) + - Zarządzanie cenami sezonowymi + - Podgląd zarezerwowanych okresów + +3. **Historia rezerwacji i zarobków** + - Lista wszystkich rezerwacji (obecne, przyszłe, zakończone) + - Szczegóły każdej rezerwacji (daty, kwota, reklamodawca) + - Zestawienia finansowe (miesięczne, roczne) + - **@TODO** Export danych do systemów księgowych + +4. **Komunikacja z reklamodawcami** + - Wiadomości związane z rezerwacjami + - Akceptacja/odrzucenie ofert rezerwacji + - Akceptacja/odrzucenie projektów reklam + - Powiadomienia o nowych zapytaniach + +5. **Statystyki wyświetleń oferty** + - Liczba wyświetleń oferty + - Statystyki zainteresowania (kliknięcia, zapytania) + - Analiza skuteczności oferty + - **@TODO** Porównanie z podobnymi ofertami w okolicy + +6. **Zarządzanie delegacji uprawnień do agencji** + - Lista agencji z dostępem do konta + - Udzielanie/odbieranie uprawnień konkretnym agencjom + - Definiowanie zakresu uprawnień (tylko podgląd vs pełne zarządzanie) + - Historia działań podjętych przez agencje + +#### 3.4.2 Panel reklamodawcy +**Funkcjonalności:** + +1. **Historia wynajmów** + - Lista wszystkich wynajmów (obecne, przyszłe, zakończone) + - Szczegóły każdego wynajmu (miejsce, okres, koszt, status) + - Dokumenty związane z wynajmem (faktury, umowy) + - **@TODO** Ocena jakości wynajmu i właściciela miejsca + +2. **Zarządzanie aktywnymi kampaniami** + - Podgląd trwających kampanii reklamowych + - Status montażu/demontażu reklam + - Komunikacja z właścicielami dotycząca aktywnych kampanii + - Zarządzanie materiałami reklamowymi + +3. **Ulubione miejsca/watchlista** + - Lista obserwowanych miejsc reklamowych + - Powiadomienia o zmianach cen lub dostępności + - Szybki dostęp do często używanych lokalizacji + - **@TODO** Porównanie cen i dostępności ulubionych miejsc + +4. **Powiadomienia o nowych ofertach** + - Alerty o nowych miejscach w interesujących lokalizacjach + - Powiadomienia o promocjach cenowych + - Informacje o zmianach dostępności + - **@TODO** Personalizowane rekomendacje miejsc + +5. **Narzędzia do planowania kampanii** + - Mapa tras z zaznaczonymi miejscami reklamowymi + - Kalkulator budżetu kampanii + - Planowanie tras reklamowych (punkt A do B) + - **@TODO** Analiza zasięgu i efektywności lokalizacji + +6. **Komunikacja z właścicielami miejsc** + - Wiadomości związane z rezerwacjami + - Zapytania o szczegóły miejsc reklamowych + - Koordynacja montażu i logistyki + - Historia komunikacji z konkretnymi właścicielami + +### 3.5 Zarządzanie materiałami reklamowymi + +#### 3.5.1 Przesyłanie materiałów +**Funkcjonalność:** System umożliwia reklamodawcom przesyłanie projektów reklam do akceptacji przez właścicieli miejsc reklamowych. + +**Obsługiwane formaty:** +- Pliki graficzne (JPG, PNG, GIF) +- Dokumenty PDF +- **@TODO** Inne formaty do ustalenia (AI, PSD, SVG) +- **@TODO** Limity rozmiaru plików +- **@TODO** Wymagania rozdzielczości + +**Proces zatwierdzania:** +1. **Upload przez reklamodawcę** + - Przesłanie projektu reklamy po zaakceptowaniu rezerwacji + - Możliwość dodania komentarzy do projektu + - Podgląd materiału przed wysłaniem + +2. **Akceptacja przez właściciela** + - Otrzymanie powiadomienia o nowym projekcie + - Podgląd materiału reklamowego + - Opcje: akceptacja lub odrzucenie z uzasadnieniem + - **@TODO** Czas na odpowiedź dotyczącą akceptacji materiału + +#### 3.5.2 Montaż i instalacja +**Model odpowiedzialności:** Platforma pełni wyłącznie rolę pośrednika łączącego właścicieli miejsc z reklamodawcami. + +**Podział odpowiedzialności:** +- **Reklamodawca odpowiada za:** + - Przygotowanie materiałów reklamowych + - Organizację montażu i demontażu + - Pokrycie wszystkich kosztów logistycznych + - Koordynację z właścicielem miejsca + - Zgodność z wymiarami i specyfikacją miejsca + +- **Właściciel miejsca odpowiada za:** + - Udostępnienie miejsca w uzgodnionych terminach + - Akceptację projektu reklamy + - Podstawowe informacje techniczne o miejscu + +- **Platforma AdRoute:** + - Wyłącznie łączenie stron i obsługa procesu rezerwacji + - Brak odpowiedzialności za fizyczną realizację kampanii + - Brak usług projektowania czy montażu + +--- + +## 4. Wymagania niefuncjonalne + +### 4.1 Wydajność +- Lorem ipsum dolor sit amet, consectetur adipiscing elit +- Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua +- Ut enim ad minim veniam, quis nostrud exercitation + +### 4.2 Bezpieczeństwo +- Lorem ipsum dolor sit amet, consectetur adipiscing elit +- Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua +- Ut enim ad minim veniam, quis nostrud exercitation + +### 4.3 Skalowalność +- Lorem ipsum dolor sit amet, consectetur adipiscing elit +- Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua + +### 4.4 Dostępność +- Lorem ipsum dolor sit amet, consectetur adipiscing elit +- Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua + +--- + +## 5. Aspekty prawne i regulacyjne + +### 5.1 Pozwolenia na reklamę zewnętrzną +**Wymagania prawne:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +**Proces weryfikacji:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +**Odpowiedzialność:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +### 5.2 Ochrona danych osobowych (RODO) +**Zgodność z RODO:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +**Przetwarzanie danych:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +### 5.3 Regulacje lokalne +**Różnorodność przepisów:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +**Strategie compliance:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +--- + +## 6. Model biznesowy + +### 6.1 Źródła przychodów +**@TODO** **Prowizja od transakcji:** Wymaga ustalenia modelu monetyzacji platformy. + +**@TODO** **Opłaty dodatkowe:** +- Opłaty za promowanie ofert +- Konta premium z dodatkowymi funkcjami +- Inne źródła przychodów do zdefiniowania + +### 6.2 Struktura kosztów +**Koszty operacyjne:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +**Koszty rozwoju:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +### 6.3 Analiza konkurencji +**Główni konkurenci:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +**Przewaga konkurencyjna:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +--- + +## 7. Plan wdrożenia + +### 7.1 Fazy rozwoju +**Faza 1 - MVP:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +**Faza 2 - Rozszerzenie:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +**Faza 3 - Skalowanie:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +### 7.2 Zasięg geograficzny +**Start:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +**Ekspansja:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +### 7.3 Timeline +**Milestones:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +--- + +## 8. Metryki sukcesu i KPI + +### 8.1 Metryki biznesowe +- Lorem ipsum dolor sit amet +- Consectetur adipiscing elit +- Sed do eiusmod tempor incididunt + +### 8.2 Metryki techniczne +- Lorem ipsum dolor sit amet +- Consectetur adipiscing elit +- Sed do eiusmod tempor incididunt + +### 8.3 Metryki użytkowników +- Lorem ipsum dolor sit amet +- Consectetur adipiscing elit +- Sed do eiusmod tempor incididunt + +--- + +## 9. Ryzyka i mitigation + +### 9.1 Ryzyka biznesowe +**Ryzyko:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. +**Mitigation:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +### 9.2 Ryzyka techniczne +**Ryzyko:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. +**Mitigation:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +### 9.3 Ryzyka prawne +**Ryzyko:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. +**Mitigation:** Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +--- + +## 10. Załączniki + +### Załącznik A: Wireframes interfejsu użytkownika +Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +### Załącznik B: Diagramy przepływu procesów +Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +### Załącznik C: Analiza techniczna integracji z mapami +Lorem ipsum dolor sit amet, consectetur adipiscing elit. + +--- + +**Koniec dokumentu** + +*Dokument zostanie aktualizowany w miarę uzyskiwania odpowiedzi od CTO na pytania z kwestionariusza.* \ No newline at end of file diff --git a/documentation/internal/public/business_analysis_summary.md b/documentation/internal/public/business_analysis_summary.md new file mode 100644 index 0000000..5aff19f --- /dev/null +++ b/documentation/internal/public/business_analysis_summary.md @@ -0,0 +1,157 @@ +# Podsumowanie Analizy Biznesowej - System AdRoute +## Iteracja 1 - Status: KOMPLETNA + +**Data:** 2025-08-19 +**Wersja:** 1.0 +**Analityk:** Analityk Biznesowy +**CTO:** Zleceniodawca projektu + +--- + +## 📋 ZEBRANIE WYMAGAŃ - STATUS + +### ✅ OBSZARY ZDEFINIOWANE KOMPLETNIE + +#### 1. **ROLE UŻYTKOWNIKÓW** +- **5 głównych ról:** Właściciele miejsc, Reklamodawcy, Agencje reklamowe, Administratorzy, Moderatorzy +- **System delegacji:** Agencje mogą działać w imieniu właścicieli z zarządzanymi uprawnieniami +- **Weryfikacja:** Obowiązkowa dla miejsc reklamowych, opcjonalna licencja dla właścicieli + +#### 2. **SYSTEM WYSZUKIWANIA** +- **5 metod wyszukiwania:** Adres/ulica, mapa interaktywna, kod pocztowy, trasy A-B, promień od punktu +- **Zasięg:** Domyślnie 5km, suwak 1-50km +- **Precyzja:** Obowiązkowe współrzędne GPS dla wszystkich miejsc + +#### 3. **FILTRY WYSZUKIWANIA** +- **5 kluczowych filtrów:** Typ miejsca (billboard, citylight, LED, plakat + rozszerzalne), rozmiar, zakres cenowy, okres dostępności, podświetlenie +- **Elastyczność:** System łatwo rozszerzalny o nowe typy + +#### 4. **INTEGRACJA Z MAPAMI** +- **Dostawca:** Google Maps API +- **Funkcje:** Zdjęcia satelitarne, Street View, natężenie ruchu, pomiar odległości +- **Kompleksowość:** Pełen pakiet funkcji mapowych + +#### 5. **PROCES REZERWACJI** +- **Model:** Widget kalendarza → oferta → akceptacja przez właściciela (48h) → płatność +- **Okresy wynajmu:** Minimum 2 tygodnie, maksimum bez ograniczeń, gradacja co tydzień +- **Przejrzystość:** Ceny i dostępność widoczne w czasie rzeczywistym + +#### 6. **SYSTEM PŁATNOŚCI** +- **Osoby prywatne:** Przelewy24.pl (karta, BLIK, przelew, mobile payments) +- **Firmy:** Dodatkowo faktury pro-forma z odroczeniem płatności +- **Bezpieczeństwo:** Płatność po akceptacji oferty przez właściciela + +#### 7. **MATERIAŁY REKLAMOWE** +- **Upload:** Pliki graficzne (JPG, PNG, GIF) i PDF przez reklamodawcę +- **Akceptacja:** Właściciel zatwierdza projekt przed montażem +- **Odpowiedzialność:** Reklamodawca za całą logistykę, montaż i koszty +- **Rola platformy:** Wyłącznie pośrednictwo, brak usług montażu/projektowania + +#### 8. **PANELE UŻYTKOWNIKÓW** +**Panel właściciela (6 funkcji):** +- Zarządzanie ofertami, Kalendarz dostępności, Historia rezerwacji/zarobków +- Komunikacja z reklamodawcami, Statystyki wyświetleń, Zarządzanie delegacji + +**Panel reklamodawcy (6 funkcji):** +- Historia wynajmów, Zarządzanie kampaniami, Ulubione miejsca/watchlista +- Powiadomienia, Narzędzia planowania, Komunikacja z właścicielami + +--- + +## 🚧 OBSZARY WYMAGAJĄCE DOPRECYZOWANIA (@TODO) + +### Kwestie finansowe i biznesowe: +- **Prowizja platformy:** % od transakcji, kto ponosi koszty, różne stawki +- **Model monetyzacji:** Opłaty dodatkowe, konta premium, promocje ofert +- **Polityka zwrotów:** Anulacje, zwroty, reklamacje + +### Szczegóły techniczne: +- **Zdjęcia miejsc:** Liczba (min/max), formaty, rozdzielczość, moderacja +- **Wymiary:** Standardy, tolerancje, jednostki miary +- **Ceny:** Model cenowy (dzień/tydzień/miesiąc), waluta, promocje sezonowe +- **Opisy:** Długość, wymagania, moderacja treści +- **Kalendarz:** Mechanizm blokowania dat, aktualizacje dostępności + +### Aspekty prawne: +- **Dokumenty weryfikacyjne:** Wymagane dokumenty dla różnych typów właścicieli +- **Zgodność z prawem:** Pozwolenia na reklamę zewnętrzną w różnych miastach + +### Funkcje zaawansowane: +- **Analityka:** Porównanie ofert, rekomendacje, analiza efektywności +- **Integracje:** Export do systemów księgowych, API dla partnerów +- **Oceny:** System ocen użytkowników, historia współpracy + +--- + +## 🎯 KLUCZOWE USTALENIA DLA ARCHITEKTA + +### Model biznesowy: +- **Platforma pośrednictwa** - łączy strony, nie świadczy usług fizycznych +- **B2B2C** - obsługa firm, agencji i osób prywatnych +- **Skalowalna architektura** - przygotowana na rozszerzenia + +### Wymagania techniczne: +- **Geolokalizacja:** Precyzyjne GPS + integracja Google Maps +- **System płatności:** Integracja Przelewy24.pl + faktury pro-forma +- **Upload plików:** Obsługa grafiki i PDF +- **Kalendarz:** Zaawansowany system zarządzania dostępnością +- **Powiadomienia:** Email, push notifications, SMS + +### Bezpieczeństwo i prywatność: +- **Weryfikacja tożsamości:** KYC dla użytkowników biznesowych +- **System uprawnień:** Delegacja z kontrolą zakresu +- **RODO:** Zgodność z ochroną danych osobowych + +--- + +## 📊 STATYSTYKI ANALIZY + +- **Przeprowadzonych wywiadów:** 29 pytań i odpowiedzi +- **Zdefiniowanych funkcji:** 47 głównych funkcjonalności +- **Ról użytkowników:** 5 + system delegacji +- **Oznaczonych @TODO:** 15 obszarów do doprecyzowania +- **Pokrycie wymagań:** ~85% (podstawowe funkcjonalności kompletne) + +--- + +## 🚀 NASTĘPNE KROKI + +### Dla Architekta Oprogramowania: +1. **Analiza wymagań technicznych** na podstawie zdefiniowanych funkcjonalności +2. **Projekt architektury wysokopoziomowej** systemu AdRoute +3. **Wybór stosu technologicznego** (backend, frontend, bazy danych, integracje) +4. **Planowanie MVP** - określenie pierwszej fazy rozwoju + +### Dla kolejnych iteracji z CTO: +1. **Doprecyzowanie kwestii @TODO** - szczególnie model monetyzacji +2. **Definicja wymagań niefunkcjonalnych** - wydajność, skalowalność +3. **Planowanie faz rozwoju** - MVP → Beta → Production +4. **Analiza ryzyk** - technicznych, biznesowych, prawnych + +--- + +## 📋 REKOMENDACJE + +### Priorytet WYSOKI - do realizacji w MVP: +- System wyszukiwania i filtrów +- Podstawowy proces rezerwacji +- Integracja z mapami i płatnościami +- Bazowe panele użytkowników + +### Priorytet ŚREDNI - druga faza: +- Zaawansowana analityka i statystyki +- System delegacji uprawnień +- Powiadomienia i alerty +- Narzędzia planowania kampanii + +### Priorytet NISKI - trzecia faza: +- Integracje z systemami zewnętrznymi +- Zaawansowane funkcje AI/ML +- Marketplace dodatkowych usług +- Ekspansja międzynarodowa + +--- + +**Dokument gotowy do przekazania zespołowi architektoniczno-dewelopersk + +Podsumowanie przygotowane - pierwsza iteracja analizy biznesowej ZAKOŃCZONA ✅** \ No newline at end of file diff --git a/documentation/internal/src/context_restoration_instructions.md b/documentation/internal/src/context_restoration_instructions.md new file mode 100644 index 0000000..ba854a3 --- /dev/null +++ b/documentation/internal/src/context_restoration_instructions.md @@ -0,0 +1,57 @@ +# INSTRUKCJA ODTWORZENIA KONTEKSTU - System AdRoute + +## Prompt do użycia po wyczyszczeniu kontekstu: + +``` +Jestem analitykiem biznesowym pracującym nad projektem AdRoute. W katalogu /mnt/d/workspace/adsroute/ znajdują się pliki dokumentujące postęp pracy z CTO nad specyfikacją systemu. + +Przeczytaj następujące pliki w kolejności: +1. documentation/internal/src/conversation_history.md - kompletny log komunikacji z CTO (29 wymian) +2. documentation/internal/public/business_analysis.md - szczegółowa analiza biznesowa (główny dokument) +3. documentation/internal/public/business_analysis_summary.md - podsumowanie iteracji 1 +4. documentation/internal/src/questionnaire.md - kwestionariusz pytań do CTO + +Na podstawie tych plików: +- Odtwórz kontekst projektu +- Zidentyfikuj aktualny stan analizy +- Określ co zostało już ustalone, a na co jeszcze czekam odpowiedzi od CTO +- Kontynuuj pracę jako analityk biznesowy zbierający wymagania + +System to: serwis internetowy do wynajmu miejsc reklamowych (bannery/billboardy) wzdłuż ulic i dróg krajowych. + +CTO to mój rozmówca (nie nazywaj go "klientem"). + +Kontynuuj aktualizację plików dokumentacyjnych podczas dalszej konwersacji. +``` + +## DODATKOWE WSKAZÓWKI: + +### W przypadku problemów z odtworzeniem kontekstu: +- Sprawdź datę w plikach (2025-08-19) +- Zweryfikuj czy wszystkie 3 pliki dokumentacyjne istnieją +- Ostatni wpis w historia_konwersacji.md pokazuje aktualny stan +- TodoWrite był używany do śledzenia postępu - może być potrzebny restart todo listy + +### Kluczowe informacje do odtworzenia: +- **Rola:** Analityk biznesowy +- **Projekt:** AdRoute - platforma wynajmu miejsc reklamowych +- **CTO:** Osoba definiująca wymagania (nie "klient") +- **Status:** ITERACJA 1 ZAKOŃCZONA - podstawowe wymagania zebrane +- **Kwestionariusz:** 23 pytania w 8 blokach tematycznych - 13 pytań odpowiedziane, pozostałe @TODO +- **Następny krok:** Przekazanie do architekta lub kolejna iteracja doprecyzowująca @TODO + +### Pliki do aktualizacji podczas kontynuacji: +1. `documentation/internal/src/conversation_history.md` - dodawać każdą wymianę komunikatów +2. `documentation/internal/public/business_analysis.md` - szczegółowa analiza odpowiedzi CTO +3. `documentation/internal/public/business_analysis_summary.md` - aktualizować podsumowanie +4. `documentation/internal/src/questionnaire.md` - aktualizować status pytań (odpowiedziane/pending) + +### Stan po iteracji 1: +- **29 wymian komunikacji** z CTO zakończonych +- **8 głównych obszarów** systemu zdefiniowanych +- **15 pozycji @TODO** do doprecyzowania w kolejnych iteracjach +- **Pokrycie wymagań: ~85%** - gotowe do przekazania architektowi + +--- + +**Data utworzenia instrukcji:** 2025-08-19 \ No newline at end of file diff --git a/documentation/internal/src/conversation_history.md b/documentation/internal/src/conversation_history.md new file mode 100644 index 0000000..d8c6db0 --- /dev/null +++ b/documentation/internal/src/conversation_history.md @@ -0,0 +1,312 @@ +# Historia konwersacji - System AdRoute + +## Data rozpoczęcia: 2025-08-19 + +--- + +## LOG KONWERSACJI (CHRONOLOGICZNIE) + +### 1. CTO: +``` +auth +``` + +**Odpowiedź Analityka (skrót):** +Pomoc z uwierzytelnianiem. Sprawdzenie struktury projektu - katalog pusty. Prośba o doprecyzowanie wymagań uwierzytelniania. + +--- + +### 2. CTO: +``` +czy rozumiesz po polsku? +``` + +**Odpowiedź Analityka (skrót):** +Tak, rozumiem po polsku. Mogę pomóc z uwierzytelnianiem w języku polskim. + +--- + +### 3. CTO: +``` +Jesteś analitykiem biznesowym który na podstawie rozmowy z klientem opracuje dokument będący dokładnym opisem funkcjonalności systemu, który chce klient, a potem ten dokument posłuży dla architekta oprogramowania do stworzenia wysokopopoziomowo architektury systemu +``` + +**Odpowiedź Analityka (skrót):** +Rozumiem rolę. Gotowy do zbierania wymagań i opracowania specyfikacji funkcjonalnej. Pytanie o cel, użytkowników i problemy do rozwiązania. + +--- + +### 4. CTO: +``` +Chcę stworzyć serwis internetowy, który pozwala znaleźć oferty wynajmu bannerów/miejsc reklamowych wzdłuż konkretnych ulic danego miasta bądź dróg krajowych i pozwalający dokonać zakupu/wynajmu tego miejsca +``` + +**Odpowiedź Analityka (skrót):** +Utworzenie todo listy. Rozpoczęcie zbierania wymagań - pytania o użytkowników (właściciele vs reklamodawcy), funkcjonalność wyszukiwania (adres, zasięg, trasy), filtry (typ, rozmiar, cena, okres). + +--- + +### 5. CTO: +``` +Jeszcze jedna rzecz zanim będziemy kontynuować. Chciałbym byś całą naszą konwersację zapisywał do jednego pliku a swoje pytania do drugiego w taki sposób, by po wyczyszczeniu kontekstu i załadowaniu na czysto zawartości projektu, wiedział na czym stoimy +``` + +**Odpowiedź Analityka (skrót):** +Utworzenie plików: `konwersacja_analiza_biznesowa.md` (pełna historia) i `kolejne_pytania_do_klienta.md` (aktualne pytania). Kontynuacja zbierania wymagań. + +--- + +### 6. CTO: +``` +Chciałbym byś wygenerował pytania do wszystkich bloków od razu +``` + +**Odpowiedź Analityka (skrót):** +Wygenerowanie kompletnego kwestionariusza 23 pytań w 8 blokach: Użytkownicy, Wyszukiwanie, Proces biznesowy, Zarządzanie ofertami, Panel użytkownika, Funkcje techniczne, Aspekty prawne, Model biznesowy. Aktualizacja plików. + +--- + +### 7. CTO: +``` +a możesz jeszcze utworzyć plik historia_konwersacji.md w którym będą dosłownie moje prompty i twoje skórcone odpowiedzi na każdy z nich? +``` + +**Odpowiedź Analityka (skrót):** +Tworzenie pliku `historia_konwersacji.md` z dokładnymi promptami CTO i skróconymi odpowiedziami analityka. + +--- + +### 8. CTO: +``` +w pliku, i tu, na potrzeby projektu nie nazywaj mnie Klientem a CTO - taką rolę tu pełnię +``` + +**Odpowiedź Analityka (skrót):** +Aktualizacja wszystkich plików - zmiana "Klient" na "CTO" we wszystkich dokumentach projektu. Gotowy do kontynuacji zbierania wymagań od CTO. + +--- + +### 9. CTO: +``` +Jeszcze jedno, jak wyczyszczę kontekst, to jakim promptem wskazać Ci jak odtworzyć kontekst na podstawie tych plików? +``` + +**Odpowiedź Analityka (skrót):** +Utworzenie pliku `context_restoration_instructions.md` z gotowym promptem do odtworzenia kontekstu po wyczyszczeniu. Plik zawiera instrukcje jak przeczytać dokumenty i kontynuować pracę jako analityk biznesowy. + +--- + +### 10. CTO: +``` +zmień nazwy plików na odpowiednie wersje angielskie, i umieść je w podkatalogu /docs/internal/ +``` + +**Odpowiedź Analityka (skrót):** +Reorganizacja struktury plików - utworzenie katalogu `/docs/internal/` i przeniesienie wszystkich plików z angielskimi nazwami: +- `conversation_history.md` +- `business_analysis_conversation.md` +- `questionnaire.md` +- `context_restoration_instructions.md` + +--- + +### 11. CTO: +``` +Jeszcze jedno: nie "cto_questionnaire.md" a "questionnaire.md" +``` + +**Odpowiedź Analityka (skrót):** +Zmiana nazwy pliku z `cto_questionnaire.md` na `questionnaire.md` i aktualizacja referencji w dokumentacji. + +--- + +### 12. CTO: +``` +Kolejne pliki które będą głównym wynikiem umieść w /documentation/internal/public. Na ten moment będzie to analiza biznesowa. w /documentation/internal/src/ umieść pozostałe pliki "techniczne" +``` + +**Odpowiedź Analityka (skrót):** +Reorganizacja struktury na `/documentation/internal/`. Główny wynik (analiza biznesowa) przeniesiony do `/public/business_analysis.md`. Pliki techniczne (historia konwersacji, kwestionariusz, instrukcje) przeniesione do `/src/`. + +--- + +### 13. CTO: +``` +Jasne, utwórz teraz w miarę docelowy konspekt analizy biznesowej. W miejscach, gdzie nie uzyskałeś ode mnie odpowiedzi umieść znany fragment "Lorem ipsum...". +``` + +**Odpowiedź Analityka (skrót):** +Utworzenie kompletnego konspektu analizy biznesowej w `/public/business_analysis.md` z 10 głównymi sekcjami: streszczenie, interesariusze, wymagania funkcjonalne, wymagania niefuncjonalne, aspekty prawne, model biznesowy, plan wdrożenia, metryki, ryzyka, załączniki. Nieznane części wypełnione tekstem Lorem ipsum. + +--- + +### 14. CTO: +``` +Super. Przejdźmy do zbierania wymagań. Przytocz pierwsze pytanie +``` + +**Odpowiedź Analityka (skrót):** +Rozpoczęcie zbierania wymagań - pierwsze pytanie o role użytkowników w systemie z podstawowymi rolami: reklamodawcy, właściciele miejsc, administratorzy, moderatorzy. + +--- + +### 15. CTO: +``` +Dodatkową rolą niech będą agencje reklamowe - które będą mogły działać w imieniu właścicieli miejsc reklamowych. Właściciel miejsca i tak będzie musiał mieć własne konto, ale będzie mógł oddelegować obsługę tego do konkretnej agencji reklamowej i ona będzie miała dostęp do tego ze swojego konta +``` + +**Odpowiedź Analityka (skrót):** +Dodanie roli "Agencje reklamowe" z możliwością delegacji uprawnień od właścicieli miejsc. System zarządzania uprawnieniami pozwalający agencjom działać w imieniu właścicieli przy zachowaniu własności konta przez właściciela. + +--- + +### 16. CTO: +``` +Właścicielami miejsc mogą być firmy, właściciele nieruchmości, jednostki samorządowe i osoby prywatne. Licencja nie jest wymagana, ale będzie potrzebna weryfikacja oferowanego miejsca reklamowego. Na ten moment nie wiem jakich dokumenty będą musieli dostarczyć, ale zakładam że będą uploadować te dokumenty przez stronę serwisu i weryfikatorzy/moderatorzy będą akceptować to bądź odrzucać +``` + +**Odpowiedź Analityka (skrót):** +Określenie typów właścicieli: firmy, właściciele nieruchomości, samorządy, osoby prywatne. Brak wymagania licencji, ale konieczna weryfikacja miejsca. System uploadowania dokumentów przez stronę z procesem akceptacji/odrzucenia przez moderatorów. + +--- + +### 17. CTO: +``` +Reklamodawcami są agencje, firmy i osoby prywatne. Wymagana jest rejestracja. Ważne by określić czy to konto firmowe czy prywatne. Limity? Na razie nie mam na to pomysłu +``` + +**Odpowiedź Analityka (skrót):** +Określenie reklamodawców: agencje, firmy, osoby prywatne. Obowiązkowa rejestracja z rozróżnieniem na konta firmowe i prywatne. Brak limitów na obecnym etapie planowania. + +--- + +### 18. CTO: +``` +Super, podałeś wszystkie opcje jakie chciałem zaimplementować +``` + +**Odpowiedź Analityka (skrót):** +Potwierdzenie wszystkich 5 opcji wyszukiwania: wpisywanie adresu/ulicy, wskazywanie na mapie, kod pocztowy, wyszukiwanie tras (A-B), promień od punktu. + +--- + +### 19. CTO: +``` +Domyślny zasięg niech będzie 5km ale to ma być suwak dający ustalić precyzję np. 1-50km. Wszystkie obiekty będą musiały być zlokalizowane po współrzędnych GPS +``` + +**Odpowiedź Analityka (skrót):** +Określenie zasięgu wyszukiwania: domyślnie 5km, suwak regulacji 1-50km. Obowiązkowa lokalizacja wszystkich miejsc reklamowych według współrzędnych GPS. + +--- + +### 20. CTO: +``` +Na razie niech to będzie typ miejsca (podałeś prawidłowe), z łatwą opcją dodania nowego typu., rozmiar, zakres cenowy, okres dostępności i podświetlenie +``` + +**Odpowiedź Analityka (skrót):** +Wybór 5 kluczowych filtrów: typ miejsca (billboard, citylight, LED, plakat + opcja dodania nowego), rozmiar, zakres cenowy, okres dostępności, podświetlenie. System rozszerzalny o nowe typy. + +--- + +### 21. CTO: +``` +Na ten moment wydaje mi się że użyjemy Google Maps ze zdjęciam satelitarnymi, Street View, natężeniem ruchu i możliwością mierzenia odległości +``` + +**Odpowiedź Analityka (skrót):** +Wybór Google Maps jako dostawcy z pełnym pakietem funkcji: zdjęcia satelitarne, Street View, natężenie ruchu, pomiar odległości. Kompleksowa integracja mapowa. + +--- + +### 22. CTO: +``` +Moim zdaniem powinno to wyglądać tak, że reklamodawca powinien widzieć widget kalendarza z dostępnymi datami i cenami. Minimalnie można wynając na 2 tygodnie. Następne oferta jest wysyłana do właściciela miejsca i on ma 48h na zaakceptowanie bądź odrzucenie oferty. Możliwość rezerwacji jest na minimum 1 tydzień z gradacją co 1 tydzień. +``` + +**Odpowiedź Analityka (skrót):** +Definicja procesu rezerwacji: widget kalendarza z dostępnością i cenami, minimalny wynajmu 2 tygodnie, rezerwacja z gradacją tygodniową (min. 1 tydzień), oferta do właściciela z 48h na odpowiedź. + +--- + +### 23. CTO: +``` +Uważam, że osoby prywatne będą mogły użyć metod płatności dostarczanych przez przelewy24.pl. Firmy dodatkowo będą mogły wystawiać sobie faktury pro-forma bez płatności od razu +``` + +**Odpowiedź Analityka (skrót):** +Określenie metod płatności: Przelewy24.pl dla osób prywatnych (karta, BLIK, przelew, płatności mobilne). Firmy dodatkowo z opcją faktur pro-forma i odroczonych płatności. + +--- + +### 24. CTO: +``` +Minimalnie można wynają na 2 tygodnie, ale bez problemu można wynająć od razu na 3, 4 5 itd tygodni +``` + +**Odpowiedź Analityka (skrót):** +Wyjaśnienie okresów wynajmu: minimum 2 tygodnie, maksimum bez ograniczeń z gradacją tygodniową (2, 3, 4, 5... tygodni). + +--- + +### 25. CTO: +``` +To narazie pomińmy. Zrobimy w kolejnej iteracji. W specyfikacji daj znacznik @TODO do tego typu pominiętych lub wymagających doprecyzowania kwestii +``` + +**Odpowiedź Analityka (skrót):** +Wprowadzenie znacznika @TODO dla kwestii do doprecyzowania w kolejnych iteracjach. Pominięcie prowizji na obecnym etapie z oznaczeniem do dalszych prac. + +--- + +### 26. CTO: +``` +Właściciel miejsca powinien dostać projekt reklamy która będzie tam montowana by określił czy się zgadza czy nie. Może to być zwykły plik graficzny lub PDF. Montaż i cała logistyka będzie po stronie zlecającego. System ma tylko połączyć właściciela miejsca z osobą chętną do zamieszczenia reklamy i to ona ponosić będzie koszty. +``` + +**Odpowiedź Analityka (skrót):** +Określenie obsługi materiałów reklamowych: upload plików graficznych/PDF przez reklamodawcę, akceptacja przez właściciela miejsca. Montaż i logistyka po stronie reklamodawcy. Platforma tylko łączy strony. + +--- + +### 27. CTO: +``` +Podałeś wszystkie fukncje które mnie interesują +``` + +**Odpowiedź Analityka (skrót):** +Potwierdzenie wszystkich 6 funkcji panelu właściciela: zarządzanie ofertami, kalendarz dostępności, historia rezerwacji/zarobków, komunikacja, statystyki wyświetleń, zarządzanie delegacji do agencji. + +--- + +### 28. CTO: +``` +Podałeś wszystkie funkcje które mnie interesuja +``` + +**Odpowiedź Analityka (skrót):** +Potwierdzenie wszystkich 6 funkcji panelu reklamodawcy: historia wynajmów, zarządzanie kampaniami, ulubione miejsca/watchlista, powiadomienia, narzędzia planowania, komunikacja z właścicielami. + +--- + +### 29. CTO: +``` +Podsumuj +``` + +**Odpowiedź Analityka (skrót):** +Podsumowanie pierwszej iteracji analizy biznesowej systemu AdRoute - zebranie kluczowych wymagań z 8 obszarów: role użytkowników, wyszukiwanie, proces biznesowy, panele, mapy, płatności, materiały reklamowe. Przygotowanie do przekazania architektowi oprogramowania. + +--- + +## KOLEJNE WPISY BĘDĄ DODAWANE TUTAJ AUTOMATYCZNIE + +*Plik będzie aktualizowany po każdej wymianie komunikatów* + +--- + +## PODSUMOWANIE STANU PROJEKTU: +- **Status:** Zbieranie wymagań +- **Utworzone dokumenty:** 3 pliki śledzące postęp +- **Następny krok:** CTO ma odpowiedzieć na wybrane pytania z kwestionariusza lub wskazać preferowane podejście do analizy wymagań \ No newline at end of file diff --git a/documentation/internal/src/questionnaire.md b/documentation/internal/src/questionnaire.md new file mode 100644 index 0000000..a9f0e3e --- /dev/null +++ b/documentation/internal/src/questionnaire.md @@ -0,0 +1,190 @@ +# Kolejne pytania do CTO - System AdRoute + +## Status: WSZYSTKIE PYTANIA DO ANALIZY +**Data:** 2025-08-19 + +--- + +## BLOK 1: UŻYTKOWNICY SYSTEMU + +### 1.1 Role użytkowników +1. **Jakie role użytkowników będą w systemie?** + - Reklamodawcy (szukający miejsc reklamowych) + - Właściciele miejsc reklamowych (oferujący miejsca) + - Administratorzy systemu + - Moderatorzy/weryfikatorzy ofert + - Inne role? + +2. **Właściciele miejsc reklamowych:** + - Kim są (firmy outdoor, właściciele nieruchomości, gminy, osoby prywatne)? + - Czy wymagana jest weryfikacja/licencja do oferowania miejsc reklamowych? + - Jakie dokumenty muszą dostarczyć (pozwolenia, własność nieruchomości)? + +3. **Reklamodawcy:** + - Kim są (agencje reklamowe, firmy, osoby prywatne)? + - Czy wymagana jest rejestracja firmowa czy może być prywatna? + - Jakie limity/ograniczenia dla różnych typów reklamodawców? + +--- + +## BLOK 2: FUNKCJONALNOŚĆ WYSZUKIWANIA I MAPOWANIE + +### 2.1 System wyszukiwania +4. **Jak dokładnie ma działać wyszukiwanie lokalizacji?** + - Wpisywanie adresu/nazwy ulicy + - Wskazywanie na mapie + - Wyszukiwanie po kodzie pocztowym + - Wyszukiwanie tras (punkt A do punktu B) + - Wyszukiwanie w promieniu X km od punktu + +5. **Zasięg i precyzja:** + - Jaki domyślny zasięg wyszukiwania? + - Czy możliwość zmiany zasięgu przez użytkownika? + - Jak precyzyjnie lokalizować miejsca (współrzędne GPS)? + +### 2.2 Filtry i kategorie +6. **Jakie filtry wyszukiwania są potrzebne?** + - Typ miejsca reklamowego (billboard, citylight, LED, plakat, inne) + - Rozmiar/format reklamy + - Zakres cenowy + - Okres dostępności (od-do) + - Natężenie ruchu/lokalizacja (centrum, przedmieścia, trasa krajowa) + - Orientacja (północ, południe, wschód, zachód) + - Oświetlenie (podświetlane/niepoświetlane) + +7. **Kategoryzacja miejsc reklamowych:** + - Jakie główne kategorie miejsc reklamowych? + - Czy podział na miasto/trasy krajowe/autostrady? + - Czy różne cenniki dla różnych kategorii? + +--- + +## BLOK 3: PROCES BIZNESOWY I REZERWACJA + +### 3.1 Proces rezerwacji +8. **Jak ma wyglądać proces rezerwacji miejsca?** + - Natychmiastowa rezerwacja czy proces aplikacyjny? + - Czy możliwość rezerwacji na konkretne daty? + - Minimalne/maksymalne okresy wynajmu? + - Czy możliwość przedłużania rezerwacji? + +9. **Zatwierdzanie ofert:** + - Czy automatyczne zatwierdzanie czy wymagana akceptacja właściciela? + - Jaki czas na odpowiedź właściciela? + - Co się dzieje przy braku odpowiedzi? + +### 3.2 Płatności i rozliczenia +10. **System płatności:** + - Jakie metody płatności (karta, przelew, BLIK, PayPal)? + - Płatność z góry czy możliwość płatności po okresie? + - Czy system depozytów/kaucji? + - Prowizja platformy - ile % od transakcji? + +11. **Faktury i dokumentacja:** + - Czy automatyczne generowanie faktur? + - Dokumenty umowne - standardowe czy negocjowalne? + - Kto wystawia faktury (platforma czy właściciel miejsca)? + +--- + +## BLOK 4: ZARZĄDZANIE OFERTAMI I TREŚCIĄ + +### 4.1 Dodawanie ofert przez właścicieli +12. **Jakie informacje wymagane przy dodawaniu miejsca reklamowego?** + - Dokładna lokalizacja (adres + GPS) + - Zdjęcia miejsca (ile minimum/maksimum?) + - Wymiary dokładne + - Cena za okres (dzień/tydzień/miesiąc?) + - Opis i dodatkowe informacje + - Dostępność (kalendarz) + +13. **Weryfikacja ofert:** + - Czy automatyczna publikacja czy moderacja? + - Kto weryfikuje prawdziwość ofert? + - Jakie konsekwencje za fałszywe oferty? + +### 4.2 Materiały reklamowe +14. **Obsługa materiałów reklamowych:** + - Czy platforma obsługuje przesyłanie projektów reklam? + - Jakie formaty plików (PDF, AI, PSD, JPG)? + - Kto odpowiada za montaż fizyczny reklamy? + - Czy platforma oferuje usługi projektowania? + - Czy wymagane zatwierdzanie treści reklam? + +--- + +## BLOK 5: PANEL UŻYTKOWNIKA I FUNKCJE + +### 5.1 Panel właściciela miejsc +15. **Funkcje dla właścicieli:** + - Zarządzanie swoimi ofertami + - Kalendarz dostępności + - Historia rezerwacji i zarobków + - Komunikacja z reklamodawcami + - Statystyki wyświetleń oferty + +### 5.2 Panel reklamodawcy +16. **Funkcje dla reklamodawców:** + - Historia wynajmów + - Zarządzanie aktywnymi kampaniami + - Ulubione miejsca/watchlista + - Powiadomienia o nowych ofertach w interesujących lokalizacjach + - Narzędzia do planowania kampanii + +--- + +## BLOK 6: FUNKCJE TECHNICZNE I INTEGRACJE + +### 6.1 Mapy i geolokalizacja +17. **Integracja z mapami:** + - Jaki dostawca map (Google Maps, OpenStreetMap)? + - Czy potrzebne zdjęcia satelitarne/Street View? + - Czy możliwość mierzenia odległości na mapie? + - Czy informacje o natężeniu ruchu? + +### 6.2 Funkcje dodatkowe +18. **System powiadomień:** + - Email, SMS, push notifications? + - O czym powiadamiać (nowe oferty, zakończenie wynajmu, płatności)? + +19. **Raportowanie i analityka:** + - Czy właściciele potrzebują statystyk (wyświetlenia, zapytania)? + - Czy reklamodawcy potrzebują raportów efektywności? + - Czy pomiar ruchu/reach kampanii? + +--- + +## BLOK 7: ASPEKTY PRAWNE I BEZPIECZEŃSTWO + +### 7.1 Regulacje prawne +20. **Aspekty prawne:** + - Czy weryfikacja pozwoleń na reklamę zewnętrzną? + - Jak obsłużyć różne przepisy w różnych miastach? + - Odpowiedzialność za zgodność z prawem - kto ponosi? + +### 7.2 Bezpieczeństwo i weryfikacja +21. **Weryfikacja użytkowników:** + - Jak weryfikować tożsamość właścicieli miejsc? + - Czy wymagane dokumenty firmowe? + - System opinii/ocen użytkowników? + +--- + +## BLOK 8: MODEL BIZNESOWY I SKALOWANIE + +### 8.1 Monetyzacja +22. **Model przychodów:** + - Prowizja od transakcji - ile %? + - Opłaty miesięczne za konto premium? + - Opłaty za promowanie ofert? + - Inne źródła przychodów? + +### 8.2 Zasięg geograficzny +23. **Skalowanie geograficzne:** + - Rozpoczęcie od jednego miasta czy od razu cała Polska? + - Plany ekspansji międzynarodowej? + - Jak obsłużyć różne waluty i języki? + +--- + +**INSTRUKCJA:** Proszę przejrzeć wszystkie bloki pytań i odpowiedzieć na te, które uważasz za najważniejsze dla rozpoczęcia projektu. Możemy również omawiać je blok po bloku. \ No newline at end of file