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:
    1. Użytkownik otwiera menu Nieruchomości → Budynki.
    2. Użytkownik tworzy nowy budynek, podaje nazwę inwestycji i adres (rekord res.partner).
    3. Użytkownik dodaje dokumenty inwestycji (ir.attachment).
    4. Użytkownik dodaje mieszkania, miejsca parkingowe i komórki lokatorskie do budynku.
    5. 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:
    1. Użytkownik otwiera Nieruchomości → Mieszkania.
    2. Użytkownik tworzy mieszkanie, przypisuje je do inwestycji oraz podaje nr, piętro, liczbę pokoi, powierzchnię, balkon/taras/ogród.
    3. Użytkownik wprowadza cenę bazową oraz ceny miejsca parkingowego i komórki lokatorskiej.
    4. System automatycznie wylicza cenę całkowitą (base_price + parking_slot_price + storage_room_price).
    5. 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:
    1. Pracownik otwiera Nieruchomości → Płatności.
    2. Pracownik tworzy płatność/rezerwację dla mieszkania i klienta, podaje kwotę i termin.
    3. Pracownik klika Potwierdź.
    4. 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:
    1. Pracownik tworzy kolejną płatność dla mieszkania.
    2. Pracownik klika Potwierdź.
    3. System przesuwa status na „W trakcie sprzedaży”.
    4. 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:
    1. Pracownik otwiera mieszkanie.
    2. Pracownik dodaje wielu klientów do pola Klienci (relacja Many2many).
    3. Dla osób niebędących małżeństwem pracownik ustawia relację „Partner / Partnerka”.
    4. 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:
    1. Pracownik otwiera kartę klienta.
    2. Pracownik klika „Dodaj członka rodziny”.
    3. W kreatorze (real_estate.add_family.wizard) pracownik wybiera członka rodziny i rodzaj pokrewieństwa (małżeństwo, dziecko, rodzic, wnuk, partner).
    4. Pracownik klika Dodaj.
    5. 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:
    1. Pracownik rejestruje raty jako płatności podrzędne względem płatności nadrzędnej.
    2. Codzienny cron (_cron_notify_overdue_payments) sprawdza płatności niezrealizowane z minionym terminem.
    3. System tworzy aktywność „Krytyczna” dla takich płatności.
    4. System wysyła e-mail do klienta z przypomnieniem o zaległej płatności (szablon email_template_overdue_payment).
    5. Przypomnienie jest idempotentne — flaga overdue_email_sent zapobiega 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:
    1. Pracownik otwiera mieszkanie.
    2. Pracownik klika „Oznacz jako przekazane”.
    3. System ustawia status „Przekazane”, wpisuje datę przekazania.
    4. System planuje aktywność follow-up (za 30 dni, poziom „Średnia”).
    5. System otwiera kreator e-mail z szablonem przekazania (email_template_handover).
    6. 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:
    1. Pracownik otwiera Nieruchomości → Obsługa klienta → Zgłoszenia.
    2. Pracownik tworzy nowe zgłoszenie: tytuł, typ (pytanie/usterka/reklamacja/dokument/płatność/przekazanie/inne), priorytet.
    3. Pracownik wybiera klienta (wymagane) i opcjonalnie mieszkanie (inwestycja wyliczana automatycznie).
    4. Pracownik podaje opis i termin.
    5. Pracownik obsługuje zgłoszenie przyciskami: W trakcie → Oczekuje na klienta → Rozwiązane → Zamknięte.
    6. System automatycznie ustawia resolved_at przy rozwiązaniu i closed_at przy 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:
    1. Pracownik otwiera kartę klienta (lub mieszkania, lub płatności).
    2. Pracownik klika „Wyślij e-mail”.
    3. System otwiera kreator mail.compose.message z wypełnioną treścią ze szablony.
    4. Pracownik może edytować treść przed wysłaniem.
    5. 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:
    1. Użytkownik tworzy symulację i dodaje scenariusz.
    2. Użytkownik wybiera tryb: tylko inwestycje / tylko klienci / pełny przepływ sprzedaży.
    3. Użytkownik ustawia parametry (liczba budynków, mieszkań, klientów, opóźnienia).
    4. Użytkownik klika Uruchom symulację.
    5. 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 / Administrator
  • addons/real_estate_simulatror_module/models/ — UC-11 (symulator: config, scenario, building, client)