{"id":30183652,"url":"https://github.com/gabriellglrs/api_tasks_django","last_synced_at":"2026-05-03T01:32:03.044Z","repository":{"id":304893003,"uuid":"1019788136","full_name":"gabriellglrs/api_tasks_django","owner":"gabriellglrs","description":"API REST desenvolvida em Django com MySQL para gerenciar tarefas. Oferece operações CRUD completas: criar, listar, atualizar e excluir tarefas. Cada tarefa possui título, descrição e status de conclusão. Inclui Docker para fácil deployment e dados de exemplo.","archived":false,"fork":false,"pushed_at":"2025-07-15T22:34:14.000Z","size":16528,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-16T21:45:25.225Z","etag":null,"topics":["api-rest","django","docker-compose","mysql","python"],"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/gabriellglrs.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,"zenodo":null}},"created_at":"2025-07-14T21:54:57.000Z","updated_at":"2025-07-15T22:34:19.000Z","dependencies_parsed_at":"2025-07-17T04:15:11.713Z","dependency_job_id":"c7f38277-e7d7-4f9f-af0f-9ee6825cf74c","html_url":"https://github.com/gabriellglrs/api_tasks_django","commit_stats":null,"previous_names":["gabriellglrs/api_tasks_django"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/gabriellglrs/api_tasks_django","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabriellglrs%2Fapi_tasks_django","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabriellglrs%2Fapi_tasks_django/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabriellglrs%2Fapi_tasks_django/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabriellglrs%2Fapi_tasks_django/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gabriellglrs","download_url":"https://codeload.github.com/gabriellglrs/api_tasks_django/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabriellglrs%2Fapi_tasks_django/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270048528,"owners_count":24518086,"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","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"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":["api-rest","django","docker-compose","mysql","python"],"created_at":"2025-08-12T11:18:11.489Z","updated_at":"2026-05-03T01:32:03.017Z","avatar_url":"https://github.com/gabriellglrs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=100% src=\"https://capsule-render.vercel.app/api?type=waving\u0026color=4C89F8\u0026height=120\u0026section=header\"/\u003e\n\n\u003cimg width=\"1584\" height=\"396\" alt=\"LinkedIn cover - 29\" src=\"https://github.com/user-attachments/assets/d1c05723-0bec-4ce7-8dee-1ef8c95ebf3e\" /\u003e\n\n\n# Todo API\n\nUma API REST simples para gerenciamento de tarefas (To-Do List) desenvolvida em Django com Django REST Framework e MySQL.\n\n## 📋 Funcionalidades\n\n- ✅ Listar todas as tarefas\n- ✅ Criar nova tarefa\n- ✅ Visualizar detalhes de uma tarefa específica\n- ✅ Atualizar tarefa existente\n- ✅ Excluir tarefa\n- ✅ Marcar tarefa como completa/incompleta\n\n## 🛠️ Tecnologias Utilizadas\n\n- **Python 3.x**\n- **Django 5.2.4**\n- **Django REST Framework**\n- **MySQL 8.0**\n- **Docker \u0026 Docker Compose**\n\n## 📁 Estrutura do Projeto\n\n```\ntodo_api/\n├── docker-compose.yml\n├── manage.py\n├── popular_DB.sql\n├── tasks/\n│   ├── __init__.py\n│   ├── admin.py\n│   ├── apps.py\n│   ├── models.py\n│   ├── serializers.py\n│   ├── tests.py\n│   ├── urls.py\n│   ├── views.py\n│   └── migrations/\n│       ├── __init__.py\n│       └── 0001_initial.py\n└── todo_api/\n    ├── __init__.py\n    ├── asgi.py\n    ├── settings.py\n    ├── urls.py\n    └── wsgi.py\n```\n\n## 🚀 Como Executar\n\n### Pré-requisitos\n\n- Docker\n- Docker Compose\n- Python 3.x (opcional, se não usar Docker)\n\n### Usando Docker (Recomendado)\n\n1. **Clone o repositório**\n```bash\ngit clone \u003curl-do-repositorio\u003e\ncd todo_api\n```\n\n2. **Inicie o banco de dados MySQL**\n```bash\ndocker-compose up -d\n```\n\n3. **Instale as dependências Python**\n```bash\npip install django djangorestframework mysqlclient\n```\n\n4. **Execute as migrações**\n```bash\npython manage.py makemigrations\npython manage.py migrate\n```\n\n5. **Popule o banco com dados de exemplo (opcional)**\n```bash\n# Acesse o MySQL e execute o arquivo popular_DB.sql\n# Certifique-se de ajustar o nome da tabela para tasks_task\n```\n\n6. **Inicie o servidor Django**\n```bash\npython manage.py runserver\n```\n\n### Instalação Local (sem Docker)\n\n1. **Instale e configure o MySQL**\n```bash\n# Crie um banco de dados chamado 'todo_db'\n# Crie um usuário 'user' com senha '123456'\n```\n\n2. **Instale as dependências**\n```bash\npip install django djangorestframework mysqlclient\n```\n\n3. **Execute as migrações**\n```bash\npython manage.py makemigrations\npython manage.py migrate\n```\n\n4. **Inicie o servidor**\n```bash\npython manage.py runserver\n```\n\n## 📡 Endpoints da API\n\n### Base URL\n```\nhttp://localhost:8000/api/\n```\n\n### Endpoints Disponíveis\n\n| Método | Endpoint | Descrição |\n|--------|----------|-----------|\n| GET | `/api/tasks/` | Lista todas as tarefas |\n| POST | `/api/tasks/` | Cria uma nova tarefa |\n| GET | `/api/tasks/{id}` | Busca uma tarefa específica |\n| PUT | `/api/tasks/{id}` | Atualiza uma tarefa específica |\n| DELETE | `/api/tasks/{id}` | Remove uma tarefa específica |\n\n## 📝 Exemplos de Uso\n\n### Listar todas as tarefas\n```bash\ncurl -X GET http://localhost:8000/api/tasks/\n```\n\n### Criar nova tarefa\n```bash\ncurl -X POST http://localhost:8000/api/tasks/ \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"title\": \"Estudar Django\",\n    \"description\": \"Aprender sobre Models, Views e Templates\",\n    \"completed\": false\n  }'\n```\n\n### Buscar tarefa específica\n```bash\ncurl -X GET http://localhost:8000/api/tasks/1\n```\n\n### Atualizar tarefa\n```bash\ncurl -X PUT http://localhost:8000/api/tasks/1 \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"title\": \"Estudar Django - Concluído\",\n    \"description\": \"Aprender sobre Models, Views e Templates\",\n    \"completed\": true\n  }'\n```\n\n### Excluir tarefa\n```bash\ncurl -X DELETE http://localhost:8000/api/tasks/1\n```\n\n## 🗃️ Modelo de Dados\n\n### Task\n```python\nclass Task(models.Model):\n    title = models.CharField(max_length=200)\n    description = models.TextField(blank=True)\n    completed = models.BooleanField(default=False)\n```\n\n**Campos:**\n- `id`: Identificador único (auto-incremento)\n- `title`: Título da tarefa (obrigatório, máx. 200 caracteres)\n- `description`: Descrição detalhada (opcional)\n- `completed`: Status de conclusão (padrão: false)\n\n## ⚙️ Configurações\n\n### Banco de Dados\nO projeto está configurado para usar MySQL com as seguintes credenciais:\n\n```python\nDATABASES = {\n    'default': {\n        'ENGINE': 'django.db.backends.mysql',\n        'NAME': 'todo_db',\n        'USER': 'user',\n        'PASSWORD': '123456',\n        'HOST': 'localhost',\n        'PORT': '3306',\n    }\n}\n```\n\n### Docker Compose\nO arquivo `docker-compose.yml` configura automaticamente:\n- MySQL 8.0\n- Banco de dados `todo_db`\n- Usuário `user` com senha `123456`\n- Porta 3306 exposta\n\n## 🧪 Testes\n\nPara executar os testes:\n\n```bash\npython manage.py test\n```\n\n## 📊 Dados de Exemplo\n\nO arquivo `popular_DB.sql` contém dados de exemplo para popular o banco:\n\n```sql\nINSERT INTO tasks_task (title, description, completed) VALUES\n('Organizar arquivos', 'Separar documentos importantes em pastas digitais', false),\n('Estudar Django', 'Revisar Models, Views e Templates', false),\n('Fazer backup', 'Criar backup dos projetos atuais no drive externo', true),\n-- ... mais dados\n```\n\n## 🔧 Troubleshooting\n\n### Erro de Conexão com MySQL\n- Verifique se o MySQL está rodando: `docker-compose ps`\n- Confirme as credenciais no arquivo `settings.py`\n- Aguarde alguns segundos após iniciar o container do MySQL\n\n### Erro de Migração\n```bash\npython manage.py makemigrations tasks\npython manage.py migrate\n```\n\n### Tabela não encontrada\nCertifique-se de que as migrações foram executadas corretamente e que o nome da tabela no SQL seja `tasks_task`.\n\n## 🤝 Contribuindo\n\n1. Faça um fork do projeto\n2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)\n3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)\n4. Push para a branch (`git push origin feature/AmazingFeature`)\n5. Abra um Pull Request\n\n## 📄 Licença\n\nEste projeto está sob a licença MIT. Veja o arquivo `LICENSE` para mais detalhes.\n\n## 📞 Contato\n\nPara dúvidas ou sugestões, entre em contato através do GitHub Issues.\n\n---\n\n**Desenvolvido com ❤️ usando Django e Django REST Framework**\n\n \u003cbr\u003e\n\n \u003cbr\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/ed7208b8-6bdc-4c82-98aa-8c8cb9c1428f\" height=\"150\"/\u003e\n\u003c/div\u003e\n\n\u003cimg width=100% src=\"https://capsule-render.vercel.app/api?type=waving\u0026color=4C89F8\u0026height=120\u0026section=footer\"/\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabriellglrs%2Fapi_tasks_django","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabriellglrs%2Fapi_tasks_django","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabriellglrs%2Fapi_tasks_django/lists"}