{"id":19591446,"url":"https://github.com/fachschaftmathphysinfo/ostseee","last_synced_at":"2025-04-27T13:32:10.908Z","repository":{"id":39017892,"uuid":"264511638","full_name":"FachschaftMathPhysInfo/ostseee","owner":"FachschaftMathPhysInfo","description":"Evaluating online courses (Moodle,e.g.) like a breeze. 💨 ","archived":false,"fork":false,"pushed_at":"2023-01-06T15:24:36.000Z","size":11074,"stargazers_count":6,"open_issues_count":33,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-05T00:41:23.688Z","etag":null,"topics":["evaluation","lti","moodle","questionnaire"],"latest_commit_sha":null,"homepage":"https://eval.mathphys.info","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FachschaftMathPhysInfo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-16T19:29:55.000Z","updated_at":"2024-05-04T13:53:11.000Z","dependencies_parsed_at":"2023-02-06T05:45:28.838Z","dependency_job_id":null,"html_url":"https://github.com/FachschaftMathPhysInfo/ostseee","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FachschaftMathPhysInfo%2Fostseee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FachschaftMathPhysInfo%2Fostseee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FachschaftMathPhysInfo%2Fostseee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FachschaftMathPhysInfo%2Fostseee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FachschaftMathPhysInfo","download_url":"https://codeload.github.com/FachschaftMathPhysInfo/ostseee/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251145596,"owners_count":21543072,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["evaluation","lti","moodle","questionnaire"],"created_at":"2024-11-11T08:29:11.150Z","updated_at":"2025-04-27T13:32:08.217Z","avatar_url":"https://github.com/FachschaftMathPhysInfo.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ostseee\n\u003e OrdnungsSystemToolzurSicherenEchtzeitEvaluation\n\nis the fourth version of the seee, but specialized for online evaluations. It uses the seee3 latex classes.\n\n## Key features\n\n* Safe way to evaluate online Courses\n* Invitation based, distribution by third party: Ensure anonymity, while preserving uniqueness\n* Evaluate Courses, Seminars, Lecturers and Exercise groups\n* Multiple Distribution Plattform support:\n    - Primary plattform: *Übungsgruppenverwaltung der Physik* - Automatic push\n    -  Moodle integration/LTI support (one click install)\n    - randomized Email list via cli\n* Easy configurable forms via JSON\n    - Different question types (Single/Multiple choice,Comment, etc)\n    - Multiple Language support for forms and in survey switch\n* Support for public Reports/ censoring\n* Advanced CLI commands:\n    - Mailing to lecturers\n    - Report generation with LaTeX\n    - Stats\n    - Secure upload to thirdparty for providing results\n* In development: Account for evaluators, export to CSV files.\n\n\n## Running the server in production mode\n\n1. Adjust `db.env.example` and save it as `db.env`\n2. Adjust `ostsee.env.example`and save it as `ostsee.env`\n    - Change the secrets, passwords as you need.\n        +  The LTI_SECRET_KEY has to be negotiated with your LTI-provider (administrator of your moodle instance, for example)\n    - If you want to secure the server using JWT tokens, set `JWT_ENABLED=1`, otherwise the admin interface will be unprotected.\n    - It is important that you fill in an `ADMIN_USER_ID` and an `ADMIN_USER_PASSWORD`\n3. Start the docker containers: `docker-compose up --build`\n4. (optional) Build the the client in `client/` using `go build main.go`\n5. and add an normal user (here max) using the admin account(note: other users CANNOT create an account): `go run main.go admin users add max Max Mustermann --pw mathematikon --user admin`\n6. Remove `ADMIN_USER_ID` in your `ostsee.env` or set it to `\"\"`in order to deactivate super admin access.\n7. Restart your docker-compose\n8. The container exposes now two pages: `localhost:3081`(admin interface) and `localhost:3082` (client, where the questionaires are answered)\n\n## Documentation\n\n### CommandLine Client\n\nFor Documentation on the client checkout its [README](client/README.md)\n\n### Web-Admin Docs\n\nFor Documentation on the web-admin interface checkout its \n[README](web-admin/README.md)\n\n## Development\n### Generating from \"api/evaluation.yml\"\n\nRun `openapi-generator` (for  client).\n\n```\nopenapi-generator generate -i api/evaluation.yml -g typescript-redux-query -o web-common --enable-post-process-file\n```\n\nFor the client (`web-common`) you have to adjust import paths to import the `index` files, e.g. via grep. You can then develop in `web-admin`or `web` (to be created).\n\n### Running the client in Development mode\n\nYou need a proxy in order to run this project. Please use `nginx`, a sample proxy config file is provided in `misc/site-react.conf`, copy it into `sites-enabled` of your `nginx`installation, restart `nginx`. Afterwards you can start the server in server by `go run main.go` and in an extra terminal the `web-admin` interface: \n\n1. Build web-common by `yarn \u0026\u0026 yarn build` inside of its directory\n2. install dependencies in `web-admin`by `yarn`\n3. `yarn start`\n\nThen navigate to `localhost:8081` to run and have fun.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffachschaftmathphysinfo%2Fostseee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffachschaftmathphysinfo%2Fostseee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffachschaftmathphysinfo%2Fostseee/lists"}