Merge branch '01-edu:master' into master

Author: sadiqui

subjects/java/raids/jraffic/README.md

@@ -47,7 +47,24 @@ East ---------------             --------------- West
 
 Position traffic lights at the points where each lane enters the intersection. Your traffic lights should only have two colors: red and green.
 
-You can use any algorithm to control the traffic lights. However, the system should be efficient enough to avoid traffic congestion (8 or more vehicles). The primary aim of the traffic light system is to prevent collisions at the intersection.
+You can implement any algorithm you choose to control the traffic lights system, but bear in mind that **traffic congestion should remain below the lane’s maximum capacity**.
+
+> **Dynamic Congestion Rule:**
+> The maximum allowed queue length for each lane is calculated based on the lane’s physical length, vehicle length, and safety gap between vehicles:
+>
+> ```
+> capacity = floor(lane_length / (vehicle_length + safety_gap))
+> ```
+>
+> Where:
+>
+> - `lane_length`: Distance from the stop line to the vehicle spawn point
+> - `vehicle_length`: Approximate car length in simulation units (e.g., pixels or meters)
+> - `safety_gap`: Minimum safe distance between vehicles
+>
+> If the number of vehicles in a lane reaches this capacity, the traffic light logic should adjust (e.g., extend green time for that lane) to prevent overflow.
+
+The primary function of your traffic light system is to avoid collisions between vehicles passing through the intersection, while dynamically adapting to congestion.
 
 **3. Vehicles**
 
@@ -56,6 +73,7 @@ You can use any algorithm to control the traffic lights. However, the system sho
  /|_||_\`.__
 =`-(_)--(_)-'
 ```
+
 The vehicles traveling through your capital city's new junction must follow these rules:
 
 - Vehicles must be painted in a color that illustrates the route they will follow. The colors are up to you to decide, and your choices will need to be made available during the audit of the raid. For example, all cars which make a right turn could be painted yellow. It's really up to you though.
@@ -87,21 +105,21 @@ You will use your keyboard to spawn vehicles for your simulation. You will use t
 
 > A safe distance is any distance which enables the vehicles to avoid crashing into each other.
 
-
 ### Example
 
 You can see an example for road_intersection [here](https://www.youtube.com/watch?v=6B0-ZBET6mo).
 
 ### Bonus
+
 You can implement the following optional features:
 
 - Vehicle and traffic light animations, and image rendering. You can find some cool assets here:
-
   - [limezu](https://limezu.itch.io/)
   - [finalbossblue](http://finalbossblues.com/timefantasy/free-graphics/).
   - [mobilegamegraphics](https://mobilegamegraphics.com/product-category/all_products/freestuff/).
   - [spriters-resource](https://www.spriters-resource.com/).
 
 ### Notions
+
 - [JavaFX](https://openjfx.io/openjfx-docs/)
 - [Java KeyEvents](https://docs.oracle.com/javase/tutorial/uiswing/events/keylistener.html)

subjects/java/raids/jraffic/audit/README.md

@@ -1,7 +1,8 @@
-#### Comprehension 
+#### Comprehension
+
+**_Is the student able to justify his choices and explain the following:_**
+**_Note:_** Ask the student to show you the implementation in the source code when necessary.
 
-***Is the student able to justify his choices and explain the following:***
-***Note:*** Ask the student to show you the implementation in the source code when necessary.
 ###### Can the student explain why he uses this library?
 
 ###### Can the student explain how he manages the High-Traffic congestion
@@ -12,7 +13,7 @@
 
 ###### Can the student explain how he manages the key hooks?
 
-#### Functional 
+#### Functional
 
 ##### Try to run the application.
 
@@ -94,7 +95,7 @@
 
 ###### Was the simulation ended?
 
-###### High traffic congestion is when there are 8 or more vehicles in the same lane without proceeding. Was there low traffic congestion while running the simulation?
+###### High traffic congestion is when there are **Max Capacity** in the same lane without proceeding. Was there low traffic congestion while running the simulation?
 
 #### General
 

subjects/road_intersection/README.md

@@ -53,9 +53,24 @@ Traffic lights are signaling devices positioned at road intersections that follo
 
 You will position those traffic lights at the point where each lane enters the intersection.
 
-You can implement any algorithm you choose to control the traffic lights system, but bare in mind that traffic congestion should not be too high (8 or more vehicles).
-
-The primary function of **your** traffic light system, is to avoid collisions between vehicles passing through the intersection.
+You can implement any algorithm you choose to control the traffic lights system, but bear in mind that **traffic congestion should remain below the lane’s maximum capacity**.
+
+> **Dynamic Congestion Rule:**
+> The maximum allowed queue length for each lane is calculated based on the lane’s physical length, vehicle length, and safety gap between vehicles:
+>
+> ```
+> capacity = floor(lane_length / (vehicle_length + safety_gap))
+> ```
+>
+> Where:
+>
+> - `lane_length`: Distance from the stop line to the vehicle spawn point
+> - `vehicle_length`: Approximate car length in simulation units (e.g., pixels or meters)
+> - `safety_gap`: Minimum safe distance between vehicles
+>
+> If the number of vehicles in a lane reaches this capacity, the traffic light logic should adjust (e.g., extend green time for that lane) to prevent overflow.
+
+The primary function of your traffic light system is to avoid collisions between vehicles passing through the intersection, while dynamically adapting to congestion.
 
 **3. Vehicles**
 
@@ -105,7 +120,6 @@ You can see an example for road_intersection [here](https://www.youtube.com/watc
 You can implement the following optional features:
 
 - Vehicle and traffic light animations, and image rendering. You can find some cool assets here:
-
   - [limezu](https://limezu.itch.io/)
   - [finalbossblue](http://finalbossblues.com/timefantasy/free-graphics/).
   - [spriters-resource](https://www.spriters-resource.com/).

subjects/road_intersection/audit/README.md

@@ -76,7 +76,7 @@
 
 ###### Was the simulation ended?
 
-###### High traffic congestion is when there are 8 or more vehicles in the same lane without proceeding. Was there low traffic congestion while running the simulation?
+###### High traffic congestion is when there are **Max Capacity** in the same lane without proceeding. Was there low traffic congestion while running the simulation?
 
 #### General