Bowling Score Tracker

Description

Bowling Score Tracker is an application designed to allow users to track and manage bowling scores. It consists of two main components: a backend API and a frontend web application.

High-Level Requirements

1. Game Management

   • Create new bowling games
   • Add multiple players to a game
   • Record scores for each frame
   • Calculate running totals and final scores

2. Score Tracking

   • Input and update frame scores for each player
   • Handle special scoring rules (strikes, spares)

3. Statistics and History

   • View game history
   • Display player statistics

Completed Features Checklist

• Core logic implementation of bowling score rules
• Backend REST API development
• Swagger documentation for API endpoints
• Logging system implementation
• Unit test for core logic
• Integration test for APIs

To-Do Checklist

• Frontend development to allow submitting frames for players
• Implement data storage in the database
• Complete full set of APIs to support all functionalities
• Integrate frontend with backend APIs
• Implement user authentication and authorization
• Add game history and statistics features

High-Level Architecture

The application is split into two main components:

1. Backend API (NestJS)

   • RESTful API endpoints
   • Business logic implementation
   • Data persistence

2. Frontend Web Application (React)

   • User interface
   • State management
   • API integration
   • Responsive design with Tailwind CSS

Technology Stack

Backend

• NestJS
• TypeScript
• PostgreSQL (via TypeORM)
• Jest (for testing)
• Swagger (for API documentation)

Frontend

• React
• TypeScript
• Tailwind CSS
• React Query (for state management and API calls)
• Jest and React Testing Library (for testing)

Deployment Diagram