{"id":27446354,"url":"https://github.com/elainefs/django-sge","last_synced_at":"2026-04-29T16:04:27.884Z","repository":{"id":287805664,"uuid":"965845556","full_name":"elainefs/django-sge","owner":"elainefs","description":"SGE - Sistema de Gerenciamento de Estoque","archived":false,"fork":false,"pushed_at":"2026-02-18T19:19:04.000Z","size":382,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-18T23:26:13.580Z","etag":null,"topics":["bootstrap","chartjs","django","django-rest-framework","docker","postgresql","python"],"latest_commit_sha":null,"homepage":"https://django-sge.onrender.com","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/elainefs.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-14T02:11:58.000Z","updated_at":"2026-02-18T19:19:08.000Z","dependencies_parsed_at":"2025-10-17T10:08:19.713Z","dependency_job_id":"883f36fc-0025-4154-aef1-b5eae5102738","html_url":"https://github.com/elainefs/django-sge","commit_stats":null,"previous_names":["elainefs/django-sge"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/elainefs/django-sge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elainefs%2Fdjango-sge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elainefs%2Fdjango-sge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elainefs%2Fdjango-sge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elainefs%2Fdjango-sge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elainefs","download_url":"https://codeload.github.com/elainefs/django-sge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elainefs%2Fdjango-sge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32432917,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T13:34:34.882Z","status":"ssl_error","status_checked_at":"2026-04-29T13:34:29.830Z","response_time":110,"last_error":"SSL_read: 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":["bootstrap","chartjs","django","django-rest-framework","docker","postgresql","python"],"created_at":"2025-04-15T04:16:48.588Z","updated_at":"2026-04-29T16:04:27.878Z","avatar_url":"https://github.com/elainefs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003ch1\u003eSistema de Gerenciamento de Estoque - SGE\u003c/h1\u003e\n    \u003cimg src=\"https://img.shields.io/github/repo-size/elainefs/django-sge\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/languages/top/elainefs/django-sge\"\u003e \n    \u003cimg src=\"https://img.shields.io/github/last-commit/elainefs/django-sge?color=blue\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/elainefs/django-sge.svg?color=blue\"\u003e\n    \u003cbr\u003e\u003cbr\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Python-3776AB?style=flat\u0026logo=python\u0026logoColor=white\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Django-092E20?style=flat\u0026logo=django\u0026logoColor=white\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/PostgreSQL-316192?style=flat\u0026logo=postgresql\u0026logoColor=white\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Bootstrap-563D7C?style=flat\u0026logo=bootstrap\u0026logoColor=white\"\u003e\n\u003c/div\u003e\n\n## 📘 Sobre\n\nAplicação FullStack desenvolvida usando Django e Django REST framework para fazer o gerenciamento de estoque.\n\nA aplicação possui uma interface web para manipulação de informações, bem como uma API RESTful, além disso, há integração com uma [aplicação de notificações](https://github.com/elainefs/django-sge-notify) para o envio de notificações por e-mail e WhatsApp via API do [CallMeBot](https://www.callmebot.com/). \n\nAlém disso, utiliza a IA generativa da OpenAI para fornecer de insights e recomendações sobre os produtos do estoque.\n\n🌐 **Acesse:** [https://django-sge.onrender.com](https://django-sge.onrender.com)\n\n⏰ **Nota:** Como esta é uma aplicação de demonstração hospedada no plano gratuito do Render, o primeiro acesso após período de inatividade pode levar 30-60 segundos para carregar, exibindo a tela padrão de carregamento do Render. Acessos subsequentes são instantâneos!\n\n![SGE - Dashboard](sge-dashboard.png)\n\n## 💻️ Tecnologias\n\n- Python\n- Django\n- Django REST framework\n- PostgreSQL\n\n## ✅ Funcionalidade\n\n- [x] Autenticação com JWT para proteger os endpoints da API.\n- [x] Integração via Webhook para disparo de notificações de movimentação de estoque.\n- [x] Listagem, criação, atualização e deleção de produtos.\n- [x] Listagem, criação, atualização e deleção de marcas de produtos.\n- [x] Listagem, criação, atualização e deleção de categorias de produtos.\n- [x] Listagem, criação, atualização e deleção de fornecedores de produtos.\n- [x] Listagem, criação, atualização e deleção de entradas e saídas de produtos.\n\n## ⚙️ Como usar\n\n### Executar a aplicação via Docker\n\nCertifique-se de ter o Docker e Docker Compose instalados, em seguida siga os seguintes passos:\n\n1. Clone o repositório\n\n```bash\ngit clone https://github.com/elainefs/django-sge.git\n\ncd django-sge\n```\n\n2. Crie um arquivo `.env` na raiz do projeto\n\nO arquivo `.env-example` é um modelo de como o seu arquivo `.env` deve ser.\n\nPara gerar uma nova `SECRET_KEY`, a partir da raiz do projeto, use o seguinte comando no terminal:\n\n```bash\npython -c \"from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())\"\n```\n\nAdicione a sua `SECRET_KEY` a sua `.env` e edite as demais informações conforme suas preferências.\n\nForneça a url do sistema de notificações em `NOTIFICATION_URL`.\n\nPara usar o recurso de IA é necessário fornecer o modelo e a chave de API através das variáveis `OPENAI_API_KEY` e `OPENAI_MODEL`.\n\n3. Execute o Docker Compose\n\n```bash\ndocker compose up --build -d\n```\n\n4. Crie um super usuário\n\n```bash\ndocker exec -it sge_web python manage.py createsuperuser\n```\n\n### Executar a aplicação localmente sem Docker\n\nPara executar essa aplicação siga os seguintes passos:\n\n1. Clone o repositório\n\n```bash\ngit clone https://github.com/elainefs/django-sge.git\n\ncd django-sge\n```\n\n2. Crie e ative um ambiente virtual\n\n```bash\npython3 -m venv .venv # Para Windows use: python -m venv .venv\n\nsource .venv/bin/activate  # Para Windows use: .venv\\Scripts\\activate\n```\n\n3. Instale as dependências do projeto\n\n```bash\npip install -r requirements.txt\n```\n\n4. Crie um arquivo `.env` na raiz do projeto\n\nO arquivo `.env-example` é um modelo de como o seu arquivo `.env` deve ser.\n\nPara gerar uma nova `SECRET_KEY`, a partir da raiz do projeto, use o seguinte comando no terminal:\n\n```bash\npython -c \"from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())\"\n```\n\nAdicione a sua `SECRET_KEY` a sua `.env` e edite as demais informações conforme suas preferências.\n\nForneça a url do sistema de notificações em `NOTIFICATION_URL`.\n\nPara usar o recurso de IA é necessário fornecer o modelo e a chave de API através das variáveis `OPENAI_API_KEY` e `OPENAI_MODEL`.\n\n5. Execute as migrações no banco de dados\n\n```bash\npython3 manage.py migrate\n```\n\n6. Crie um super usuário\n\n```bash\npython3 manage.py createsuperuser\n```\n\n7. Execute a aplicação\n\n```bash\npython3 manage.py runserver\n```\n\nA aplicação estará disponível em `http://localhost:8000`.\n\nO gerenciamento pode ser feito através da interface do Django Admin em: `http://localhost:8000/admin/`\n\nPara interagir com a API você pode usar o Swagger UI ou outra aplicação de requisições HTTP de sua preferência, como Postman, Insomnia, entre outras.\n\n- **Swagger UI**: Acesse a documentação interativa da API em `http://0.0.0.0:8000/api/swagger/` ou `http://localhost:8000/api/swagger/`\n\n- **Redoc**: Você também pode ver a descrição completa dos endpoints através da documentação pelo Redoc em `http://0.0.0.0:8000/api/redoc/` ou `http://localhost:8000/api/redoc/`\n\n## 🔗 Endpoints da API\n\n### Autenticação JWT\n\nPara ter acesso aos dados da API é necessário um token JWT.\n\nO access token possui validade de 1 dia e o refresh de 7 dias.\n\n#### Criação de Token\n\nPOST - `http://localhost:8000/api/v1/authentication/token/`\n\nPasse as informações do usuário cadastrado no sistema no body da requisição:\n\n```\n{\n    \"username\": \"admin\",\n    \"password\": \"admin\"\n}\n```\n\n#### Verificação do Token\n\nPOST - `http://localhost:8000/api/v1/authentication/token/verify/`\n\nPasse o access token obtido na criação no body da requisição:\n\n```\n{\n    \"token\": \"access_token\"\n}\n```\n\n#### Refresh Token\n\nPOST - `http://localhost:8000/api/v1/authentication/token/refresh/`\n\nPasse o refresh token obtido na criação no body da requisição:\n\n```\n{\n    \"refresh\": \"refresh_token\"\n}\n```\n\n### Marcas\n\n#### Criar marcas de produtos\n\nPOST - `http://localhost:8000/brands/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nRequest Body:\n\n```json\n{\n  \"name\": \"Dell\",\n  \"description\": \"Descrição da marca\"\n}\n```\n\n#### Listar todas as marcas\n\nGET - `http://localhost:8000/brands/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\n#### Listar marca por ID\n\nGET - `http://localhost:8000/brands/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor       |\n| ----- | ----------- |\n| id    | id_da_marca |\n\n#### Atualizar marca\n\nPUT - `http://localhost:8000/brands/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor       |\n| ----- | ----------- |\n| id    | id_da_marca |\n\nRequest Body:\n\n```json\n{\n  \"name\": \"Dell\",\n  \"description\": \"Descrição da marca\"\n}\n```\n\n#### Excluir marca\n\nDELETE - `http://localhost:8000/brands/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor       |\n| ----- | ----------- |\n| id    | id_da_marca |\n\n### Categorias\n\n#### Criar categoria de produtos\n\nPOST - `http://localhost:8000/categories/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nRequest Body:\n\n```json\n{\n  \"name\": \"Notebook\",\n  \"description\": \"Descrição da categoria\"\n}\n```\n\n#### Listar todas as categorias\n\nGET - `http://localhost:8000/categories/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\n#### Listar categorias por ID\n\nGET - `http://localhost:8000/categories/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor           |\n| ----- | --------------- |\n| id    | id_da_categoria |\n\n#### Atualizar categoria\n\nPUT - `http://localhost:8000/categories/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor           |\n| ----- | --------------- |\n| id    | id_da_categoria |\n\nRequest Body:\n\n```json\n{\n  \"name\": \"Notebook\",\n  \"description\": \"Descrição da categoria\"\n}\n```\n\n#### Excluir categoria\n\nDELETE - `http://localhost:8000/categories/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor           |\n| ----- | --------------- |\n| id    | id_da_categoria |\n\n### Entradas de produtos\n\n#### Criar entrada de produtos\n\nPOST - `http://localhost:8000/inflows/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nRequest Body:\n\n```json\n{\n    \"product\": 1\n    \"supplier\": 1,\n    \"quantity\": 10,\n    \"description\": \"Compra de 10 notebooks.\",\n}\n```\n\n#### Listar todas as entradas\n\nGET - `http://localhost:8000/inflows/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\n#### Listar entrada por ID\n\nGET - `http://localhost:8000/inflows/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor         |\n| ----- | ------------- |\n| id    | id_da_entrada |\n\n\u003e **Para manter a integridade do banco, a menos que o usuário seja um super usuário logado pelo painel administrativo do Django, não é permitido excluir ou atualizar entradas.**\n\n### Saídas de produtos\n\n#### Criar saída de produtos\n\nPOST - `http://localhost:8000/outflows/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nRequest Body:\n\n```json\n{\n  \"product\": 1,\n  \"quantity\": 10,\n  \"description\": \"Venda de 10 notebooks.\"\n}\n```\n\n#### Listar todas as saídas\n\nGET - `http://localhost:8000/outflows/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\n#### Listar entrada por ID\n\nGET - `http://localhost:8000/outflows/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor       |\n| ----- | ----------- |\n| id    | id_da_saida |\n\n\u003e **Para manter a integridade do banco, a menos que o usuário seja um super usuário logado pelo painel administrativo do Django, não é permitido excluir ou atualizar saídas.**\n\n### Produtos\n\n#### Criar produto\n\nPOST - `http://localhost:8000/products/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nRequest Body:\n\n```json\n{\n  \"title\": \"Rayzen 5 5500U\",\n  \"description\": \"Processador para notebooks.\",\n  \"serie_number\": \"40180480180810\",\n  \"cost_price\": \"150.00\",\n  \"selling_price\": \"239.00\",\n  \"quantity\": 7,\n  \"category\": 3,\n  \"brand\": 4\n}\n```\n\n#### Listar todos os produtos\n\nGET - `http://localhost:8000/products/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\n#### Listar produtos por ID\n\nGET - `http://localhost:8000/products/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor         |\n| ----- | ------------- |\n| id    | id_do_produto |\n\n#### Atualizar produto\n\nPUT - `http://localhost:8000/products/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor         |\n| ----- | ------------- |\n| id    | id_do_produto |\n\nRequest Body:\n\n```json\n{\n  \"title\": \"Rayzen 5 5500U\",\n  \"description\": \"Processador para notebooks.\",\n  \"serie_number\": \"40180480180810\",\n  \"cost_price\": \"150.00\",\n  \"selling_price\": \"239.00\",\n  \"quantity\": 7,\n  \"category\": 3,\n  \"brand\": 4\n}\n```\n\n#### Excluir produto\n\nDELETE - `http://localhost:8000/products/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor         |\n| ----- | ------------- |\n| id    | id_da_produto |\n\n### Fornecedores\n\n#### Criar fornecedor de produtos\n\nPOST - `http://localhost:8000/suppliers/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nRequest Body:\n\n```json\n{\n  \"nome\": \"AMD LTDA\",\n  \"description\": \"Empresa de processador para notebooks.\"\n}\n```\n\n#### Listar todos os fornecedores\n\nGET - `http://localhost:8000/suppliers/api/v1/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\n#### Listar fornecedores por ID\n\nGET - `http://localhost:8000/suppliers/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor            |\n| ----- | ---------------- |\n| id    | id_do_fornecedor |\n\n#### Atualizar produto\n\nPUT - `http://localhost:8000/suppliers/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor            |\n| ----- | ---------------- |\n| id    | id_do_fornecedor |\n\nRequest Body:\n\n```json\n{\n  \"nome\": \"AMD LTDA\",\n  \"description\": \"Empresa de processador para notebooks.\"\n}\n```\n\n#### Excluir fornecedor\n\nDELETE - `http://localhost:8000/suppliers/api/v1/{id}/`\n\nCampos do header da requisição:\n\n| Campo         | Valor        |\n| ------------- | ------------ |\n| Authorization | Bearer token |\n\nParâmetros\n\n| Campo | Valor            |\n| ----- | ---------------- |\n| id    | id_do_fornecedor |\n\n## 📄 Licença\n\nEste projeto está sobre a licença MIT. Veja o arquivo [LICENSE](https://github.com/elainefs/django-sge/blob/main/LICENSE) para mais informações.\n\n---\n\nMade with ❤️ by [Elaine Ferreira](https://github.com/elainefs)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felainefs%2Fdjango-sge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felainefs%2Fdjango-sge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felainefs%2Fdjango-sge/lists"}