Este glossário tem como objetivo explicar, de forma simples e prática, os termos técnicos mais utilizados no desenvolvimento e funcionamento do Qualiex. Ele ajuda novos colaboradores, clientes e equipes internas a entenderem como o sistema é estruturado, como é desenvolvido e quais tecnologias fazem parte do seu dia a dia.
Arquiteturas Utilizadas
Quando várias pessoas desenvolvem o mesmo software, é essencial seguir um padrão para que tudo funcione de forma organizada. Esse padrão é chamado de arquitetura.
No Qualiex, usamos principalmente dois modelos:
MVC – Usado nos módulos clássicos (v1)
Módulos (V1)- Planner
- Action
- Docs
- Meeting
- Staff
- Tracker
- Audit
- Indicators
- Metrology
- Riscks
- Supply
- Relatórios
- Dashboard
MVC (Model–View–Controller) é uma arquitetura clássica que separa o sistema em três partes:
-
Model (Modelo): lida com os dados
-
View (Visão): o que o usuário vê
-
Controller (Controle): liga as ações do usuário ao sistema
Essa separação permite reaproveitar código e facilita a manutenção.
Os módulos v1 do Qualiex utilizam MVC.
API REST – Usada nas versões mais novas (v3 e v4)
Módulos (v3)
- Configurações Clássicas
Módulos (v4)
- Atas e Decisões
- Documentos
- Fornecedores
- Metrologia
- Planos
- Análises
- Riscos
- Configurações
- Auditorias
- Fluxos
- Ocorrências
- Portal do Fornecedor
Nas versões mais modernas, o Qualiex utiliza APIs REST.
Uma API é um conjunto de regras que permite que sistemas diferentes conversem entre si.
Ela é criada de forma genérica para que vários times possam utilizá-la, como o time de mobile. Assim, os aplicativos conseguem consumir os dados sem precisar de APIs exclusivas.
Glossário Geral
Abaixo estarão os termos técnicos mais utilizados juntamente com uma explicação.Domínio
Endereço da web que usamos para acessar o sistema, como:
Contexto Qualiex
O domínio funciona como o “endereço” do Qualiex na internet.
O sufixo (ex: apps1, apps3) não indica tecnologia — foi apenas um padrão criado no início para organizar ambientes.
Ou seja: qualquer domínio pode apontar tanto para MVC quanto para API REST.
Host (Hospedagem)
O que é (técnico):
É o local onde nossos sistemas ficam guardados e rodando — no nosso caso, na infraestrutura da Microsoft.
Contexto Qualiex:
Pense no host como o “prédio” do Qualiex na internet.
O domínio é o endereço, e a hospedagem é onde o sistema realmente funciona.
Sem hospedagem, o domínio não leva a lugar nenhum.
Database (Banco de Dados)
O que é (técnico):
Local onde todas as informações do sistema são armazenadas.
Contexto Qualiex:
O banco contém apenas dados brutos (letras, números, registros).
Quem transforma esses dados em algo compreensível é a aplicação.
Exemplo: se o banco guarda “50”, sozinho esse dado não significa nada.
Mas no módulo Action, o sistema interpreta como 50% de progresso.
Active Directory (AD)
O que é (técnico):
Serviço da Microsoft que autentica usuários com base no protocolo LDAP.
Contexto Qualiex:
Algumas empresas utilizam o AD por políticas internas e pela conformidade com normas de segurança (como a ISO 27001).
Nesse caso, o login do Qualiex pode ser feito usando o usuário corporativo da empresa.
GitHub
O que é (técnico):
Ferramenta que permite versionar código e trabalhar em equipe sem risco de sobrescrever arquivos.
Contexto Qualiex:
O GitHub é o versionador usado pela equipe de desenvolvimento.
É onde guardamos o código, criamos versões, comparamos alterações e restauramos versões antigas quando necessário.
Termos importantes dentro do GitHub:
Master
Técnico: Principal ramificação do repositório.
Contexto:
É a versão mais atual e estável do Qualiex.
Quando iniciamos um ajuste, “clonamos” a master.
Branch
Técnico: Uma ramificação da master para trabalhar mudanças sem afetar a versão principal.
Contexto:
A branch é como um “galho” criado para resolver um bug ou desenvolver uma nova funcionalidade.
Assim, só o trecho alterado é enviado de volta para a master, sem mexer no restante do sistema.
Commit
Técnico: Salvamento de uma mudança com identificação única (hash SHA).
Contexto:
Quando terminamos de desenvolver algo, fazemos um commit, que registra exatamente o que mudou e quem mudou.
Depois disso, a branch está pronta para ser unificada com a master — após testes, é claro.
Deploy
O que é (técnico):
Processo de colocar uma nova versão de software em produção.
Contexto Qualiex:
Depois que as alterações passam por testes e homologação, o deploy é a etapa final.
É o momento em que aquele ajuste ou nova funcionalidade realmente entra no ar para todos os usuários.
MVP (Minimum Viable Product)
O que é (técnico):
Versão mais simples possível de um produto que ainda entrega valor.
Contexto Qualiex:
É quando desenvolvemos a versão mais enxuta de uma funcionalidade com o menor custo e esforço possível, para validar a ideia e aprender rapidamente antes de evoluir o produto.