Simulateur is a stock market simulation platform built using Django. The platform allows users to create and manage scenarios to simulate stock market events and track their outcomes. It includes an admin interface to manage the simulation settings and control the flow of the simulation.
- Create and manage companies with detailed backstories and stock information.
- Simulate stock market events and scenarios.
- Manage teams and user profiles with financial details.
- Admin dashboard to control simulation parameters and monitor progress.
- Secure access and operations restricted to superadmins.
- Python 3.10
- Django 4.2.13
Use pycharm professional or community
To run the complete system, you can use Docker Compose for setting up the entire environment with one command:
docker compose --profile all down
docker compose --profile all up -d --build-
Install Dependencies:
cd simulateur python3 -m run.py --install -
Run the Server:
python3 -m run.py --start-simulation 1
To create a superadmin, use the Django management command:
python3 manage.py createsuperadmin --username=admin --password=admin [email protected]Follow the prompts to set up the superadmin credentials.
Contributions are welcome! Please fork the repository and create a pull request with your changes.
This project is licensed under the MIT License
The project includes the following CSV files for initial data setup:
.
├── data
│ ├── scenarios.csv
│ ├── simulation_settings.csv
│ ├── companies.csv
│ ├── events.csv
│ ├── triggers.csv
│ ├── portfolios.csv
│ ├── stocks.csv
│ ├── teams.csv
│ └── users.csv
Here is a brief overview of the project file structure:
.
├── Dockerfile
├── data
├── db.sqlite3 # db
├── docker-compose.yml
├── manage.py
├── requirements.txt # packages
├── simulateur
│ ├── asgi.py # websocket and http
│ ├── settings.py
│ ├── urls.py
├── simulation
│ ├── admin.py
│ ├── apps.py
│ ├── channels # websocket
│ ├── logic # simulation logic
│ ├── models.py
│ ├── templates
│ ├── tests.py
│ ├── urls.py
│ └── views