#Szczegółowy projekt systemu CRM 2.0

#1. Przegląd systemu i filozofia projektowania

#1.1 Pozycjonowanie systemu

Niniejszy system to platforma zarządzania sprzedażą CRM 2.0 zbudowana w oparciu o platformę bezkodową NocoBase. Głównym celem jest:

Pozwól handlowcom skupić się na budowaniu relacji z klientami, a nie na wprowadzaniu danych i powtarzalnych analizach.

System automatyzuje rutynowe zadania poprzez przepływy pracy i wykorzystuje AI do pomocy w punktacji leadów, analizie szans sprzedaży oraz innych zadaniach, pomagając zespołom sprzedaży zwiększyć efektywność.

#1.2 Filozofia projektowania

#Filozofia 1: Pełny lejek sprzedaży

Kompleksowy proces sprzedaży:

Dlaczego zaprojektowano to w ten sposób?

#Filozofia 2: Konfigurowalny lejek sprzedaży

Różne branże mogą dostosowywać etapy lejka sprzedaży bez modyfikowania kodu.

#Filozofia 3: Budowa modułowa

• Moduły podstawowe (Klienci + Szanse sprzedaży) są obowiązkowe; inne moduły można włączyć w zależności od potrzeb.
• Wyłączenie modułów nie wymaga zmian w kodzie; odbywa się to poprzez konfigurację interfejsu NocoBase.
• Każdy moduł jest zaprojektowany niezależnie, aby zmniejszyć powiązania (coupling).

#2. Architektura modułów i personalizacja

#2.1 Przegląd modułów

System CRM przyjmuje architekturę modułową — każdy moduł może być niezależnie włączony lub wyłączony w zależności od wymagań biznesowych.

#2.2 Zależności między modułami

#2.3 Wstępnie skonfigurowane wersje

#2.4 Mapowanie modułów na kolekcje

#Kolekcje modułów podstawowych (zawsze wymagane)

#2.5 Jak wyłączyć moduły

Wystarczy ukryć wpis w menu dla danego modułu w interfejsie administracyjnym NocoBase; nie ma potrzeby modyfikowania kodu ani usuwania kolekcji.

#3. Kluczowe encje i model danych

#3.1 Przegląd relacji encji

#3.2 Szczegóły kluczowych kolekcji

#3.2.1 Leady (nb_crm_leads)

Zarządzanie leadami przy użyciu uproszczonego 4-etapowego przepływu pracy.

Proces etapowy:

Nowy → W toku → Zweryfikowany → Przekonwertowany na klienta/szansę
         ↓          ↓
   Niezakwalifikowany Niezakwalifikowany

Kluczowe pola:

#3.2.2 Klienci (nb_crm_customers)

Zarządzanie klientami/firmami wspierające handel międzynarodowy.

Kluczowe pola:

#3.2.3 Szanse sprzedaży (nb_crm_opportunities)

Zarządzanie szansami sprzedaży z konfigurowalnymi etapami lejka.

Kluczowe pola:

#3.2.4 Oferty (nb_crm_quotations)

Zarządzanie ofertami wspierające wiele walut i przepływy pracy zatwierdzania.

Przepływ statusów:

Szkic → Oczekuje na zatwierdzenie → Zatwierdzona → Wysłana → Zaakceptowana/Odrzucona/Wygasła
              ↓
           Odrzucona → Edycja → Szkic

Kluczowe pola:

#3.2.5 Zamówienia (nb_crm_orders)

Zarządzanie zamówieniami wraz ze śledzeniem płatności.

Kluczowe pola:

#3.3 Podsumowanie kolekcji

#Kolekcje biznesowe CRM

#Kolekcje danych podstawowych (moduły wspólne)

#3.4 Kolekcje pomocnicze

#3.4.1 Komentarze (nb_crm_comments)

Ogólna kolekcja komentarzy/notatek, którą można powiązać z różnymi obiektami biznesowymi.

#3.4.2 Udostępnianie klientów (nb_crm_customer_shares)

Umożliwia współpracę wielu osób i udostępnianie uprawnień do klientów.

#3.4.3 Współpracownicy szansy (nb_crm_opportunity_users)

Wspiera współpracę zespołu sprzedaży nad szansami sprzedaży.

#3.4.4 Regiony (nb_cbo_regions)

Słownik danych podstawowych krajów/regionów.

