feat: add interactive exploration of Shannon's capacity formula with Plotly graphs

- Implemented bandwidth sensitivity and power sensitivity plots.
- Created a contour map for bit rate multiplying factors.
- Added input parameters for C/N and bandwidth with validation.
- Displayed computed results and sensitivity analysis metrics.
- Integrated interactive graphs for user exploration.
- Included background information section for user guidance.

README.md

@@ -1,18 +1,111 @@
-# Shannon-for-Dummies
+# Shannon's Equation for Dummies
 
-Educational application
+**Educational Web Application for Satellite Communications**
 
-Exploration from Claude's Shannon initial theory to its practical application to satellite communications.
+Exploration from Claude Shannon's initial theory to its practical application to satellite communications.
 
-The application is using PysimpleGUI / PySimpleGUIWeb and runs either in local windows or in web pages.
+## 🚀 Stack
 
-The Web version via localhost is fully functional although not as convenient as the windowed version (only 1 plot open).
-The look of the web version differs significantly from the local version (PySimpleGUIWeb is still beta). 
+- **Frontend**: [Streamlit](https://streamlit.io) with [Plotly](https://plotly.com) interactive charts
+- **Backend**: Python 3.11+ with scientific libraries (numpy, scipy, itur, astropy)
+- **Database**: SQLite for community contributions
+- **Deployment**: Docker + docker-compose, designed for 24/7 multi-user operation
 
-The Web version in remote does work for a single user (all users connected can send commands but see the same page). 
-This mode is experimental and doesn't behave as a web server : users are not managed, the app closes when the user closes the window ...
+## 📁 Project Structure
 
-The value of the application is essentially in the background information accessed by clicking labels of all inputs / outputs.
+```
+.
+├── app.py                      # Main Streamlit entry point
+├── core/                       # Core business logic
+│   ├── calculations.py         # Shannon equations & satellite link budget
+│   ├── database.py            # SQLite contribution management
+│   └── help_texts.py          # Educational help content
+├── views/                      # UI pages
+│   ├── theory.py              # Theoretical exploration (Shannon limit)
+│   ├── real_world.py          # Real-world link budget calculator
+│   └── contributions.py       # Community knowledge database
+├── .streamlit/config.toml     # Streamlit configuration
+├── Dockerfile                 # Container image definition
+├── docker-compose.yml         # Orchestration with nginx-proxy
+└── requirements.txt           # Python dependencies
+```
 
-A Knowledge DB is coupled to the application for collaborative contributions on the subject opening technical discussions. At this stage the DB is local.
+## 🛠️ Local Development
+
+### Prerequisites
+- Python 3.11+
+- pip
+
+### Setup
+
+```bash
+# Create virtual environment
+python3 -m venv .venv
+source .venv/bin/activate  # On Windows: .venv\Scripts\activate
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Run the app
+streamlit run app.py
+```
+
+The app will open at `http://localhost:8501`
+
+## 🐳 Docker Deployment
+
+### Build and run
+
+```bash
+docker-compose up -d
+```
+
+The app will be available at `http://localhost:8080`
+
+### Environment
+
+- **Port**: 8080 (configurable in `.streamlit/config.toml`)
+- **Health Check**: `/_stcore/health`
+- **Data Persistence**: SQLite databases stored in `shannon_data` volume
+
+### Production Setup
+
+The `docker-compose.yml` is configured for nginx-proxy:
+- Network: `nginx-proxy`
+- Virtual host: `shannon.antopoid.com`
+- HTTPS ready (with appropriate Let's Encrypt configuration)
+
+## 📚 Features
+
+### 1. Theoretical Exploration
+- Shannon capacity calculation (C = BW × log₂(1 + C/N))
+- Bandwidth and power sensitivity analysis
+- Bit rate factor maps
+- Interactive Plotly graphs
+
+### 2. Real-World Link Budget
+- Complete satellite link calculation
+- ITU-R atmospheric attenuation models
+- Receiver noise and baseband impairments
+- Practical Shannon limits with penalties
+
+### 3. Community Contributions
+- Collaborative knowledge database
+- Search and filter capabilities
+- Read/Write/Delete permissions
+
+## 🎓 Educational Value
+
+The application provides extensive background information accessible through help expanders on every input/output, covering:
+- Shannon's theorem and its implications
+- Satellite communication fundamentals
+- Atmospheric propagation effects
+- Modulation and coding schemes
+- Real-world system design trade-offs
+
+## 📝 License & Author
+
+© 2021-2026 · Shannon Equation for Dummies  
+Created by JPC (February 2021)  
+Migrated to Streamlit (2026)