https://github.com/kth/kursutveckling-web
En app som sköter generering av sidan som innehåller information om kursens utveckling och historik i Kurs- och programkatalogen. Sidan innehåller bl.a. arkivsidan för historiska kursplaner och pm versioner, samt sidan för publicerade kursanalyser med kursdata för en specifik kurs.
https://github.com/kth/kursutveckling-web
kursutveckling parceljs react react-mobx reactjs responsive-design
Last synced: 9 months ago
JSON representation
En app som sköter generering av sidan som innehåller information om kursens utveckling och historik i Kurs- och programkatalogen. Sidan innehåller bl.a. arkivsidan för historiska kursplaner och pm versioner, samt sidan för publicerade kursanalyser med kursdata för en specifik kurs.
- Host: GitHub
- URL: https://github.com/kth/kursutveckling-web
- Owner: KTH
- License: mit
- Created: 2019-03-14T12:24:43.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-17T12:33:53.000Z (about 2 years ago)
- Last Synced: 2024-04-18T13:06:18.741Z (about 2 years ago)
- Topics: kursutveckling, parceljs, react, react-mobx, reactjs, responsive-design
- Language: JavaScript
- Homepage:
- Size: 23.8 MB
- Stars: 3
- Watchers: 14
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Welcome to kursutveckling-web 👋
[](#)
## Course development and history web
## Kursens utveckling och historik web
**React** app using **mobx** and **parcel-js**.
This page displays course analysis and course data published by course coordinators sorted by years. Prospective, current and previous students can use the information for selecting courses or follow up on previous course evaluations. Teachers, course coordinators, examiners etc. can use the page as a tool for course development.
Displays:
- Meny with navigation links for course information related pages (_kursinfo-web, kursinfo-admin-web_)
- Dropdown list with all previous course syllabuses
- Tables with course data and course analyses, as well as this course round syllabuss (and course-pm)
- Navigation links per table to edit it in administrate tool **kursutveckling-admin-web**
The two types of course analyses, Canvas analyses and Admin Web Tool analyses, differ in their origins and data sources:
- Admin Web Tool analyses, from the discontinued `kursutveckling-admin-web` tool, include the field `examinationGrade` for describing course round results. The field `alterationText` refers to changes implemented before the **current** course round. The latest analysis of this kind will be published in March 2025.
- Canvas-based analyses data is fetched and compiled in the integration `kursutveckling-integration-api`, including the field `gradingDistribution` for describing course round results. The field `alterationText` here refers to changes planned before the **next** course round.
Application is fetching data from **LADOK-API** for:
1. Course title
2. For a list of course syllabusses for all available years in Ladok
Application is fetching data from **Kursutveckling api** to show:
1. All data contained in table for course analyses and data
Application is showing course syllabuses via **kursplan-api**
Web pages is public for everyone.
**All connected projects can be found here:**
- [https://github.com/KTH/kursutveckling-admin-web](https://github.com/KTH/kursutveckling-admin-web)
- [https://github.com/KTH/kursutveckling-api](https://github.com/KTH/kursutveckling-api)
- [https://github.com/KTH/kursplan-api](https://github.com/KTH/kursplan-api)
**Related projects**
- [https://github.com/KTH/kursutveckling-integration-api](https://github.com/KTH/kursutveckling-integration-api)
- [https://github.com/KTH/kursinfo-admin-web](https://github.com/KTH/kursinfo-admin-web)
- [https://github.com/KTH/kursinfo-api](https://github.com/KTH/kursinfo-api)
- [https://github.com/KTH/kursinfo-web](https://github.com/KTH/kursinfo-web)
### Secrets for Development
Secrets during local development are stored in a gitignored `.env` file (`env.in` can be used as template for your `.env` file). More details about environment variable setup and secrets can be found in [confluence](https://confluence.sys.kth.se/confluence/x/OYKBDQ).
### Install
First time you might need to use options `--ignore-scripts` because of npm resolutions:
```sh
npm install --ignore-scripts
```
or
```sh
npm install
```
You might need to install as well:
```sh
npm install cross-env
npm install concurrently
```
### Usage
Start the service on [http://localhost:3000/kursutveckling/:courseCode](http://localhost:3000/kursutveckling/:courseCode).
```sh
npm run start-dev
```
### Debug in Visual Studio Code
It's possible to use debugging options available in Visual Studio Code
Add a file `launch.json` to `.vscode` directory :
- _Microsoft_
```json
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Debug kursutveckling-web",
"program": "${workspaceFolder}\\app.js",
"envFile": "${workspaceFolder}\\.env",
"env": {
"NODE_ENV": "development"
}
}
]
}
```
- _Mac, Unix and so on_
```json
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Debug kursutveckling-web",
"program": "${workspaceFolder}/app.js",
"envFile": "${workspaceFolder}/.env",
"env": {
"NODE_ENV": "development"
}
}
]
}
```