Neste artigo, você encontra:
1. Visão Geral do Sistema
1.1 - Menu Principal
2. Explorador de Projetos
2.1 - Busca de Projetos
2.2 - Informações do Projeto
2.3 - Alterar Visibilidade
2.4 - Tipos de Design do Projeto
3. Designs do Projeto
3.1 - Cards de Design
3.2 - Versões do Design
3.3 - Exportar Versão
3.4 - Chave de Importação
3.5 - Validar Permissão
4. Pesquisa de Projetos
4.1 - Campos Obrigatórios
4.2 - Filtros Disponíveis
5. Configurações de Conta por Sistema
5.1 - Buscar Configurações
5.2 - Editar Configuração
5.3 - Nova Configuração
6. Visualizador de Enumeradores
7. Gestão de Usuários e Permissões
7.1 - Buscar Usuário
7.2 - Lista de Todos os Usuários
7.3 - Cadastrar Novo Usuário
7.4 - Editar Usuário
7.5 - Permissões Disponíveis
8. Transferência de Projetos
8.1 - Lista de Transferências
8.2 - Filtros da Lista
8.3 - Criar Nova Transferência
8.4 - Detalhes da Transferência
Visão Geral do Sistema
O Design Connect Backoffice é um sistema web destinado à gestão de projetos Promob. Através dele, é possível explorar projetos, visualizar designs e suas versões, gerenciar usuários e permissões, configurar contas e realizar transferências de projetos entre contas.
Ao acessar o sistema, é exibido o Menu Principal na lateral esquerda e a área de conteúdo principal à direita. Na parte inferior do menu, são exibidos o nome do usuário logado, seu cargo, e os botões Meu Perfil e Sair.
Menu Principal
Confira abaixo os itens de navegação apresentados no menu principal.
IMPORTANTE: os itens variam conforme as permissões do usuário.
Item do Menu |
Descrição |
Permissão Necessária |
| Explorador de Projetos | Busca e visualização detalhada de projetos. | Ler projetos |
| Pesquisa de Projetos | Busca avançada com múltiplos filtros. | Ler projetos |
| Configurações de Conta | Gerenciamento de configurações por conta/sistema. | Configurar chaves de API de orçamento |
| Enumeradores | Consulta de valores de referência do sistema. | Acesso geral |
| Gestão de Usuários | Cadastro, edição e exclusão de usuários. | Gerenciar permissões de usuário |
| Transferência de Projetos | Migração de projetos entre contas. | Migrar projetos entre contas |
Em dispositivos móveis, o menu lateral é substituído pelo botão (☰) no topo da tela. Toque nele para abrir ou fechar o menu deslizante.
Explorador de Projetos
O Explorador de Projetos é o módulo central do Backoffice. Ele permite buscar um projeto específico e visualizar todas as suas informações, designs e versões.
Busca de Projetos
1. Para localizar um projeto, utilize um dos dois campos disponíveis na tela de pesquisa.
ID do Projeto (GUID): informe o identificador único do projeto no formato GUID (ex: d80745ee-8970-4757-a078-30ff8c33dd76).
Chave de Importação: informe a chave gerada anteriormente para importação no Promob.
2. Após preencher um dos campos, clique no botão Buscar Projeto.
3. O sistema exibirá um indicador de carregamento enquanto processa a busca. Caso o projeto não seja encontrado, uma mensagem de erro será exibida.
IMPORTANTE: o botão de busca permanece desabilitado enquanto nenhum campo estiver preenchido.
Informações do Projeto
Quando um projeto é encontrado, o sistema exibe um painel completo com todas as suas informações.
Confira abaixo cada campo detalhado.
Campo |
Descrição |
| Nome do Projeto | Nome atribuído ao projeto pelo usuário. |
| ID | Identificador GUID do projeto (clique para copiar). |
| Conta | Gerenciamento de configurações por conta/sistema. |
| Biblioteca | Consulta de valores de referência do sistema. |
| Maker | Cadastro, edição e exclusão de usuários. |
| Cliente | Nome do cliente vinculado ao projeto. |
| Status | Situação atual do projeto (clique no badge para ver todas). |
| Estágio | Estágio do fluxo de trabalho (clique no badge para ver todos). |
| Visibilidade | Público ou Privado (com opção de alterar). |
| Fila Web Worker | Indica se o projeto está na fila do Web Worker (Sim/Não). |
| Responsável/Dono | Nome e ID do responsável pelo projeto. |
| Números de Série | Lista de números de série vinculados. |
| Origem do Projeto | Como o projeto foi criado (ex: Others). |
| Fechamento | Data de fechamento (quando definida). |
| Entrega | Data de entrega prevista (quando definida). |
| Tags | Etiquetas atribuídas ao projeto. |
Alterar Visibilidade
Na seção de visibilidade do projeto, existem dois botões: Público e Privado. O botão correspondente à visibilidade atual permanece desabilitado. Ao clicar no outro botão, o sistema altera a visibilidade e exibe uma mensagem de confirmação.
IMPORTANTE: alterar a visibilidade para Público torna o projeto visível para todos os usuários da conta. Certifique-se antes de realizar essa ação.
Tipos de Design do Projeto
Abaixo das informações gerais, o sistema exibe três cards coloridos representando os tipos de design disponíveis para o projeto.
Detalhes de Opção (Aba Projetos): variações e alternativas do projeto principal. Exibe as datas de criação, modificação e última interação.
Detalhes de Fabricante (Aba Loja): versão para produção e manufatura. Exibe datas e origem do design fabricante.
Detalhes de Processo de Revisão (Aba Revisão): design em fase de análise e aprovação. Exibe datas do processo de revisão.
Quando o projeto não possui um determinado tipo de design, o card exibe a mensagem Projeto não possui design do tipo X.
Designs do Projeto
Para visualizar os designs de um projeto, clique no botão Carregar Designs localizado abaixo dos cards de tipos de design. O sistema carregará todos os designs disponíveis e os exibirá em formato de cards.
Cards de Design
Confira abaixo as informações e ações apresentadas em cada card de design.
Imagem do design: exibe a imagem de preview. Caso não exista imagem, é apresentado um ícone de Carregar imagem, que pode ser clicado para carregar a visualização. Clicar na imagem a exibe em tamanho ampliado.
ID do design: identificador GUID exibido de forma truncada. Clique no ícone de cópia ao lado para copiar o ID completo para a área de transferência.
Tipo de Design: badge indicando o tipo: Option, Fabricante ou Revisão.
Assistência Técnica: badge indicando Sim ou Não.
Badge ATUAL: O design ativo no momento recebe um destaque visual com borda colorida.
Cada card possui quatro botões de ação: Ver Versões, Gerar Chave de Importação, Validar Permissão e JSON (exibe os dados brutos do design).
Versões do Design
Ao clicar em Ver Versões em um design, o sistema carrega uma tabela com todas as versões disponíveis. Cada linha da tabela exibe:
Campo |
Descrição |
| Imagem | Miniatura da imagem da versão. |
| ID | Identificador da versão (clique para copiar). |
| Última Versão | Badge verde na versão mais recente. |
| Data de Criação | Quando a versão foi criada. |
| Data de Upload | Quando a versão foi enviada ao sistema. |
| Versão Base | Botão para acessar a versão de origem (abre em nova aba). |
| Responsável | Nome e ID de quem criou a versão. |
| Número de Série | Número de série utilizado na criação. |
As colunas Data de Criação, Data de Upload, Responsável e Número de Série são ordenáveis; basta clicar no cabeçalho da coluna para alternar a ordenação.
Cada versão possui três ações: Gerar Chave, Copiar Link e Exportar.
Exportar Versão
Ao clicar em Exportar em uma versão, o sistema abre uma tela com as informações da versão e duas opções de download:
Promob Completo: baixa o arquivo .promob com todos os dados do projeto.
Promob Compacto: baixa uma versão otimizada do arquivo, com tamanho reduzido.
Durante o download, o sistema exibe o status "Exportando...". O botão Cancelar fecha a tela sem iniciar nenhum download.
Chave de Importação
A chave de importação é um código utilizado para abrir o projeto no aplicativo Promob Desktop. Para gerá-la, clique em Gerar Chave de Importação no card do design ou em Gerar Chave na tabela de versões.
O sistema exibirá o status "Gerando chave..." e, em seguida, abrirá uma janela com a chave gerada. Clique em Copiar para copiar a chave para a área de transferência. Uma mensagem de confirmação será exibida após a cópia.
IMPORTENTE: quando a chave é gerada a partir do card do design (e não de uma versão específica), ela corresponde automaticamente à última versão disponível. O sistema exibe uma mensagem informativa nesse caso.
Validar Permissão
A funcionalidade Validar Permissão verifica se um determinado conjunto de dados de usuário/conta tem permissão para abrir o design no Promob.
1. Clique em Validar Permissão no card do design. Uma tela será aberta exibindo o nome do projeto e do design.
2. No campo de dados JSON, insira as informações de permissão no formato correto. Clique em Usar Template para preencher automaticamente um exemplo de estrutura JSON.
3. Clique em Validar. O sistema processará a validação e exibirá o resultado, podendo ser um dos casos abaixo:
TEM permissão: mensagem verde de sucesso indicando que o usuário pode abrir o design.
NÃO tem permissão: mensagem amarela de alerta indicando restrição de acesso.
Caso o JSON digitado esteja inválido, o sistema exibirá uma mensagem de erro. O botão Limpar reseta o formulário para uma nova validação.
Pesquisa de Projetos
O módulo de Pesquisa de Projetos permite realizar buscas avançadas com múltiplos filtros combinados. Diferente do Explorador (que busca por ID), aqui, é possível pesquisar por diversos critérios simultaneamente.
Campos Obrigatórios
Os campos ID da Conta e ID do Sistema são obrigatórios e estão destacados em vermelho quando não preenchidos. Sem esses campos, não é possível realizar a pesquisa.
Filtros Disponíveis
Filtro |
Descrição |
| Nome do Projeto | Busca por nome do projeto (parcial ou completo. |
| Texto de Busca | Busca por nome ou tag do projeto. |
| Negociação | Filtro por tipo de negociação (dropdown). |
| ID do Projeto (GUID) | Busca por ID específico. |
| ID do Cliente | Filtra projetos de um cliente específico. |
| ID do Usuário | Filtra projetos de um usuário específico. |
| Usuários | Lista de IDs de usuários separados por vírgula. |
| Número de Série | Filtra por número de série do equipamento. |
| Tags | Filtra por etiquetas separadas por vírgula. |
| Visibilidade | Público, Privado ou Todas. |
| Status | Todos, Ativos ou Deletados. |
| Opções de Assistência | Filtra por tipo de assistência técnica. |
| Situações | Running, Lost, Suspended, Converted, AuthorizationPending. |
| Estágios | Prospection, Project, Presentation, Budget, Negotiation. |
| Data de Criação | Intervalo de datas (início e fim). |
| Data de Modificação | Intervalo de datas (início e fim). |
| Data de Exclusão | Intervalo de datas (início e fim). |
| Ordenação | Campo de ordenação dos resultados (ex: ModifiedDate). |
Após configurar os filtros desejados, clique em Pesquisar Projetos.
Para resetar todos os campos, utilize o botão Limpar Filtros.
Os resultados são exibidos em uma lista abaixo dos filtros. Ao clicar em um projeto na lista, o sistema redireciona automaticamente para o Explorador de Projetos com as informações completas daquele projeto.
Quando nenhum resultado é encontrado, o sistema exibe uma mensagem informativa.
Configurações de Conta por Sistema
Este módulo gerencia as configurações presentes no site Connect, organizadas por conta e sistema. Essas configurações controlam comportamentos específicos da integração entre o Backoffice e o site Connect.
Buscar Configurações
Para visualizar as configurações existentes, preencha o campo obrigatório ID da Conta e, opcionalmente, o ID do Sistema para filtrar por sistema específico. Clique em Buscar para carregar os resultados.
Os resultados são exibidos em uma tabela com as colunas: ID da Conta, ID do Sistema e Ações (botão de edição). Um badge exibe o total de resultados encontrados.
Editar Configuração
Ao clicar no botão de edição de uma configuração na tabela de resultados, o sistema abre uma tela com os campos abaixo.
ID da Conta: exibido em modo somente leitura.
ID do Sistema: exibido em modo somente leitura.
Configurações Habilitadas: lista de checkboxes com as opções disponíveis, como "AllowSendToWorkerFromConnect" e "SendProjectStatusToWorkerAutomatically".
Marque ou desmarque as opções desejadas e clique em Salvar para aplicar as alterações.
O botão Cancelar fecha a janela sem salvar.
Nova Configuração
1. Clique em Nova Configuração para criar uma configuração para uma nova combinação de conta e sistema.
2. Preencha os campos e selecione as configurações desejadas.
3. O botão Limpar reseta os campos de filtro da tela principal.
IMPORTANTE: esta tela representa o item Configurações presentes no site Connect. A documentação completa do site pode ser consultada através do link de ajuda disponível no topo da página.
Visualizador de Enumeradores
O módulo de Enumeradores permite consultar todos os valores de referência utilizados pelo sistema. Esses valores são organizados em categorias e servem como base para os campos de seleção e filtros em outras telas.
A tela apresenta abas para cada categoria de enumerador, com um badge indicando a quantidade de valores em cada uma. Cada valor é exibido em um card com sua descrição de uso.
Além das abas por categoria, existem duas abas especiais:
JSON Completo: exibe todos os dados em formato técnico.
Visão Geral: resumo consolidado de todas as categorias.
Cada categoria possui uma cor distinta para facilitar a identificação visual.
Gestão de Usuários e Permissões
O módulo de Gestão de Usuários permite buscar, cadastrar, editar e excluir usuários do sistema, além de gerenciar suas permissões de acesso.
Buscar Usuário
1. No topo da tela, há um campo de busca por e-mail. Digite o endereço de e-mail do usuário e clique em Buscar. O sistema oferece sugestões de e-mails similares durante a digitação. O botão X ao lado do campo limpa a busca.
2. Quando o usuário é encontrado, um card é exibido com: nome, e-mail, ID, badges de permissões (com opção de expandir clicando em +N) e botões de ação: Editar Permissões e Excluir Usuário.
3. Quando o e-mail não é encontrado no sistema, é oferecida a opção de cadastrar um novo usuário.
Lista de Todos os Usuários
Abaixo da área de busca, a tela exibe uma tabela com todos os usuários cadastrados no sistema. A tabela apresenta um contador total de usuários (ex: 5006) e as colunas: ID, Nome, Email, Permissões e Ações.
É possível filtrar a lista utilizando o campo Filtrar por nome ou ID e o botão Filtrar Permissões (que permite selecionar uma permissão específica para filtrar). Na coluna de Ações, cada linha possui botões para editar, duplicar e excluir o usuário.
Cadastrar Novo Usuário
1. Para cadastrar um novo usuário, clique no botão "+" no canto inferior direito da tela (ou na opção que aparece quando o e-mail buscado não é encontrado).
2. O sistema abrirá a tela Cadastrar Novo Usuário com os seguintes campos:
Nome Completo: campo obrigatório para o nome do usuário.
Email: campo obrigatório para o endereço de e-mail (com validação de formato).
Permissões do Usuário: lista de checkboxes com todas as permissões disponíveis. É necessário selecionar ao menos uma permissão. Os atalhos Marcar Todas e Desmarcar Todas facilitam a seleção em lote.
3. Clique em Cadastrar para criar o usuário ou Cancelar para fechar sem salvar.
Editar Usuário
1. Para editar um usuário existente, clique no botão de edição (ícone de lápis) na tabela de usuários ou em Editar Permissões no card de resultado da busca.
2. A tela Editar Usuário será aberta com os dados preenchidos:
Nome Completo: editável.
Email: editável.
ID do Usuário: exibido em campo cinza, não editável (ex: "O ID não pode ser alterado").
Permissões do Usuário: checkboxes com as permissões atuais já marcadas.
No rodapé da janela são exibidas as datas de criação e última modificação do registro. Clique em Salvar Alterações para confirmar ou Cancelar para descartar.
IMPORTANTE: não é possível excluir o próprio usuário logado. O botão Excluir Usuário ficará desabilitado nesse caso.
Permissões Disponíveis
O botão Sobre as Permissões no topo da tela abre uma janela informativa com a descrição de cada permissão do sistema:
Permissão |
O que permite |
| Alterar visibilidade de projetos | Mudar projetos entre público e privado. |
| Configurar chaves de API de orçamento | Gerenciar configurações de conta por sistema. |
| Editar projetos | Modificar informações dos projetos. |
| Exportar projetos | Baixar arquivos .promob das versões. |
| Gerenciar chaves de API | Criar e administrar chaves de API. |
| Gerenciar permissões de usuário | Cadastrar, editar e excluir usuários. |
| Ler projetos | Visualizar projetos, designs e versões. |
| Migrar projetos entre contas | Realizar transferências de projetos. |
| Visualizar chaves de API | Consultar chaves de API existentes. |
Transferência de Projetos
O módulo de Transferência de Projetos permite migrar projetos de uma conta para outra de forma monitorada, com acompanhamento de progresso em tempo real.
Lista de Transferências
A tela principal exibe uma tabela com todas as transferências realizadas ou em andamento. As colunas incluem: Conta Origem, Conta Destino, Status, Data de Criação, Total de projetos, Processados, Progresso (barra visual) e Ações (botão de visualização).
Os status são identificados por badges coloridos:
Concluído (verde): transferências finalizadas.
Em Progresso (amarelo): transferências em andamento.
Filtros da Lista
1. Clique em Filtros (ou Ocultar filtros) para expandir ou recolher o painel de filtros. Os filtros disponíveis são: Conta Origem, Conta Destino, Status (dropdown), Data Início e Data Fim.
2. Após configurar, clique em Filtrar para aplicar ou Limpar para resetar.
Criar Nova Transferência
1. Clique no botão Nova Transferência no topo da tela.
2. A tela Nova Transferência de Projetos será aberta com os seguintes campos obrigatórios:
Conta Origem: ID da conta de onde os projetos serão transferidos.
Conta Destino: ID da conta para onde os projetos serão enviados.
Projetos criados a partir de: data inicial do filtro de período.
Projetos criados até: data final do filtro de período.
Filtro de Período: defina um período para transferir apenas projetos criados dentro dessas datas. Isso permite segmentar a transferência sem mover todos os projetos da conta.
3. Clique em Criar Transferência para iniciar o processo ou Cancelar para desistir.
Detalhes da Transferência
Ao clicar em uma transferência na lista (ou no botão de visualização), o sistema exibe a tela de detalhes completos:
Informações gerais: Conta Origem, Conta Destino, Data de Criação, Última Atualização, Duração e ID do Job (com opção de copiar).
Progresso da Transferência: uma barra de progresso visual com percentual, acompanhada da contagem de projetos processados (ex: "3 de 3 projetos processados").
Resumo em cards: quatro cards exibindo: Total de Projetos, Sucesso, Erros e Pendentes.
Abas de detalhes: a aba Erros lista os projetos que falharam durante a transferência, com a respectiva mensagem de erro. A aba Mapeamentos de Clientes exibe como os clientes foram mapeados entre as contas.
Quando a transferência está em progresso, a tela atualiza automaticamente. O status Atualizando automaticamente confirma que os dados estão sendo recarregados. O botão Atualizar (ícone de refresh) permite forçar uma atualização manual. O botão Voltar retorna à lista de transferências.
Perfil do Usuário
Clique em Meu Perfil no menu lateral para abrir a janela com as informações da sua conta. Os dados exibidos são:
Campo |
Descrição |
| Avatar/Ícone | Ícone representativo do usuário. |
| Nome | Nome completo do usuário logado. |
| Endereço de e-mail. | |
| ID | Identificador único do usuário. |
| Cargo | Cargo ou função (ex: Administrador). |
| Forma de Login | Provedor utilizado para autenticação (Cyncly ou Promob). |
| Departamento | Departamento ao qual o usuário pertence. |
Clique no botão de fechar para retornar à tela anterior.
Glossário
Termo |
Descrição |
| Design | Representa uma variação do projeto (opção, fabricante ou revisão). |
| Versão | Um registro ("foto") do design em um determinado momento. |
| Versão Base | A versão de onde outra versão foi criada (origem). |
| Chave de Importação | Código utilizado para abrir o projeto no aplicativo Promob Desktop. |
| Badge | Etiqueta colorida que exibe uma informação de forma visual. |
| Maker | Configuração de fabricante vinculada ao projeto. |
| Visibilidade | Define se o projeto é público (todos veem) ou privado. |
| GUID | Identificador único global no formato hexadecimal (ex: d80745ee-8970-...). |
| Web Worker | Processo em segundo plano que executa tarefas no servidor.. |
| Enumerador | Conjunto de valores pré-definidos usados como referência pelo sistema. |