Zarządzenie Budżetem i Rozliczeniami

---

🎯 Cel projektu

Aplikacja ZBiR powstała jako odpowiedź na ograniczenia Excela w zarządzaniu finansami HAL/ZHL. Umożliwia:

• wygodne wprowadzanie danych,
• pracę wielu użytkowników (komendant, kwatermistrz),
• zatwierdzanie przez skarbnika okręgu,
• bezpieczne logowanie i kontrolę dostępu,
• eksport gotowego raportu PDF.

👤 Role użytkowników

Rola	Uprawnienia
Komendant/Kwatermistrz	tworzy wydarzenia, dodaje wpisy, zaprasza współpracowników
Skarbnik Okręgu	zatwierdza konta i raporty, przegląda wszystkie wydarzenia
Administrator	zarządza kontami, brak dostępu do danych finansowych

🧱 Stack technologiczny

Backend:

• NestJS – REST API
• Prisma – ORM
• PostgreSQL – relacyjna baza danych

Frontend:

• Next.js – SSR + Middleware
• Tailwind CSS – stylowanie
• TanStack Table – tabela z edycją inline
• React Hook Form + Yup – formularze z walidacją
• Zustand – zarządzanie stanem

Bezpieczeństwo:

• JWT Auth z rotacją tokenów
• Role-Based Access Control (RBAC)
• Dane osobowe szyfrowane i zabezpieczone
• Planowana integracja z Keycloak (SSO) i RLS (PostgreSQL)

📌 Status projektu

Moduł / Funkcja	Status
🔐 Rejestracja i logowanie	✅ Zrealizowane
🔑 JWT + Refresh Token	✅ Zrealizowane
🛂 RBAC	✅ Zrealizowane
🏕 Moduł wydarzeń (Camp)	🛠 W trakcie
💸 Wpisy finansowe (Entry)	🛠 W trakcie
📤 Eksport PDF	🛠 W trakcie
📦 Docker Compose	🔜 Planowane
🔭 Monitoring i CI/CD	🔜 W planach

---

📈 Kierunki rozwoju

W kolejnych etapach planujemy rozszerzyć ZBiR o funkcjonalności umożliwiające:

• rozliczanie pojedynczych jednostek (np. drużyny, szczepy),
• Wydajne korzystanie z urządzen mobilnych (Progressive Web App)

Jeśli chcesz zasugerować inne funkcje – otwórz issue lub skontaktuj się z nami bezpośrednio.

🧠 Architektura logiczna

• Camp → Wydarzenie (np. obóz)
• Entry → Pojedynczy wpis finansowy (wpływy, wydatki)
• UserToCamp → Powiązania użytkowników z wydarzeniami (rola, status zaproszenia)

💬 Jak się przyczynić?

Choć aplikacja nie jest open-source, zachęcamy do:

• zgłaszania propozycji przez Issues
• przesyłania uwag dot. ergonomii i UX
• zgłaszania błędów funkcjonalnych

📝 Licencja

Projekt objęty prywatną licencją – wszelkie wdrożenia możliwe wyłącznie po uzgodnieniu z autorami.

---

Aplikacja stworzona przez:

© 2025 ZBiR - Zarządzenie Budżetem i Rozliczeniami