ClubIS is an information system for any Czech orienteering club. The core functionality includes management of Members data, Event entries and Finance. Tight integration with Oris is planned to be implemented. The goal is to create a modern open-sourced and maintained information system to create an alternative for other outdated https://members.eob.cz/ or paid https://www.privatni-zona.cz/ solutions.
 |
 |
|---|---|
 |
 |
- Dev Wiki / Documentation
- Logging
- Mail remainders
- Database backup / restore
- Oris integration
- Localization
- Tests
- .NET 6 | .NET Framework and .NET Core marged into multiplatform (Windows/Linux) .NET 6
- Blazor | component-based C# framework for creating web UI
- MudBlazor | Material Design component library for Blazor
Before you begin, ensure you have installed the .NET 6.0 SDK.
PostgreSQL database server needs to be set up.
docker run --rm --name clubis-postgres-db -p 127.0.0.1:5432:5432 -e POSTGRES_PASSWORD=postgres -d postgres
Using your favourite C# devolopment IDE, set ClubIS.WebAPI as your startup project and run the app.
As an alternative, you can use .NET CLI and start the project by exucuting dotnet run in the WebAPI folder as the current directory.
A web browser should be launched with the application running and fetching data from the API.
Summary of the available API calls from the controllers will be at http://localhost:{port}/swagger/index.html, although most of the calls require you to log in to the application first in order to obtain the authorization cookie.
Edit databse credentials in connection string and docker-compose file and run the docker-compose. The app is running at port 5100, set up reverse proxy to serve the app with HTTPS.
For feedback and any brilliant ideas for improvement (or even tiny little tweaks), feel free to open an issue or contact me at [email protected]. Any contributions you make are greatly appreciated. For contributing directly:
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
I advise you, before opening a merge request, open related issue to discuss the upcoming changes first.
Thanks to the following people who have contributed to this project:
- @lopapex | student project collaborator
- @mslachtova | student project collaborator
Distributed under the MIT License. See LICENSE for more information.