-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
47 additions
and
6 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,11 +1,52 @@ | ||
# cpe-calendar | ||
Sync your CPE calendar with your personal one | ||
<div align="center"> | ||
<img width=200 alt="logo cpe-calendar" src="/static/favicon.svg"> | ||
|
||
# CPE calendar | ||
|
||
Sync your CPE calendar with your personal one. | ||
|
||
</div> | ||
|
||
# About | ||
|
||
The goal of the CPE Calendar is to offer students easy and effortless access to their school schedule by syncing it with their personal calendar. This works on all devices (phones, computers, laptops) and with any calendar provider, including Apple and Google. | ||
|
||
The calendar automatically updates every hour, keeping you informed of any schedule changes. This project is open-source, and contributions or issue reports are welcome on GitHub. | ||
|
||
# Setup | ||
|
||
1. Frist step is to setup your own `.env` use as reference `exemple.env` | ||
2. | ||
``` | ||
1. The first step is to set up your own `.env` file. Use `example.env` as a reference. | ||
2. Then run the production version using Docker Compose. | ||
|
||
# Known Issues | ||
|
||
There can be an issue starting the Docker environment on Windows due to the missing `make-key.sh` script. | ||
|
||
# Development | ||
|
||
If you want to run the project without the Docker environment, follow these steps: | ||
|
||
### Generate the needed key | ||
```bash | ||
openssl genrsa -out secret/private.pem 2048 | ||
openssl rsa -in secret/private.pem -pubout > static/public.pem | ||
``` | ||
``` | ||
|
||
### Start the code | ||
```bash | ||
go mod download | ||
go run main.go | ||
``` | ||
|
||
# Trust | ||
|
||
As with all hosted open-source projects, there's no guarantee that the instance owner hasn't modified the official code. This implies a certain level of trust in the service chain. Depending on your trust level or risk tolerance, consider the following: | ||
|
||
1. **Full Trust**: Use the service as is. | ||
2. **Partial Trust**: Limit potential risks by creating a dedicated password for the service. | ||
3. **No Trust**: As this is an open-source project, you can host your own instance. A guide is available for setting it up. | ||
|
||
# Affiliation | ||
|
||
This project is entirely independent and is not affiliated with any school or organization. | ||
|