Can't read portuguese? Read this README in english

Este repositório será utilizado para a criação de um blog com Django, onde o conteúdo será formatado em Markdown.

Trata-se de um projeto pessoal para praticar o desenvolvimento de aplicações web com Django.

Este projeto é um blog simples que permite a criação de posts formatados em Markdown, podendo ser visualizados por qualquer usuário. Também é possível criar uma conta de usuário para postar conteúdo, editar e excluir posts. Também é possível criar uma conta para comentar nos posts. Existe uma área de administração para gerenciar os posts, usuários e comentários.

Os posts são classificados por categorias e tags, e é possível visualizar os posts de uma categoria específica ou filtrar por tags. Além da possibilidade de usuários criarem tags personalizadas e gerar filtros a partir delas.

• Django: Framework web de alto nível escrito em Python.
• Django REST Framework: Biblioteca que facilita a criação de APIs REST com Django.
• Markdown: Biblioteca Python para processar texto em Markdown.
• Docker: Plataforma para desenvolvimento, envio e execução de aplicações em contêineres.
• PostgreSQL: Banco de dados relacional de código aberto.

Este projeto em Django está Dockerizado e segue os princípios da arquitetura limpa (Clean Architecture). Ele proporciona uma estrutura sólida para o desenvolvimento de uma variedade de aplicações, desde APIs até aplicações web.

Siga estes passos para executar o projeto:

1. Clonar o Repositório:

   git clone git@github.com:luderibeiro/django_base.git
   

2. Configurar o Ambiente:

• Crie um arquivo .env na raiz do projeto e adicione as configurações necessárias, como chaves de API, configurações de banco de dados, etc.

4. Executar o Docker Compose:

   docker-compose up --build
   

obs.: a tag --build deve ser executada somente a primeira vez que o projeto for instalado ou quando houverem alterações nos arquivos de build.

5. Acessar a Aplicação: A aplicação estará disponível em http://localhost:8000.

   Caso queira acessar a pagina admin basta acessar http://localhost:8000/admin/

Tratamento de erros

• No caso de receber este erro: PermissionError: [Errno 13] Permission denied: '/data/web/static/admin' Rodar o seguinte comando:

  sudo chown -R user:group data
  

obs.: Mude "user" por seu usuário local da máquina e "group" pelo grupo do usuário

Sinta-se à vontade para contribuir com melhorias ou novas funcionalidades. Basta seguir estes passos:

1. Faça um fork do repositório.
2. Crie um branch para a sua contribuição: git checkout -b feature/nova-feature.
3. Faça suas alterações e faça commit: git commit -m 'Adiciona nova feature'.
4. Faça push para o branch: git push origin feature/nova-feature.
5. Abra um pull request.

Este projeto está licenciado sob a MIT License.