1
0
Fork 0
forked from Kispi/Core
HGÖ Schule als Staat Software 2023
Find a file
Simon Giesel dd23862e9d
All checks were successful
continuous-integration/drone/push Build is passing
feat(webapp): add missing students export
2023-07-14 12:12:05 +02:00
.docs docs(readme): update docs 2023-06-04 11:57:22 +02:00
.vscode feat(core): add spa handling, add radio, add account import from csv file and use new dialog elements 2023-07-03 11:38:34 +02:00
server feat(webapp): add server time to admin portal 2023-07-12 15:36:33 +02:00
webapp feat(webapp): add missing students export 2023-07-14 12:12:05 +02:00
.drone.yml feat(core): add employer portal 2023-07-09 21:27:45 +02:00
.env.example feat(core): add spa handling, add radio, add account import from csv file and use new dialog elements 2023-07-03 11:38:34 +02:00
.gitignore feat(core): add spa handling, add radio, add account import from csv file and use new dialog elements 2023-07-03 11:38:34 +02:00
COMMIT_CONVENTION.md feat(core): migrate to pocketbase and update ui 2023-06-01 18:34:41 +02:00
Dockerfile feat(core): migrate to pocketbase and update ui 2023-06-01 18:34:41 +02:00
README.md feat(core): change branding 2023-06-05 18:05:25 +02:00

🔥 Schule als Staat - Hohenlohe Gymnasium Öhringen 🔥

User administration, user check and customs, banking system, employer portal and an admin portal

screenshot

This is our repository containing all required resources to run the "Core" WebApp from the "Hohenlohe Gymnasium Öhringen - Schule als Staat" project.
This repository also contains all the required Pocketbase files to run the backend server.

🚀 Getting Started

The following instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
See deployment for notes on how to deploy the project on a live system.

🍽️ Prerequisites

NodeJS (including PNPM) is required to run this project.
Also Go is required to run the built in server.

📦 Installing

At first clone this repository to your local machine by using

git clone https://git.cliffbreak.de/SimGie/HGOE-SaS.git

Change to the cloned repository

cd HGOE-Sas

Copy the example environment file

cp .env.example .env

To install all required webapp packages run

cd webapp && pnpm install

To start the webapp in development mode run the following npm script

pnpm dev

To build the webapp run the following npm script

pnpm build

To install all required server packages run

cd ../server && go mod download

To generate unique VAPID keys run the following Go command copy this keys to the .env file

go run main.go generate-vapid-keys

To start the server run the following Go command

go run main.go serve

If you do changes to the database schema keep in mind to Export collections via the Pocketbase UI. Paste the exported JSON into the pb_schema.json file and run the following npm script to update the frontend schema types.

cd ../webapp && pnpm typegen

🧑‍💻 Configure Visual Studio Code

If you haven't a instance of Visual Studio Code up and running download the latest version here.
Install the recommended extensions by opening the Extensions-Tab (Ctrl+Shift+X).
Enter @recommended and install all extensions.
After that restart Visual Studio Code to apply all changes.

🎉 Contributing

Please refer to our COMMIT_CONVENTION

🏗️ Built With

  • Node.js - The JavaScript runtime used as the projects base
  • PNPM - Faster alternative to npm for managing dependencies
  • Vue.js - The Frontend Web Framework
  • Vite - Used Frontend Tooling
  • Go - The Backend Programming Language
  • Pocketbase - The Backend Framework

🤵 Authors