{"id":21457776,"url":"https://github.com/bitzkort/hommiestock-back","last_synced_at":"2026-02-21T06:13:16.048Z","repository":{"id":264264683,"uuid":"892869911","full_name":"BitzKort/HommieStock-Back","owner":"BitzKort","description":"This is the backend repository of the final proyect for the Nosql course","archived":false,"fork":false,"pushed_at":"2024-12-17T13:01:08.000Z","size":97,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-23T13:33:00.369Z","etag":null,"topics":["fastapi","mongodb","nosql-databases","python","redis"],"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/BitzKort.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-11-23T00:04:23.000Z","updated_at":"2024-12-20T03:14:45.000Z","dependencies_parsed_at":"2024-12-12T02:18:02.881Z","dependency_job_id":"9186a0d4-0793-4b07-b643-0858b159d193","html_url":"https://github.com/BitzKort/HommieStock-Back","commit_stats":null,"previous_names":["bitzkort/hommiestock-back"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitzKort%2FHommieStock-Back","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitzKort%2FHommieStock-Back/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitzKort%2FHommieStock-Back/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitzKort%2FHommieStock-Back/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BitzKort","download_url":"https://codeload.github.com/BitzKort/HommieStock-Back/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243971193,"owners_count":20376784,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["fastapi","mongodb","nosql-databases","python","redis"],"created_at":"2024-11-23T06:06:58.147Z","updated_at":"2025-10-20T05:47:36.814Z","avatar_url":"https://github.com/BitzKort.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HommieStock Backend Repository\n\nThis repository contains the backend for the final project in the NoSQL databases course. The project uses MongoDB as a non-relational database and a REST API built with FastAPI to deliver a complete inventory management solution.\n\n---\n\n## Project Description\n\nHommieStock is a solution designed to manage the real-time inventory of a retail chain. It provides functionalities for managing products, inventories, orders, suppliers, returns, and reports, all optimized to take full advantage of a NoSQL database like MongoDB.\n\n---\n\n## Prerequisites\n\nBefore running the project, ensure you have the following installed:\n\n- Python 3.9 or higher.\n- [Pipenv](https://pipenv.pypa.io/en/latest/) for virtual environment management.\n- A MongoDB instance (local or cloud, such as [MongoDB Atlas](https://www.mongodb.com/cloud/atlas)) properly configured.\n\n---\n\n## How to Run the Project\n\nFollow these steps to set up and run the backend:\n\n1. Install Pipenv:\n\n   ```bash\n   pip install pipenv\n   ```\n2. Create an venv:\n\n    ```bash\n    pipenv shell\n    ```\n3. Install dependencies\n\n    ```bash\n    pipenv install -r requirements.txt\n    ```\n4. Run de server:\n\n    ```bash\n    python -m uvicorn main:app --reload\n    ```\n5. Open on your browser: http://127.0.0.1:8000      \n\n---\n## Important Notes\n\n### MongoDB Connection:\nIf you encounter issues connecting to MongoDB, make sure that:\n\n1. Your IP address is allowed in your MongoDB Atlas account.\n2. The credentials and URI in the configuration file are correct.\n\n### Virtual Environment:\n\nMake sure you are working within the virtual environment created with Pipenv before executing any commands.\n\n---\n\n## Branch Structure\n* main: Main branch with the stable version of the project.\n* feature/mongodb_structure: Branch with the initial implementation of the MongoDB structure.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitzkort%2Fhommiestock-back","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitzkort%2Fhommiestock-back","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitzkort%2Fhommiestock-back/lists"}