Kernel — (Linhagem SPARK)

Uma biblioteca digital moderna e eficiente para gerenciamento e leitura de livros técnicos, projetada para profissionais e entusiastas de tecnologia que buscam organização e acesso rápido ao conhecimento.

Descrição

O Kernel é uma solução de biblioteca digital que automatiza o gerenciamento de livros através da GitHub API, eliminando a necessidade de manutenção manual de bancos de dados. O sistema detecta automaticamente arquivos PDF na pasta designada, extrai metadados inteligentes dos nomes dos arquivos e apresenta uma interface moderna com recursos de busca, filtragem por gênero e visualização detalhada.

Problema que resolve: Gerenciar manualmente grandes coleções de livros digitais é trabalhoso e propenso a erros. O Kernel automatiza esse processo, permitindo que você simplesmente adicione arquivos à pasta e o sistema faça o resto.

Stack

Frontend

• HTML5 - Estrutura semântica
• CSS3 - Estilização moderna com gradientes e design responsivo
• JavaScript (ES6+) - Lógica de aplicação e integração com APIs

Backend

• GitHub API - Listagem automática de arquivos e metadados, contagem de estrelas
• GitHub Pages - Hospedagem estática gratuita

Bibliotecas e Ferramentas

• Fetch API - Requisições HTTP assíncronas
• DOM Manipulation - Interface dinâmica
• CSS Grid & Flexbox - Layout responsivo
• Vanilla JS - Sem dependências externas

Funcionalidades

• ✅ Detecção Automática - Lista automaticamente todos os PDFs da pasta via GitHub API
• ✅ Extração de Metadados - Interpreta nomes de arquivos no formato "Título - Autor - Ano"
• ✅ Classificação Inteligente - Detecta gêneros baseado em palavras-chave (Programação, IA, Segurança, etc.)
• ✅ Busca em Tempo Real - Filtra por título ou autor instantaneamente
• ✅ Filtro por Gênero - Organização por categorias técnicas
• ✅ Interface Responsiva - Design adaptável para desktop e mobile
• ✅ Modal de Detalhes - Visualização completa com link de download direto
• ✅ Zero Manutenção - Adicione arquivos e dê push, o site atualiza sozinho
• ✅ Metadados Híbridos - Combina detecção automática com JSON manual para personalização
• ✅ Contador de Estrelas - Exibe número de estrelas do GitHub em tempo real no header

Como Rodar

Pré-requisitos

• Navegador moderno (Chrome, Firefox, Safari, Edge)
• Conta no GitHub (para uso da API)
• Git instalado (opcional, para deployment)

Instalação Local

1. Clone o repositório

   git clone https://github.com/mauriciospark/kernel.git
   cd kernel

2. Configure as credenciais do GitHub

   Edite o arquivo javascript/config.js:

   const user = 'SEU_USUARIO';
   const repo = 'SEU_REPOSITORIO';
   const path = 'livros';

3. Adicione livros à pasta

   Coloque seus arquivos PDF na pasta livros/ com nomenclatura recomendada:

   livros/Clean Code - Robert C. Martin - 2008.pdf
   livros/The Pragmatic Programmer - Andrew Hunt - 1999.pdf
   

4. Inicie o servidor local

   Use qualquer servidor HTTP estático:

   # Python 3
   python -m http.server 8000
   
   # Node.js (com http-server)
   npx http-server

5. Acesse a aplicação

   Abra o navegador em http://localhost:8000

Deployment no GitHub Pages

1. Faça push do repositório

   git add .
   git commit -m "Initial commit"
   git push origin main

2. Ative o GitHub Pages

   • Vá em Settings > Pages
   • Selecione a branch main
   • A pasta deve ser / (root)

3. Acesse seu site

   • URL: https://SEU_USUARIO.github.io/kernel/

Estrutura de Arquivos

kernel/
├── index.html              # Página principal
├── css/
│   └── style.css          # Estilos da aplicação
├── javascript/
│   ├── script.js          # Lógica principal
│   └── config.js          # Configurações do GitHub
├── json/
│   └── books.json         # Metadados opcionais
├── livros/                # Pasta de livros (PDFs)
├── docs/                  # Documentação do projeto
│   ├── ABOUT.md
│   ├── ARCHITECTURE.md
│   ├── CONTRIBUTING.md
│   └── CHANGELOG.md
├── README.md              # Este arquivo
└── LICENSE                # Licença MIT

Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

Autor

Mauricio Spark
© 2026 - Todos os direitos reservados

---

Linhagem SPARK - Privacidade, Eficiência, Autonomia e Design