🗄️ MarcoDB Enterprise

Documentação Oficial do Banco de Dados | Versão 1.1
Copyright © 2026 SoteroApps / Qorigin

O MarcoDB Enterprise é o motor de banco de dados nativo do ecossistema Qorigin. Projetado para máxima performance e segurança, ele utiliza uma estrutura de dados B+ Tree, oferecendo acesso ultrarrápido a dados estruturados e BLOBs (Binary Large Objects) através de uma arquitetura Cliente-Servidor via protocolo TCP puro.

⚙️ 1. Arquitetura Core e Resiliência

Ao contrário de bancos de dados simples em arquivo, o MarcoDB foi construído com as mesmas engenharias de sistemas corporativos como PostgreSQL e MySQL.

Recursos de Nível Industrial

Write-Ahead Logging (WAL): Tolerância absoluta a falhas. Antes de qualquer byte ser alterado na memória, a intenção é salva fisicamente em disco. Em caso de queda de energia (Hard Crash), o servidor recupera o estado perfeitamente na reinicialização.
Overflow Pages (Big Data): Quebra o limite físico de páginas de 4KB da B-Tree. Textos ou JSONs gigantes são fatiados automaticamente em listas encadeadas de memória (Vagões de Dados), permitindo o armazenamento de arquivos pesados.
Message Framing (TCP): Utiliza o marcador <|EOM|> para proteger a rede contra fragmentação de pacotes, garantindo que arquivos importados nunca sejam corrompidos no tráfego.
Autenticação SHA-256: Handshake de segurança obrigatório. Senhas nunca trafegam ou são validadas em texto puro.

💬 2. Linguagem MQL (Marco Query Language)

A comunicação com o servidor é feita de forma simples e direta, ideal para microsserviços e integrações rápidas.

Comando MQL	Sintaxe Esperada	Descrição da Ação
`auth`	`auth <usuario> <senha>`	Autentica o socket TCP atual. Necessário antes de qualquer outra operação.
`set`	`set <chave> <valor>`	Insere um novo registro no banco. Retorna erro se a chave já existir.
`get`	`get <chave>`	Recupera o valor (texto ou JSON) armazenado.
`update`	`update <chave> <novo_valor>`	Substitui o valor de uma chave existente usando mecanismo seguro de reescrita.
`del`	`del <chave>`	Remove permanentemente a chave e libera as páginas de disco.
`import`	`import <chave> <arquivo.txt>`	(Apenas Driver Python/CLI) Lê um arquivo massivo do disco local e faz o upload direto para o servidor usando Overflow.

🔌 3. Drivers e Integração

O MarcoDB foi projetado para rodar em qualquer hospedagem (incluindo VPS e planos compartilhados da Hostinger) através da porta 7300.

Python (SDK Oficial)

Ideal para integrar com o Lucida-flow Studio ou backends robustos.

from marcodb_client import MarcoDBClient

# Inicializa o driver já com autenticação
db = MarcoDBClient(host='127.0.0.1', port=7300, user='root', password='sua_senha_aqui')

if db.connect():
    db.execute("set projeto Qorigin")
    resposta = db.execute("get projeto")
    print("Dado retornado:", resposta)
    db.close()

🌐 4. Exemplo Mestre (Integração Web / PHP)

Para desenvolvedores web, fornecemos a classe MarcoDB.php, que utiliza fsockopen para contornar bloqueios de hospedagens e conectar seu site diretamente ao banco de dados.

<?php
require_once 'MarcoDB.php';

try {
    // 1. Conecta ao Servidor da QOrigin
    $db = new MarcoDB('198.51.100.45', 7300, 'root', 'senha_forte_123');
    $db->connect();
    
    // 2. Simulando salvamento de um JSON gigantesco
    $config_site = json_encode([
        "tema" => "escuro",
        "manutencao" => false,
        "usuarios_ativos" => 1542
    ]);
    
    // O MarcoDB cria as Páginas de Overflow automaticamente
    $db->query("update configuracoes_gerais " . $config_site);
    
    // 3. Resgatando para o Front-end
    $dados = $db->query("get configuracoes_gerais");
    echo "Configuração Atual: " . $dados;

    $db->close();

} catch (Exception $e) {
    echo "Erro Crítico de Banco de Dados: " . $e->getMessage();
}
?>

MarcoDB Enterprise - O coração da infraestrutura QOrigin.

🗄️ MarcoDB Docs