Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Índice


O que é o Review da Solução?

...

O Review da Solução é um processo de avaliação criado para as soluções e aplicativos que você desenvolve usando a plataforma TOTVS Fluig. Em resumo, é seu selo de garantia: Ele existe paraassegurar a segurança, a qualidade e a conformidade de sua solução com os padrões técnicos e de uso da plataforma TOTVS Fluig.


Por que o Review da Solução é importante para o parceiro?

...

Passar pelo Review da Solução é uma forma de gerar valor e confiança para você e para o cliente.

...

  • Reputação da marca: A qualidade da sua solução reflete na reputação da TOTVS, fortalecendo a confiança na marca líder de mercado.


O que define uma solução completa?

...

As Soluções soluções que passam pelo processo do Review da Solução são mais do que um software simples. Elas devem oferecer uma experiência completa ao cliente, com três elementos essenciais:

  • Recursos prontos para uso: software A solução deve estar funcional e pronto para ser utilizado imediatamente pelo cliente.

...

  • Canal de suporte: Deve haver um canal de atendimento dedicado para garantir o suporte adequado aos usuários.


A qual parceiro o Review da Solução se aplica?

...

O processo de avaliação do Review da Solução é para as soluções desenvolvidas que estão associadas à plataforma TOTVS Fluig. O processo de avaliação será ajustado de acordo com a natureza da sua solução. O Review da Solução contempla as seguintes categorias:

Categoria da soluçãoDescriçãoObservações
Solução Aplicativo

Aplicações robustas que rodam dentro do TOTVS Fluig, utilizando recursos nativos da plataforma (widgets, datasets, processos, layouts, formulários, APIs etc.). São instaladas no ambiente do cliente TOTVS Fluig.

  • Aplicativo que usa os componentes nativos do TOTVS Fluig.
  • Cliente precisa ter um ambiente TOTVS Fluig.
    • Ex.: Aplicativo de gestão com widget + processo + formulários + relatório.
Solução Flows Soluções compostas por processos e formulários prontos, focadas em implantação rápida. Não são aplicativos completos, mas processos prontos para serem instalados e usados com configurações mínimas.
  • Cliente precisa ter TOTVS Fluig para instalar o Flows.
    • Ex.: Fluxo de aprovação de férias pronto, Processos para RH, Financeiro, TI etc.
Solução Runner 

É uma solução aplicativo, porém entregue em uma arquitetura SaaS hospedada na nuvem, comercializada como serviço. O cliente não precisa ter um ambiente TOTVS Fluig, pois o aplicativo utiliza o TOTVS Fluig apenas como motor (engine) nos bastidores.

  • Um aplicativo construído com tecnologia TOTVS Fluig, mas oferecido como SaaS.
    • Ex.: Cliente acessa via web, sem instalar TOTVS Fluig.

...

Time de Ecossistemas: Review da Solução

...

Image Removed Leonardo David Galleas Levandoski

...

O time de Ecossistemas é o responsável por realizar o pelo Review da Solução do parceiro. Para sua referência, esta é a composição do time e os papéis que eles desempenham na avaliação. Esse Durante a avaliação, esse time garantirá que sua solução atenda aos a todos os critérios estabelecidos de Segurança e Qualidade.

...

Image Removed Anderson Henrique da Costa Simões 

...

Image Removed Paula Ferreira Lopes

...

Qualidade

...

.

...

Image Removed Luís Felipe de Andrade Rossi

...

...

Image Removed William Cano Bizon

...


Time de Ecossistemas: quem contatar para ajudar

...

O time de Ecossistemas está aqui para apoiar você durante o Review da Solução.


Suporte ao

...

Processo de Review da Solução

...

Para questões específicas sobre o Review de Solução, oferecemos suporte nos seguintes pilares:

  • Orientação de Processo: O

O  seu ponto de contato para a parte de qualidade do processo:

  • Qualidade Leonardo David Galleas LevandoskiGuia no processo: orientação sobre o processo de Review da Solução e o

    que esperar em cada fase do Review da Solução.

  • Caminho da

    entrega: garante que você saiba

    Entrega: Suporte sobre onde e como submeter sua solução no Portal.

  • Documentação: Disponibilização de materiais técnicos e manuais de apoio

    portal de parceiros

    .

  • Materiais

    Dúvidas de

    apoio: é responsável por criar as documentações técnicas que ajudam no seu desenvolvimento.

Suporte técnico e código

O  seu ponto de contato para a parte de desenvolvimento que vai ajudar você a construir a solução corretamente:

