Skip to content

Repository files navigation

📖 Comic Creator v2.0.0

Comic Creator é uma solução completa para download, organização e leitura de mangás e quadrinhos. Agora com autenticação JWT multi-usuário, permitindo bibliotecas e progressos de leitura individuais.

🚀 Guia Rápido de Instalação

Pré-requisitos

  • Python 3.10+
  • Node.js 18+ e npm

1. Preparar o Backend

Na raiz do projeto:

# Criar e ativar ambiente virtual
python3 -m venv .venv
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate   # Windows

# Instalar dependências
pip install -r requirements.txt

# Configurar variáveis de ambiente
echo "JWT_SECRET_KEY=$(openssl rand -hex 32)" > .env

# Iniciar o servidor (Porta 5000)
python main.py

2. Preparar o Frontend

Em um novo terminal, entre na pasta frontend:

cd frontend

# Instalar dependências
npm install

# Configurar variáveis de ambiente
cp .env.example .env
# O arquivo .env já vem configurado para desenvolvimento local.
# Edite apenas se seu backend rodar em uma porta diferente da 5000.

# Iniciar em modo desenvolvimento
npm run dev

O frontend ficará disponível em http://localhost:5173.


🛠️ Como usar

  1. Downloads: Cole a URL base do capítulo de um mangá compatível. Você pode baixar um capítulo único ou um intervalo (ex: cap 1 ao 50).
  2. Biblioteca: Veja todos os seus mangás baixados. Cada um tem sua capa e lista de capítulos.
  3. Leitor: Clique em um capítulo para abrir o leitor integrado.
  4. Gerenciamento: Você pode trocar a capa de qualquer mangá fazendo o upload de uma imagem local e excluir títulos indesejados.

📂 Organização de Arquivos

  • Caminho padrão: Os mangás são salvos em ~/Comics (na sua pasta de usuário).
  • Estrutura: Cada mangá tem sua própria pasta contendo os capítulos em formato PDF.
  • Configurações: Para mudar o local de salvamento ou outras opções, veja config/settings.py.

🧪 Testes

Para garantir a estabilidade do sistema, você pode rodar a suíte de testes:

# Backend
pytest

# Ou use os scripts automatizados
./run_tests.sh

Desenvolvido seguindo os padrões de Clean Architecture e as boas práticas

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages