Merge branch 'release/v2.0.0'

Author: MirkoZETA

.github/workflows/README_DEV.md .github/workflows/README.md.github/workflows/README_DEV.md renamed to .github/workflows/README.md

@@ -43,8 +43,11 @@ This guide helps developers set up, test, and deploy the Flex Net Sim Backend AP
    # Test help endpoint
    curl http://127.0.0.1:5000/help
 
-   # Test simulation endpoint
+   # Test standard simulation endpoint
    curl -X POST -H "Content-Type: application/json" -d '{}' http://127.0.0.1:5000/run_simulation
+   
+   # Test streaming simulation endpoint
+   curl -N -X POST -H "Content-Type: application/json" -d '{"goalConnections": 50000}' http://127.0.0.1:5000/run_simulation_stream
    ```
 
 ## Testing
@@ -119,7 +122,11 @@ Follow the Google Cloud setup steps from the video, focusing on:
     Use the `curl` command with the `ENDPOINT-URL` you obtained from the previous steps to test your deployed API. Replace `YOUR-ENDPOINT-URL` with the actual `ENDPOINT-URL`.
 
     ```bash
+    # Test standard endpoint
     curl -X POST -H "Content-Type: application/json" -d '{"algorithm": "FirstFit", "networkType": 1, "bitrate": "fixed-rate"}' <YOUR-ENDPOINT-URL>/run_simulation
+    
+    # Test streaming endpoint
+    curl -N -X POST -H "Content-Type: application/json" -d '{"algorithm": "FirstFit", "goalConnections": 5000000}' <YOUR-ENDPOINT-URL>/run_simulation_stream
     ``` 
 
     Remember that depending on the authetification preferences you might need to authetificate to send request to the Endpoint just created.

.gitignore

@@ -10,4 +10,7 @@ simulation.out
 # Test files
 .coverage
 htmlcov
-.pytest_cache
+.pytest_cache
+
+# Claude Code
+CLAUDE.md

CHANGELOG.md

@@ -5,15 +5,37 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
-
 ### ROADMAP
-- Switch to Flex Net Sim v0.8.2.
-- Enhance previous algorithms.
-- Add algorithm BestFit.
 - Switch to new domain.
 
-## [1.1.1] - 2023-03-01
+## [2.0.0] - 2025-03-03
+
+### Added
+- New `/run_simulation_stream` endpoint for streaming simulation results in real-time:
+  - Streaming responses include event types and structured JSON data.
+- Refactored backend code to reduce duplication and improve maintainability.
+- Added unit tests for the streaming endpoint.
+- Modified `simulator.hpp` to flush `stdout` after each line for better streaming support (see `src/README.md`).
+- Improved the `\help` endpoint with more concise documentation.
+- Enabled CORS only for the `/run_simulation_stream` endpoint to allow controlled API access.
+
+### Changed
+- Switched to Flex Net Sim v0.8.2.
+- Standardized API response format for better consistency:
+  - Success responses now use `status: "success"` with data in a `data` field.
+  - Error responses now use `status: "error"` with a `message` and detailed `error` fields.
+- Reorganized the test suite into separate files for better maintainability.
+- Improved parameter validation with descriptive error messages.
+- Changed the error response code from `500` to `400` for invalid parameters.
+- Moved parameter validation from C++ to the API layer for a better user experience.
+- Replaced the `ExactFit` algorithm with `BestFit`.
+- Enhanced algorithms
+
+### Fixed
+- Fixed error in main.cpp always using FirstFit
+- Fixed error in main.cpp always using Fixed-Rate
+
+## [1.1.1] - 2025-03-01
 
 ### Added
 - Deployed coverage to pages
@@ -47,7 +69,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - This API hopefully serves as playground to all new users of Flex Net Sim C++ simulation library.
 - The current version utilizes Flex Net Sim v0.8.1.
 - `/run_simulation` endpoint for simulation includes parameters such as:
-    - `algorithm`: FirstFit, ExactFit.
+    - `algorithm`: FirstFit, BestFit.
     - `networkType`: Only 1 (EON) available for now.
     - `goalConnections`: 1 to 10,000,000.
     - `confidence`: significance level (alpha) greater than zero.
@@ -60,5 +82,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - API allocated in cloud run.
 - Documentation README for the process of develop/deployment located in [workflows](https://github.com/MirkoZETA/FlexNetSim-API/tree/master/.github/workflows/README_DEV.md).
 
-[1.1.0]: https://github.com/MirkoZETA/FlexNetSim-API/releases/tag/v1.1.0
 [1.0.0]: https://github.com/MirkoZETA/FlexNetSim-API/releases/tag/v1.0.0
+[1.1.0]: https://github.com/MirkoZETA/FlexNetSim-API/releases/tag/v1.1.0
+[1.1.1]: https://github.com/MirkoZETA/FlexNetSim-API/releases/tag/pipeline-fix
+[2.0.0]: https://github.com/MirkoZETA/FlexNetSim-API/releases/tag/v2.0.0

README.md

@@ -1,10 +1,10 @@
 # Flex Net Sim Backend API
 
-[![Static Badge](https://img.shields.io/badge/version-1.1.0-blue)](https://github.com/MirkoZETA/FlexNetSim-API)
+[![Static Badge](https://img.shields.io/badge/version-2.0.0-blue)](https://github.com/MirkoZETA/FlexNetSim-API)
 ![Static Badge](https://img.shields.io/badge/language-python-blue)
 [![Static Badge](https://img.shields.io/badge/licese-MIT-green)](https://github.com/MirkoZETA/FlexNetSim-API/blob/master/LICENSE)
 [![Static Badge](https://github.com/MirkoZETA/FlexNetSim-API/actions/workflows/fns-api-workflow.yml/badge.svg)](https://github.com/MirkoZETA/FlexNetSim-API/actions/workflows/fns-api-workflow.yml)
-[![Static Badge](https://img.shields.io/badge/coverage-94%25-brightgreen)](https://mirkozeta.github.io/FlexNetSim-API/coverage/)
+[![Static Badge](https://img.shields.io/badge/coverage-95%25-brightgreen)](https://mirkozeta.github.io/FlexNetSim-API/coverage/)
 
 A lightweight API for running optical network simulations with [Flex Net Sim C++](https://gitlab.com/DaniloBorquez/flex-net-sim).
 
@@ -34,13 +34,13 @@ For development and deployment instructions for this API, refer to [README_DEV.m
 
 ### `/run_simulation` (POST)
 
-Runs a network simulation with the provided parameters.
+Runs a network simulation with the provided parameters and returns complete results.
 
 #### Request Parameters
 
 | Parameter       | Type      | Description                | Allowed Values & Constraints                                   | Default   |
 |---------------|---------|----------------------------|-------------------------------------------------|-----------|
-| `algorithm`    | `string`  | RSA algorithm              | `FirstFit`, `ExactFit`                         | `FirstFit` |
+| `algorithm`    | `string`  | RSA algorithm              | `FirstFit`, `BestFit`                         | `FirstFit` |
 | `networkType`  | `integer` | Network type               | Only `1` (EON) supported                        | `1`       |
 | `goalConnections` | `integer` | Target connection requests | Must be > 0 and < 10,000,000                   | `100000`  |
 | `confidence`   | `float`   | Confidence level           | Must be > 0 and < 1.0                           | `0.05`    |
@@ -74,9 +74,84 @@ curl -X POST -H "Content-Type: application/json" \
 https://fns-api-cloud-run-787143541358.us-central1.run.app/run_simulation
 ```
 
