{"id":27117672,"url":"https://github.com/degisew/commerce-store","last_synced_at":"2026-05-01T13:31:27.316Z","repository":{"id":164789319,"uuid":"640211263","full_name":"degisew/commerce-store","owner":"degisew","description":"A back-end e-commerce API built with Python, Django, and PostgreSQL. It includes endpoints for creating, retrieving, updating, and deleting products, as well as for managing orders, customers, carts, and their items.","archived":false,"fork":false,"pushed_at":"2025-06-07T18:41:20.000Z","size":139,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"dev","last_synced_at":"2025-06-07T19:28:44.598Z","etag":null,"topics":["django","django-rest-framewok","postgressql","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/degisew.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2023-05-13T10:51:05.000Z","updated_at":"2025-06-07T18:41:24.000Z","dependencies_parsed_at":"2025-06-07T19:34:48.759Z","dependency_job_id":null,"html_url":"https://github.com/degisew/commerce-store","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/degisew/commerce-store","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/degisew%2Fcommerce-store","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/degisew%2Fcommerce-store/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/degisew%2Fcommerce-store/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/degisew%2Fcommerce-store/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/degisew","download_url":"https://codeload.github.com/degisew/commerce-store/tar.gz/refs/heads/dev","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/degisew%2Fcommerce-store/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32499681,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["django","django-rest-framewok","postgressql","python3"],"created_at":"2025-04-07T06:35:54.556Z","updated_at":"2026-05-01T13:31:27.305Z","avatar_url":"https://github.com/degisew.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Commerce Store\n\n\u003cdiv align=\"center\"\u003e\n\n\u003c!-- ![Project Logo](https://via.placeholder.com/150x150/0066cc/ffffff?text=LOGO) --\u003e\n\n**A back-end e-commerce API built with Python, Django, and PostgreSQL.**\n\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)](https://python.org)\n[![Django](https://img.shields.io/badge/Django-4.x-green.svg)](https://djangoproject.com)\n[![Docker](https://img.shields.io/badge/Docker-20.10+-blue.svg)](https://docker.com)\n\n**Contact**: [degisew.mengist21@gmail.com](mailto:degisew.mengist21@gmail.com) | [LinkedIn](https://linkedin.com/in/degisew-mengist)\n\n\u003c/div\u003e\n\n## Overview\n\nA back-end e-commerce API built with Python, Django, and PostgreSQL. It includes endpoints for creating, retrieving, updating, and deleting products, as well as for managing orders, customers, carts, and their items.\n\n**Key Features**:\n\n- Secure JWT authentication and role-based access control.\n- Containerized deployment with Docker.\n- Products Catalog management.\n- Shopping Cart and Orders management.\n\n\u003c!-- **Links**:\n\n- **Portfolio**: [Portfolio](https://degisew-portfolio.netlify.com)\n- **GitHub**: [GitHub](https://github.com/degisew)\n- **LinkedIn**: [LinkedIn](https://linkedin.com/in/degisew-mengist) --\u003e\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Quick Start](#quick-start)\n- [Project Structure](#project-structure)\n- [Setup](#setup)\n- [API Reference](#api-reference)\n- [Architecture](#architecture)\n  \u003c!-- - [Testing](#testing) --\u003e\n- [Deployment](#deployment)\n\n## Quick Start\n\n```bash\n# Clone the repo\ngit clone https://github.com/degisew/commerce-store.git\ncd commerce-store\n\n# Run with Docker\ndocker-compose up --build\n\n# OR run locally\npython -m venv venv\nsource venv/bin/activate  # Windows: venv\\Scripts\\activate\npip install -r requirements/dev.txt\npython manage.py runserver\n```\n\n**Access**: [http://localhost:8000/api/v1/docs](http://localhost:8000/api/v1/docs) for API docs.\n\n## Project Structure\n\n```bash\n├── apps/                 # Custom Apps collection\n├── config/               # Project Configurations\n├── docker\n│     └── dev/\n│          └── Dockerfile # Django API Dockerfile for development environment\n├── docs/                 # Documentation files\n├── requirements/         # requirements.txt files collection\n├── .env                  # Environment variables (you will create this)\n├── compose.yaml          # Docker Compose configuration file\n└── README.md             # This README file\n```\n\n## Setup\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eShow Setup Details\u003c/strong\u003e\u003c/summary\u003e\n\n### Prerequisites\n\n- Python 3.10+\n- Docker 20.10+ \u0026 Docker Compose 1.29+\n- PostgreSQL 14+ (for local setup)\n- Git 2.30+\n\n### Instructions\n\n1. **Clone the Repository**:\n\n   ```bash\n   git clone https://github.com/degisew/commerce-store.git\n   cd commerce-store\n   ```\n\n2. **Configure Environment**:\n\n   ```bash\n   Create a .env file with-in your root project directory and store secure values.\n   ```\n\n   Example `.env`:\n\n   ```bash\n   # Database\n   POSTGRES_USER=your_db_user\n   POSTGRES_PASSWORD=your_db_password\n   POSTGRES_DB=your_db_name\n\n   # Django\n   SECRET_KEY=your_secret_key\n   DB_USER=your_database_user\n\n   # Optional: pgAdmin\n   PGADMIN_DEFAULT_EMAIL=admin@example.com\n   PGADMIN_DEFAULT_PASSWORD=your_pgadmin_password\n   ```\n\n3. **Run the Application**:\n   - **Docker (Recommended)**:\n\n     ```bash\n     docker-compose up --build\n     ```\n\n   - **Local Development**:\n\n     ```bash\n     python -m venv venv\n     source venv/bin/activate\n     pip install -r requirements/dev.txt\n     python manage.py runserver\n     ```\n\n4. **Access Services**:\n   - API: [http://localhost:8000](http://localhost:8000)\n   - API Docs: [http://localhost:8000/api/v1/docs](http://localhost:8000/api/v1/docs)\n   - pgAdmin (if included): [http://localhost:8001](http://localhost:8001)\n\n\u003c/details\u003e\n\n## API Reference\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eShow API Reference\u003c/strong\u003e\u003c/summary\u003e\n\n| Endpoint | Method | Description |\n|----------|--------|-------------|\n| `/api/v1/store/products` | GET | List all available products |\n| `/api/v1/core/users` | GET | List Registered accounts |\n| `/api/v1/store/collections` | GET | List all Product Categories |\n\n\n**Full Docs**: [http://localhost:8000/api/v1/docs](http://localhost:8000/api/v1/docs)\n\n\u003c/details\u003e\n\n## Architecture\n\n**Tech Stack**:\n\n- **Backend**: Django, and Django Rest Framework for RESTful APIs\n- **Database**: PostgreSQL\n- **DevOps**: Docker, Docker-compose\n\n\u003c!-- ## Testing\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eShow Testing Details\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\n# Run tests With coverage\ndocker compose exec api pytest\n\n- 85%+ test coverage with `pytest` and `coverage.py`.\n- Includes unit tests (models, utilities) and integration tests (API endpoints).\n```\n\n\u003c/details\u003e --\u003e\n\n## Deployment\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eShow Deployment Details\u003c/strong\u003e\u003c/summary\u003e\n\n### Production\n\n```bash\n\n# Run with Docker Compose\ndocker-compose -f compose.prod.yaml up -d\n```\n\n### Environment Variables\n\n```bash\nDB_USER=your_database_user\nREDIS_URL=redis://host:6379/0\nSECRET_KEY=your-secret-key\nALLOWED_HOSTS=your-domain.com\n```\n\n\u003c/details\u003e\n\n## License\n\nMIT License. See [LICENSE](LICENSE).\n\n\u003cdiv align=\"center\"\u003e\n\n**⭐ Star this repo if you found it useful!**\n\nBuilt by [Degisew Mengist](https://github.com/degisew)\n\n[⬆ Back to Top](#commerce-store)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdegisew%2Fcommerce-store","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdegisew%2Fcommerce-store","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdegisew%2Fcommerce-store/lists"}