Dies ist der Quellcode der Mitgliederplattform des Erlanger Wingolfs. Sie erfüllt fünf Hauptaufgaben: Hilfestellung bei der Verwaltung der Mitglieder, Netzwerk der Mitglieder, Austausch von Informationen und Dokumenten, Bereitstellung verlässlicher Kommunikationskanäle und Präsentation nach außen.
Die Wingolfsplattform ist ein Produkt vieler ehrenamtlicher Mitwirkender. Wenn Du Interesse hast, das Projekt bei der Konzeption, als Entwickler, Designer, Tester oder auch finanziell zu unterstützen, melde Dich einfach!
Die Wingolfsplattform basiert serverseitig auf Ruby on Rails, clientseitig auf Vue.js.
Auf einer Entwicklungsmaschine mit Docker installierst Du die Entwicklungsversion der Wingolfsplattform wie folgt:
git clone git@github.com:fiedl/wingolfsplattform.git
cd wingolfsplattform
git clone git@github.com:fiedl/your_platform.git
docker-compose build
Falls Du die Umgebung alternativ lieber großteils ohne Docker installieren möchtest, guck Dir am Besten unseren alten Getting-Started-Guide an.
Starte die Web-Oberfläche mit
docker-compose run rails bundle exec rake db:create db:migrate db:seed
docker-compose up rails
und rufe danach http://localhost:3000 auf.
Mit der Rails-Konsole kannst Du auch ohne Web-Oberfläche auf alles zugreifen:
docker-compose run console
Tests vollständig durchlaufen lassen:
docker-compose run tests
Während der Entwicklung kannst Du auch guard laufen lassen. Dieses Tool lässt, wenn Du Code-Dateien veränderst, immer die passenden Tests laufen.
docker-compose run guard
Bitte macht euch mit dem Rails-Security-Guide vertraut. Kontrolliert euren Code bitte außerdem mit brakeman.
Datenbank in eine SQL-Datei exportieren:
docker-compose run rails bundle exec ruby script/dump
Dies erzeugt eine SQL-Datei mit Zeitstempel im Verzeichnis backups/sql_dumps.
SQL-Datei importieren:
docker-compose run rails bash -c "mysql -h mysql -u root --password=secret -D wingolfsplattform_development" < /path/to/sql/file.sql
- Plattform-Podcast, Ep. #1
- Was kann die Plattform?
- Wie sende ich eine Semesterstatistik an den Vorort?
- Wie abonniere ich meinen Veranstaltungskalender?
- Wie trage ich ein Semesterprogramm ein?
- Wie binde ich Veranstaltungen auf einer öffentlichen Homepage ein?
- Wie erstelle ich eine Amtsträger-Obergruppe?
- Weitere Screencasts: https://plattformpodcast.com
- Trello Board "AK Internet: Entwicklung"
- YourPlatform-Projekt, https://github.com/fiedl/your_platform
Copyright (c) 2012-2021, Sebastian Fiedlschuster
Mitarbeiter: Jörg Reichardt, Manuel Zerpies, Joachim Back, Willi Helwig, Falk Schimweg, Felix Plapper
Der Quellcode ist unter den Lizenzbestimmungen der GNU Affero General Public License (AGPL) veröffentlicht. Hiervon sind explizit ausgenommen die Grafiken und Schriftarten in den Verzeichnissen app/assets/images und app/assets/fonts, die lediglich dem Betrieb der laufenden Primärinstanz dienen.
The Source Code is released under the GNU Affero General Public License (AGPL). Explicitely excluded are the images and fonts in the directories app/assets/images and app/assets/fonts, which are only to be used by Wingolf for production.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see http://www.gnu.org/licenses/.
Vorrangige Sonderbestimmung für den VAW e.V.: Aufgrund des sog. neuen Entwicklungsmodells ist eine Nutzung der Software durch Philister des VAW e.V. ab Commit c748222315 und später an die finanzielle Vergütung der jeweiligen Entwicklungsarbeit geknüpft.