🍿 CineLog - Catálogo Pessoal de Filmes e Séries

O CineLog é uma aplicação interativa de linha de comando (CLI) desenvolvida em Python. Ele funciona como um diário virtual, permitindo que o usuário registre, avalie e pesquise os filmes e séries que já assistiu. Todos os dados são salvos localmente, garantindo que o seu catálogo nunca se perca!

✨ Funcionalidades

• ➕ Adicionar Títulos: Registre o nome, gênero, ano de lançamento, uma nota de 0 a 5 e uma breve crítica.

• 🛡️ Validação Inteligente: O sistema impede a entrada de anos inválidos, notas fora do padrão e alerta sobre filmes duplicados.

• 📜 Listagem Dinâmica: Visualize toda a sua coleção com uma formatação limpa e agradável no terminal (incluindo representação visual da nota com estrelas ⭐).

• 🔍 Múltiplos Filtros de Pesquisa:

  • Por Título (pesquisa parcial inteligente).

  • Por Gênero.

  • Por Ano de Lançamento.

• 💾 Persistência de Dados: Toda a informação é automaticamente salva e lida a partir de um arquivo JSON local.

🛠️ Tecnologias e Conceitos Aplicados

Este projeto foi construído para consolidar fundamentos essenciais de programação em Python, incluindo:

• Controle de Fluxo e Loops (while, for, if/elif/else).

• Estruturas de Dados (Manipulação avançada de Listas e Dicionários).

• Tratamento de Exceções (try/except) para evitar quebras de código devido a entradas inválidas do usuário.

• Modularização (Separação da Lógica de Negócios da Interface de Usuário).

• Manipulação de Arquivos (Leitura e Escrita de arquivos JSON).

• Clean Code (Criação de funções auxiliares e regras de nomenclatura PEP 8).

📁 Estrutura do Projeto

O projeto é dividido em três arquivos principais para manter a organização e escalabilidade do código:

📦 cinelog
 ┣ 📜 main.py            # Ponto de entrada da aplicação (Menu e Interface)
 ┣ 📜 catalogo.py        # Lógica de negócio, validações e manipulação de dados
 ┣ 📜 meus_filmes.json   # Banco de dados local (gerado automaticamente)
 ┗ 📜 README.md          # Documentação do projeto

🚀 Como Executar o Projeto

Pré-requisitos

• Ter o Python instalado na máquina (versão 3.6 ou superior).

Passo a Passo

1. Clone este repositório ou baixe os arquivos fonte:

   git clone [https://github.com/seu-usuario/cinelog.git](https://github.com/seu-usuario/cinelog.git)
   
   

2. Abra o terminal e navegue até a pasta do projeto:

   cd cinelog
   
   

3. Execute o arquivo principal:

   python main.py
   
   

4. O menu interativo aparecerá no seu terminal. Divirta-se catalogando os seus filmes favoritos! 🍿

👨‍💻 Autor

Desenvolvido como projeto prático de encerramento do Bloco 1 de Fundamentos de Python.

Sinta-se à vontade para fazer um fork, abrir issues ou sugerir melhorias!