CRM – Komisja ds. Współprac Zewnętrznych · Samorząd Studentów UWr
Aplikacja webowa do prowadzenia kontaktów z firmami: baza firm, historia kontaktu, kampanie ze ścieżkami (e-mail + social media naraz), zespoły i role, prompty do darmowego AI, import/eksport Excela.
- Logowanie e-mailem i hasłem. Administrator dodaje osobę w Więcej → Zespoły i ludzie → + Dodaj osobę i przekazuje jej wygenerowane dane logowania; osoba zmienia hasło w profilu. Nie trzeba skrzynki SMTP ani żadnych maili. Przy osobie jest też przycisk Nowe hasło (gdy ktoś zapomni).
- Opcjonalnie: logowanie linkiem z maila (wymaga własnego SMTP w Supabase – kroki 5–6 niżej).
- Wysyłka: aplikacja przygotowuje spersonalizowaną wiadomość i przenosi ją do Outlooka osoby (Outlook w przeglądarce, Outlook.com albo program pocztowy). Wiadomości na Instagram/Facebook/TikTok/LinkedIn: kopiuj + otwórz profil.
- Struktura: administratorzy główni → liderzy zespołów → zespoły (każdy zespół ma sektory i/lub kategorie firm) → członkowie.
- Prywatność odpowiedzi: treść odpowiedzi firmy widzi tylko osoba, która ją zapisała. Liderzy i admini widzą, że odpowiedź przyszła, wynik i notatkę.
Technologia: statyczna strona (Vite, bez frameworka) + Supabase (baza Postgres, logowanie, realtime). Hosting: Vercel. Wszystko mieści się w darmowych planach.
Wdrożenie krok po kroku (ok. 30 minut)
1. Supabase – baza i logowanie
- Załóż konto na https://supabase.com i utwórz projekt (New project, region: Central EU (Frankfurt), zapisz hasło do bazy).
- Wejdź w SQL Editor → New query, wklej całą zawartość
supabase/schema.sql i kliknij Run.
- W nowym zapytaniu wklej
supabase/seed.sql (2350 firm z bazy komisji, e-mail i social media już rozdzielone) i kliknij Run.
Jeśli edytor odmówi przez rozmiar pliku – podziel go na kilka części (każdy blok insert … ; jest niezależny) albo zaimportuj firmy później w aplikacji (Ustawienia → Import).
- Authentication → Providers → Email: włączone, Confirm email włączone.
- Authentication → Email Templates → Magic Link: wklej treść
supabase/email-template.html (zawiera kod {{ .Token }}, który można wpisać w aplikacji).
- Ważne – wysyłka maili z kodami. Wbudowany serwer pocztowy Supabase wysyła maile tylko do członków Twojego zespołu w Supabase i ma bardzo mały limit. Żeby kody docierały do wszystkich studentów, ustaw własny SMTP:
Project Settings → Authentication → SMTP Settings → Enable custom SMTP. Darmowe opcje: Resend (3000 maili/mies.) albo Brevo (300 maili/dzień). Wpisz host, port, login i hasło z panelu dostawcy, nadawca np.
[email protected].
- Project Settings → API: skopiuj Project URL i klucz anon public – będą potrzebne w kroku 2.
2. Vercel – strona
- Na https://vercel.com: Add New → Project → Import repozytorium
crm-wspolprace-ssuwr.
- Framework: Vite (wykryje się sam). W Environment Variables dodaj:
VITE_SUPABASE_URL = Project URL z SupabaseVITE_SUPABASE_ANON_KEY = klucz anon public
- Deploy. Dostaniesz adres typu
https://crm-wspolprace-ssuwr.vercel.app.
- Wróć do Supabase → Authentication → URL Configuration: Site URL = adres z Vercela, a w Redirect URLs dodaj ten sam adres.
3. Pierwsze uruchomienie
- Wejdź na adres aplikacji i zaloguj się jako pierwszy swoim mailem uczelnianym – zostaniesz administratorem głównym.
- Uzupełnij profil (imię, funkcja, rodzaj Outlooka, podpis).
- Struktura i zespoły → + Nowy zespół: nazwa, lider, sektory lub kategorie.
- Wyślij link członkom komisji. Po ich zalogowaniu zaakceptuj ich w zakładce Struktura (od razu wybierasz rolę) i dodaj do zespołów.
Klucz anon jest publiczny z założenia – dostęp do danych pilnują reguły RLS w bazie (niezalogowani i niezaakceptowani nie widzą niczego).
Jak się pracuje
Cztery zakładki: Dziś · Firmy · Kampanie · Więcej.
- Dziś – na górze karta „Następna firma”. Klikasz Zacznij kontakt → i idziesz krokami: 1) Otwórz w Outlooku (mail gotowy, klikasz tylko „Wyślij”), 2) kopiuj i otwórz profil w social mediach, 3) ewentualnie telefon. Potem Gotowe – następna firma → i aplikacja sama otwiera kolejną. „Pomiń” przeskakuje firmę, „Jutro” przekłada ją o dzień.
- Odpowiedzieli – zapisujesz wynik (rozmowy / współpraca / nie teraz / odmowa); treść odpowiedzi widzisz tylko Ty.
- Firmy – duża wyszukiwarka, przełącznik Mój zespół / Moje firmy / Wszystkie i 6 etapów: Nowa, W kontakcie, Rozmowy, Współpraca, Nie teraz, Odmowa. Pozostałe filtry są schowane pod „Więcej filtrów”.
- Kampanie (liderzy i admini) – wystarczy nazwa, cel i zespół. Gotowa ścieżka (mail + Instagram → przypomnienie → telefon) i podział firm ustawiają się same; zmienić je można w zwiniętych sekcjach.
- Więcej – statystyki, szukanie nowych firm, szablony, zespoły i ludzie, profil (tu też zmiana hasła), ustawienia.
- Treść z AI za darmo – w oknie kontaktu „Zmień kanały · napisz treść z AI”: kopiujesz prompt do Copilota / ChatGPT / Gemini i wklejasz odpowiedź.
Role
| Rola | Może |
|---|
| Administrator główny | wszystko: akceptuje konta, nadaje role, tworzy zespoły, ustawienia, import, usuwa firmy |
| Lider zespołu | tworzy kampanie, przypisuje firmy, zarządza członkami swojego zespołu i jego kategoriami |
| Członek | pracuje na firmach: kontakty, odpowiedzi, notatki, edycja danych, szablony, dodawanie firm |
Rozwój lokalny
cp .env.example .env # wpisz URL i klucz anon
npm install
npm run dev
Pliki
src/core.js – połączenie z Supabase, stan, szablony, promptysrc/views-work.js – pulpit, zadania, kontakt z firmą, firmy, karta firmysrc/views-camp.js – kampanie, kreator, szablonysrc/views-org.js – struktura i zespoły, profil, szukanie leadów, ustawienia, import/eksportsupabase/schema.sql – tabele, role, reguły dostępu (RLS), blokada domensupabase/seed.sql – startowa baza firmscripts/make_seed.py – generator seed.sql z pliku JSON
