Learnify is a gamified educational platform developed as a final-year academic project by Antonio Carlos Leite Junior.
Learnify supports a study journey organized around subjects and learning content. Students can create an account or log in, choose a subject, access its content, answer quizzes, and follow their learning progress through scores, statistics, achievements, and a ranking.
The solution combines a React web application, a Spring Boot REST API, and PostgreSQL persistence. It is prepared to run as a multi-service stack with Docker Compose.
- Account registration, login, logout, and account deletion.
- JWT-based authentication for protected areas.
- Subject and content browsing.
- Quizzes and answer submission.
- Progress and score updates after quizzes.
- Dashboard with statistics and achievements.
- Paginated user ranking.
- Authenticated user profile.
- Interactive API documentation.
- A student creates an account or signs in.
- The student selects a subject and opens its content.
- The student answers quizzes associated with that content.
- The API records the result and updates progress and score data.
- The application presents statistics, achievements, and ranking information.
The repository records my work as the project author across the full-stack solution, including:
- The React frontend flows for authentication, subjects, content, quizzes, dashboard, profile, gamification, and ranking.
- The Spring Boot API structure for authentication, domain resources, persistence, and health monitoring.
- Automated unit, integration, and end-to-end test coverage for the implemented application flows.
- Local container orchestration for the web application, API, and PostgreSQL database.
- Frontend: React, TypeScript, Vite, React Router, Axios, TanStack React Query, Zustand, React Hook Form, Zod, and Tailwind CSS.
- Backend: Java, Spring Boot, Spring Web MVC, Spring Data JPA, Spring Security, JJWT, and Spring Boot Actuator.
- Database: PostgreSQL with Hibernate through Spring Data JPA.
- Testing: Vitest, Testing Library, JUnit 5, H2, Testcontainers, JaCoCo, and Playwright.
- Infrastructure: Docker and Docker Compose.
From the repository root, create the local environment files and start the complete stack with:
./scripts/setup-local.sh
docker compose up --buildThe setup script copies the tracked .env.example templates into local .env files and generates a local JWT secret. These generated files are ignored by Git and must not be committed.
Open the web application at http://localhost:5173. The API is available at http://localhost:8080.
The repository already includes continuous integration through GitHub Actions for automated builds, tests, linting, coverage checks, and E2E validation. Extending that workflow with a confirmed continuous delivery step, such as deployment or release publication, is a possible next improvement.
See LICENSE for the project's terms of use.
