Przejdź do treści

🎯 Pierwsze Kroki - Po Instalacji

Ten przewodnik pomoże Ci wykonać pierwsze kroki po instalacji Panel Księgowy.

✅ Checklist po instalacji

1. Weryfikacja instalacji

  • Wszystkie kontenery działają (docker-compose ps)
  • Django dostępne na http://localhost:8000
  • Vite dostępne na http://localhost:5173
  • Dokumentacja dostępna na http://localhost:8001
  • Migracje zastosowane (python manage.py migrate)
  • Superuser utworzony (python manage.py createsuperuser)

2. Konfiguracja podstawowa

  • Plik .env skonfigurowany
  • Baza danych połączona
  • Redis działa
  • Celery działa

3. Test funkcjonalności

  • Logowanie działa
  • Dashboard się ładuje
  • Moduły są dostępne
  • API działa (jeśli testujesz)

🚀 Pierwsze kroki dla różnych ról

Dla użytkowników końcowych

  1. Zaloguj się do systemu
  2. Przejrzyj dashboard - Zapoznaj się z interfejsem
  3. Dodaj pierwszego klienta - Przetestuj funkcjonalność
  4. Utwórz pierwsze zadanie - Przetestuj moduł zadań

Zobacz: Szybki Start dla Użytkowników

Dla administratorów

  1. Skonfiguruj zespół - Uzupełnij dane biura
  2. Dodaj użytkowników - Zaproś członków zespołu
  3. Skonfiguruj moduły - Włącz potrzebne moduły
  4. Skonfiguruj integracje - REGON, VAT, Email

Zobacz: Szybki Start dla Administratorów

Dla developerów

  1. Przeczytaj architekturę - Zrozum strukturę systemu
  2. Przejrzyj kod - Sprawdź istniejące moduły
  3. Utwórz testowy moduł - Przetestuj proces tworzenia
  4. Napisz testy - Przetestuj proces testowania

Zobacz: Szybki Start dla Developerów

🧪 Testowanie funkcjonalności

Test podstawowych funkcji

  1. Rejestracja zespołu
  2. Przejdź do /teams/register/
  3. Wypełnij formularz

  4. Sprawdź czy email aktywacyjny został wysłany

  5. Logowanie

  6. Zaloguj się jako superuser

  7. Sprawdź czy dashboard się ładuje

  8. Dodawanie klienta

  9. Przejdź do /a/<team_slug>/clients/
  10. Kliknij "Dodaj klienta"

  11. Wprowadź NIP i sprawdź auto-wypełnianie

  12. Wystawianie faktury

  13. Przejdź do /a/<team_slug>/invoicing/
  14. Kliknij "Nowa faktura"
  15. Dodaj pozycje i wygeneruj PDF

🔧 Konfiguracja zaawansowana

Master Data

  1. Przejdź do Superadmin → Master Data
  2. Sprawdź czy dane są załadowane:
  3. Banki (156 banków)
  4. Urzędy Skarbowe (402 US)
  5. Urzędy ZUS (45 urzędów)
  6. Waluty (34 waluty)

Integracje

  1. REGON API
  2. Skonfiguruj API key

  3. Przetestuj auto-wypełnianie

  4. Biała Lista VAT

  5. Włącz automatyczną weryfikację

  6. Przetestuj weryfikację kontrahenta

  7. Email

  8. Skonfiguruj SMTP/IMAP
  9. Przetestuj wysyłanie emaili

📊 Dane testowe

Załadowanie danych testowych

# Załaduj dane testowe
docker-compose exec web python manage.py loaddata fixtures/test_data.json

# Lub utwórz własne dane
docker-compose exec web python manage.py shell

Przykładowe dane

Po załadowaniu danych testowych będziesz miał: - 1 zespół testowy - "Test Biuro" - 10 klientów testowych - Z przykładowymi danymi - 20 faktur testowych - Z różnymi statusami - 50 zadań testowych - Z różnymi priorytetami

🎓 Materiały szkoleniowe

Po wykonaniu pierwszych kroków, przejdź do:

📚 Więcej informacji

Ostatnia aktualizacja: 2025-11-29
Wersja dokumentacji: 1.0