Histórico da Página
| Í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 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:
...
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ção | Descrição | Observaçõ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. |
|
| 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. |
|
| 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. |
|
...
Time de Ecossistemas: Review da Solução
...
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.
...
Anderson Henrique da Costa Simões
...
Qualidade
...
Luís Felipe de Andrade Rossi
...
.
Paula Ferreira Lopes
...
Responsável por apoiar o processo de Review da Solução.
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ê saibaEntrega: 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 | ||
|---|---|---|
| ||
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 | ||
|---|---|---|
| ||
Para consultar a descrição completa de cada requisito, clique aqui. |
| Categoria | O que o Review da Solução avalia |
| Documentação de uso | Garante que a documentação (recursos, regras, instalação, pré-requisitos, etc.) seja completa, acessível e atualizada para o usuário final e administrador. |
| Desenvolvimento | Verifica 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ça | Assegura 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ção | Confirma se a solução segue as diretrizes para ser empacotado e publicado. |
| Privacidade | Garante 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écnico | Garante que o parceiro envie o código-fonte completo e o artefato compilado devidamente. |
| Instalação | Verifica 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. |
| Onboarding | Assegura que a solução proporcione um Onboarding rápido e simples, sem exigir configurações manuais ou processos adicionais após a instalação. |
| Uso | Garante que a solução funcione sem travamentos ou erros, oferecendo boa usabilidade, interface responsiva, mensagens claras e conteúdo sem erros gramaticais. |
| Processos | Garante que a solução Flows esteja configurado corretamente, sem inconsistências. |
| Configuração | Garante que a solução permita ao administrador controlar o acesso e a disponibilidade do app no ambiente. |
| QA | Garante 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 | ||
|---|---|---|
| ||
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
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 | ||
|---|---|---|
| ||
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.earcorretamente.
- 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.xmlpara 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.
...
| Etapa | Descrição das etapas | Objetivo |
| 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. |
...