Project site of eCamp v3

English

(deutsche Übersetzung weiter unten)

eCamp is a web application for planning J+S camps, J+S courses and other camps. It helps to exchange all planned programme among the camp organizers.

An older version called "eCamp v2" is productive and can be used at the following address (but only in german): https://ecamp.pfadiluzern.ch

eCamp v3 is the re-development of eCamp with the goal of reimplementing the functionality of eCamp v2 using modern technologies and an extensible architecture. Currently, an MVP (minimum viable product) is in operation. Next, we will focus on course planning, and further extensions will follow later.

The following commonly requested improvements over eCamp v2 are already implemented:

• Improved saving features - where possible, data are auto-saved on the fly.
• Usability on mobile phones - the design is mobile-first.
• Login via MiData account of the Swiss Guide and Scouts Movement is possible
• Switching the user interface language
• Formatting texts (bold, italic, bullet lists etc.)

eCamp v3 is made up of a backend based on the PHP framework API Platform (Symfony), which offers an API, as well as a Vue.js frontend and some other smaller services.

How can I help?

Thanks for helping! There are a few ways to get started.

• Visit our test environment at https://dev.ecamp3.ch. If you discover a bug, open a new issue for it.
• To help us translate eCamp v3 into other languages, visit our translation tool.
• To run the project locally on your computer, follow one of the installation guides:
  • Installation with Docker on Linux
  • Installation with Docker on Windows + WSL2
  • Set up VS Code as your code editor
• If you encounter issues during setup or have questions, don't worry, you're not alone. You can ask for help on our community discord server and we'll do our best to help you get up and running.
• Before you start coding, read our contributing guidelines.
• Familiarize yourself with the documentation in the Wiki.
• Choose an issue labeled "good first issue" and try to solve it.

Deutsch

eCamp ist eine Webapplikation, mit welcher J+S-Lager, J+S-Kurse und andere Lager geplant werden können. Dabei verfügen alle Benutzer stets über den aktuellsten Stand der Planung.

Die ältere Version eCamp v2 ist produktiv im Einsatz und kann unter folgender Adresse genutzt werden: https://ecamp.pfadiluzern.ch

eCamp v3 ist die Neu-Entwicklung von eCamp. Das Ziel ist es, die Funktionalität von eCamp v2 mit moderneren Technologien und einer erweiterbaren Architektur neu zu implementieren. Aktuell läuft eine MVP (minimum viable product, minimale nützliche Version). Als Nächstes fokussieren wir uns auf die Kursplanung und später werden dann noch weitere Erweiterungen folgen.

Folgende Verbesserungen, die bei eCamp v2 oft gewünscht wurden, sind bereits implementiert:

• Bessere Speicher-Funktion - wo immer möglich werden die Daten laufend automatisch gespeichert.
• Benutzbarkeit auf dem Mobiltelefon - das Design ist mobile-first.
• Login via MiData-Account der Pfadibewegung Schweiz ist möglich
• Mehrsprachigkeit
• Formatierung in Texten (fett, kursiv, Aufzählungen etc.)

eCamp v3 besteht aus einem Backend basierend auf dem PHP-Framework API Platform (Symfony), welches eine API anbietet, einem Vue.js-Frontend sowie einigen weiteren kleineren Services.

Wie kann ich helfen?

Danke dass du mithelfen möchtest! Es gibt ein paar verschiedene Arten wie du beginnen kannst.

• Besuche unsere Testumgebung auf https://dev.ecamp3.ch. Wenn du einen Fehler entdeckst, eröffne ein Issue dafür.
• Wenn du uns helfen möchtest, eCamp v3 auf andere Sprachen zu übersetzen, besuche unser Übersetzungs-Tool.
• Um das Projekt bei dir auf dem Computer laufen zu lassen, folge einer der Installationsanleitungen:
  • Installation mit Docker auf Linux
  • Installation mit Docker auf Windows + WSL2 (nur englisch)
  • VS Code als Code-Editor einrichten (nur englisch)
• Falls du Probleme beim Einrichten oder Verständnisfragen hast - keine Sorge, du bist nicht allein. Auf unserem Community Discord Server unterstützen wir dich sehr gerne.
• Bevor du mit programmieren loslegen kannst, lies unsere contributing guidelines
• Studier die Dokumentation im Wiki
• Such dir ein einsteigertaugliches Issue aus und probiere es zu lösen