# Arquitetura e Tecnologias
Stack técnico, hierarquia de classes, dependências e conexões com bancos de dados. ## Diagrama de componentes
FullStore HTTP POST getVendas isnapp controle.php PHP 7.3 setSubmit() MySQL OSK PDV, Trocas Omni, filiais SQL Server Linx/BI LX\_ZERO\_300 W\_BI\_FAT\_VENDEDOR... CNPJ + periodo CTEs + filiais prepared statement JSON success / message / data Figura 1 - Componentes e fluxo de dados da integracao.
## Stack
CamadaTecnologiaDetalhe
LinguagemPHP **7.3**Namespaces, PDO, Traits
FrameworkCodeIgniter (`MY_Controller`)Base do backend
Banco operacionalMySQL / PDOPDV, Omni, Trocas
Banco E-commerceSQL Server / PDO `sqlsrv:`Linx `LX_ZERO_300`
RespostaJSON via `setSubmit()`Envelope padrão `success / message / data`
## Hierarquia de classes
biblioteca base do loader fullStoreService carrega classe por UUID/token utilOsk PDO MySQL OSK WOSK\\fullStoreService\\WebService valida, consulta canais e monta resposta WOSK\\Commons\\WebService trait: setSubmit(), logs db\_sqlserver PDO sqlsrv para e-commerce usa trait instancia Cadeia principal biblioteca -> fullStoreService / utilOsk -> WOSK\\fullStoreService\\WebService -> trait + db\_sqlserver
## Arquivos required Em `controle.php`, carregamos três dependências via `require_once(APPPATH . '...')`:
UUIDArquivoFornece
`4cb18a6c-...``wosk_webservice.php`Trait `WOSK\Commons\WebService` — formata JSON (`setSubmit`), valida campos e salva logs no MySQL
`592ccfa0-...``utilOsk.php`Classe pai — conecta ao MySQL OSK e expõe `$this->conexao` (PDO)
`0670acec-...``db_sqlserver.php`Gerencia conexão PDO com SQL Server (driver `sqlsrv:`)
## Conexão MySQL
Como configuramos
A classe `utilOsk` chama `getConfiguracao('db_osk_prod')` — credenciais armazenadas em Base64 na tabela de configuração do sistema. Em seguida, `_setConexao()` cria a conexão PDO: ``` // connection string: "mysql:host={host};port={porta};dbname={banco}" // PDO::ATTR_PERSISTENT = true (conexão persistente) // PDO::ATTR_TIMEOUT = 120 (timeout em segundos) // charset = UTF-8 ``` ## Conexão SQL Server
Instanciamos em buscarDadosEcommercePorLoja()
``` $sqlserver = new \db_sqlserver(false, 'LX_ZERO_300', true); // false = produção (não homologação) // 'LX_ZERO_300' = banco Linx // true = conecta imediatamente ```
AmbienteHostPortaBanco
**Produção**`````LX_ZERO_300`
Homologação`````LINX_HMLG`
**Credenciais hardcoded** As credenciais do SQL Server ficam em `db_sqlserver.php`.
## Tabelas MySQL utilizadas
TabelaAliasO que fornece
`movimentacao`mCabeçalho da transação (tipo, data, situação, módulo)
`movimentacao_detalhe`mdItens da venda (produto, qtde, preço)
`movimentacao_nfe`nf / nfeNúmero, série e situação da NF-e
`movimentacao_movimentacao`mmVínculos entre movimentações (troca↔venda, omni↔orçamento)
`pessoa`vNome e código do vendedor
`entidade`eCódigo da filial / loja
`juridica`jCNPJ da empresa
## Objetos SQL Server utilizados
ObjetoTipoO que fornece
`W_BI_FAT_VENDEDOR_VDK_OMNI_V0`View BIPedidos e-commerce por vendedor: NF, valor, CPF, filial, pedido site/WMS
`FILIAIS`TabelaCadastro de filiais — usamos para excluir franquias (`TIPO_FILIAL <> 'FRANQUIA'`)