Skip to content

LAMP-LUCAS/fotonPDF

Repository files navigation

📄 fotonPDF

Gestão e Edição de PDFs Ultra-Rápida via Menu de Contexto.

O fotonPDF é uma ferramenta desktop multiplataforma (Windows/Linux) focada em produtividade extrema. Ele integra operações essenciais de PDF diretamente ao explorador de arquivos, eliminando a necessidade de abrir softwares pesados para tarefas simples.


🧭 Navegação Rápida (MOC - Map of Content)

Para uma experiência completa no Obsidian, utilize o arquivo central de navegação: 👉 [[docs/MAP|🗺️ Mapa da Documentação]]


📖 Guia do Usuário (End-User)

Se você deseja apenas usar o software e não é desenvolvedor, acesse:

🏛️ Pilares do Projeto

  • [[docs/ARCHITECTURE|🏗️ Arquitetura]]: Entenda a estrutura Hexagonal + Monólito Modular.
  • [[docs/BUSINESS|💰 Modelo de Sustentabilidade]]: Como o projeto se mantém financeiramente.
  • [[docs/DEVELOPMENT|🛠️ Guia de Desenvolvimento]]: Setup, padrões e workflow.
  • [[docs/ROADMAP|🚀 Roadmap e Sprints]]: Onde estamos e para onde vamos.

🤖 Para IAs e Assistentes

  • [[LLM_CONTEXT|🧠 Contexto do Projeto]]: Instruções vitais para LLMs e CodeAssistants.

✨ Funcionalidades Principais (MVP)

  • Integração Nativa: Menus organizados com prefixo fotonPDF ▸ para PDFs.
  • Operações Inteligentes: Girar, Juntar e Separar com timestamps automáticos para evitar sobrescritas.
  • Visualizador Fóton: Janela de pré-visualização ultrarrápida (PyQt6) com suporte a abertura direta via CLI.
  • Navegação Universal: ModernNavBar com transparência dinâmica, submenus colapsáveis e atalhos estilo Okular.
  • Mesa de Luz Profissional: Visualização de páginas como objetos físicos com zoom focado no mouse e renderização Hi-Res.
  • Suporte A0/A1: Tiling inteligente para grandes formatos de engenharia sem travar a memória.
  • Resiliência Industrial: Infraestrutura de "Error Boundaries" que mantém o app estável mesmo sob falhas críticas de UI.
  • Estabilidade: Distribuição otimizada em modo diretório para performance máxima.

🛠️ Stack Tecnológica

  • Linguagem: Python 3.11+
  • UI: PyQt6 / QML
  • Engine PDF: PyMuPDF (fitz) & pdfium
  • Arquitetura: Híbrida (Hexagonal + Modular)

"Simplicidade é o último grau de sofisticação." - Leonardo da Vinci

About

Ferramenta rápida e multiplataforma para gerenciar PDFs direto do menu de contexto. Junte, separe, gire e visualize PDFs com agilidade usando Python, PyQt6 e PyMuPDF.

Topics

Resources

Contributing

Stars

Watchers

Forks

Contributors