Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/thiago-cloud/kanban_log

Aplicação que permite registrar anotações de determinado tópico que estar sendo aprendido.
https://github.com/thiago-cloud/kanban_log

bootstrap5 django html powershell python

Last synced: 3 months ago
JSON representation

Aplicação que permite registrar anotações de determinado tópico que estar sendo aprendido.

Awesome Lists containing this project

README 

        
# 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 = ['']` 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. Build do projeto: `python .\manage.py runserver`.

8. 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.