Arquivos do Sistema

1. Estrutura Geral

O sistema do Pregão CCMBR está organizado em microsistemas (moedas, cédulas) e segue um padrão modular. A pasta raiz principal é pregao/.

Exemplo de estrutura de pastas:

---

2. Observações sobre os Arquivos

2.1 Configurações

• config/databaseNexa.php

  • Contém conexão PDO com o banco de dados.

  • Importante: Não alterar para evitar conflitos com todo o sistema.

2.2 Assets (CSS / JS)

• assets/css/estilo.css → Estilos globais do sistema.

• assets/css/moedas.css → Estilos específicos do pregão de moedas.

• assets/js/scripts.js → Scripts globais, usados em todo o sistema.

• assets/js/moedas.js → Scripts específicos para moedas, incluindo animação dos cards, atualização de fila e interações.

2.3 Includes

• header.php, menu.php, footer.php → Componentes de layout reutilizáveis.

• funcoes.php → Funções PHP gerais, como formatação de valores, validações, helpers de data/hora.

• card_moeda.php, card_lances.php, card_chat.php, card_info.php → Estrutura modular de cada componente do pregão.

• login_form.php → Formulário de login e validação de usuário.

2.4 Arquivos Principais

• index.php (moedas) → Página inicial do pregão, renderiza cards, fila de moedas, chat e controles de lance.

• lance_antecipado.php → Página de envio de lances antes da peça entrar no pregão.

• catalogo.php → Catálogo de peças, mostrando a fila do pregão e permitindo acesso à ficha técnica.

---

3. Sugestões de Melhorias

1. Separação por microsistemas mais claros:

   • Criar pasta leilao/ para funções comuns a moedas e cédulas (ex.: funcoes_leilao.php).

2. Organização de CSS e JS:

   • Mover arquivos JS e CSS específicos para cada microsistema em subpastas (moedas/, cedulas/).

3. Padronização de includes:

   • Criar um includes/common/ para arquivos compartilhados, evitando duplicação.

4. Documentação inline:

   • Inserir comentários nos arquivos card_*.php e scripts JS, explicando cada função ou bloco crítico.

5. Controle de versão:

   • Considerar um arquivo README.md em cada pasta, descrevendo sua função e dependências.

Fonte:

Autor do blog: Nilton Romani