AlphaCRM — Dokumentacja techniczna
AlphaCRM to aplikacja SaaS do zarządzania relacjami z klientami, zaprojektowana specjalnie dla polskich firm B2B. Zbudowana na nowoczesnym stosie technologicznym z naciskiem na bezpieczeństwo danych, zgodność z polskim prawem i prostotę obsługi.
Frontend Next.js 14 (App Router)Backend Supabase (PostgreSQL)Auth Supabase Auth (cookies)Hosting VercelPłatności StripeStyl Tailwind CSS⚡ Szybki start
Od rejestracji do pierwszego kontaktu w mniej niż 5 minut.
🏗️ Architektura
┌─────────────────────────────────────────────┐
│ Przeglądarka (Next.js) │
│ App Router · Server Components · Tailwind │
└────────────────────┬────────────────────────┘
│ HTTP / cookies
┌────────────────────▼────────────────────────┐
│ Supabase (Backend) │
│ ┌──────────────┐ ┌──────────────────────┐ │
│ │ PostgreSQL │ │ Supabase Auth │ │
│ │ + RLS │ │ (email/password) │ │
│ └──────────────┘ └──────────────────────┘ │
└────────────────────┬────────────────────────┘
│
┌──────────▼──────────┐
│ Zewnętrzne API │
│ GUS · CEIDG · KSeF │
└─────────────────────┘
Tabele bazy danych
| Tabela | Opis | Kluczowe pola |
|---|---|---|
profiles |
Użytkownicy i ich plan | id, org_id, role, plan |
organizations |
Dane organizacji | id, name, nip, address |
contacts |
Kontakty B2B | id, org_id, name, nip, email, phone, tags |
deals |
Szanse sprzedażowe | id, org_id, contact_id, stage, value, owner_id |
invitations |
Zaproszenia do org. | id, org_id, email, role, invited_by, status |
👤 Moduł: Kontakty
Centralna baza firm i osób kontaktowych. Każdy kontakt należy do organizacji (izolacja danych przez RLS Supabase).
Pola kontaktu
name Nazwa / pełne imięnip NIP (opcjonalny)email Adres emailphone Telefoncompany Nazwa firmytags Tagi (tablica)notes Notatki (rich text)created_at Data dodania🎯 Moduł: Pipeline
Wizualny pipeline Kanban do zarządzania szansami sprzedażowymi. Każda szansa (deal) powiązana jest z kontaktem i posiada etap, wartość oraz właściciela.
Domyślne etapy
Etapy można dostosować w ustawieniach organizacji. Kolejność określa się przez drag & drop w panelu ustawień.
👥 Moduł: Zespół & Role
| Rola | Kontakty | Pipeline | Ustawienia | Zapraszanie |
|---|---|---|---|---|
| Admin | ✓ pełny | ✓ pełny | ✓ | ✓ (tylko Pro) |
| Member | ✓ pełny | ✓ pełny | ✗ | ✗ |
📊 Import / Eksport
Import CSV
Plik CSV musi zawierać nagłówki w pierwszym wierszu. Obsługiwane separatory: , i ;
name,email,phone,company,nip,tags Jan Kowalski,jan@firma.pl,+48600000001,Firma ABC,1234567890,"klient,vip" Anna Nowak,anna@xyz.pl,+48601000002,XYZ Sp. z o.o.,,prospect
Eksport danych
Eksport dostępny w dowolnym momencie z poziomu Ustawienia → Dane → Eksportuj. Dostępne formaty: CSV i JSON. Eksport obejmuje kontakty, deale i notatki.
🏢 Integracja NIP / GUS / CEIDG
Po wpisaniu numeru NIP w formularzu kontaktu lub organizacji, AlphaCRM automatycznie odpytuje publiczne API GUS (REGON) i CEIDG w celu uzupełnienia danych firmy.
Pobierane dane
🔒 RODO
AlphaCRM przetwarza dane osobowe w rozumieniu RODO. Dane przechowywane są na serwerach w Unii Europejskiej (region Supabase: eu-central-1).
- Każda organizacja posiada izolowany kontener danych (Row Level Security)
- Eksport danych na żądanie — art. 20 RODO (przenoszalność)
- Usunięcie konta usuwa wszystkie dane powiązane z organizacją
- Logi dostępu przechowywane przez 90 dni
🧾 Integracja KSeF
Integracja z Krajowym Systemem e-Faktur umożliwi wysyłanie faktur ustrukturyzowanych (FA(2)) bezpośrednio z AlphaCRM, bez konieczności logowania do portalu KSeF.
💳 Plany & Limity
| Funkcja | Solo — 29 zł/mies. | Pro — 23 zł/user/mies. |
|---|---|---|
| Użytkownicy | 1 | Nieograniczeni |
| Kontakty | 500 | Nieograniczone |
| Zaproszenia | ✗ | ✓ |
| Pipeline Kanban | ✓ | ✓ |
| Auto-NIP | ✓ | ✓ |
| Import / Eksport CSV | ✓ | ✓ |
| KSeF (wkrótce) | ✓ | ✓ |
🛡️ Bezpieczeństwo
- Row Level Security (RLS) — każde zapytanie SQL jest automatycznie filtrowane przez
org_idaktualnego użytkownika - Auth via cookies HTTP-only — tokeny sesji nie są dostępne przez JavaScript
- Walidacja po stronie serwera — wszystkie operacje krytyczne (zaproszenia, plan) weryfikowane w Next.js API routes, nie tylko w UI
- HTTPS everywhere — TLS 1.3, HSTS
- Dane w UE — serwery Supabase w regionie eu-central-1 (Frankfurt)