Releases: fivelibx/fivelib
v1.0.0 — Stable Release: Hub Unificado de Documentação para Desenvolvedores
Descrição:
FiveLib v1.0.0 marca a consolidação oficial da nossa plataforma, sucedendo o projeto DevAcademicX. Esta versão entrega um ecossistema robusto para a centralização de documentações, indexação de ferramentas técnicas e facilitação do onboarding de novos desenvolvedores através de um ambiente unificado e curado.
Principais Destaques:
- Arquitetura Conteinerizada: Ambiente padronizado via Docker para garantir consistência em qualquer infraestrutura (x86_64).
- Segurança em Camadas: Sistema blindado com autenticação JWT, hashing de senhas com
bcrypte validação de payloads com Pydantic/Zod. - Auditoria de Segurança: Release validada com sucesso via análise estática (
bandit,safety,trufflehog), garantindo integridade das dependências e proteção contra exposição de segredos. - Experiência de Usuário: Interface responsiva construída com Next.js 16, focada em performance e usabilidade intuitiva (RNF01).
Documentação Técnica:
Para uma visão detalhada sobre a engenharia, modelagem de dados, especificações de API e estratégias de segurança, disponibilizamos o Technical Dossier completo em anexo (arquivos PDF).
- 📄
pt-technical-dossier-v1.0.0.pdf - 📄
en-technical-dossier-v1.0.0.pdf
Agradecemos a todos os colaboradores envolvidos na arquitetura e desenvolvimento desta versão.
Acesse e explore o FiveLib:
- 🌐 Plataforma: https://fivelib.vercel.app
- 💬 Discussões: Fórum de Discussões no GitHub — Para dúvidas, sugestões e trocas de ideias.
- 🐞 Reportar Bugs: Issues do Repositório — Para erros técnicos e problemas de funcionamento.
v0.8.0 — Consolidação da Área do Usuário, Biblioteca Pessoal e Suporte Individualizado
A versão 0.8.0 introduz a consolidação da área do usuário, trazendo autonomia para o gerenciamento de perfis, expansão de recursos da biblioteca pessoal e o rastreamento individualizado de chamados de suporte. O desenvolvimento focou na segurança de dados sensíveis no frontend, privacidade no banco de dados e na manutenção e legibilidade de toda a base de código.
Gerenciamento de Perfil e Autonomia do Usuário
- Área Customizada: Implementação do Gerenciador de Perfil, permitindo ao usuário a edição de suas informações e a personalização de seu título profissional, além da inclusão de um mockup estrutural do feed para futuras atualizações da plataforma.
- Navegação Centralizada: Integração de um menu dropdown na interface principal, fornecendo atalhos rápidos e organizados para a visualização do perfil, customizações de conta, biblioteca e suporte.
- Segurança na Alteração de Dados: Fluxo estrito para alteração de e-mail e credenciais sensíveis, condicionado à validação obrigatória por meio de código de autenticação de 6 dígitos enviado diretamente à caixa de entrada do usuário.
Funcionalidades da Biblioteca e Suporte Individual
- Links Privados Ativos: Atualização da seção "Minha Biblioteca", tornando-a totalmente funcional com armazenamento, listagem e exclusão de links privados no Supabase, restando apenas o isolamento de favoritos para as próximas sprints na home e busca.
- Isolamento de Chamados (Meus Chamados): Correção da rota de suporte individual (
GET /api/v1/tickets/me), garantindo que o usuário visualize estritamente os seus próprios tickets abertos no banco de dados através do ID contido no token, eliminando vazamentos de escopo.
Correções de Interface (Frontend)
- Links Funcionais no Footer: Ajuste nos botões e redirecionamentos do rodapé do site após feedback de usabilidade, convertendo elementos estáticos em links reais e funcionais direcionados ao repositório do GitHub.
- Limpeza Visual da Interface: Remoção temporária de ícones e componentes de UI que não possuíam implementações de back-end ativas no momento, preparando o footer e o layout para novas entradas de conteúdo de forma escalável.
Manutenção e Qualidade de Código (Backend)
- Cleanup Geral de Código: Eliminação sistemática de comentários desnecessários, trechos de código mortos e depurações antigas em todos os endpoints e repositórios do backend Python, otimizando a legibilidade e facilitando futuras manutenções e auditorias da equipe de desenvolvimento.
v0.5.0 - Autenticação Robusta e Validação de Usuários
A versão 0.5.0 introduz a consolidação do sistema de gestão de usuários e autenticação. O desenvolvimento focou na segurança da infraestrutura de credenciais, padronização de rotas e na garantia de um fluxo de acesso resiliente desde a versão 0.3.0.
Segurança e Autenticação
- Criptografia de Senhas: Implementação de algoritmos de hash para o armazenamento irreversível e seguro de credenciais no banco de dados.
- Gestão de Tokens: Atualização do sistema de sessões com tokens utilizando hash, garantindo maior proteção contra interceptação e adulteração.
- Validação por E-mail: Integração do fluxo de verificação de contas, com envio e validação de e-mails em tempo real funcional.
Auditoria e Testes de Segurança
- Análise Estática no Backend: Aplicação de ferramentas como
banditpara análise de vulnerabilidades no código Python esafetypara verificação de falhas em dependências de terceiros. - Auditoria de Frontend: Execução sistemática do
npm auditpara identificar e mitigar vulnerabilidades nos pacotes JavaScript. - Validação de Infraestrutura: Análise estática dos
Dockerfilesdo frontend e backend utilizandohadolintpara garantir conformidade com as melhores práticas de containerização. - Prevenção de Vazamentos: Varredura completa do histórico de commits com
trufflehogpara assegurar que nenhum segredo, chave ou credencial foi exposto no repositório. - Isolamento de Ambiente: Padronização do ambiente virtual (
venv) no backend com fixação rigorosa das dependências para evitar conflitos com pacotes do sistema e garantir confiabilidade nos deploys.
Backend e Infraestrutura
- Refatoração de Endpoints: Ajuste estrutural nas rotas de autenticação (login e registro), garantindo respostas padronizadas e integração fluida com o frontend.
- Tratamento de Exceções: Implementação de validações mais estritas utilizando Pydantic, garantindo o bloqueio de requisições malformadas ou credenciais inválidas com retornos HTTP adequados.
Melhorias Gerais
- Robustez do Cadastro e Login: Correção de fluxos de borda e garantia de estabilidade nas requisições simultâneas.
- Limpeza da Interface: Ajustes no frontend para focar estritamente na autenticação nativa (e-mail/senha), ocultando temporariamente métodos de OAuth não finalizados.
v0.3.0 - Estrutura Básica Completa
🛠️ Frontend & Design
- Migração para Next.js: Implementação do App Router para melhor performance e SEO.
- Design System: Integração completa do shadcn/ui e Tailwind CSS v4.
- Branding: Atualização da identidade visual e ativos de marca.
⚙️ Backend & Infra
- Core API: Início do desenvolvimento com FastAPI e suporte a containers Docker.
- Persistência: Configuração do SQLAlchemy e Alembic para gestão de migrações com PostgreSQL (Supabase).
- CI/CD: Pipeline de deploy automatizado via GitHub Actions para Vercel e Render.
📄 Documentação (Documentation First)
- Refatoração completa do README principal.
- Criação dos guias de
DESIGN.md,ARCHITECTURE.mde especificações de infraestrutura. - Abertura do GitHub Discussions para suporte à comunidade.