...

  • Código: Esclarecimento de requisitos e suporte técnico durante o desenvolvimento.

  • Validação Técnica: Avaliação final para garantir que a solução atenda a todos os requisitos fundamentais do ecossistema.


Canais de atendimento

...

Para interagir com nosso time, utilize os canais abaixo:

  • Portal do Parceiro: A comunicação principal ocorre diretamente pelo Portal de parceiros a ferramenta de submissão.

  • Chat Exclusivo: Utilize o grupo de chat criado pela TOTVS no Google Chat para interações rápidas.

  • E-mail de Apoio: [email protected].

Dica
titleDica!

Ao enviar um e-mail, sempre coloque no assunto o nome da sua empresa e o motivo (ex: "Dúvida Técnica - [Nome da sua Empresa] - [Nome da sua Solução]" ou "Solicitação de Acesso - [Nome da sua Empresa]") para agilizar o atendimento

...

.


Entendendo os requisitos e o processo de avaliação

...

A seguir, veja os detalhes sobre o processo de avaliação da sua solução.


Por que existem os requisitos?

...

Os requisitos do Review da Solução são as regras que garantem a Qualidade e a Segurança da sua Solução. Eles precisam ser incorporados desde o início do seu desenvolvimento.

É essencial que você observe a classificação de cada requisito para priorizar o que é obrigatório. Seguir essas regras e respeitar o prazo garantirá que sua solução seja aprovada mais rapidamente.


Tipos de requisitos: o que o Review da Solução avalia

...

Os requisitos do Review da Solução são divididos em categorias para cobrir todos os aspectos da sua solução. O processo verifica desde a experiência do usuário até a segurança.

...

Informações
titleNota:

Para consultar a descrição completa de cada requisito, clique aqui.

CategoriaO que o Review da Solução avalia
Documentação de usoGarante que a documentação (recursos, regras, instalação, pré-requisitos, etc.) seja completa, acessível e atualizada para o usuário final e administrador.
DesenvolvimentoVerifica se o código segue as boas práticas do TOTVS Fluig e evita variações técnicas, consultas diretas ao banco, bibliotecas desatualizadas, códigos duplicados e configurações fixas.
SegurançaAssegura que a solução não exponha vulnerabilidades e que as informações sejam protegidas. Exige o uso de conexões seguras (SSL/TLS) em serviços externos.
DistribuiçãoConfirma se a solução segue as diretrizes para ser empacotado e publicado.
PrivacidadeGarante que a solução tenha Termos de uso e Política de privacidade adequados à legislação, com transparência sobre a coleta e tratamento de dados.
TécnicoGarante que o parceiro envie o código-fonte completo e o artefato compilado devidamente.
InstalaçãoVerifica se a instalação é isenta de erros. O instalador deve executar todos os procedimentos (deploy, criação de registros, etc.) e validar permissões/pré-requisitos automaticamente.
OnboardingAssegura que a solução proporcione um Onboarding rápido e simples, sem exigir configurações manuais ou processos adicionais após a instalação.
UsoGarante que a solução funcione sem travamentos ou erros, oferecendo boa usabilidade, interface responsiva, mensagens claras e conteúdo sem erros gramaticais.
ProcessosGarante que a solução Flows esteja configurado corretamente, sem inconsistências.
ConfiguraçãoGarante que a solução permita ao administrador controlar o acesso e a disponibilidade do app no ambiente.
QAGarante que o parceiro forneça uma licença válida para testes, caso a solução possua licenciamento adicional, para validação completa.


Classificação dos requisitos (obrigatório x recomendado)

...

Nem todos os requisitos têm o mesmo peso! É crucial que você, parceiro, entenda a diferença para garantir a aprovação:

...

Informações
titleNota:

Todos os requisitos são mapeados por um código (ex: QA-101, QA-203) e estão definidos na planilha oficial do processo.



Boas práticas antes do envio para o Review da Solução

...

Antes de enviar sua solução para o Review da Solução, é essencial validar se ela está totalmente alinhada aos requisitos. Certifique-se de que todos os critérios obrigatórios foram atendidos e que a solução está tecnicamente adequada. Além de cumprir todos os requisitos do Review, recomenda-se seguir também as boas práticas descritas abaixo, garantindo maior qualidade, organização e assertividade no processo de aprovação.


Adequação Técnica e Clean Code

...

  • Organização e estrutura
    • Respeite o padrão: Mantenha a estrutura do TOTVS Fluig padrão com pastas pré-definidas (css, js, images) para Widgets, Layouts e outros componentes.

    • Limpeza: Antes de submeter para o Review da Solução, remova qualquer arquivo que não esteja sendo utilizado no componente (arquivos de teste, backups, etc.).

