Update documentation for new project structure

- Fix repository URLs to use michael-borck/simnexus instead of teaching-repositories
- Update import statements to use the new nested module structure
- Correct CLI commands to use simnexus ui web/tui instead of simnexus-web/tui
- Fix typo in stock_market.md (figsise → figsize)
- Add AUTHORS.md file acknowledging contributors
- Update web deployment instructions to use correct app entry point

Author: michael-borck

AUTHORS.md

@@ -0,0 +1,40 @@
+# ✍️ Authors & Contributors
+
+This project was made possible thanks to the following contributors:
+
+## Core Author
+
+- **Michael Borck**  
+  Lead developer and educational designer.  
+  GitHub: [michael-borck](https://github.com/teaching-repositories)  
+  Email: michael@borck.me
+
+## AI Co-Authors
+
+- **ChatGPT (OpenAI)**  
+  Provided design and code-generation assistance for the original SimNexus module.  
+  Helped with architecture, packaging, documentation, and workflow automation.  
+  Contributions include:  
+  - Project scaffolding and CI/CD  
+  - mkdocs configuration  
+  - Testing and tooling  
+  - Educational project design
+
+- **Claude (Anthropic)**  
+  Provided assistance with transitioning the project to modern framework.  
+  Helped with modular architecture, web interfaces, and documentation.  
+  Contributions include:  
+  - Web interface implementation  
+  - Code restructuring and modularisation  
+  - Build system updates  
+  - Module integration  
+  - Development tools
+
+## Acknowledgments
+
+- Inspired by the open-source Python packaging ecosystem and educators exploring AI in the classroom.
+- Built with a focus on educational applications of AI in teaching and learning environments.
+
+---
+
+_If you’ve contributed and are not listed here, please submit a pull request to add yourself!_

docs/api.md

@@ -2,12 +2,12 @@
 
 ## Product Popularity Simulation Class
 
-::: simnexus.ProductPopularitySimulation
+::: simnexus.core.product_popularity_simulation.ProductPopularitySimulation
 
 ## Resource Fluctuation Simulation Class
 
-::: simnexus.ResourceFluctuationsSimulation
+::: simnexus.core.resource_fluctuations_simulation.ResourceFluctuationsSimulation
 
 ## Stock Market Simulation Class
 
-::: simnexus.StockMarketSimulation
+::: simnexus.core.stock_market_simulation.StockMarketSimulation

docs/contact.md

@@ -14,13 +14,13 @@ Please allow 24-48 hours for a response, as we strive to provide detailed and he
 
 If you're experiencing technical issues or need help troubleshooting, you can:
 
-- **Submit an Issue**: Visit our [GitHub Issues Page](https://github.com/teaching-repositories/simnexus/issues) to report a bug or a problem. Please check to see if your issue has already been reported or addressed before opening a new issue.
+- **Submit an Issue**: Visit our [GitHub Issues Page](https://github.com/michael-borck/simnexus/issues) to report a bug or a problem. Please check to see if your issue has already been reported or addressed before opening a new issue.
 
 ## Feature Requests
 
 We are always looking to improve SimNexus and welcome your ideas and proposals for new features:
 
-- **Feature Suggestions**: Please submit your feature requests through our [GitHub Issues Page](https://github.com/teaching-repositories/simnexus/issues). Tag your post with the 'feature request' label so we can easily identify it.
+- **Feature Suggestions**: Please submit your feature requests through our [GitHub Issues Page](https://github.com/michael-borck/simnexus/issues). Tag your post with the 'feature request' label so we can easily identify it.
 
 ## Follow Us
 

docs/contribute.md

@@ -2,4 +2,4 @@
 
 We welcome contributions from the community. Before contributing, please read our contribution guidelines to understand how you can help improve this project.
 
-[Read the Contribution Guidelines](https://github.com/teaching-repositories/simnexus/blob/main/CONTRIBUTING.md)
+[Read the Contribution Guidelines](https://github.com/michael-borck/simnexus/blob/main/CONTRIBUTING.md)

docs/getting_started.md

@@ -39,7 +39,7 @@ pip install simnexus[web]
 For the latest development version:
 
 ```bash
-pip install git+https://github.com/teaching-repositories/simnexus.git
+pip install git+https://github.com/michael-borck/simnexus.git
 ```
 
 ## Verify Installation
@@ -65,7 +65,7 @@ SimNexus offers multiple ways to run simulations:
 Import SimNexus in your Python code:
 
 ```python
-from simnexus import StockMarketSimulation
+from simnexus.core.stock_market_simulation import StockMarketSimulation
 
 # Create a simulation instance
 sim = StockMarketSimulation(
@@ -123,19 +123,19 @@ SimNexus includes comprehensive examples to help you get started:
 - **CLI Examples**: Shell scripts demonstrating command-line capabilities  
 - **Jupyter Notebooks**: Interactive examples for data analysis
 
-See the [examples directory](https://github.com/teaching-repositories/simnexus/tree/main/examples) in the repository.
+See the [examples directory](https://github.com/michael-borck/simnexus/tree/main/examples) in the repository.
 
 ## Next Steps
 
 - Explore the [API documentation](api.md) for detailed information on simulation classes
 - Try different interfaces: [CLI](cli.md), [TUI](tui.md), or [Web](web.md)
-- Check out the [example code](https://github.com/teaching-repositories/simnexus/tree/main/examples) for practical applications
+- Check out the [example code](https://github.com/michael-borck/simnexus/tree/main/examples) for practical applications
 
 ## Getting Help
 
 If you encounter any issues or have questions:
 
-- Check the [documentation](https://teaching-repositories.github.io/simnexus/)
+- Check the [documentation](https://michael-borck.github.io/simnexus/)
 - Run `simnexus --help` for CLI assistance
 - Contact information is available on the [Contact](contact.md) page
 

docs/stock_market.md

@@ -16,7 +16,7 @@ This simulation models the fluctuations of stock prices, enabling students to ex
 **Example Code**
 
 ```python
-from simnexus import StockMarketSimulation
+from simnexus.core.stock_market_simulation import StockMarketSimulation
 import matplotlib.pyplot as plt
 
 # Example scenario: High volatility with a downward price trend and a significant market event.
@@ -26,7 +26,7 @@ sim = StockMarketSimulation(start_price=100, days=365, volatility=0.03,
 prices = sim.run_simulation()
 
 # Visualising the stock market fluctuations
-plt.figure(figsise=(10, 6))
+plt.figure(figsize=(10, 6))
 plt.plot(prices, label='Stock Price')
 plt.axvline(x=sim.event_day, color='red', linestyle='--', label='Major Market Event')
 plt.xlabel('Days')

docs/tui.md

@@ -15,7 +15,7 @@ pip install simnexus[dev]
 Launch the TUI with:
 
 ```bash
-simnexus-tui
+simnexus ui tui
 ```
 
 ## Interface Overview

docs/web.md

@@ -15,15 +15,15 @@ pip install simnexus[web]
 Start the web server with:
 
 ```bash
-simnexus-web
+simnexus ui web
 ```
 
 By default, the server runs on http://localhost:8000.
 
 For custom host and port:
 
 ```bash
-simnexus-web --host 0.0.0.0 --port 5000
+simnexus ui web --host 0.0.0.0 --port 5000
 ```
 
 ## Web Interface Features
@@ -80,7 +80,7 @@ FastHTML allows SimNexus to create a modern, interactive web interface without t
 For production deployment, we recommend using Uvicorn behind a reverse proxy like Nginx:
 
 ```bash
-uvicorn simnexus.web.app:app --host 0.0.0.0 --port 8000
+uvicorn simnexus.web.app:create_app --host 0.0.0.0 --port 8000
 ```
 
 Or with Docker (see the project repository for the Dockerfile).

pyproject.toml

@@ -58,9 +58,9 @@ cli = [
 ]
 
 [project.urls]
-Homepage = "http://yourhomepage.com"
-Documentation = "https://teaching-repositories.github.io/simnexus/"
-Repository = "https://github.com/teaching-repositories/simnexus"
+Homepage = "http://simnexus.borck.me"
+Documentation = "https://michael-borck.github.io/simnexus/"
+Repository = "https://github.com/michael-borck/simnexus"
 
 [project.scripts]
 simnexus = "simnexus.cli.main:app"