https://github.com/codam-coding-college/coalition-system
Codam's custom coalition system connected to 42's Intranet
https://github.com/codam-coding-college/coalition-system
42born2code codam
Last synced: 3 months ago
JSON representation
Codam's custom coalition system connected to 42's Intranet
- Host: GitHub
- URL: https://github.com/codam-coding-college/coalition-system
- Owner: codam-coding-college
- Created: 2024-08-14T12:36:37.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-02-19T16:33:34.000Z (5 months ago)
- Last Synced: 2025-03-27T06:22:44.461Z (3 months ago)
- Topics: 42born2code, codam
- Language: TypeScript
- Homepage: https://coalitions.codam.nl
- Size: 484 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Codam's Custom Coalition System
A work in progress.
## To-do list
### Deployment
- [x] Finalize containerization
- [x] Switch to containerized postgres database
### Questionnaire
- [x] Code questionnaire
- [x] Code questionnaire results
- [x] Only make questionnaire available between specific dates set by admin
- [x] Allow users without an assigned coalition to always fill in the questionnaire
### Points system & tournament
- [x] Implement Codam's new point system
- [x] Improve Codam's new point system (add custom project point system, rip out Intra's)
- [x] Set up automated points system using Intra webhooks
- [x] Implement Intra's bloc tournament system
### Student interface
- [x] Create basic dashboard
- [x] Create basic graphs
- [x] Create various rankings
- [ ] Create tournament history overview with historical wins
### Admin / staff interface
- [x] Create dashboard
- [x] Create interface for editing the questionnaire
- [x] Create interface to manually trigger webhooks (manually re-assign automated points)
- [x] Create interface to fetch potentially missed webhooks between specific dates
- [x] Create point history interface where admin can delete, recalculate and synchronize points with Intra
- [x] Create interface to edit automated point system
- [x] Implement method to recalculate already given points
- [x] Create interface for manually assigning custom points
- [x] Create interface for manually assigning points for organizing events
### Intra connection (API & Webhooks)
- [x] Implement a way of synchronizing points with Intra
- [x] Implement a way of averaging out the points on Intra
- [ ] Implement a way of syncing existing Intra points including historical ones
- [ ] Find a way of blocking Intra's coalitions_user creation
- [ ] Re-implement old [coalition rank system](https://github.com/codam-coding-college/coalition-ranks)
If you're a student and want to contribute to this project, talk to the staff about it first to figure out what is possible and discuss implementation ideas.
## Development
1. Clone the repository
2. Fill the `.env` file with the necessary environment variables (don't forget to change the POSTGRES_HOST in the PRISMA_DB_URL variable to localhost)
3. Run `npm install` to install dependencies
4. Run `npm run build` to build the project
5. Start the PostgreSQL database using Docker: `docker-compose -f docker-compose.dev.yml up -d`
6. Run `npm run start` to start the server and seed the initial database
7. Optional:
- run `node build/dev/create_quiz_questions.js` to seed the database with initial questionnaire questions
- run `node build/dev/create_rankings.js` to seed the database with initial rankings
- synchronize some data from Intra using the Webhook Catch-up tool in the Admin interface
### Reseed the database
1. Delete the *.sync-timestamp* file in the root directory
2. Run `npm run build && npm run start`
### Add initial questionnaire questions
Run `node build/dev/create_quiz_questions.js` after running `npm run build`