...

  • Gerenciamento de dependências
    • Registro: Todas as bibliotecas JavaScript externas devem ser referenciadas no arquivo application.info.

    • Evite redundância: O TOTVS Fluig já carrega nativamente bibliotecas como jQuery, jQuery UI e o Fluig Style Guide. Não as adicione novamente ao seu projeto para evitar conflitos e peso desnecessário.

...

  • Diretrizes técnicas
    • Internacionalização (i18n): Todos os textos visíveis (títulos, labels, avisos) devem utilizar chaves de tradução, e não texto fixo no código.

    • Licenciamento: Implemente a verificação de licença utilizando a API de Licença oficial.


Componente adaptado para a Store

...

Para a Store no TOTVS Fluig, padronizamos a estrutura que o componente deve ser desenvolvido, cujo objetivo também é acelerar o processo de de review Review da soluçãoSolução, O componente deve seguir os padrões demonstrados noexemplo Sample Component (sample component), atendendo aos requisitos abaixo: 

Aviso
titleAviso importante

Este exemplo sample-component é destinado a Solução Aplicativo. Como os requisitos de desenvolvimento podem variar, oferecemos apoio para ajustar os critérios às necessidades específicas da sua solução.


  • Estrutura e empacotamento
    • Artefato Final: O arquivo a ser submetido deve, obrigatoriamente, ter a extensão .ear.

    • Geração do Pacote: Utilize o pacote pack (disponível na estrutura do projeto) para compilar e gerar o arquivo .ear corretamente.


  • Identificação da solução (component.xml)
    • Arquivo mandatório: A presença do arquivo component.xml é essencial para o reconhecimento do componente.

    • Código único (component code): Este campo define a identidade da sua solução. Ele deve ser exclusivo em toda a Store(global). Certifique-se de que o código escolhido não entra em conflito com nenhuma outra solução já existente.

...

  • Apresentação e experiência 
    • Página dedicada: Utilize o arquivo pages.xml para configurar uma página exclusiva para sua solução dentro do TOTVS Fluig.

    • Identidade visual: Inclua um ícone personalizado. Isso profissionaliza a entrega e facilita a identificação do app pelo usuário final.


Boas práticas gerais

...

Para garantir o sucesso e a agilidade na aprovação da sua solução, recomendamos a adoção das seguintes práticas de qualidade e gestão.

...

  • Processos e colaboração
    • Feedback contínuo (Metodologia Ágil): Caso utilize Sprints, agende demonstrações com o time de Ecossistemas ao final de cada ciclo. Apresentar a evolução, mesmo que parcial, permite receber sugestões antecipadas e evitar retrabalho.

    • Revisão de código (Code Review): Se utilizar controle de versão (como Git), adote o fluxo de Pull Requests. Permitir que outro desenvolvedor avalie o código antes da integração reduz drasticamente a incidência de bugs e erros lógicos.

Processo de avaliação 

...

Após finalizar sua solução e seguir as boas práticas citadas acima, ela passará pelas etapas descritas a seguir, que compõem o processo oficial de avaliação - Review da Solução. Cada etapa foi estruturada para garantir qualidade, segurança e conformidade com os padrões da plataforma TOTVS Fluig.

...

EtapaDescrição das etapasObjetivo
1. Envio da Solução

Parceiro: Realiza o envio da solução completa, incluindo todos os artefatos necessários e a documentação técnica obrigatória. Conforme orientações em Enviando sua solução para Review.

Iniciar oficialmente o processo de avaliação do Review da Solução.
2. Validação técnica

Time Ecossistemas: Realiza os testes do Review da Solução, executando uma validação técnica completa, composta por verificações automáticas e manuais, focadas nos requisitos e na segurança e qualidade.

Durante esse processo, é possível acompanhar o status e o progresso da validação.

Garantir que a solução atenda plenamente aos requisitos técnicos e de segurança antes de ser aprovada.
3. Registro do relatório

Time Ecossistemas: Elabora e envia o relatório

Elaborar o relatório de avaliação, detalhando todos os itens identificados durante os testes da solução.
4. Feedback ao Parceiroparceiro

Parceiro: Recebe o relatório no Portal do Parceiro, contendo o resultado final da avaliação e todas as recomendações necessárias.

Saber o resultado final (se a sua solução foi aprovada ou não) e receber o feedback necessário para correção, se for o caso.

...