Przypadki użycia — Zarządzanie nieruchomościami
UC-01 — Rejestracja nowej inwestycji (budynku) wraz z zasobami
- Aktor: Zarządzający nieruchomościami
- Warunek wstępny: użytkownik ma uprawnienia „Kierownik” (
group_real_estate_manager). - Przepływ główny:
- Użytkownik otwiera menu Nieruchomości → Budynki.
- Użytkownik tworzy nowy budynek, podaje nazwę inwestycji i adres (rekord
res.partner). - Użytkownik dodaje dokumenty inwestycji (
ir.attachment). - Użytkownik dodaje mieszkania, miejsca parkingowe i komórki lokatorskie do budynku.
- Użytkownik zapisuje rekord.
- Warunek końcowy: Budynek jest widoczny w systemie z policzoną liczbą mieszkań, miejsc parkingowych, komórek i notatek.
UC-02 — Wprowadzenie mieszkania na sprzedaż z automatyczną kalkulacją ceny
- Aktor: Zarządzający nieruchomościami
- Warunek wstępny: Istnieje budynek (inwestycja).
- Przepływ główny:
- Użytkownik otwiera Nieruchomości → Mieszkania.
- Użytkownik tworzy mieszkanie, przypisuje je do inwestycji oraz podaje nr, piętro, liczbę pokoi, powierzchnię, balkon/taras/ogród.
- Użytkownik wprowadza cenę bazową oraz ceny miejsca parkingowego i komórki lokatorskiej.
- System automatycznie wylicza cenę całkowitą (
base_price + parking_slot_price + storage_room_price). - Użytkownik ustawia status (np. „Na sprzedaż”).
- Warunek końcowy: Mieszkanie widnieje w ofercie z poprawnie wyliczoną ceną całkowitą i pełną specyfikacją.
UC-03 — Rezerwacja mieszkania przez klienta
- Aktor: Pracownik sprzedaży
- Warunek wstępny: Mieszkanie ma status „Na sprzedaż”; klient istnieje w bazie.
- Przepływ główny:
- Pracownik otwiera Nieruchomości → Płatności.
- Pracownik tworzy płatność/rezerwację dla mieszkania i klienta, podaje kwotę i termin.
- Pracownik klika Potwierdź.
- System zmienia status mieszkania na „Zarezerwowane” i przypisuje klienta do mieszkania.
- Warunek końcowy: Mieszkanie jest zarezerwowane, klient powiązany z mieszkaniem, płatność ma status „Zrealizowana”.
UC-04 — Sprzedaż mieszkania (przejście do „W trakcie sprzedaży” i „Sprzedane”)
- Aktor: Pracownik sprzedaży
- Warunek wstępny: Mieszkanie ma status „Zarezerwowane”.
- Przepływ główny:
- Pracownik tworzy kolejną płatność dla mieszkania.
- Pracownik klika Potwierdź.
- System przesuwa status na „W trakcie sprzedaży”.
- Po finalizacji (kolejne potwierdzenie / przycisk) status zmienia się na „Sprzedane”.
- Warunek końcowy: Mieszkanie oznaczone jako sprzedane, z pełną historią płatności i przypisanych klientów.
UC-05 — Dodanie współkupujących do jednego mieszkania
- Aktor: Pracownik sprzedaży
- Warunek wstępny: Mieszkanie istnieje; klienci są w bazie.
- Przepływ główny:
- Pracownik otwiera mieszkanie.
- Pracownik dodaje wielu klientów do pola Klienci (relacja Many2many).
- Dla osób niebędących małżeństwem pracownik ustawia relację „Partner / Partnerka”.
- Pracownik zapisuje.
- Warunek końcowy: Jedno mieszkanie ma wielu współwłaścicieli, widocznych na liście klientów mieszkania.
UC-06 — Dodanie członka rodziny / powiązania rodzinnego
- Aktor: Pracownik sprzedaży
- Warunek wstępny: Dwóch klientów istnieje w bazie.
- Przepływ główny:
- Pracownik otwiera kartę klienta.
- Pracownik klika „Dodaj członka rodziny”.
- W kreatorze (
real_estate.add_family.wizard) pracownik wybiera członka rodziny i rodzaj pokrewieństwa (małżeństwo, dziecko, rodzic, wnuk, partner). - Pracownik klika Dodaj.
- System tworzy relację w obie strony (np. rodzic ↔ dziecko) automatycznie.
- Warunek końcowy: Klienci są powiązani relacją rodzinną w obu kierunkach; system blokuje powiązanie klienta z samym sobą.
UC-07 — Rejestracja płatności ratalnych i monitoring przeterminowanych płatności
- Aktor: Pracownik sprzedaży + System (cron)
- Warunek wstępny: Istnieją płatności z terminem.
- Przepływ główny:
- Pracownik rejestruje raty jako płatności podrzędne względem płatności nadrzędnej.
- Codzienny cron (
_cron_notify_overdue_payments) sprawdza płatności niezrealizowane z minionym terminem. - System tworzy aktywność „Krytyczna” dla takich płatności.
- System wysyła e-mail do klienta z przypomnieniem o zaległej płatności (szablon
email_template_overdue_payment). - Przypomnienie jest idempotentne — flaga
overdue_email_sentzapobiega powtarzaniu; resetuje się, gdy płatność przestaje być zaległa.
- Warunek końcowy: Pracownik/zarządzający widzi przeterminowane płatności jako krytyczne zadania, klient otrzymuje e-mail z przypomnieniem.
UC-08 — Przekazanie mieszkania (handover)
- Aktor: Pracownik sprzedaży
- Warunek wstępny: Mieszkanie ma status „Sprzedane”.
- Przepływ główny:
- Pracownik otwiera mieszkanie.
- Pracownik klika „Oznacz jako przekazane”.
- System ustawia status „Przekazane”, wpisuje datę przekazania.
- System planuje aktywność follow-up (za 30 dni, poziom „Średnia”).
- System otwiera kreator e-mail z szablonem przekazania (
email_template_handover). - Pracownik przegląda treść i wysyła wiadomość do klientów.
- Warunek końcowy: Mieszkanie oznaczone jako przekazane, klient otrzyma e-mail, pracownik ma zadanie follow-up.
UC-09 — Rejestracja i obsługa zgłoszenia (obsługa posprzedażowa)
- Aktor: Pracownik obsługi klienta
- Warunek wstępny: Klient istnieje w bazie.
- Przepływ główny:
- Pracownik otwiera Nieruchomości → Obsługa klienta → Zgłoszenia.
- Pracownik tworzy nowe zgłoszenie: tytuł, typ (pytanie/usterka/reklamacja/dokument/płatność/przekazanie/inne), priorytet.
- Pracownik wybiera klienta (wymagane) i opcjonalnie mieszkanie (inwestycja wyliczana automatycznie).
- Pracownik podaje opis i termin.
- Pracownik obsługuje zgłoszenie przyciskami: W trakcie → Oczekuje na klienta → Rozwiązane → Zamknięte.
- System automatycznie ustawia
resolved_atprzy rozwiązaniu iclosed_atprzy zamknięciu (czyszczone przy ponownym otwarciu).
- Warunek końcowy: Zgłoszenie ma pełny cykl życia z automatycznymi znacznikami czasu. Licznik widoczny na karcie klienta i mieszkania.
UC-10 — Wysłanie e-mail do klienta
- Aktor: Pracownik sprzedaży
- Warunek wstępny: Klient ma podany adres e-mail; skonfigurowany serwer SMTP.
- Przepływ główny:
- Pracownik otwiera kartę klienta (lub mieszkania, lub płatności).
- Pracownik klika „Wyślij e-mail”.
- System otwiera kreator
mail.compose.messagez wypełnioną treścią ze szablony. - Pracownik może edytować treść przed wysłaniem.
- Pracownik klika Wyślij.
- Warunek końcowy: Klient otrzymuje e-mail. Wiadomość widoczna w historii (chatter) rekordu.
- Szablony: potwierdzenie płatności, przypomnienie o zaległości, zmiana statusu mieszkania, przekazanie, ogólna wiadomość.
UC-11 — Generowanie danych testowych (symulator)
- Aktor: Administrator / Kierownik
- Warunek wstępny: Zainstalowany moduł
real_estate_simulatror_module; istnieją szablony budynków i klientów. - Przepływ główny:
- Użytkownik tworzy symulację i dodaje scenariusz.
- Użytkownik wybiera tryb: tylko inwestycje / tylko klienci / pełny przepływ sprzedaży.
- Użytkownik ustawia parametry (liczba budynków, mieszkań, klientów, opóźnienia).
- Użytkownik klika Uruchom symulację.
- System automatycznie tworzy rekordy: budynki, mieszkania, miejsca parkingowe, komórki, klienci, relacje rodzinne, płatności.
- Warunek końcowy: System zawiera realistyczne dane testowe gotowe do pracy lub prezentacji.
Odwołane pliki
addons/real_estate_module/models/building.py— UC-01 (inwestycja, zasoby, liczniki)addons/real_estate_module/models/apartment.py— UC-02, UC-03, UC-04, UC-05, UC-08 (cykl życia, kalkulacja ceny, rezerwacja, współkupujący, przekazanie)addons/real_estate_module/models/parking_slot.py,addons/real_estate_module/models/storage_room.py— UC-01, UC-02 (miejsca parkingowe, komórki lokatorskie)addons/real_estate_module/models/client.py— UC-05, UC-06, UC-10 (klienci, współkupujący, rodzina, e-mail)addons/real_estate_module/models/family_relationship.py— UC-06 (dwukierunkowe pokrewieństwo)addons/real_estate_module/models/payment.py— UC-03, UC-04, UC-07, UC-10 (płatność,confirm(), cron przeterminowanych płatności + e-mail)addons/real_estate_module/models/customer_care_request.py— UC-09 (zgłoszenia obsługi klienta)addons/real_estate_module/wizards/add_family_wizard.py— UC-06 (kreator „Dodaj członka rodziny”)addons/real_estate_module/data/cron.xml,addons/real_estate_module/data/activity_types.xml— UC-07 (cron i typy aktywności)addons/real_estate_module/data/email_templates.xml— UC-07, UC-08, UC-10 (szablony e-mail)addons/real_estate_module/security/groups.xml— role: Sprzedaż / Kierownik / Administratoraddons/real_estate_simulatror_module/models/— UC-11 (symulator: config, scenario, building, client)