Przejdź do treści

Panel Księgowy

Dla Developerów

panel-ksiegowy/panel-ksiegowy

👨‍💻 Szybki Start - Dla Developerów¶

Ten przewodnik pomoże Ci szybko rozpocząć rozwój Panel Księgowy.

🎯 W 5 minut do pierwszego commita¶

Krok 1: Środowisko deweloperskie (2 min)¶

# Sklonuj repozytorium
git clone <repository-url>
cd panel_ksiegowy_app

# Uruchom Docker Compose
docker-compose up -d

# Zastosuj migracje
docker-compose exec web python manage.py migrate

# Utwórz superusera
docker-compose exec web python manage.py createsuperuser

Krok 2: Sprawdź strukturę (1 min)¶

# Struktura projektu
apps/                    # Aplikacje Django
├── crm/                # Moduł CRM
├── contractors/        # Moduł Kontrahenci
├── tasks/              # Moduł Tasks
└── ...

templates/              # Szablony Django
assets/                 # Pliki statyczne (JS/CSS)
docs/                   # Dokumentacja

Krok 3: Uruchom serwer (1 min)¶

# Django development server
docker-compose exec web python manage.py runserver

# Vite dev server (automatycznie przez docker-compose)
# Dostęp: http://localhost:5173

Krok 4: Utwórz pierwszy moduł (1 min)¶

Zobacz: Tworzenie Modułu

🚀 Następne kroki¶

Przeczytaj dokumentację¶

Architektura - Zrozum architekturę systemu
Multi-tenancy - Zrozum multi-tenancy
Struktura Modułu - Wymagana struktura
Standardy Kodu - Standardy kodu

Rozpocznij rozwój¶

Sprawdź istniejące moduły
apps/crm/ - Przykład kompleksowego modułu
apps/tasks/ - Przykład najlepszego UX/UI
Utwórz nowy moduł
Zobacz: Tworzenie Modułu
Zaktualizuj built-features-registry.mdc
Napisz testy
Minimum 80% pokrycia
Zobacz: Standardy Testowania

💡 Najważniejsze koncepcje¶

Multi-tenancy¶

BaseTeamModel - Wszystkie modele biznesowe dziedziczą po BaseTeamModel
Team filtering - Zawsze filtruj po team_id
Decorators - Używaj @login_and_team_required

URL Structure¶

Team-based URLs - /a/<team_slug>/<module>/<action>/
team_urlpatterns - Wszystkie URL-e biznesowe

Views¶

Function-based views - Preferowane nad CBV
Decorators - @login_and_team_required, @team_admin_required

📚 Więcej informacji¶

Dokumentacja Developerska - Kompletny przewodnik
Architektura - Architektura systemu
Moduły - Przewodniki modułów
Standardy Kodu - Standardy kodu

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