+#### Response Format
+
+```json
+{
+  "status": "success",
+  "data": "simulation results as text..."
+}
+```
+
+#### Response Codes
+
+- `200 OK`: Success
+- `400 Bad Request`: Invalid parameters
+- `500 Internal Server Error`: Server-side error
+
+### `/run_simulation_stream` (POST)
+
+Runs a network simulation with the provided parameters and streams results in real-time using Server-Sent Events (SSE).
+
+#### Request Parameters
+
+Same parameters as `/run_simulation` endpoint.
+
+#### Example: Streaming with Default Parameters
+
+```bash
+curl -N -X POST -H "Content-Type: application/json" -d '{}' \
+  https://fns-api-cloud-run-787143541358.us-central1.run.app/run_simulation_stream
+```
+
+#### Example: Streaming with Custom Parameters
+
+```bash
+curl -N -X POST -H "Content-Type: application/json" \
+-d '{ 
+  "algorithm": "FirstFit",
+  "networkType": 1,
+  "goalConnections": 5000000,
+  "confidence": 0.05,
+  "lambdaParam": 120,
+  "mu": 1,
+  "network": "NSFNet",
+  "bitrate": "fixed-rate"
+}' \
+https://fns-api-cloud-run-787143541358.us-central1.run.app/run_simulation_stream
+```
+
+#### Response Format
+
+The endpoint returns a stream of Server-Sent Events with the following event types:
+
+1. **Start Event**:
+   ```
+   event: start
+   data: {"status": "started", "message": "Simulation started"}
+   ```
+
+2. **Data Events** (multiple events, one per line of output):
+   ```
+   event: data
+   data: {"status": "running", "message": "Line of simulation output"}
+   ```
+
+3. **End Event**:
+   ```
+   event: end
+   data: {"status": "completed", "message": "Simulation completed"}
+   ```
+
+4. **Error Event** (only if an error occurs):
+   ```
+   event: error
+   data: {"status": "error", "message": "Error description", "error": "Detailed error"}
+   ```
+
 #### Response Codes
 
-- `200 OK`: Success. Returns `{"output": "...", "error": ""}`
+- `200 OK`: Success (stream starts)
 - `400 Bad Request`: Invalid parameters
 - `500 Internal Server Error`: Server-side error