❓ Frequently Asked Questions

Find answers to the most common questions about Bloquinho. If you don't find what you're looking for, contact us!

📋 General

Is Bloquinho really free?

Yes! Bloquinho is 100% open source and free for everyone, forever. There are no paid plans, subscriptions or limitations.

✅ 100% Free ✅ Open Source ✅ No Limitations

What platforms are supported?

Bloquinho works on all major platforms:

  • Desktop: Windows, macOS, Linux
  • Web: Modern browsers (Chrome, Firefox, Safari, Edge)
  • Mobile: Android and iOS (in development)

How can I contribute to the project?

There are several ways to contribute:

  • Development: Contribute code on GitHub
  • Documentation: Help improve the Wiki
  • Testing: Report bugs and suggestions
  • Translation: Help with translations
  • Donation: Financial support for the project

🔒 Security and Privacy

How is my data stored?

Your data is stored locally on your device with advanced encryption:

  • Local Storage: All data stays on your device
  • Encryption: Sensitive data is encrypted with AES
  • FlutterSecureStorage: Protected OAuth2 tokens
  • Hive Database: Fast and reliable local storage
  • No Telemetry: No data is sent without your permission

Is OAuth2 secure?

Yes! Bloquinho's OAuth2 system was designed with maximum security:

  • Encrypted Tokens: Stored with FlutterSecureStorage
  • Auto Renewal: Tokens are renewed automatically
  • Single Login: You log in once and stay connected
  • Robust Validation: Expired tokens are removed automatically
  • Detailed Logs: Total transparency of operations

Can I use Bloquinho offline?

Absolutely! Bloquinho works completely offline:

  • Offline Mode: All main features work without internet
  • Optional Sync: Cloud is optional, not required
  • Local Data: Everything is saved locally first
  • Manual Backup: Total control over your backups

⚙️ Features

What are the main features?

Bloquinho offers a complete set of productivity tools:

  • Notion-like Editor: Advanced editor with blocks and slash commands
  • Workspaces: Multiple contexts (personal, work, studies)
  • Profile System: Profiles with avatars and personal information
  • Backup and Sync: Robust local and cloud backup system
  • Database: Advanced tables with 17 data types
  • Agenda and Events: Complete calendar management
  • Password Manager: Secure credential storage

How does the workspace system work?

The workspace system allows you to organize your data by context:

  • Default Workspaces: Personal, Work, Studies
  • Complete Isolation: Each workspace has independent data
  • Organized Sections: Notes, Documents, Passwords, Agenda, DB
  • Customization: Colors, icons and custom names
  • Duplication: Create copies of existing workspaces

Como funciona o cache de avatares?

O sistema de cache de avatares garante performance e privacidade:

  • Download Automático: Fotos baixadas automaticamente via OAuth2
  • Armazenamento Local: Pasta dedicada no dispositivo
  • Controle Inteligente: Refresh automático após 1 dia
  • Limpeza Automática: Arquivos antigos removidos após 7 dias
  • Fallback Robusto: Iniciais quando não há foto disponível

☁️ Synchronization and Cloud

Quais serviços de nuvem são suportados?

O Bloquinho suporta os principais serviços de nuvem:

  • Google Drive: Integração completa com OAuth2
  • Microsoft OneDrive: Suporte via Microsoft Graph API
  • Estrutura Organizada: Pastas criadas automaticamente
  • Sincronização Bidirecional: Upload e download automáticos
  • Indicadores Visuais: Status de sincronização em tempo real

Como funciona a persistência de sessões?

O sistema mantém suas sessões ativas automaticamente:

  • Login Único: Você faz login uma vez e permanece conectado
  • Restauração Automática: Sessões são restauradas na inicialização
  • Validação de Tokens: Tokens expirados são removidos automaticamente
  • Debug Completo: Logs detalhados para diagnóstico
  • Segurança Máxima: Tokens armazenados com criptografia

Como funciona o sistema de backup?

O sistema de backup oferece múltiplas opções de proteção:

  • Backup Local: Arquivos JSON com todos os dados
  • Exportação Manual: Controle total sobre backups
  • Importação Segura: Restauração com validação de integridade
  • Backup Automático: Criação automática com limpeza
  • Estatísticas Detalhadas: Informações completas sobre backups

🔧 Development and Technical

Como posso expandir a Wiki?

A Wiki é facilmente expansível:

  • Arquivos HTML: Adicione novos arquivos na pasta /Site/wiki
  • Menu Automático: O menu lateral atualiza automaticamente
  • Navegação Integrada: Sistema de navegação já implementado
  • Design Consistente: Use o CSS existente para manter o visual
  • Animações: Efeito de virar página já implementado

Quais tecnologias são usadas?

O Bloquinho utiliza tecnologias modernas e confiáveis:

  • Frontend: Flutter para interface multiplataforma
  • Estado: Riverpod para gerenciamento de estado reativo
  • Armazenamento: Hive para dados locais
  • Segurança: FlutterSecureStorage para dados sensíveis
  • Navegação: GoRouter para roteamento avançado
  • OAuth2: Autenticação segura com Google e Microsoft

Como reportar bugs ou solicitar funcionalidades?

Existem várias formas de contribuir com feedback:

  • GitHub Issues: Reporte bugs e sugestões no repositório
  • Email: Entre em contato diretamente via email
  • LinkedIn: Conecte-se com o desenvolvedor
  • Documentação: Consulte os logs de desenvolvimento
  • Contribuição Direta: Envie pull requests com melhorias

📞 Support and Contact

Como posso obter suporte?

Oferecemos múltiplos canais de suporte:

  • Email: dr.karim.patatas@gmail.com
  • Telefone: +351 925 542 328
  • LinkedIn: https://www.linkedin.com/in/k-patatas/
  • GitHub: https://github.com/Sen2pi
  • Site: https://bloquinho.kpsolucoes.pt/
  • Portfolio: https://portfoliokarimsantos.vercel.app/

O projeto é mantido ativamente?

Sim! O Bloquinho é um projeto ativo com desenvolvimento contínuo:

  • Atualizações Regulares: Novas funcionalidades e correções
  • Logs Detalhados: Documentação completa de desenvolvimento
  • Testes Abrangentes: Cobertura de testes de 95%+
  • Feedback da Comunidade: Melhorias baseadas em sugestões
  • Roadmap Claro: Planejamento de funcionalidades futuras

🌟 Ainda tem dúvidas?

Se não encontrou a resposta que procurava, não hesite em entrar em contato conosco. Estamos aqui para ajudar e adoramos receber feedback da comunidade!

📚 Documentação

Consulte a Wiki para guias detalhados sobre todas as funcionalidades do Bloquinho.

🔒 Segurança

Saiba mais sobre como protegemos seus dados e garantimos sua privacidade.

🏗️ Arquitetura

Entenda a arquitetura técnica e as decisões de design do projeto.

💝 Doação

Suporte o projeto e ajude a manter o desenvolvimento ativo.