How manish-code-7/vtu-cgpa-calculator works
Project type and purpose
• This is a Spring Boot–based, full-stack web application that demonstrates software quality assurance (SQA) by providing two parallel implementations of a VTU CGPA calculator: one “good” (fully tested, robust, correct) and one “bad” (deliberate logical flaws, poor validation, minimal testing).
• The primary goal is educational: let users compare how SQA practices affect correctness, robustness, and maintainability.
File structure
• Top level
• Dockerfile, .dockerignore, pom.xml (build & container config)
• README.md (project overview)
• src/main/java/com/example/vtucgpa/
• VTUCgpaApplication.java (Spring Boot entry point)
• controller/ (HTTP routing for good vs. bad flows)
• service/ (business logic for each flow)
• model/ (request and response DTOs for each flow)
• src/main/resources/templates/
• index.html (landing page with links)
• good-cgpa.html, bad-cgpa.html (Thymeleaf templates for each flow)
• src/test/java/com/example/vtucgpa/
• GoodCGPAServiceTest.java (tests showcasing robust, correct behavior)
• BadCGPAServiceTest.java (tests failing or passing incorrectly to illustrate poor SQA)
README for additional insights
• Confirms MVC pattern with separate controllers, services, models, and templates
• Explains the two flows, how to run the app, and the learning outcomes
Putting it all together
Path A (Good): GoodCGPAController → GoodCGPAService → GoodCGPASemesterRequest/Result → Thymeleaf good-cgpa.html
Path B (Bad): BadCGPAController → BadCGPAService → BadCGPASemesterRequest/Result → Thymeleaf bad-cgpa.html