MeliponarioManager v0.8.0

MeliponarioManager v0.8.0 consolida o ciclo de robustez operacional, interface desktop, Agenda, relatórios e gerenciamento local de arquivos desenvolvido após v0.7.1.

A versão continua sendo uma Pre-release experimental da série 0.x. O objetivo deste ciclo foi amadurecer o produto desktop local-first sem transformar o aplicativo em serviço web, BI pesado ou sistema oficial de gestão pública.

Destaques

• integridade histórica ampliada para caixas, colônias e fatos operacionais;
• normalização consistente de timestamps operacionais;
• shell desktop mais compacto e profissional, com temas claro, escuro e seguir sistema;
• hardening de field test em foco de dialogs, contraste, grupos de ações, menus flutuantes e adaptação a diferentes resoluções desktop;
• ações administrativas auditáveis, correções, anulações e reversões preservando histórico;
• Agenda operacional com tarefas manuais e derivadas, execução contextual e reagendamento;
• centros de registro de Colônia, Caixa e Meliponário;
• lifecycle completo de transporte temporário com retorno e reabertura auditada;
• Central de Relatórios com visão operacional, produção, custos, Agenda, histórico de colônia e consolidação por meliponário;
• exportação CSV UTF-8 protegida contra formula injection em campos textuais;
• importação dedicada de listas de espécies em CSV, com prévia, duplicidades ignoradas e gravação transacional sem alterar registros existentes;
• impressão de relatórios pela WebView e pelo sistema operacional;
• anexos gerenciados por meliponário com arquivos binários mantidos fora do SQLite;
• diagnóstico de arquivos ausentes e órfãos sem limpeza automática;
• fotos de inspeção com seletor nativo, preview lazy e abertura/revelação no desktop;
• backup completo com manifest.json, inventário de mídia, tamanho e SHA-256;
• restauração com validação prévia, staging, backup de segurança e rollback local;
• exportação JSON estrutural versionada sem incorporar binários;
• persistência de estado da janela com tauri-plugin-window-state.

Interface desktop e adaptabilidade

A interface permanece desktop-first, mas deixa de depender de um piso estrutural de 900px. A faixa de 1024x768 ou superior é tratada como primeira classe, enquanto 800x600 permanece operacionalmente utilizável com composição compacta. Em telas maiores, limites de largura preservam legibilidade em vez de simplesmente esticar painéis.

Dialogs mantêm o foco durante edição, grupos de ações recebem espaçamento e quebra de linha previsíveis, e menus contextuais de registros são renderizados como superfícies flutuantes que não deslocam tabelas.

Importação de espécies

A tela de Espécies passa a aceitar importação de arquivos CSV fornecidos pelo próprio usuário. O fluxo analisa o arquivo antes de gravar, apresenta novas entradas, duplicidades e linhas inválidas, ignora duplicadas e executa a gravação em transação.

O importador não atualiza cadastros existentes, não reativa espécies arquivadas automaticamente e não valida legislação, permissões ou listas oficiais de qualquer estado. Cabe ao usuário escolher a lista adequada ao seu contexto.

Relatórios e informação gerencial

A v0.8.0 adiciona uma Central de Relatórios dedicada, separando análise operacional da área de gerenciamento de dados.

Os relatórios usam os registros existentes como fonte de verdade e aplicam as regras de estado efetivo no backend. Fatos anulados ou operações revertidas não entram silenciosamente em totais operacionais válidos.

CSV e impressão são saídas de consulta. Eles não substituem backup nem a exportação estrutural JSON.

Arquivos, fotos e dados

Anexos gerenciados passam a ser armazenados na área local da aplicação com nomes físicos internos baseados em UUID e caminhos relativos registrados no SQLite.

Fotos de inspeção continuam vinculadas ao histórico da inspeção e recebem fluxo desktop com seleção nativa, preview sob demanda e tratamento explícito quando o arquivo físico não está disponível.

