Welcome! We appreciate your interest in contributing. Please take a moment to review the following guidelines to ensure a smooth and collaborative contribution process.
- Purpose
- Setup
- Secret Key
- Configure your .env
- Run SwitchSetup
- DataBase
- Creating Issues
- Submitting Pull Requests
- Code Style
- Code Review and Merging
- Code of Conduct
- Acknowledgments
- Contact
This document provides guidelines and instructions for contributing to our project. It aims to ensure that contributions are made in a consistent and efficient manner.
To set up the project locally, please follow these steps:
- Clone the repository:
git clone https://github.com/AleDouglas/SwitchSetup.git
. - Install the packages from the requirements.txt file in your Virtual Environment or use the Dockerfile .
- You need generate your own Secret Key .
- Configure your .env .
- You can run it in your terminal or dockerfile .
Start the Python interpreter
import secrets
secrets.token_hex(32)
Copy the key in .env
Be mindful that you can generate a new key whenever necessary. However, it is crucial to remember that if you are using our project, you should not disclose the key to anyone.
Create an .env file in the /core directory:
SECRET_KEY=SECRET KEY
DEBUG=True
Use DEBUG=TRUE only when in development.
Use for login:
Username: admin
Password: 123
cd WebApi
python manage.py migrate
python manage.py runserver
cd WebApi
python manage.py migrate
cd ..
docker build -t image_name .
docker run -p 8000:8000 imagename
We use SQLite at first, but it is possible to manage other databases.
Use Django's own reference.
If you lose the database file or decide to switch to a different one, you will need to follow these steps:
- Migration ( Inside the WebApi file )
python manage.py migrate
After this, you just need to either use Docker or run it on your local machine.
Use for login:
Username: admin
Password: 123
I recommend using MySQL or PostgreSQL to avoid the use of a physical database within the documents. Simply follow the Django reference for the necessary modifications.
If you encounter any issues or have feature requests, please create an Issue using the following guidelines:
- Before creating a new Issue, search the existing Issues to avoid duplicates.
- Provide a clear and descriptive title.
- Include detailed information about the problem or feature request, including steps to reproduce (if applicable).
- Add relevant labels to categorize the Issue appropriately.
We welcome Pull Requests for bug fixes, improvements, or new features. To submit a Pull Request, please follow these steps:
- Fork the repository and create a new branch for your changes.
- Commit your changes with clear and concise messages.
- Provide a detailed description of the changes made in the Pull Request.
- Ensure that your code adheres to our Code Style guidelines.
We don't follow a specific code style, however, it's important to stick to the standard already in place.
All Pull Requests will go through a code review process before merging. Reviewers will provide feedback and suggestions for improvement. Once the changes pass the review, they will be merged into the main branch.
We have a Code of Conduct to ensure a respectful and inclusive environment for all contributors. Please review our Code of Conduct and adhere to it throughout your interactions within the project.
We would like to express our gratitude to all contributors who have dedicated their time and effort to this project.
If you have any questions, suggestions, or need further assistance, feel free to contact us at [[email protected]].
We appreciate your contributions and look forward to working together to make this project even better!