RCOS IO is the latest iteration of an admin and member portal for the Rensselaer Center for Open Source. It was created by Coordinators in 2022 and will be maintained by alumnus Frank Matranga until at least 2028, solving the issue of loss of experience as student leadership comes and goes.
RCOS has to handle the data of typically 150+ students each semester (even 100+ students during summer semesters). Data includes enrolled students, external organizations and their users, projects, semester enrollments, meetings, mentors, small groups, etc. Most of the operations are straightforward CRUD operations (Create Read Update Destroy) and the data does not often change. As a result, a traditional web application using a relational database is a good choice. Django was chosen because it is batteries-included and opinionated, and Python is a very well-known and accessible language to develop and deploy.
- Python Django backend
- Plain old HTML frontend using
- HTMX (coming soon)
- PostgreSQL database
- Redis cache
- Python 3.11+
- Poetry
- Clone repository
- Install dependencies
poetry install - Create a
.envfile (not the placement of the.) and add environment values- see
.env.examplefor the expected variables
- see
- Activate Poetry shell
poetry shell - Setup database
./manage.py migrateOR ask maintainers for test data DB file - Create a superuser for testing
./manage.py createsuperuser
poetry shell./manage.py runserver- Navigate to http://127.0.0.1:8000/auth/login/ and enter the email of your superuser and choose "Login (admin)"
git push origin main:production
We use MEND Renovate to automatically open dependency update PRs.
To manually update dependencies, run poetry update.