O backup completo inclui o banco SQLite, a árvore media/ e um manifest versionado com inventário de assets. A validação verifica integridade do banco, schema, paths, tamanho, SHA-256 e correspondência entre o manifest e a mídia real antes de preparar a restauração.

A exportação JSON permanece estrutural e declara explicitamente que não incorpora os arquivos binários. Ela não é apresentada como mecanismo de restauração completa.

Migrations e compatibilidade

A v0.8.0 preserva as migrations históricas existentes e leva o schema acumulado até 0017_managed_attachments.sql.

As migrations 0001..0017 permanecem parte do histórico imutável do projeto. A preparação desta release não altera migrations nem cria migration adicional.

O projeto inclui teste de upgrade a partir de um schema representativo da v0.7.1 e cobertura de regressão para as migrations adicionadas durante o ciclo da v0.8.0.

Plataformas e artefatos

O pipeline de distribuição permanece preparado para gerar:

• Linux: .deb;
• Linux: AppImage;
• Windows: instalador NSIS;
• Windows: instalador MSI.

Os bundles devem ser revisados antes da publicação da GitHub Release.

Estado da versão

Esta continua sendo uma Pre-release experimental.

O MeliponarioManager permanece deliberadamente na série 0.x, sem meta de chegada à versão 1.0.0. O desenvolvimento futuro será guiado pelo uso real, testes de campo e necessidades concretas de manejo.

A implementação acumulada da v0.8.0 passou por revisão técnica, testes automatizados, CI, build desktop e uma rodada de field test que originou correções de interação e acabamento visual. A validação prática continuará durante o uso da pre-release.

Limitações conhecidas

• instaladores Windows ainda não possuem assinatura de código;
• package-lock.json e Cargo.lock ainda não estão versionados, portanto a resolução exata de dependências ainda não é totalmente reproduzível;
• o projeto permanece experimental e recursos ou formatos podem evoluir entre versões 0.x;
• o aplicativo não substitui GEFAU, GEDAVE, GTA ou outros sistemas oficiais e não certifica validade jurídica de documentos;
• a importação de espécies não valida se uma lista corresponde à regulamentação vigente da unidade federativa do usuário.

Antes de atualizar ou testar

Por ser uma versão experimental, mantenha backup dos dados importantes antes de atualizar e valide restaurações com cópias de trabalho quando os dados forem críticos.

Documentação

• README: https://github.com/marcelositr/MeliponarioManager/blob/main/README.md
• Modelo de domínio: https://github.com/marcelositr/MeliponarioManager/blob/main/docs/DOMAIN.md
• Agenda: https://github.com/marcelositr/MeliponarioManager/blob/main/docs/AGENDA.md
• Relatórios: https://github.com/marcelositr/MeliponarioManager/blob/main/docs/REPORTS.md
• Arquivos gerenciados: https://github.com/marcelositr/MeliponarioManager/blob/main/docs/FILES.md
• Gerenciamento de dados: https://github.com/marcelositr/MeliponarioManager/blob/main/docs/DATA-MANAGEMENT.md
• Distribuição: https://github.com/marcelositr/MeliponarioManager/blob/main/docs/DISTRIBUTION.md
• Política de releases: https://github.com/marcelositr/MeliponarioManager/blob/main/docs/RELEASES.md
• Changelog: https://github.com/marcelositr/MeliponarioManager/blob/main/CHANGELOG.md

Feedback

Problemas reproduzíveis podem ser registrados em GitHub Issues com versão, sistema operacional, passos para reprodução e impacto observado nos dados quando aplicável.

MeliponarioManager v0.7.1

Primeira pré-release distribuível do MeliponarioManager, consolidando o núcleo de gerenciamento, manejo e rastreabilidade do plantel em uma aplicação desktop local-first.

Esta versão substitui a tentativa de distribuição da tag v0.7.0. A aplicação já compilava corretamente, mas o pipeline de bundles revelou que AppImage e MSI exigiam ícones explicitamente declarados na configuração do Tauri. A correção foi feita em v0.7.1 sem reescrever a tag anterior.

