A dystopian Social Credit System simulation where citizens are ranked, judged, and tiered based on their behavior.
Warning
This was a project built during the Odoo Hackathon 5th edition in 48 hours, expect code to be messy or bugs to be found.
Tiering Machine simulates a society where every action is monitored and scored. It features an AI-powered judicial system that evaluates reports and assigns point penalties or rewards, determining a citizen's social standing.
The project is divided into three main components:
- Client: A React-based frontend providing the user interface for citizens and administrators.
- Server: A Spring Boot backend handling logic, AI integration, and data persistence.
- Database: PostgreSQL database schema and data.
- Frontend: React, TypeScript, Vite, Material UI, React Three Fiber
- Backend: Java 21, Spring Boot 3.2, Gradle (Kotlin DSL)
- Database: PostgreSQL
- AI: Groq API (Llama 3.1)
- DevOps: Docker
Note
Development commits were made in other repositories, this repository is a bundled version of the project.
- Frontend: Tiering-Machine-FE (DELETED)
- Backend: Tiering-Machine-BE (PRIVATE)
- Database: No Git
- Frontend: Combell Web Hosting
- Backend: Azure App Service (Container)
- Database: Azure Database for PostgreSQL flexible servers
Note
Web application is deployed on the cloud on low tiers of Azure. Expect some latency.
Please refer to the specific READMEs for each component to get started:
- Frontend/DevOps Lead: Aryan (Github)
- Backend Lead: MJ (Github)
- Database Lead: Sahir (Github)