Sejm Stats

Making Polish parliamentary data more accessible
and understandable for citizens.

📚 Dokumentacja (PL) · 📖 Project Docs · 💬 Discord · ❤️ Patronite · 🎥 YouTube

Sejm-stats provides a clear and concise view of complex parliamentary data, making it easier for citizens to stay informed about the actions and decisions of their representatives.

🚀 Quick Start

To get started with development:

Clone the repository:

git clone https://github.com/miskibin/sejm-stats
cd sejm-stats

Choose your development environment:
- Backend Development
- Frontend Development

🛠️ Development Setup

Sejm-stats is split into two environments: backend and frontend.

Backend Development

Create a .env file in the root directory with the following content:

POSTGRES_DB=example
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_PORT=5432
DATABASE_HOST=db
DEBUG=true
SECRET_KEY=does_not_matter
EMAIL_HOST_PASSWORD=only_used_when_debug_is_false
BUILD_TARGET=prod
C_FORCE_ROOT=true

Use Visual Studio Code and open the project in a devcontainer.

Run the server:

python manage.py runserver 0.0.0.0:8000

To update data, run the Celery worker:
```
celery -A core worker -l info
```

Note

🤖 The UI for the Django part is obsolete and will be removed soon.

Frontend Development

Tip

🤖 If you don't want to run the backend locally, you can use the production API. Set NEXT_PUBLIC_API_URL=https://sejm-stats.pl/apiInt in /frontend/.env file.

Install npm
Navigate to the frontend directory:
```
cd ./frontend
```
Install dependencies:
```
npm i
```
Run the development server:
```
npm run dev
```

🤝 Contributing

When creating a pull request, we enforce a specific title format using blumilksoftware/action-pr-title GitHub action. The rules are:

#123 - Some PR title - for PRs that deal with a specific issue, where 123 is the issue number
- Some PR title - for PRs that don't have a related issue

For any inquiries or contributions, please refer to our GitHub repository or join our Discord server. Your support through Patronite or feedback on YouTube is also highly appreciated.

Tip

🤖 If you have any questions, feel free to ask on Discord!

Sejm-stats is open for contributions!