Destaques

• gerenciamento de múltiplos meliponários, espécies, colônias e caixas;
• histórico de ocupação de caixas sem apagar movimentações anteriores;
• inspeções, alimentação, produção, manutenção e fotos de inspeção;
• eventos e timeline unificada por colônia;
• divisões, multiplicações e genealogia;
• transferências internas, externas e transportes temporários;
• documentos estruturados de movimentação e rastreabilidade;
• ciclo de vida com perda, inativação e reativação;
• alertas derivados diretamente dos dados de manejo;
• dashboard operacional do plantel;
• backup do SQLite e da mídia, exportação JSON, relatório Markdown e restauração preparada com validação de integridade;
• CI endurecido com formatação, Clippy, testes, build desktop e validação dos ícones de bundle;
• pipeline de bundles para Linux e Windows.

Correção de distribuição em v0.7.1

• bundle.icon agora declara os PNGs usados no Linux e os formatos .ico e .icns gerados pelo Tauri;
• AppImage passa a localizar um ícone quadrado válido;
• MSI/WiX passa a localizar o .ico exigido pelo instalador Windows;
• CI e pipeline de bundles executam npm run bundle:check logo após a geração dos ícones para detectar esse tipo de regressão antes do empacotamento.

Plataformas e artefatos

O pipeline desta versão está preparado para gerar:

• Linux: .deb;
• Linux: AppImage;
• Windows: instalador NSIS;
• Windows: instalador MSI.

Os arquivos devem ser revisados no draft da release antes da publicação.

Estado da versão

Esta é uma Pre-release experimental. A série 0.x do MeliponarioManager é usada como laboratório contínuo de evolução e testes e não existe meta de chegada a 1.0.0.

v0.7.0 permanece preservada como a primeira tag pública e primeira tentativa de distribuição. Ela não resultou em uma GitHub Release concluída por causa das falhas de empacotamento corrigidas nesta versão.

Dados e rastreabilidade

O aplicativo é local-first. O SQLite permanece no diretório de dados da aplicação e os arquivos de mídia são mantidos separadamente, com metadados registrados no banco.

A modelagem de movimentações considera conceitos encontrados em fluxos de GEFAU, GEDAVE e GTA no Estado de São Paulo, mas o MeliponarioManager não substitui sistemas oficiais, não emite autorizações e não certifica a validade jurídica de documentos.

Limitações conhecidas

• instaladores Windows ainda não possuem assinatura de código;
• package-lock.json e Cargo.lock ainda não estão versionados, portanto a resolução exata de dependências ainda não é totalmente reproduzível;
• o projeto ainda precisa de validação mais ampla em uso real e com bases maiores;
• recursos e formatos podem evoluir entre versões 0.x.

Antes de testar

Por ser uma versão experimental, mantenha backup dos dados importantes e valide os fluxos de restauração com cópias de trabalho antes de depender exclusivamente deles.

Documentação

• README: https://github.com/marcelositr/MeliponarioManager/blob/main/README.md
• Modelo de domínio: https://github.com/marcelositr/MeliponarioManager/blob/main/docs/DOMAIN.md
• Gerenciamento de dados: https://github.com/marcelositr/MeliponarioManager/blob/main/docs/DATA-MANAGEMENT.md
• Distribuição: https://github.com/marcelositr/MeliponarioManager/blob/main/docs/DISTRIBUTION.md
• Política de releases: https://github.com/marcelositr/MeliponarioManager/blob/main/docs/RELEASES.md
• Changelog: https://github.com/marcelositr/MeliponarioManager/blob/main/CHANGELOG.md

Feedback

Problemas reproduzíveis e propostas de melhoria podem ser registrados em GitHub Issues com versão, sistema operacional, passos para reprodução e impacto observado nos dados quando aplicável.