{"id":16415406,"url":"https://github.com/django-dev-br/002-django5-basic-django-admin","last_synced_at":"2025-10-26T19:31:34.281Z","repository":{"id":254590068,"uuid":"846992602","full_name":"Django-Dev-Br/002-django5-basic-django-admin","owner":"Django-Dev-Br","description":"Primeiras configurações para acesso ao Django Admin","archived":true,"fork":false,"pushed_at":"2024-10-11T13:35:08.000Z","size":147,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-10T00:42:33.502Z","etag":null,"topics":["django","django-admin","django-admin-interface","django-admin-panel","django-application","django-framework","django-project"],"latest_commit_sha":null,"homepage":"https://django.dev.br/","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/Django-Dev-Br.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}},"created_at":"2024-08-24T14:41:22.000Z","updated_at":"2024-10-11T13:35:32.000Z","dependencies_parsed_at":"2024-09-08T13:14:05.421Z","dependency_job_id":"505ec50c-e1a4-4f51-982c-700a44d27ca2","html_url":"https://github.com/Django-Dev-Br/002-django5-basic-django-admin","commit_stats":{"total_commits":19,"total_committers":2,"mean_commits":9.5,"dds":"0.052631578947368474","last_synced_commit":"e6b2e39f96ae7ff487ed8cd1184618722c8ecb60"},"previous_names":["django-dev-br/002-django4-basic-django-admin","django-dev-br/002-django5-basic-django-admin"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Django-Dev-Br%2F002-django5-basic-django-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Django-Dev-Br%2F002-django5-basic-django-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Django-Dev-Br%2F002-django5-basic-django-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Django-Dev-Br%2F002-django5-basic-django-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Django-Dev-Br","download_url":"https://codeload.github.com/Django-Dev-Br/002-django5-basic-django-admin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238394323,"owners_count":19464583,"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":["django","django-admin","django-admin-interface","django-admin-panel","django-application","django-framework","django-project"],"created_at":"2024-10-11T07:04:11.568Z","updated_at":"2025-10-26T19:31:33.952Z","avatar_url":"https://github.com/Django-Dev-Br.png","language":"Python","readme":"\n# 002 Django 5 - Admin Setup\n\nNo [repositório anterior](https://github.com/Django-Dev-Br/001-django5-basic-project) criamos um projeto Django. \n\nAgora, dando sequência, vamos materializar a estrutura de tabelas do banco de dados que vem com o Django. Em seguida, vamos criar um superusuário para acessar o Django-Admin. \n\nNos repositórios seguines,[03](https://github.com/Django-Dev-Br/003-django5-fixtures) e [04](https://github.com/Django-Dev-Br/004-django5-dot-env-file), vamos adicionar algumas configurações adicionais, seguindo boas práticas de mercado.\n\nNos repositórios [05](https://github.com/Django-Dev-Br/005-Django5-Basic-App) e [06](https://github.com/Django-Dev-Br/006-Django5-Basic-App-2) vamos adicionar um app ao Projeto. \n\nEsses 06 primeiros respositórios supracitados compõem um scaffold ou o core para o desenvolvimento de uma aplicação web com Python e Django. \n\n### O que é o Django Admin?\n\nO Django Admin é uma interface administrativa gerada automaticamente por meio das configurações do projeto Django. Ele permite gerenciar modelos (tabelas de bancos de dados) e realizar operações CRUD (Criar, Ler, Atualizar, Deletar) de forma rápida e eficiente. O Django Admin é uma ferramenta poderosa para gerenciar o conteúdo e as funcionalidades do seu site diretamente a partir do navegador.\n\n[confira o melhor material de toda a internet sobre o assunto:](https://books.agiliq.com/projects/django-admin-cookbook/en/latest/)\n\n**OBS**: Confira no [repositório anterior](https://github.com/Django-Dev-Br/001-django4-basic-project) os conceitos de **Projeto Django, venv, PIP e PyPi**. \n\n## COMO RODAR ESSE PROJETO EM SEU COMPUTADOR:\n\n### Requisitos\n\n- [GIT](https://git-scm.com/downloads/win)\n- **[Python 3.12 com PIP e venv](https://www.python.org/)**\n- **o Django 5 requer Python 3.10 ou superior.**\n\n- **No [repositório anterior](https://github.com/Django-Dev-Br/001-django4-basic-project) há explicações sobre PIP e venv**\n\n  [Baixar Python 3.12](https://www.python.org/downloads/release/python-3122/)\n\n  Confira o vídeo para saber como trabalhar com múltiplas versões do Python e com venv (ambiente virtual):\n  [![Watch the video](https://img.youtube.com/vi/cxsaUE5JzDk/0.jpg)](https://youtu.be/cxsaUE5JzDk)\n\n\n### 8 passos simples para executar\n\n1. **Clone o repositório**:\n    ```bash\n    git clone https://github.com/Django-Dev-Br/002-django5-basic-django-admin.git\n    ```\n\n2. **Crie um ambiente virtual**:\n   \n    **Windows**\n    ```bash\n     python -m venv myvenv  \n    ```\n   **Linux**\n    ```bash\n     python3 -m venv myvenv  \n    ```\n\n3. **Ative o ambiente virtual criado**:\n   \n    **Windows**\n    ```bash\n    myvenv\\Scripts\\activate  \n    ```\n\n   **Linux**\n    ```bash\n    source myvenv/bin/activate  \n    ```\n4. **Acesse a pasta do projeto Django**\n   ```bash\n    cd 002-django5-basic-django-admin\n    ```\n   \n5. **Instale o Django**:\n    ```python\n    pip install django\n    ```\n    - use, preferencialmente, a versão 5.1. Para tanto, execute o comando:\n\n     ```bash\n    pip install  \"django\u003e=5.1,\u003c=5.2\"\n    ```\n     \n    ----- **OU** -----\n\n    **Instalação via arquivo requirements**\n    ```bash\n    pip install -r requirements.txt\n    ```\n    O arquivo requirements.txt é um arquivo de texto que contém uma lista de pacotes a ser instalado em uma venv. É uma boa prática de programação do ecossistema Python.\n   \n6. **Execute as migrações do banco de dados**:\n   \n    ```bash\n    python manage.py migrate\n    ```\n    O comando acima criará no diretório raiz o banco de dados db.sqlite3 com o esquema de tabelas do Django\n\n\n8. **Crie um superusuário para acessar o Django Admin**:\n   \n    ```bash\n    python manage.py createsuperuser\n    ```\n    Após, siga as instruções do terminal para criar um usuário e senha. Em regra, usa-se, respectivamente, admin e root. Não é preciso informar o email em ambiente local.\n\n   **OBS:** No [próximo repositório desta série](https://github.com/Django-Dev-Br/003-django5-fixtures), iremos ver como criar um arquivo de backup desse superusuário ora criado.\n\n10. **Execute o servidor de desenvolvimento**:\n    ```bash\n    python manage.py runserver\n    ```\n\n### Acesse o Django Admin no seu navegador:\n\nApós executar o servidor de desenvolvimento, você pode acessar o Django Admin no seguinte endereço:\n\n[http://127.0.0.1:8000/admin/](http://127.0.0.1:8000/admin/)\n\nFaça login com as credenciais do superusuário que você acabou de criar.\n\n\n### Estrutura de Diretórios do Projeto\n\n```\n002-django5-admin-setup/\n├── .gitignore           # Arquivo que especifica quais arquivos e diretórios o Git deve ignorar (não incluir no versionamento)\n├── db.sqlite3           # Banco de dados SQLite criado após as migrações\n├── myproject/\n│   ├── __init__.py      # Marca o diretório como um pacote Python\n│   ├── asgi.py          # Configurações para o servidor ASGI (usado para aplicações assíncronas)\n│   ├── settings.py      # Configurações do projeto (banco de dados, apps instalados, etc.)\n│   ├── urls.py          # Mapeamento de requisições HTTP e redirecionamento para os templates HTML\n│   └── wsgi.py          # Configurações para o servidor WSGI (usado para servir a aplicação)\n└── manage.py            # CLI do Django, um script de linha de comando para tarefas execução de comandos do Django no terminal\n└── requirements.txt    # Lista de pacotes Python necessários para o projeto\n```\n\n### OBS: Como Criar um Projeto Django\n\nSe desejar criar seu próprio projeto Django, use o seguinte comando após criar e ativar a virtual env e instalar o django nela, conforme orientações acima:\n\n```bash\ndjango-admin startproject myproject\n```\n\n### Sobre Nosso Treinamento Prático-Profissional com projeto real para iniciantes e avançados em web DevOps Full-stack com Python, Django, Bootstrap e Linux.\n\n[Django Developers Brasil - Aprenda programando enquanto programa aprendendo!](https://django.dev.br/)\n\nNosso treinamento oferece uma experiência prática de aprendizado de programação, adequada tanto para iniciantes quanto para desenvolvedores avançados. Você participará de um projeto real de desenvolvimento de software em um ambiente corporativo autêntico, onde pessoas com diferentes níveis de conhecimento irão colaborar, aprendendo umas com as outras.\n\n**Junte-se a nós!** E desenvolva as habilidades necessárias para o mercado de trabalho, aprimorando tanto seus conhecimentos técnicos quanto suas soft skills em um ambiente colaborativo e realista.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-dev-br%2F002-django5-basic-django-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjango-dev-br%2F002-django5-basic-django-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjango-dev-br%2F002-django5-basic-django-admin/lists"}