{"id":22447448,"url":"https://github.com/siam29/django-docker","last_synced_at":"2026-05-15T20:31:37.054Z","repository":{"id":266067866,"uuid":"897227241","full_name":"siam29/Django-Docker","owner":"siam29","description":"An efficient and scalable inventory management system built with Django. It supports features like property management, user authentication, and geospatial data integration.","archived":false,"fork":false,"pushed_at":"2024-12-12T16:55:28.000Z","size":4184,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-17T11:07:13.255Z","etag":null,"topics":["docker-compose","html5","pytest-cov","python3","sitemap-xml"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/siam29.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-02T09:09:18.000Z","updated_at":"2024-12-12T16:55:31.000Z","dependencies_parsed_at":"2025-02-01T16:10:16.256Z","dependency_job_id":"0306da95-a574-4515-a947-9316c5cd6c37","html_url":"https://github.com/siam29/Django-Docker","commit_stats":null,"previous_names":["siam29/django-docker"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/siam29/Django-Docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siam29%2FDjango-Docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siam29%2FDjango-Docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siam29%2FDjango-Docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siam29%2FDjango-Docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/siam29","download_url":"https://codeload.github.com/siam29/Django-Docker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siam29%2FDjango-Docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33078898,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T20:25:35.270Z","status":"ssl_error","status_checked_at":"2026-05-15T20:25:34.732Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker-compose","html5","pytest-cov","python3","sitemap-xml"],"created_at":"2024-12-06T04:16:59.535Z","updated_at":"2026-05-15T20:31:37.030Z","avatar_url":"https://github.com/siam29.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Inventory Management System\nAn efficient and scalable inventory management system built with Django. It supports features like property management, user authentication, and geospatial data integration.\n\n\n\n## Table of Contents\n1. [Project Overview](#project-overview)\n2. [Features](#features)\n3. [Tech Stack](#tech-stack)\n4. [Set up this project](#installation)\n   - [Clone the repository](#clone-the-repository)\n   - [Install dependencies](#install-dependencies)\n   - [Set up environment variables](#set-up-environment-variables)\n   - [Database setup](#database-setup)\n5. [Running the Project](#running-the-project)\n   - [Run Server](#run-server)\n   - [Run Tests](#run-tests)\n   - [Sitemap Generator](#sitemap-generate)\n\n7. [Contributing](#contributing)\n8. [Connect with Me](#connect-with-me)\n\n\n\n## Django project structure\n```\nDjango-Docker/\n├── inventory-management/\n│   ├── env/                     # Virtual environment directory \n│   ├── mysite/    # Main Django application\n│   │   ├── __init__.py\n│   │   ├── asgi.py              # ASGI entry point for deployment\n│   │   ├── settings.py          # Main project settings\n│   │   ├── urls.py              # Main project URLs\n│   │   ├── wsgi.py              # WSGI entry point for deployment\n│   │   └── __pycache__/         # Python cache files (ignored by version control)\n│   ├── properties/              # Core app for the inventory system\n│   │   ├── __init__.py\n│   │   ├── admin.py             # Admin configurations\n│   │   ├── apps.py              # App-specific settings\n│   │   ├── forms.py             # Custom Django forms\n│   │   ├── models.py            # Django models\n│   │   ├── tests.py             # Test cases for the app\n│   │   ├── urls.py              # URLs specific to the app\n│   │   ├── views.py             # Views for handling HTTP requests\n│   │   ├── migrations/          # Database migrations\n│   │   │   ├── __init__.py\n│   │   │   └── ...              # Migration files\n│   │   ├── templates/           # HTML templates\n│   │   │   ├── base.html\n│   │   │   ├── signup.html\n│   │   │   └── ...\n│   │   └── csv/                 # contain csv file\n│   │       \n│   │       \n│   │       \n│   ├── manage.py                # Django’s command-line utility\n│   ├── requirements.txt         # Python dependencies\n│   ├── pytest.ini               # Pytest configuration\n│   ├── Dockerfile               # Dockerfile for building the app\n│   ├── docker-compose.yml       # Docker Compose file\n│   ├── .env                     # Environment variables\n│   ├── README.md                # Project documentation\n│   ├── .gitignore               # Ignored files for Git\n│                \n└── postgres-data/               # Data volume for PostgreSQL container\n```\n\n\n## Project Overview\nThis project is designed to streamline the management of properties, users, and locations with features such as geospatial data integration, advanced user permissions, and import/export capabilities for data. Built with Django, it supports efficient workflows for property owners and admins.\n\n## Features\n- User Authentication and Role Management\n- Geospatial Data Handling (Django GIS)\n- Import/Export Data via Admin Panel\n- Amenity Validation for JSON Fields\n- Unit and Integration Testing with Pytest\n\n## Tech Stack\n\n- **Backend**: Django\n- **Database**: PostgreSQL with PostGIS\n- **Testing**: `pytest`, `pytest-django`, `pytest-cov`\n- **Geospatial**: Leaflet\n- **Containerization**: Docker\n\n## Set up this project\n#### 1. Clone the repository from GitHub\nClone the project repository from GitHub to local machine\n```\nhttps://github.com/siam29/Django-Docker.git\n```\n#### 2. Navigate to the ```inventory-management``` directory\nChange the current directory to inventory-management inside the cloned repository\n```\ncd inventory-management/\n```\n#### 3. Create a Python virtual environment\nreate a new Python virtual environment in the project directory to isolate dependencies\n```\npython3 -m venv env\n```\n#### 4. Activate the virtual environment\n```\nsource env/bin/activate\n```\n#### 5. Install required dependencies\nInstall all the required dependencies listed in ```requirements.txt```\n\n```\npip install -r requirements.txt\n```\n#### 6. Build the Docker container\nBuild the Docker container for your project\n```\ndocker-compose build\n```\n```Hint:``` This command sets up the Docker containers as specified in your docker-compose.yml file, creating the environment for your Django project.\n#### 7. Up the Docker container\nBring up the Docker containers and start the services\n```\ndocker-compose up\n```\n\n#### 8. Check the running containers\n```\ndocker ps\n```\n```Hint:``` This will show you the currently running containers and their status.\n\n\n#### 9. Make Migrations\nTo apply database changes, run the following command to create migration files:\n```\ndocker exec -it inventoryManagement python manage.py makemigrations\n```\n#### 10. Apply Migrations\nApply the migrations to update the database schema:\n```\ndocker exec -it inventoryManagement python manage.py migrate\n```\n\n#### 11. Check the Status of Migrations\nTo check which migrations have been applied:\n```\ndocker exec -it inventoryManagement python manage.py showmigrations\n```\n#### 12. Create superuser\nTo access the Django admin panel, need to create a superuser. Run the following command to enter the Docker container and create the superuser:\n```\ndocker exec -it inventoryManagement python manage.py createsuperuser\n```\nThen show this messege. Fill up this carefully and remember the password \n\n- Username (leave blank to use 'root'): \u003cEnter user name\u003e\n- Email address: \n- Password: \n- Password (again): \n- The password is too similar to the username.\n- This password is too common.\n- Bypass password validation and create user anyway? [y/N]: y\n- Superuser created successfully.\n\nAfter completing these steps, you will have a superuser created for your Django application. You can log into the Django admin panel by going to:\n## Run this project\n\nPaste this url for the admin before create the superuser username and password now enter this for sign in admin.\n```\nhttp://localhost:8000/admin/\n```\nOnce logged in as an ```admin```, you can mark other users as ```Active```, ```Staff```, or ```Superuser```. This allows you to manage user roles and permissions, enabling them to log in and add accommodations.\n\n### Property Owners Creation\nclick on ```Groups``` table and create a ```Property Owners``` group and gave this four permission showing in the image below and click the save button.\n![Alt text](property_owner.png)\nGo to the url and paste this command for registration a user\n```\nhttp://localhost:8000/signup/\n```\n### Test this project\nTo run tests with coverage, use ```pytest```\n```\ndocker exec -it inventoryManagement pytest --cov=properties --cov-report=term-missing\n```\n\n### Sitemap Generate\nGenerating a sitemap helps search engines to better understand the structure of this website. With the following command, we can generate a sitemap for the Django application.\n```\ndocker-compose exec web python manage.py generate_sitemap\n```\n## Contributing\nContributions are welcome! Please fork the repository and submit a pull request for any bug fixes or feature requests.\n\n## Connect with Me\nIf you have any questions, suggestions, or feedback, feel free to reach out to me through the following channels\n- Email: almahmudsiam15@gmail.com\n- GitHub: https://github.com/siam29\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiam29%2Fdjango-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiam29%2Fdjango-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiam29%2Fdjango-docker/lists"}