Redirectioneaza

• tax form #230 made easy
• digital solution for an offline process
• as simple and as efficient as possible
• helps you compare and choose who to support
• helps NGOs reach their public and keep track of their supporters

See the project live

Contributing | Built With | Development | Creating a new release | Feedback | License | About Code for Romania

Contributing

This project is built by amazing volunteers, and you can be one of them. Here's a list of ways in which you can contribute to this project. If you want to make any change to this repository, please make a fork first.

Help us out by testing this project in the staging environment. If you see something that doesn't quite work the way you expect it to, open an Issue. Make sure to describe what you expect to happen and what is actually happening in detail.

If you would like to suggest new functionality, open an Issue and mark it as a [Feature request]. Please be specific about why you think this functionality will be of use. If you can, please include some visual description of what you would like the UI to look like if you’re suggesting new UI elements.

Built With

Programming languages

• Backend: Python 3.13 with Django 5.2
• Frontend: JavaScript ES6+ with Vite 7 + AlpineJS 3 + TailwindCSS 4

Platforms

• AWS through Terraform

Frontend framework

• HTML Django Templates + TailwindCSS + AlpineJS

Package managers

• uv
• npm

Database technology and provider

• PostgreSQL

Development

Deployment without Docker

Prerequisites

• UV
• NVM
• a PostgreSQL 16.10 database (can be run with Docker)

1. Go to the root of the project
2. Run cp .env.example .env.local to create the environment file
3. Configure your database to run with the configuration in the .env.local file or run the database using docker with docker compose up -d db_psql_dev or make rund-db
4. Set up the Node.js environment
   1. Go to the backend directory
   2. Run nvm use || nvm install to install the Node.js version specified in the .nvmrc file
   3. Run npm install to install the Node.js dependencies
5. Set up the Python environment
   1. Go to the backend directory
   2. Create a virtual environment with uv venv --python 3.13
   3. Run uv sync --active to install the Python dependencies

Running the project

1. Run the Django project in one terminal
   1. Go to the backend directory
   2. Run source .venv/bin/activate to activate the Python virtual environment
   3. Run django-admin runserver localhost:8000 to start the Django development server
2. Run the frontend in another terminal
   1. Go to the backend directory
   2. Run nvm use to use the Node.js version specified in the .nvmrc file
   3. Run npm run dev to start the frontend development server
3. Open http://localhost:8000 in your browser

ℹ️ Configure whatever port works best for you. For Django, change the :8000 to whatever works best for you. For the frontend, set the DJANGO_VITE_DEV_SERVER_PORT variable in the .env.local file

‼️ In case of problems with the instructions, please open an issue. If you managed to find a solution, please open a PR with the changes.

Deployment With Docker

1. Go to the root of the project
2. Run cp .env.example .env to create the environment file
3. Run make run to start the containers with an PostgreSQL database
4. Open http://localhost:8080 in your browser

Creating a new release

The production deployment is done through a CI/CD pipeline using GitHub Actions. When a new release is created, the pipeline will build the Docker images and push them to the Docker Hub registry. Then, the infrastructure is updated using Terraform to pull the new images and deploy them to the AWS infrastructure.

Instructions

1. Create a new tag on GitHub with a new version number and push it.

   git tag -a vX.Y.Z -m "vX.Y.Z"
   git push origin vX.Y.Z
   

2. Create a new release on GitHub using the new tag. Either through the GitHub UI or using the GitHub CLI:

   gh release create "vX.Y.Z" --title "vX.Y.Z" --latest --verify-tag --generate-notes
   

3. The GitHub Actions pipeline will automatically start and build the Docker image.
4. Once the pipeline is finished, change the image_tag variable in the ./terraform/locals.tf file to the new version number.
5. Create a new pull request with the changes and, if the Terraform plan looks good, merge it to the main branch.
6. The GitHub Actions pipeline will automatically start and deploy the new version to production.
7. Check the production site to see if everything is working as expected.
8. Celebrate!

Feedback

• Request a new feature on GitHub.
• Vote for popular feature requests.
• File a bug in GitHub Issues.
• Email us with other feedback [email protected] or on [email protected].

License

This project is licensed under the MPL 2.0 License — see the LICENSE file for details

About Code for Romania

Started in 2016, Code for Romania is a civic tech NGO, official member of the Code for All network. We have a community of around 2.000 volunteers (developers, ux/ui, communications, data scientists, graphic designers, devops, it security and more) who work pro bono for developing digital solutions to solve social problems. #techforsocialgood. If you want to learn more details about our projects visit our site or if you want to talk to one of our staff members, please e-mail us at [email protected].

Last, but not least, we rely on donations to ensure the infrastructure, logistics and management of our community that is widely spread across 11 timezones, coding for social change to make Romania and the world a better place. If you want to support us, you can do it here.