Aplicação Kanban_logs

Status: Desenvolvedor ⚠️

Kanban Logs é uma aplicação web desenvolvida com Python, Django, e Bootstrap 5 que permite aos usuários registrar e organizar tópicos de estudo, acompanhados de anotações, em um formato visual de Kanban. A ferramenta ajuda a gerenciar o progresso de aprendizado de forma eficiente e prática.

Tecnologias Utilizadas

• Backend: Django (Framework Python)
• Frontend: Bootstrap 5 (Framework CSS)
• Banco de Dados: SQLite (ou qualquer outro compatível com Django)

Pré-requisitos

• Python3: Download do Python3.
• Django: Digite no seu powershell ou terminal linux o comando pip install django.
• Pip: Gerenciador de pacotes do Python que serve para instalação de dependências. Digite no seu Powershell ou no terminal do Linux o comando python -m ensurepip --default-pip.
• Git: Download do Git.

Estrutura do Repositório

Os projetos em Django utilizam a arquitetura MVT, Model, View, Template o que é bem semelhante a MVC.

• Kanban_log/: Diretório raiz do projeto ele é responsavel pela configuração e gerenciamento dos apps.
• Kanban_logs/: Diretório(app) principal.
• user/: Cóntem a parte logica do de gerenciamento de usuário como o de regitro e o login.
• templates/: Contém a parte logica do de gerenciamento de usuário como o de registro e o login.
• manage.py: Arquivo responsável pela inicialização do projeto.
• urls.py: Arquivo responsável pelo mapeamento de rotas.
• views.py: View desempenha o papel do Controller no MVC. Ela possui funções que processa as requisições HTTP, interage com os modelos e retorna uma resposta, no caso uma página HTML.
• models.py: Model desempenha o papel da regra de negócio de Topic(tópico) e Entry(anotações) no caso do app user não precisou porque a regra de negócio utilizado nesse caso foi a padrão importada do próprio Django.
• forms.py: Padronização do formulário tanto o de Topic como o de Entry.
• settings.py: Responsável pela configuração do projeto, como a declaração de instalação de aplicativos e dependências como o Bootstrap, e a definição de qual banco de dados será utilizado na aplicação.
• README.md: Este arquivo.

Como Executar

1. No terminal do Powershell ou o git bash digite git clone https://github.com/thiago-cloud/Kanban_log.git em desktop ou pasta de sua preferência.
2. Em seguida vá até a raiz do projeto cd Kanban_log e digite: . ll_env/Scripts/activate para ativar o ambiente virtual do projeto.
3. Vá à raiz do projeto, a raiz do projeto tem o arquivo settings.py, nesse mesmo arquivo troque ALLOWED_HOST = ['.vercel.app'] para ALLOWED_HOST = ['127.0.0.1'] isso e necessário para rodar o projeto na máquina local no lugar de rodar no vercel.
4. Após ativar o ambiente do projeto você estara dentro do ambiente agora, digite python -m ensurepip --default-pip para instalar as depêndencias do gerenciador de pacotes pip.
5. Instale o django o comando é: pip install django.
6. Instalação do bootstrap5 o comando é: pip install django-bootstrap-v5
7. Na raiz do projeto, execute o comando python manage.py migrate para aplicar todas as migrações e criar as tabelas do banco de dados em sua máquina local, permitindo o funcionamento do banco de dados SQLite3.
8. Build do projeto: python .\manage.py runserver.
9. OBS: Os comandos devem ser digitados na raiz do projeto com ambiente virtual ativo, ou seja, dentro do ambiente virtual que no caso o ambiente virtual criado se chama ll_env.