Merge branch 'master' into patch-24

pedrodesu · web-flow · commit 07bd06f6b70e · 2025-08-28T01:51:24.000+01:00
diff --git a/subjects/ascii-art-web/README.md b/subjects/ascii-art-web/README.md
@@ -15,8 +15,8 @@ Implement the following HTTP endpoints:
 1. GET `/`: Sends HTML response, the main page.\
    1.1. GET Tip: [go templates](https://golang.org/pkg/html/template/) to receive and display data from the server.
 
-2. POST `/ascii-art`: that sends data to Go server (text and a banner)\
-   2.1. POST Tip: use form and other types of [tags](https://developer.mozilla.org/en-US/docs/Web/HTML/Element) to make the post request.\
+2. POST `/ascii-art`: that sends data (text and specified banner) to the Go server.\
+   2.1. POST Tip: use form and other types of [tags](https://developer.mozilla.org/en-US/docs/Web/HTML/Element) to make the post request.
 
 The way you display the result from the POST is up to you. What we recommend are one of the following :
 
@@ -25,18 +25,18 @@ The way you display the result from the POST is up to you. What we recommend are
 
 The main page must have:
 
-- text input
-- radio buttons, select object or anything else to switch between banners
-- button, which sends a POST request to '/ascii-art' and outputs the result on the page.
+- a text input field
+- radio buttons, select object or another method to switch between banners
+- a button that sends a POST request to '/ascii-art' and displays the result on the page.
 
 ### HTTP status code
 
 Your endpoints must return appropriate HTTP status codes.
 
-- OK (200), if everything went without errors.
-- Not Found, if nothing is found, for example templates or banners.
-- Bad Request, for incorrect requests.
-- Internal Server Error, for unhandled errors.
+- 200 OK, if everything went without errors.
+- 404 Not Found, if nothing is found, for example templates or banners.
+- 400 Bad Request, for incorrect requests.
+- 500 Internal Server Error, for unhandled errors.
 
 ## Markdown
 
diff --git a/subjects/ascii-art/README.md b/subjects/ascii-art/README.md
@@ -36,7 +36,6 @@ $$@@$$$$$$$$``````````@@$$@@$$$$$$
 - It is recommended to have **test files** for [unit testing](https://go.dev/doc/tutorial/add-a-test).
 
 - Some **banner** files with a specific graphical template representation using ASCII will be given. The files are formatted in a way that is not necessary to change them.
-
   - [shadow](shadow.txt)
   - [standard](standard.txt)
   - [thinkertoy](thinkertoy.txt)
@@ -113,32 +112,32 @@ student$ go run . "HeLlO" | cat -e
                                       $
                                       $
 student$ go run . "Hello There" | cat -e
- _    _          _   _               _______   _                           $
-| |  | |        | | | |             |__   __| | |                          $
-| |__| |   ___  | | | |   ___          | |    | |__     ___   _ __    ___  $
-|  __  |  / _ \ | | | |  / _ \         | |    |  _ \   / _ \ | '__|  / _ \ $
-| |  | | |  __/ | | | | | (_) |        | |    | | | | |  __/ | |    |  __/ $
-|_|  |_|  \___| |_| |_|  \___/         |_|    |_| |_|  \___| |_|     \___| $
-                                                                           $
-                                                                           $
+ _    _          _   _                 _______   _                           $
+| |  | |        | | | |               |__   __| | |                          $
+| |__| |   ___  | | | |   ___            | |    | |__     ___   _ __    ___  $
+|  __  |  / _ \ | | | |  / _ \           | |    |  _ \   / _ \ | '__|  / _ \ $
+| |  | | |  __/ | | | | | (_) |          | |    | | | | |  __/ | |    |  __/ $
+|_|  |_|  \___| |_| |_|  \___/           |_|    |_| |_|  \___| |_|     \___| $
+                                                                             $
+                                                                             $
 student$ go run . "1Hello 2There" | cat -e
-     _    _          _   _                      _______   _                           $
- _  | |  | |        | | | |              ____  |__   __| | |                          $
-/ | | |__| |   ___  | | | |   ___       |___ \    | |    | |__     ___   _ __    ___  $
-| | |  __  |  / _ \ | | | |  / _ \        __) |   | |    |  _ \   / _ \ | '__|  / _ \ $
-| | | |  | | |  __/ | | | | | (_) |      / __/    | |    | | | | |  __/ | |    |  __/ $
-|_| |_|  |_|  \___| |_| |_|  \___/      |_____|   |_|    |_| |_|  \___| |_|     \___| $
-                                                                                      $
-                                                                                      $
+     _    _          _   _                         _______   _                           $
+ _  | |  | |        | | | |                ____   |__   __| | |                          $
+/ | | |__| |   ___  | | | |   ___         |___ \     | |    | |__     ___   _ __    ___  $
+| | |  __  |  / _ \ | | | |  / _ \          __) |    | |    |  _ \   / _ \ | '__|  / _ \ $
+| | | |  | | |  __/ | | | | | (_) |        / __/     | |    | | | | |  __/ | |    |  __/ $
+|_| |_|  |_|  \___| |_| |_|  \___/        |_____|    |_|    |_| |_|  \___| |_|     \___| $
+                                                                                         $
+                                                                                         $
 student$ go run . "{Hello There}" | cat -e
-   __  _    _          _   _               _______   _                           __    $
-  / / | |  | |        | | | |             |__   __| | |                          \ \   $
- | |  | |__| |   ___  | | | |   ___          | |    | |__     ___   _ __    ___   | |  $
-/ /   |  __  |  / _ \ | | | |  / _ \         | |    |  _ \   / _ \ | '__|  / _ \   \ \ $
-\ \   | |  | | |  __/ | | | | | (_) |        | |    | | | | |  __/ | |    |  __/   / / $
- | |  |_|  |_|  \___| |_| |_|  \___/         |_|    |_| |_|  \___| |_|     \___|  | |  $
-  \_\                                                                            /_/   $
-                                                                                       $
+   __  _    _          _   _                 _______   _                           __    $
+  / / | |  | |        | | | |               |__   __| | |                          \ \   $
+ | |  | |__| |   ___  | | | |   ___            | |    | |__     ___   _ __    ___   | |  $
+/ /   |  __  |  / _ \ | | | |  / _ \           | |    |  _ \   / _ \ | '__|  / _ \   \ \ $
+\ \   | |  | | |  __/ | | | | | (_) |          | |    | | | | |  __/ | |    |  __/   / / $
+ | |  |_|  |_|  \___| |_| |_|  \___/           |_|    |_| |_|  \___| |_|     \___|  | |  $
+  \_\                                                                              /_/   $
+                                                                                         $
 student$ go run . "Hello\nThere" | cat -e
  _    _          _   _          $
 | |  | |        | | | |         $
diff --git a/subjects/blockchain/retrieve-transaction-in-out/README.md b/subjects/blockchain/retrieve-transaction-in-out/README.md
@@ -15,7 +15,7 @@ _+ 0.01 fee_
 
 ### Instructions
 
-Using a local Bitcoin node RPC API, create a function `retrieveTxValue()` that takes as input a hash of a simple transaction, and returns an object with an array of inputs values and an array outputs values in this transaction.
+Using a local Bitcoin node RPC API, create a function `retrieveTransactionInOut()` that takes as input a hash of a simple transaction, and returns an object with an array of inputs values and an array outputs values in this transaction.
 
 The Bitcoin node RPC interface is expected to be running with the following parameters:
 
@@ -29,8 +29,8 @@ rpcpassword=multipass
 ### Usage
 
 ```js
-txHash = 'd030023d96b9170af9ec2fe5d9b62a5eacbcbf144c68f3f45d68bca72d1d3649'
-retrieveTxData(txHash)
+txHash = "d030023d96b9170af9ec2fe5d9b62a5eacbcbf144c68f3f45d68bca72d1d3649";
+retrieveTxData(txHash);
 /* Expected : 
     { 
       in: [ 0.18075094 ], 
diff --git a/subjects/box_recursion/README.md b/subjects/box_recursion/README.md
@@ -30,11 +30,11 @@ pub struct WorkEnvironment {
     pub grade: Link,
 }
 
-pub type Link;
+pub type Link = _; // Complete type alias
 
 #[derive(Debug)]
 pub struct Worker {
-    pub role: String,
+    pub role: Role,
     pub name: String,
     pub next: Link,
 }
diff --git a/subjects/get_document_id/README.md b/subjects/get_document_id/README.md
@@ -13,7 +13,7 @@ Create the following structures which will help you get the `document_id` of the
 
 The `u32` is the `id` of the office generating the error.
 
-Beside the structures, you must create a **function** named `get_document_id`, and associate it to the `OfficeOne` structure.
+Besides the structures, you must create a **function** named `get_document_id`, and associate it to the `OfficeOne` structure.
 
 This **function** should return the `Result` value in the `OfficeFour` structure or the first `Err` it finds in the chain.
 
diff --git a/subjects/java/raids/jraffic/README.md b/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)
diff --git a/subjects/java/raids/jraffic/audit/README.md b/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
 
diff --git a/subjects/make-your-game/score-handling/audit/README.md b/subjects/make-your-game/score-handling/audit/README.md
@@ -1,6 +1,6 @@
 #### Functional
 
-###### Has the requirement for the allowed packages been respected? (Reminder for this project: only [standard packages](https://golang.org/pkg/))
+###### Has the requirement for the allowed packages been respected? (Reminder for this project: only [standard packages](https://golang.org/pkg/) and [Gorilla](https://pkg.go.dev/github.com/gorilla/websocket))
 
 ##### Play and finish the game.
 
diff --git a/subjects/previousprime/README.md b/subjects/previousprime/README.md
@@ -2,7 +2,7 @@
 
 ### Instructions
 
-Create a **function** which returns the first prime number which is less than or equal to the `u64` passed as an argument.
+Create a **function** which returns the biggest prime number which is smaller than the `u64` passed as an argument.
 
 If there are no smaller primes, the function should return `0`.
 
@@ -13,13 +13,13 @@ If there are no smaller primes, the function should return `0`.
 
 ```rust
 pub fn prev_prime(nbr: u64) -> u64  {
-
+    todo!()
 }
 ```
 
 ### Usage
 
-Here is a possible program to test your function :
+Here is a possible program to test your function:
 
 ```rust
 use previousprime::*;
@@ -29,7 +29,7 @@ fn main() {
 }
 ```
 
-And its output :
+And its output:
 
 ```console
 $ cargo run
diff --git a/subjects/previousprime/main.rs b/subjects/previousprime/main.rs
diff --git a/subjects/real-time-forum/typing-in-progress/README.md b/subjects/real-time-forum/typing-in-progress/README.md
@@ -19,7 +19,7 @@ This engine must have/display:
 - A websocket to establish the connection with both users
 - An animation so that the user can see that you are typing, this animation should be smooth (no interruptions/janks) and just enough to draw attention for the user to see (user friendly)
 - The name of the user that is typing
-- Whenever the user stops typing or finishes the conversation, it should not display the animation
+- Whenever the user stops typing or finishes the conversation, it should not display the animation, a short delay may optionally be added for better UX
 
 To help with the display of the typing in progress you can take a look on the js [event](https://developer.mozilla.org/en-US/docs/Web/Events) list, mainly the **Keyboard events** and the **Focus events**
 
diff --git a/subjects/real-time-forum/typing-in-progress/audit.md b/subjects/real-time-forum/typing-in-progress/audit.md
@@ -2,7 +2,7 @@
 
 ###### Has the requirement for the allowed packages been respected? (Check the [allowed packages](README.md))
 
-##### Open two browsers (ex: Chrome and Firefox or private windows) and log in with different users in each one. With one user start typing.
+##### Open two browsers (ex: Chrome and Firefox or private windows) and log in with different users in each. Start typing with one of the users.
 
 ###### Is there any animation confirming that the typing in progress is working?
 
@@ -18,13 +18,13 @@
 
 ###### Can you confirm that the typing in progress has the name of the user that is typing?
 
-##### Open two browsers (ex: Chrome and Firefox or private windows) and log in with different users in each one. With one user starting to type and then stopping.
+##### Using the same two browsers, start typing with one of the users, then stop typing.
 
 ###### Can you confirm that the typing in progress engine stopped when the user stop typing?
 
-##### Open two browsers (ex: Chrome and Firefox or private windows) and log in with different users in each one, then start a conversation between the users.
+##### Using the same two browsers, start a conversation between two users.
 
-###### Is the typing in progress engine working properly for both users? (each one can see when whether the other is typing or not)
+###### Is the typing in progress engine working properly for both users? (each one should be able to see whether the other is typing or not)
 
 #### Bonus
 
diff --git a/subjects/real-time-forum/typing-in-progress/audit/README.md b/subjects/real-time-forum/typing-in-progress/audit/README.md
@@ -2,7 +2,7 @@
 
 ###### Has the requirement for the allowed packages been respected? (Check the [allowed packages](README.md))
 
-##### Open two browsers (ex: Chrome and Firefox or private windows) and log in with different users in each one. With one user start typing.
+##### Open two browsers (ex: Chrome and Firefox or private windows) and log in with different users in each. Start typing with one of the users.
 
 ###### Is there any animation confirming that the typing in progress is working?
 
@@ -18,13 +18,13 @@
 
 ###### Can you confirm that the typing in progress has the name of the user that is typing?
 
-##### Open two browsers (ex: Chrome and Firefox or private windows) and log in with different users in each one. With one user starting to type and then stopping.
+##### Using the same two browsers, start typing with one of the users, then stop typing.
 
 ###### Can you confirm that the typing in progress engine stopped when the user stop typing?
 
-##### Open two browsers (ex: Chrome and Firefox or private windows) and log in with different users in each one, then start a conversation between the users.
+##### Using the same two browsers, start a conversation between two users.
 
-###### Is the typing in progress engine working properly for both users? (each one can see when whether the other is typing or not)
+###### Is the typing in progress engine working properly for both users? (each one should be able to see whether the other is typing or not)
 
 #### Bonus
 
diff --git a/subjects/road_intersection/README.md b/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/).
diff --git a/subjects/road_intersection/audit/README.md b/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
 
diff --git a/subjects/rot21/README.md b/subjects/rot21/README.md

Original file line number	Diff line number	Diff line change
`@@ -30,11 +30,11 @@ pub struct WorkEnvironment {`
`30`	`30`	`pub grade: Link,`
`31`	`31`	`}`
`32`	`32`
`33`		`-pub type Link;`
	`33`	`+pub type Link = _; // Complete type alias`
`34`	`34`
`35`	`35`	`#[derive(Debug)]`
`36`	`36`	`pub struct Worker {`
`37`		`- pub role: String,`
	`37`	`+ pub role: Role,`
`38`	`38`	`pub name: String,`
`39`	`39`	`pub next: Link,`
`40`	`40`	`}`