Initial commit.

Author: franckferman

LICENSE

@@ -0,0 +1,110 @@
+<div id="top" align="center">
+
+<!-- Shields Header -->
+[![Contributors][contributors-shield]](https://github.com/franckferman/Monty-Hall-Problem-Simulator/graphs/contributors)
+[![Forks][forks-shield]](https://github.com/franckferman/Monty-Hall-Problem-Simulator/network/members)
+[![Stargazers][stars-shield]](https://github.com/franckferman/Monty-Hall-Problem-Simulator/stargazers)
+[![License][license-shield]](https://github.com/franckferman/Monty-Hall-Problem-Simulator/blob/stable/LICENSE)
+
+<!-- Logo -->
+<a href="https://github.com/franckferman/Monty-Hall-Problem-Simulator">
+  <img src="https://raw.githubusercontent.com/franckferman/Monty-Hall-Problem-Simulator/refs/heads/stable/docs/github/graphical_resources/Logo-Monty-Hall-Problem-Simulator.png" alt="Monty-Hall-Problem-Simulator Logo" width="auto" height="auto">
+</a>
+
+<!-- Title & Tagline -->
+<h3 align="center">🚪 Monty Hall Problem Simulator</h3>
+<p align="center">
+    <em>Simulate, analyze, and visualize your chances in the famous Monty Hall paradox.</em>
+    <br>
+    A Go-powered simulator for the Monty Hall problem with statistical analysis.
+</p>
+
+</div>
+
+## 📜 Table of Contents
+
+<details open>
+  <summary><strong>Click to collapse/expand</strong></summary>
+  <ol>
+    <li><a href="#-about">📖 About</a></li>
+    <li><a href="#-contributing">🤝 Contributing</a></li>
+    <li><a href="#-star-evolution">🌠 Star Evolution</a></li>
+    <li><a href="#-license">📜 License</a></li>
+    <li><a href="#-contact">📞 Contact</a></li>
+  </ol>
+</details>
+
+## 📖 About
+
+**Monty-Hall-Problem-Simulator**: _A Go-based simulator to explore and visualize the famous Monty Hall paradox_.
+
+This simulator was originally developed as part of a personal learning journey to better understand probabilities, paradoxes, and to demonstrate the Monty Hall problem through real simulations — beyond theoretical explanations.
+
+Initially created as a personal experiment, it later became public because I believe others might benefit from having a concrete, hands-on way to see the paradox in action.
+
+> ⚠️ Note: Although fully functional and optimized, this project remains a personal and educational experiment.
+> It is not a commercial product, but rather a public code archive aimed at educational, academic, or experimental uses.
+
+The project combines secure random generation, statistical analysis, and clean modular Go code, making it a reusable and extendable tool for anyone curious about probabilistic paradoxes, statistics, or Golang.
+
+> Feel free to reuse, adapt, or improve it as you wish.
+
+### ⚙️ Features
+
+- ✅ Secure and realistic simulations using cryptographically secure randomness (no pseudo-random hacks).
+- ✅ Detailed statistical output, including win rate percentages for both "switch" and "stay" strategies.
+- ✅ Clean and modular architecture following Go idiomatic practices for easy customization and extensions.
+- ✅ Cross-platform pre-built binaries (Linux, Windows, MacOS Intel & ARM64) — ready to use.
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/franckferman/Monty-Hall-Problem-Simulator/refs/heads/stable/docs/github/graphical_resources/Screenshot-Monty-Hall-Problem-Simulator-Demo.png" alt="Monty-Hall-Problem-Simulator Demo Screenshot" width="auto" height="auto">
+</p>
+
+<p align="right">(<a href="#top">🔼 Back to top</a>)</p>
+
+## 🤝 Contributing
+
+Vos contributions, retours et suggestions jouent un rôle essentiel dans l’amélioration continue de ce projet. Que ce soit pour signaler un problème, proposer une nouvelle fonctionnalité ou soumettre une amélioration, chaque contribution compte et est la bienvenue.
+
+<p align="right">(<a href="#top">🔼 Back to top</a>)</p>
+
+## 🌠 Star Evolution
+
+Découvrez l’évolution des étoiles attribuées à ce projet et suivez sa croissance au fil du temps:
+
+<a href="https://star-history.com/#franckferman/Monty-Hall-Problem-Simulator&Timeline">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=franckferman/Monty-Hall-Problem-Simulator&type=Timeline&theme=dark" />
+    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=franckferman/Monty-Hall-Problem-Simulator&type=Timeline" />
+  </picture>
+</a>
+
+Chaque étoile compte. Merci pour votre soutien. Vos encouragements nourrissent notre motivation et contribuent à l’évolution du projet. ✨
+
+## 📚 License
+
+Ce projet est sous licence GNU Affero General Public License, Version 3.0 (AGPL-3.0). Pour plus de détails, veuillez consulter le fichier de licence dans le dépôt: [Read the license on GitHub](https://github.com/franckferman/Monty-Hall-Problem-Simulator/blob/stable/LICENSE)
+
+<p align="right">(<a href="#top">🔼 Back to top</a>)</p>
+
+## 📞 Contact
+
+[![ProtonMail][protonmail-shield]](mailto:[email protected]) 
+[![LinkedIn][linkedin-shield]](https://www.linkedin.com/in/franckferman)
+[![Twitter][twitter-shield]](https://www.twitter.com/franckferman)
+
+<p align="right">(<a href="#top">🔼 Back to top</a>)</p>
+
+<!-- MARKDOWN LINKS & IMAGES -->
+<!-- https://www.markdownguide.org/basic-syntax/#reference-style-links -->
+[contributors-shield]: https://img.shields.io/github/contributors/franckferman/Monty-Hall-Problem-Simulator.svg?style=for-the-badge
+[contributors-url]: https://github.com/franckferman/Monty-Hall-Problem-Simulator/graphs/contributors
+[forks-shield]: https://img.shields.io/github/forks/franckferman/Monty-Hall-Problem-Simulator.svg?style=for-the-badge
+[forks-url]: https://github.com/franckferman/Monty-Hall-Problem-Simulator/network/members
+[stars-shield]: https://img.shields.io/github/stars/franckferman/Monty-Hall-Problem-Simulator.svg?style=for-the-badge
+[stars-url]: https://github.com/franckferman/Monty-Hall-Problem-Simulator/stargazers
+[license-shield]: https://img.shields.io/github/license/franckferman/Monty-Hall-Problem-Simulator.svg?style=for-the-badge
+[license-url]: https://github.com/franckferman/Monty-Hall-Problem-Simulator/blob/stable/LICENSE
+[protonmail-shield]: https://img.shields.io/badge/ProtonMail-8B89CC?style=for-the-badge&logo=protonmail&logoColor=blueviolet
+[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge&logo=linkedin&colorB=blue
+[twitter-shield]: https://img.shields.io/badge/-Twitter-black.svg?style=for-the-badge&logo=twitter&colorB=blue

README.md

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+
+# ============================
+# 🏗️ Monty Hall Problem Simulator - Build Script
+# ============================
+
+set -e  # Stop if error occurs
+set -u  # Treat unset variables as error
+set -o pipefail  # Handle errors in pipelines
+
+# ----------- Config -----------
+PROJECT_NAME="Monty-Hall-Problem-Simulator"
+MAIN_FILE="main.go"
+OUTPUT_DIR="bin"
+
+# Clean old binaries
+echo "🧹 Cleaning previous builds..."
+rm -rf "$OUTPUT_DIR"
+mkdir -p "$OUTPUT_DIR"
+
+# ----------- Build Flags -----------
+BUILD_FLAGS="-trimpath -ldflags='-s -w'"
+CGO_ENABLED=0
+
+# ----------- Build Targets -----------
+declare -A TARGETS
+TARGETS=(
+  ["Linux"]="GOOS=linux GOARCH=amd64"
+  ["Windows"]="GOOS=windows GOARCH=amd64"
+  ["MacOS"]="GOOS=darwin GOARCH=amd64"
+  ["MacOS-ARM64"]="GOOS=darwin GOARCH=arm64"
+)
+
+# ----------- Build Process -----------
+echo "🚀 Starting build process..."
+
+for target in "${!TARGETS[@]}"; do
+  echo "🔨 Building for $target..."
+
+  # Output file name
+  output_file="$OUTPUT_DIR/$PROJECT_NAME-$target"
+  [ "$target" == "Windows" ] && output_file="$output_file.exe"
+
+  # Command
+  build_cmd="CGO_ENABLED=$CGO_ENABLED ${TARGETS[$target]} go build $BUILD_FLAGS -o $output_file $MAIN_FILE"
+
+  # Execute
+  echo "⚙️  $build_cmd"
+  eval $build_cmd
+
+  # Check
+  if [ -f "$output_file" ]; then
+    echo "✅ Built $output_file"
+  else
+    echo "❌ Failed to build $target"
+    exit 1
+  fi
+done
+
+echo "🎉 All binaries built successfully and available in '$OUTPUT_DIR/'"
+

bin/Monty-Hall-Problem-Simulator-Linux

@@ -0,0 +1,3 @@
+module Monty-Hall-Problem-Simulator
+
+go 1.20