#4. Cykl życia leadu

Zarządzanie leadami wykorzystuje uproszczony 4-etapowy przepływ pracy. Po utworzeniu nowego leadu przepływ pracy może automatycznie wyzwolić punktację AI, aby pomóc handlowcom szybko zidentyfikować leady wysokiej jakości.

#4.1 Definicje statusów

#4.2 Schemat blokowy statusów

#4.3 Proces konwersji leadu

Interfejs konwersji oferuje jednocześnie trzy opcje; użytkownicy mogą wybrać utworzenie lub powiązanie:

• Klient: Utwórz nowego klienta LUB powiąż z istniejącym klientem.
• Kontakt: Utwórz nowy kontakt (powiązany z klientem).
• Szansa sprzedaży: Szansa sprzedaży musi zostać utworzona.

Rekordy po konwersji:

• converted_customer_id: ID powiązanego klienta
• converted_contact_id: ID powiązanego kontaktu
• converted_opportunity_id: ID utworzonej szansy sprzedaży

#5. Cykl życia szansy sprzedaży

Zarządzanie szansami sprzedaży wykorzystuje konfigurowalne etapy lejka sprzedaży. Gdy etap szansy ulegnie zmianie, może to automatycznie wyzwolić przewidywanie prawdopodobieństwa wygranej przez AI, aby pomóc handlowcom zidentyfikować ryzyka i okazje.

#5.1 Konfigurowalne etapy

Etapy są przechowywane w kolekcji nb_crm_opportunity_stages i mogą być dostosowywane:

#5.2 Przepływ lejka

#5.3 Wykrywanie stagnacji

Szanse sprzedaży bez aktywności zostaną oznaczone:

-- Oblicz dni stagnacji
UPDATE nb_crm_opportunities
SET stagnant_days = EXTRACT(DAY FROM NOW() - last_activity_at)
WHERE stage NOT IN ('won', 'lost');

#5.4 Obsługa wygranej/przegranej

W przypadku wygranej:

1. Zaktualizuj etap na 'won'.
2. Zapisz faktyczną datę zamknięcia.
3. Zaktualizuj status klienta na 'active'.
4. Wyzwól utworzenie zamówienia (jeśli oferta została zaakceptowana).

W przypadku przegranej:

1. Zaktualizuj etap na 'lost'.
2. Zapisz powód utraty.
3. Zapisz ID konkurenta (jeśli przegrano z konkurencją).
4. Powiadom menedżera.

#6. Cykl życia oferty

#6.1 Definicje statusów

#6.2 Zasady zatwierdzania (do ustalenia)

Przepływy pracy zatwierdzania są wyzwalane na podstawie następujących warunków:

#6.3 Obsługa wielu walut

#Filozofia projektowania

Używaj USD jako jednolitej waluty bazowej dla wszystkich raportów i analiz. Każdy rekord kwoty przechowuje:

• Oryginalną walutę i kwotę (to, co widzi klient)
• Kurs wymiany w momencie transakcji
• Równowartość w USD (do porównań wewnętrznych)

#Słownik walut (nb_cbo_currencies)

Konfiguracja walut wykorzystuje wspólną kolekcję danych podstawowych, wspierając dynamiczne zarządzanie. Pole current_rate przechowuje aktualny kurs wymiany, aktualizowany przez zaplanowane zadanie na podstawie najnowszego rekordu w nb_crm_exchange_rates.

#Historia kursów walut (nb_crm_exchange_rates)

Rejestruje historyczne dane kursów walut. Zaplanowane zadanie synchronizuje najnowsze kursy z nb_cbo_currencies.current_rate.

Uwaga: Oferty są powiązane z kolekcją nb_cbo_currencies poprzez klucz obcy currency_id, a kurs wymiany jest pobierany bezpośrednio z pola current_rate. Szanse sprzedaży i zamówienia używają pola VARCHAR currency do przechowywania kodu waluty.

#Wzorzec pola kwoty

Kolekcje zawierające kwoty postępują zgodnie z tym wzorcem:

Zastosowano w:

• nb_crm_opportunities.amount → amount_usd
• nb_crm_quotations.total_amount → total_amount_usd

#Integracja z przepływem pracy

Logika pobierania kursu wymiany:

1. Pobierz kurs wymiany bezpośrednio z nb_cbo_currencies.current_rate podczas operacji biznesowych.
2. Transakcje w USD: Kurs = 1.0, wyszukiwanie nie jest wymagane.
3. current_rate jest synchronizowany przez zaplanowane zadanie z najnowszego rekordu nb_crm_exchange_rates.

#6.4 Zarządzanie wersjami

Gdy oferta zostanie odrzucona lub wygaśnie, można ją powielić jako nową wersję:

QT-20260119-001 v1 → Odrzucona
QT-20260119-001 v2 → Wysłana
QT-20260119-001 v3 → Zaakceptowana

#7. Cykl życia zamówienia

#7.1 Przegląd zamówienia

Zamówienia są tworzone po zaakceptowaniu oferty, reprezentując potwierdzone zobowiązanie biznesowe.

#7.2 Definicje statusów zamówienia

#7.3 Model danych zamówienia

#nb_crm_orders

#nb_crm_order_items

#7.4 Śledzenie płatności

#nb_crm_payments

#8. Cykl życia klienta

#8.1 Przegląd klienta

Klienci są tworzeni podczas konwersji leadu lub po wygraniu szansy sprzedaży. System śledzi pełny cykl życia od pozyskania do rzecznictwa (advocacy).

#8.2 Definicje statusów klienta

#8.3 Punktacja kondycji klienta (Health Scoring)

Kondycja klienta jest obliczana na podstawie wielu czynników:

Progi kondycji:

if (health_score >= 90) status = 'advocate';
else if (health_score >= 70) status = 'active';
else if (health_score >= 50) status = 'growing';
else status = 'at_risk';

#8.4 Segmentacja klientów

#Zautomatyzowana segmentacja

#9. Integracja z e-mail

#9.1 Przegląd

NocoBase zapewnia wbudowaną wtyczkę integracji e-mail wspierającą Gmail i Outlook. Po zsynchronizowaniu e-maili przepływy pracy mogą automatycznie wyzwalać analizę AI nastrojów i intencji wiadomości, pomagając handlowcom szybko zrozumieć nastawienie klienta.

#9.2 Synchronizacja e-mail

Wspierani dostawcy:

• Gmail (przez OAuth 2.0)
• Outlook/Microsoft 365 (przez OAuth 2.0)

Zachowanie synchronizacji:

• Dwukierunkowa synchronizacja wysłanych i odebranych wiadomości.
• Automatyczne powiązanie e-maili z rekordami CRM (Leady, Kontakty, Szanse sprzedaży).
• Załączniki przechowywane w systemie plików NocoBase.

#9.3 Powiązanie E-mail-CRM (do ustalenia)

#9.4 Szablony e-mail

Handlowcy mogą korzystać z gotowych szablonów:

#10. Możliwości wspomagane przez AI

#10.1 Zespół pracowników AI

System CRM integruje wtyczkę NocoBase AI, wykorzystując następujących wbudowanych pracowników AI skonfigurowanych do zadań specyficznych dla CRM:

#10.2 Lista zadań AI

Możliwości AI są podzielone na dwie niezależne kategorie:

#I. Pracownicy AI (wyzwalani przez bloki interfejsu)

Użytkownicy wchodzą w bezpośrednią interakcję z AI poprzez bloki "Pracownik AI" w interfejsie, aby uzyskać analizy i sugestie.

#II. Węzły LLM w przepływie pracy (automatyczne wykonanie w tle)

Węzły LLM osadzone w przepływach pracy, wyzwalane automatycznie przez zdarzenia kolekcji, zdarzenia akcji lub zaplanowane zadania, niezależnie od Pracowników AI.

Uwaga: Węzły LLM w przepływie pracy używają promptów i schematów wyjściowych dla strukturalnego formatu JSON, który jest analizowany i zapisywany w polach danych biznesowych bez interwencji użytkownika.

#10.3 Pola AI w bazie danych

#11. Silnik przepływu pracy

#11.1 Zaimplementowane przepływy pracy

#11.2 Przepływy pracy do zaimplementowania

#12. Projekt menu i interfejsu

#12.1 Struktura administracyjna

#12.2 Widoki pulpitów nawigacyjnych

#Widok menedżera sprzedaży

#Widok przedstawiciela handlowego

#Widok dyrektorski

Wersja dokumentu: v2.0 | Aktualizacja: 2026-02-06