📦 Instalacja - Panel Księgowy¶

Ten przewodnik pomoże Ci zainstalować Panel Księgowy w środowisku deweloperskim lub produkcyjnym.

🎯 Wymagania¶

Wymagania systemowe¶

Docker - Wersja 20.10 lub nowsza
Docker Compose - Wersja 2.0 lub nowsza
Git - Do klonowania repozytorium
8 GB RAM - Minimum (16 GB zalecane)
10 GB wolnego miejsca - Na dysku

Wymagania opcjonalne¶

Node.js - Wersja 18+ (jeśli chcesz uruchomić Vite lokalnie)
Python - Wersja 3.12+ (jeśli chcesz uruchomić Django lokalnie)

🚀 Instalacja z Dockerem (Zalecane)¶

Krok 1: Sklonuj repozytorium¶

git clone <repository-url>
cd panel_ksiegowy_app

Krok 2: Skonfiguruj zmienne środowiskowe¶

# Skopiuj przykładowy plik .env
cp .env.example .env

# Edytuj .env i uzupełnij wymagane zmienne
# Najważniejsze:
# - SECRET_KEY
# - DATABASE_URL
# - REDIS_URL

Krok 3: Uruchom kontenery¶

# Uruchom wszystkie kontenery
docker-compose up -d

# Sprawdź status
docker-compose ps

Krok 4: Zastosuj migracje¶

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

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

Krok 5: Załaduj dane testowe (opcjonalnie)¶

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

🛠️ Instalacja bez Dockera (Zaawansowane)¶

Krok 1: Zainstaluj zależności¶

# Python dependencies
pip install -r requirements.txt

# Node.js dependencies
npm install

Krok 2: Skonfiguruj bazę danych¶

# Utwórz bazę danych PostgreSQL
createdb panel_ksiegowy_app

# Zastosuj migracje
python manage.py migrate

Krok 3: Uruchom serwery¶

# Terminal 1: Django
python manage.py runserver

# Terminal 2: Vite
npm run dev

# Terminal 3: Celery
celery -A panel_ksiegowy_app worker -l INFO --beat

✅ Weryfikacja instalacji¶

Sprawdź dostępność¶

Django - http://localhost:8000
Vite - http://localhost:5173
Dokumentacja - http://localhost:8001

Sprawdź logi¶

# Logi Django
docker-compose logs web

# Logi Vite
docker-compose logs vite

# Logi Celery
docker-compose logs celery

🔧 Konfiguracja¶

Zmienne środowiskowe¶

Najważniejsze zmienne w .env:

# Django
SECRET_KEY=your-secret-key-here
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1

# Database
DATABASE_URL=postgresql://postgres:postgres@db:5432/panel_ksiegowy_app

# Redis
REDIS_URL=redis://redis:6379/0

# Email
EMAIL_BACKEND=django.core.mail.backends.console.EmailBackend

Ustawienia Django¶

Większość ustawień jest w settings.py. Sprawdź: - INSTALLED_APPS - Zainstalowane aplikacje - DATABASES - Konfiguracja bazy danych - CACHES - Konfiguracja cache

🆘 Rozwiązywanie problemów¶

Problem: Port jest zajęty¶

Rozwiązanie:

# Zmień port w docker-compose.yml
ports:
  - "8001:8000"  # Zmień 8001 na inny port

Problem: Baza danych nie łączy się¶

Rozwiązanie:

# Sprawdź czy kontener db działa
docker-compose ps db

# Sprawdź logi
docker-compose logs db

# Restart kontenera
docker-compose restart db

Problem: Migracje nie działają¶

Rozwiązanie:

# Sprawdź czy baza danych istnieje
docker-compose exec db psql -U postgres -l

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

📚 Więcej informacji¶

Pierwsze Kroki - Co zrobić po instalacji
Dokumentacja Developerska - Kompletny przewodnik
Docker Deployment - Szczegółowy przewodnik Docker

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