This server repository should be cloned, and the server should be kept running during the functionality review.
- Angular 17
- NgRx for state management
- RxJS for reactive programming
- Angular Material for UI components
- ESLint and Prettier for code linting and formatting
- Deployment Platform: Successfully deploy the UI on one of the following platforms: GitHub Pages, Netlify, Vercel, Cloudflare Pages, or a similar service.
-
Commit guidelines compliance: Ensure that all commits follow the specified commit guidelines, thereby promoting a clear and consistent commit history. This includes using meaningful commit messages that accurately describe the changes made.
-
Checklist included in README.md: Include the project's checklist in the README.md file. Mark all implemented features to provide a clear overview of the project's completion status.
-
Score calculation: Use this checklist to calculate your score. Check all implemented features, then calculate your score and put it at the top of the
README.md
. -
UI Deployment link in README.md: Place the link to the deployed UI at the top of the README.md file, alongside the calculated score.
- Two Views (10 points): Implement two primary views: "Garage" and "Winners".
- Garage View Content (5 points): The "Garage" view must display its name, the current page number, and the total number of cars in the database (how many car user has in his garage).
- Winners View Content (5 points): The "Winners" view should similarly display its name, the current page number, and the total count of records in the database (how many records the winners table contains).
- Persistent State (10 points): Ensure the view state remains consistent when navigating between views. This includes preserving page numbers and input states. For example, page number shouldn't be reset, input controls should contain that they contained before switching, etc.
- CRUD Operations (20 points): Enable users to create, update, and delete cars, and display the list of cars. A car has two attributes: "name" and "color". For "delete"-operation car should be deleted from "garage" table as well as from "winners".
- Color Selection (10 points): Allow color selection from an RGB palette (like here), displaying the selected color on the car's image along with its name.
- Management Buttons (5 points): Provide buttons near each car's image for updating its attributes or deleting it.
- Pagination (10 points): Implement pagination for the "Garage" view, displaying 7 cars per page.
- Random Car Creation (10 points): There should be a button to create random cars (100 cars per click). Name should be assembled from two random parts, for example "Tesla" + "Model S", or "Ford" + "Mustang" (At least 10 different names for each part). Color should be also generated randomly.
- Engine Control Buttons (10 points): Place start/stop engine buttons near each car's image.
- Start Engine Animation (20 points): User clicks to the engine start button -> UI is waiting for car's velocity answer -> animate the car and makes another request to drive. In case api returned 500 error car animation should be stopped.
- Stop Engine Animation (10 points): User clicks to the engine stop button -> UI is waiting for answer for stopping engine -> car returned to it's initial place.
- Button States (5 points): Start engine button should be disabled in case car is already in driving mode. As well as stop engine button should be disabled when car is on it's initial place.
- Responsive Animation (5 points): Ensure car animations are fluid and responsive on screens as small as 500px.
- Start Race Button (15 points): Implement a button to start the race for all cars on the current page.
- Reset Race Button (10 points): Create a button to reset the race, returning all cars to their starting positions.
- Winner Announcement (10 points): After some car finishes first user should see the message contains car's name that shows which one has won.
- Display Winners (15 points): After some car wins it should be displayed at the "Winners view" table.
- Pagination for Winners (10 points): Implement pagination for the "Winners" view, with 10 winners per page.
- Winners Table (10 points): The table should include columns for the car's โ, image, name, number of wins, and best time in seconds. If the same car wins more than once the number of wins should be incremented while best time should be saved only if it's better than the stored one.
- Sorting Functionality (10 points): Allow users to sort the table by the number of wins and best time, in ascending or descending order.
- Modular Design (40 points): The application should be clearly divided into logical modules or layers, such as API interaction, UI rendering, and state management. Consultation with a mentor on the architecture before implementation is advised.
- JavaScript-Generated HTML Content (30 points): All HTML content must be dynamically generated using JavaScript, with the
<body>
tag containing only a single<script>
tag.
- SPA Implementation (25 points): The application must be a Single Page Application (SPA) using either React v18+ or Angular v17+. All content must be generated using TypeScript with
strict
andnoImplicitAny
settings enabled intsconfig.json
, ensuring seamless user experience without page reloads during navigation.
- Use of Webpack or Similar (20 points): Implement Webpack or another bundling tool to compile the project into a minimal set of files, ideally one HTML file, one JS file, and one CSS file. Ensure that the configuration enforces TypeScript strict type checking.
- Eslint with Airbnb Style Guide (15 points): Code must adhere to the Airbnb ESLint configuration to maintain code quality, as outlined in the Airbnb style guide. Specific rules may be adjusted only with mentor approval, and there should be no ESLint errors or warnings.
- Function Modularization (10 points): Code should be organized into small, clearly named functions with specific purposes. Each function should not exceed 40 lines, reflecting strong typing and avoiding the use of magic numbers or strings.
- Code Duplication and Magic Numbers (5 points): Minimize code duplication and maintain readability by avoiding the use of magic numbers or strings throughout the codebase.
- Prettier Setup (5 points): Prettier is correctly set up with two scripts in
package.json
:format
for auto-formatting andci:format
for checking issues. - ESLint Configuration (5 points): ESLint is configured with the Airbnb style guide. A
lint
script inpackage.json
runs ESLint checks. Configuration files should reflect strict TypeScript settings as pertsconfig.json
.
- (Up to 35 points) Discretionary points awarded by the reviewer based on overall code quality, readability