LARPilot
LARPilot is a comprehensive platform for managing Live Action Role-Playing (LARP) events. The system integrates tools for both players and organizers with Google services (Sheets, Docs, Calendar) integration.
Table of Contents
Opis projektu
LARPilot jest platformą do zarządzania grami terenowymi (LARP). System łączy w
sobie narzędzia dla graczy oraz organizatorów i integruje się z usługami
Google (Sheets, Docs, Calendar). Najważniejsze moduły obejmują:
- Panel dla graczy – rejestracja na larpy, przegląd własnych wydarzeń oraz
dostęp do kart postaci i udostępnionych informacji.
- Panel organizatora – logowanie z użyciem kont Google/Facebook,
definiowanie ról organizacyjnych (główny fabularzysta, mistrz gry,
crafter itd.), zarządzanie zgłoszeniami graczy oraz przypisywanie ich do
wakatów.
- Moduł fabularny – przejrzyste tworzenie wątków i postaci wraz z ich
powiązaniami. Umożliwia wizualizację relacji, dodawanie zadań oraz
wymagań dotyczących NPC i scenografii.
- Moduł crafterski – listy zadań w stylu kanban do koordynacji prac
nad rekwizytami i scenografią. Tablice mogą również służyć do
monitorowania innych zadań organizacyjnych, np. planowania cateringu,
organizacji terenu, umów, etc.
- Moduł zaufania – bezpieczne zgłaszanie incydentów podczas gry z opcją
anonimowości, mediacji i eskalacji zgodnie z procedurą opisującą kody
uczestników oraz śledzenie statusu sprawy.
- Moduł zapisów – obsługa zgłoszeń graczy, konflikty między graczami,
dynamiczne ceny biletów i możliwość zwolnienia roli w przypadku rezygnacji.
- Moduł księgowości – ewidencja kosztów (wynajem terenu, scenografia,
gastronomia) i przychodów z biletów.
Te funkcje odpowiadają na potrzeby organizatorów, którzy oczekują jednego
miejsca do planowania wątków, zarządzania kartami postaci i komunikacji z
uczestnikami, a także narzędzia do raportowania i obsługi incydentów.
Documentation
User Guides
Technical Documentation
Technical Architecture
LARPilot follows a Domain-Driven Design (DDD) approach with modular architecture. The application is organized into self-contained domains under src/Domain/. See Domain Architecture for complete details.
Core Domains
- Infrastructure - Shared kernel with cross-cutting concerns, base classes, and shared utilities
- Account - User authentication and profile management (OAuth: Google, Facebook, Discord)
- Public - Public-facing LARP discovery and character sheet viewer
- Larp - Core LARP event lifecycle with workflow-based status management (DRAFT → WIP → PUBLISHED → CONFIRMED)
Story Management
- StoryObject - Story elements (Character, Thread, Quest, Event, Faction, Item, Place, Relation) with graph visualization and decision trees
- StoryMarketplace - Quest/thread recruitment system for story writers
- Application - Player application submission and character matching algorithm
Operations
- Participant - LARP participant roster (players, GMs, staff) with invitation codes
- Kanban - Task management with drag-and-drop boards for crafting and logistics
- Incident - Safety incident reporting and tracking system
- EventPlanning - Event scheduling with FullCalendar, resource booking, and conflict detection
- Map - Interactive game maps with location pins
Integration
- Integration - Google Sheets character import, Google Docs sync, Google Calendar events
This is the beginning of the README. Read the rest at the original. Read the full README ↗
