DCT2SQLWX - Versão 28

## Sistema Avançado de Sincronização de Esquemas WINDEV

### ?? Visão Geral

O DCT2SQLWX v28 é um sistema completo e avançado para sincronização de esquemas entre análises WINDEV e bancos de dados relacionais. Esta versão representa uma evolução significativa, incorporando funcionalidades de internacionalização, monitoramento em tempo real, notificações inteligentes e automação avançada.

### ? Principais Funcionalidades

- **?? Internacionalização Completa**: Suporte para 5 idiomas (PT, EN, FR, ES, IT)
- **?? Monitoramento em Tempo Real**: Detecção automática de mudanças estruturais
- **?? Notificações Inteligentes**: E-mails HTML responsivos com informações contextuais
- **?? Relatórios JSON**: Estruturas de dados padronizadas para integração
- **?? Configurações Centralizadas**: Gerenciamento unificado de todas as configurações
- **?? Pós-Scripts Automáticos**: Reindex, rebuild e scripts customizados
- **?? Segurança Transacional**: Modo "tudo ou nada" para garantir integridade
- **??? Multi-SGBD**: Suporte para SQL Server, MySQL, PostgreSQL, Oracle e DB2

### ?? Estrutura do Projeto

```
DCT2SQLWX_v28/
+-- DCT2SQLWX_v28.wdg # Classe principal
+-- DCT2SQLWX_Translations.wdg # Sistema de tradução
+-- DCT2SQLWX_GlobalConfig.wdg # Configurações globais
+-- DCT2SQLWX_Monitoring.wdg # Sistema de monitoramento
+-- DCT2SQLWX_JSONStatus.wdg # Relatórios JSON
+-- DCT2SQLWX_PostScript.wdg # Sistema de pós-scripts
+-- DCT2SQLWX_Example.wdg # Exemplos de uso
+-- Config/
¦ +-- DCT2SQLWX_Config_Example.ini
+-- Scripts/
¦ +-- scripts_config_example.ini
+-- DCT2SQLWX_v28_Documentation.md # Documentação completa
+-- README.md # Este arquivo
```

### ??? Instalação e Configuração

#### Requisitos
- WINDEV 26 ou superior
- Windows 10 / Windows Server 2016+
- Drivers de banco de dados apropriados
- Servidor SMTP (para notificações por e-mail)

#### Configuração Inicial

1. **Copie os arquivos** para seu projeto WINDEV
2. **Configure o arquivo INI**:
```bash
cp Config/DCT2SQLWX_Config_Example.ini Config/DCT2SQLWX_Config.ini
```
3. **Edite as configurações** conforme seu ambiente
4. **Configure scripts customizados** (opcional):
```bash
cp Scripts/scripts_config_example.ini Scripts/scripts_config.ini
```

### ?? Uso Básico

```WINDEV
// Exemplo básico de uso
oDCT2SQLWX is DCT2SQLWX_v28

// Inicializa o sistema
oDCT2SQLWX = new DCT2SQLWX_v28()

// Configura idioma
oDCT2SQLWX.SetLanguage("PT")

// Executa sincronização
IF oDCT2SQLWX.SynchronizeSchema(
"C:\MeuProjeto\Analise.wdd",
"SQLSERVER",
"Server=localhost;Database=MeuDB;Trusted_Connection=true;",
False
) THEN
Info("Sincronização concluída com sucesso!")
ELSE
Error("Erro: " + oDCT2SQLWX.GetLastError())
END
```

### ?? Idiomas Suportados

| Código | Idioma | Status |
|--------|-----------|--------|
| PT | Português | ? Completo |
| EN | English | ? Completo |
| FR | Français | ? Completo |
| ES | Español | ? Completo |
| IT | Italiano | ? Completo |

### ??? Bancos de Dados Suportados - TODAS AS 14 BASES

- **Microsoft SQL Server** (2008+)
- **MySQL** (5.6+)
- **MariaDB** (10.0+)
- **PostgreSQL** (9.6+)
- **Oracle Database** (10g+)
- **IBM DB2 LUW** (9.7+) - Linux, Unix, Windows
- **SQLite** (3.x)
- **Firebird** (2.5+)
- **Sybase ASE** (15.x+)
- **IBM Informix** (11.x+)
- **Microsoft Access** (2010+)
- **HFSQL** (WINDEV)
- **Teradata** (13.x+) ? **FUNDAMENTAL para ambientes corporativos**
- **AS/400 (IBM i)** (V7R1+) ? **FUNDAMENTAL para ambientes corporativos**

### ?? Configuração de E-mail

```ini
[Email]
SmtpServer=smtp.gmail.com
SmtpPort=587
SmtpUser=seu_email@gmail.com
SmtpPassword=sua_senha
UseSSL=1
NotificationEmails=dba@empresa.com,admin@empresa.com
```

### ?? Pós-Scripts Disponíveis

- **Reindex**: Reorganização automática de índices
- **Rebuild**: Reconstrução de índices fragmentados
- **Backup**: Backup pós-sincronização
- **Scripts Customizados**: SQL, Batch, PowerShell, Python

### ?? Relatórios JSON

O sistema gera relatórios estruturados em JSON contendo:

- Status da análise WINDEV
- Status do banco de dados
- Estatísticas de operação
- Histórico de mudanças
- Informações de backup
- Métricas de performance

### ?? Segurança

- **Modo Transacional**: Rollback automático em caso de erro
- **Criptografia**: Senhas e dados sensíveis protegidos
- **Validação**: Entrada rigorosa e sanitização de dados
- **Auditoria**: Log completo de todas as operações
- **Permissões**: Verificação de privilégios necessários

### ?? Monitoramento

- **Tempo Real**: Supervisão contínua de operações
- **Detecção de Mudanças**: Identificação automática de alterações estruturais
- **Alertas**: Notificações proativas por e-mail
- **Métricas**: Coleta de dados de performance
- **Histórico**: Rastreamento completo de operações

### ??? Configurações Avançadas

```WINDEV
// Configuração avançada
oAdvancedSettings is AdvancedSettings

// E-mail
oAdvancedSettings.EmailConfig.SmtpServer = "smtp.empresa.com"
ArrayAdd(oAdvancedSettings.EmailConfig.ToEmails, "dba@empresa.com")

// Pós-scripts
oAdvancedSettings.ScriptConfig.EnableReindex = True
oAdvancedSettings.ScriptConfig.FragmentationThreshold = 25.0

// Aplica configurações
oDCT2SQLWX.ConfigureAdvancedSettings(oAdvancedSettings)
```

### ?? Documentação

- **[Documentação Completa](DCT2SQLWX_v28_Documentation.md)**: Guia detalhado com todos os métodos
- **[Exemplos de Uso](DCT2SQLWX_Example.wdg)**: Casos de uso práticos
- **[Organograma do Projeto](DCT2SQLWX_v28_Documentation.md#organograma-do-projeto-dct2sqlwx-v28)**: Arquitetura e componentes

### ?? Solução de Problemas

#### Problemas Comuns

1. **Erro de Conectividade**
- Verifique string de conexão
- Teste conectividade manual
- Confirme drivers instalados

2. **Falha de Permissões**
- Verifique privilégios DDL
- Confirme permissões de backup
- Valide acesso aos diretórios

3. **Erro de E-mail**
- Teste configurações SMTP
- Verifique credenciais
- Confirme conectividade de rede

### ?? Suporte

Para suporte técnico e dúvidas:

1. Consulte a [documentação completa](DCT2SQLWX_v28_Documentation.md)
2. Verifique os [exemplos de uso](DCT2SQLWX_Example.wdg)
3. Analise os logs detalhados do sistema
4. Utilize o modo de simulação para testes

### ?? Atualizações

### Versão 28.0 (Atual)
- ? Internacionalização completa (5 idiomas)
- ? Sistema de monitoramento avançado
- ? Notificações por e-mail inteligentes
- ? Relatórios JSON estruturados
- ? Configurações globais centralizadas
- ? Pós-scripts automáticos
- ? Segurança transacional aprimorada

### Roadmap Futuro
- ?? Suporte para bancos NoSQL
- ?? Interface gráfica moderna
- ?? Análises preditivas com ML
- ?? Integração cloud nativa
- ?? APIs REST para integração

### ?? Licença

Este projeto é baseado na versão 26 anterior com melhorias significativas desenvolvidas para atender às necessidades modernas de sincronização de esquemas em ambientes corporativos.

### ?? Contribuições

Para contribuir com melhorias:

1. Documente casos de uso específicos
2. Reporte bugs com logs detalhados
3. Sugira melhorias de funcionalidade
4. Compartilhe scripts customizados úteis

---

**DCT2SQLWX v28** - Sistema Avançado de Sincronização de Esquemas
*Desenvolvido com foco em robustez, segurança e facilidade de uso*


## ?? Segurança Transacional Completa

### ? Características Principais
- **Transações Atômicas**: Princípio "Tudo ou Nada"
- **Sistema de Savepoints**: Rollback granular para operações específicas
- **Backup Pré-Transação**: Backup automático antes de qualquer alteração
- **Logs Detalhados**: Data/hora de início, fim e tempo total em segundos
- **Validação de Integridade**: Verificação completa antes do commit

### ??? Processo de Segurança
1. **Backup Automático** antes de iniciar
2. **Transação Iniciada** com controle ACID
3. **Savepoints Criados** antes de cada operação crítica
4. **Validação Contínua** de integridade
5. **Commit Seguro** ou **Rollback Automático**
6. **Pós-Scripts** de manutenção (reindex, rebuild, backup final)

### ?? Controle Temporal
```
Início: 23/07/2025 14:30:15
Fim: 23/07/2025 14:32:47
Duração: 152 segundos
Status: SUCESSO ?
```

### ?? Melhores Práticas por SGBD
- **SQL Server**: `ALTER INDEX ALL REORGANIZE/REBUILD`
- **Oracle**: `ALTER TABLE MOVE` + `ALTER INDEX REBUILD`
- **Teradata**: `COLLECT STATISTICS` + rebuild de índices
- **MySQL**: `OPTIMIZE TABLE` + `ANALYZE TABLE`
- **PostgreSQL**: `REINDEX TABLE` + `ANALYZE`

## ?? Arquivos da Versão 28

### ?? Arquivos Principais
- `DCT2SQLWX_v28_FINAL.wdg` - Classe principal integrada
- `DCT2SQLWX_TransactionSecurity.wdg` - Sistema de segurança transacional
- `DCT2SQLWX_DatabaseSupport.wdg` - Suporte para 13 bases de dados

### ?? Internacionalização
- `DCT2SQLWX_Translations.wdg` - Sistema multilíngue completo

### ?? Configuração e Monitoramento
- `DCT2SQLWX_GlobalConfig.wdg` - Configurações centralizadas
- `DCT2SQLWX_Monitoring.wdg` - Monitoramento e notificações

### ?? Relatórios e Pós-Scripts
- `DCT2SQLWX_JSONStatus.wdg` - Relatórios estruturados
- `DCT2SQLWX_PostScript.wdg` - Manutenção automática

### ?? Documentação
- `DCT2SQLWX_v28_Documentation.md` - Documentação completa
- `DCT2SQLWX_v28_Organogram.md` - Organograma do projeto
- `README.md` - Este arquivo

### ?? Configuração
- `Config/DCT2SQLWX_Config_Example.ini` - Exemplo de configuração
- `Scripts/scripts_config_example.ini` - Configuração de scripts

## ?? Uso Rápido

```WINDEV
// Exemplo de uso simplificado
oDCT2SQLWX is DCT2SQLWX_v28_FINAL

// Sincronização segura
bResult is boolean = oDCT2SQLWX.SynchronizeAnalysisToDatabase(
"C:\MeuProjeto\Analise.wdd",
"Server=localhost;Database=MeuBanco;Trusted_Connection=true;",
"SQLSERVER"
)

IF bResult THEN
Info("Sincronização realizada com sucesso!")
// Relatórios automáticos gerados
// E-mails enviados para DBAs
// Backup criado automaticamente
ELSE
Error("Falha na sincronização - Rollback executado")
// Banco restaurado ao estado anterior
// Logs detalhados disponíveis
END
```

## ?? Vantagens da Versão 28

### ? **Segurança Máxima**
- Impossível corromper dados por falha na sincronização
- Backup automático antes de qualquer alteração
- Rollback instantâneo em caso de problema

### ? **Suporte Universal**
- 13 bases de dados incluindo Teradata
- Comandos otimizados para cada SGBD
- Melhores práticas implementadas

### ? **Monitoramento Empresarial**
- Notificações automáticas por e-mail
- Relatórios JSON para integração
- Logs detalhados para auditoria

### ? **Facilidade de Uso**
- Interface multilíngue (5 idiomas)
- Configuração centralizada
- Uso simplificado com um método

A versão 28 representa o **estado da arte** em sincronização segura de estruturas de banco de dados, garantindo máxima confiabilidade para ambientes de produção críticos.


———-

DCT2SQLWX - Version 28

Advanced WINDEV Schema Synchronization System

?? Overview

DCT2SQLWX v28 is a complete and advanced system for synchronizing schemas between WINDEV analyses and relational databases. This version marks a major evolution, incorporating internationalization, real-time monitoring, smart notifications, and advanced automation.

?

? Key Features
• ?? Full Internationalization: Support for 5 languages (PT, EN, FR, ES, IT)
• ?? Real-Time Monitoring: Automatic detection of structural changes
• ?? Smart Notifications: Responsive HTML emails with contextual information
• ?? JSON Reports: Standardized data structures for integration
• ?? Centralized Configuration: Unified configuration management
• ?? Auto Post-Scripts: Reindex, rebuild, and custom scripts
• ?? Transactional Security: All-or-nothing mode to ensure integrity
• ??? Multi-DBMS Support: Compatible with SQL Server, MySQL, PostgreSQL, Oracle, and DB2

?

?? Project Structure

DCT2SQLWX_v28/
+-- DCT2SQLWX_v28.wdg # Main class
+-- DCT2SQLWX_Translations.wdg # Translation system
+-- DCT2SQLWX_GlobalConfig.wdg # Global settings
+-- DCT2SQLWX_Monitoring.wdg # Monitoring system
+-- DCT2SQLWX_JSONStatus.wdg # JSON reporting
+-- DCT2SQLWX_PostScript.wdg # Post-scripts system
+-- DCT2SQLWX_Example.wdg # Usage examples
+-- Config/
¦ +-- DCT2SQLWX_Config_Example.ini
+-- Scripts/
¦ +-- scripts_config_example.ini
+-- DCT2SQLWX_v28_Documentation.md # Full documentation
+-- README.md # This file


?

??? Installation & Setup

Requirements
• WINDEV 26 or later
• Windows 10 / Windows Server 2016+
• Appropriate DB drivers installed
• SMTP server (for email notifications)

Initial Setup
1. Copy project files to your WINDEV environment
2. Configure the INI file:

cp Config/DCT2SQLWX_Config_Example.ini Config/DCT2SQLWX_Config.ini


3. Edit the configuration to match your environment
4. Set up optional custom scripts:

cp Scripts/scripts_config_example.ini Scripts/scripts_config.ini



?

?? Basic Usage

// Basic example
oDCT2SQLWX is DCT2SQLWX_v28

// Initialize
oDCT2SQLWX = new DCT2SQLWX_v28()

// Set language
oDCT2SQLWX.SetLanguage("EN")

// Execute synchronization
IF oDCT2SQLWX.SynchronizeSchema(
"C:\MyProject\Analysis.wdd",
"SQLSERVER",
"Server=localhost;Database=MyDB;Trusted_Connection=true;",
False
) THEN
Info("Synchronization completed successfully!")
ELSE
Error("Error: " + oDCT2SQLWX.GetLastError())
END


?

?? Supported Languages

Code Language Status
PT Portuguese ? Complete
EN English ? Complete
FR French ? Complete
ES Spanish ? Complete
IT Italian ? Complete


?

??? Supported Databases – All 14 DBMSs
• Microsoft SQL Server (2008+)
• MySQL (5.6+)
• MariaDB (10.0+)
• PostgreSQL (9.6+)
• Oracle Database (10g+)
• IBM DB2 LUW (9.7+) - Linux, Unix, Windows
• SQLite (3.x)
• Firebird (2.5+)
• Sybase ASE (15.x+)
• IBM Informix (11.x+)
• Microsoft Access (2010+)
• HFSQL (WINDEV)
• Teradata (13.x+) ? Critical for enterprise environments
• AS/400 (IBM i) (V7R1+) ? Critical for enterprise environments

?

?? Email Configuration

[Email]
SmtpServer=smtp.gmail.com
SmtpPort=587
SmtpUser=your_email@gmail.com
SmtpPassword=your_password
UseSSL=1
NotificationEmails=dba@company.com,admin@company.com


?

?? Available Post-Scripts
• Reindex: Automatic index reorganization
• Rebuild: Rebuilds fragmented indexes
• Backup: Backup after synchronization
• Custom Scripts: SQL, Batch, PowerShell, Python

?

?? JSON Reports

The system generates structured JSON reports including:
• WINDEV analysis status
• Database structure status
• Operation statistics
• Change history
• Backup information
• Performance metrics

?

?? Security
• Transactional Mode: Automatic rollback on errors
• Encryption: Secure credentials and sensitive data
• Validation: Strict input and data sanitation
• Auditing: Full operation logging
• Permissions: Privilege verification

?

?? Monitoring
• Real-Time: Continuous operation supervision
• Change Detection: Automatic structure tracking
• Alerts: Proactive email notifications
• Metrics: Performance data collection
• History: Full operation traceability

?

??? Advanced Settings

// Advanced setup
oAdvancedSettings is AdvancedSettings

// Email
oAdvancedSettings.EmailConfig.SmtpServer = "smtp.company.com"
ArrayAdd(oAdvancedSettings.EmailConfig.ToEmails, "dba@company.com")

// Post-scripts
oAdvancedSettings.ScriptConfig.EnableReindex = True
oAdvancedSettings.ScriptConfig.FragmentationThreshold = 25.0

// Apply
oDCT2SQLWX.ConfigureAdvancedSettings(oAdvancedSettings)


?

?? Documentation
• Full Documentation
• Usage Examples
• Project Diagram

?

??? Troubleshooting

Common Issues
1. Connectivity Error
• Check connection string
• Test manual DB access
• Verify driver installation
2. Permission Error
• Validate DDL privileges
• Confirm backup permissions
• Ensure directory access
3. Email Error
• Test SMTP settings
• Check credentials
• Ensure internet access

?

?? Support
1. Read the documentation
2. Review examples
3. Check system logs
4. Use simulation mode for testing

?

?? Updates

Version 28.0 (Current)
• ? Full internationalization
• ? Advanced monitoring system
• ? Smart email alerts
• ? Structured JSON reports
• ? Centralized configuration
• ? Automated post-scripts
• ? Enhanced transactional security

Future Roadmap
• ?? NoSQL database support
• ?? Modern GUI
• ?? Predictive analytics with ML
• ?? Native cloud integration
• ?? REST APIs for integration

?

?? Licensing

This project is based on version 26 with major enhancements to meet modern schema sync needs in enterprise environments.

?

?? Contributions
1. Document specific use cases
2. Report bugs with logs
3. Suggest new features
4. Share useful custom scripts

?

?? Full Transactional Security

? Key Features
• Atomic Transactions: All-or-nothing principle
• Savepoint System: Granular rollbacks
• Pre-Transaction Backups: Automatic before changes
• Detailed Logs: Start/end timestamps, duration
• Integrity Validation: Full check before commit

?

??? Security Process
1. Auto Backup before starting
2. Transaction Starts with full ACID control
3. Savepoints Created before each critical step
4. Ongoing Integrity Checks
5. Safe Commit or Automatic Rollback
6. Post-Scripts for maintenance (reindex, rebuild, backup)

?

?? Execution Timing Example

Start: 2025-07-23 14:30:15
End: 2025-07-23 14:32:47
Duration: 152 seconds
Status: SUCCESS ?


?

?? Best Practices by DBMS
• SQL Server: ALTER INDEX ALL REORGANIZE/REBUILD
• Oracle: ALTER TABLE MOVE + ALTER INDEX REBUILD
• Teradata: COLLECT STATISTICS + index rebuild
• MySQL: OPTIMIZE TABLE + ANALYZE TABLE
• PostgreSQL: REINDEX TABLE + ANALYZE

?

?? Version 28 File List

?? Core Files
• DCT2SQLWX_v28_FINAL.wdg – Integrated main class
• DCT2SQLWX_TransactionSecurity.wdg – Transactional security system
• DCT2SQLWX_DatabaseSupport.wdg – 13-database support

?? Internationalization
• DCT2SQLWX_Translations.wdg – Full multilanguage system

?? Config & Monitoring
• DCT2SQLWX_GlobalConfig.wdg – Centralized config
• DCT2SQLWX_Monitoring.wdg – Monitoring & alerts

?? Reports & Post-Scripts
• DCT2SQLWX_JSONStatus.wdg – Structured JSON reports
• DCT2SQLWX_PostScript.wdg – Maintenance automation

?? Docs
• DCT2SQLWX_v28_Documentation.md – Full documentation
• DCT2SQLWX_v28_Organogram.md – Project structure
• README.md – This file

?? Config Files
• Config/DCT2SQLWX_Config_Example.ini – Config example
• Scripts/scripts_config_example.ini – Post-script config example

?

?? Quick Use

// Simplified usage
oDCT2SQLWX is DCT2SQLWX_v28_FINAL

// Safe synchronization
bResult is boolean = oDCT2SQLWX.SynchronizeAnalysisToDatabase(
"C:\MyProject\Analysis.wdd",
"Server=localhost;Database=MyDB;Trusted_Connection=true;",
"SQLSERVER"
)

IF bResult THEN
Info("Synchronization completed successfully!")
// Reports auto-generated
// Email alerts sent to DBAs
// Auto-backup created
ELSE
Error("Sync failed - Rollback executed")
// Database restored to previous state
// Logs available
END


?

?? Key Benefits of Version 28

? Maximum Security
• Prevents corruption from failed sync
• Automatic backup before changes
• Instant rollback on failure

? Universal DB Support
• 13 major database engines including Teradata
• Optimized commands per DBMS
• Best practices implemented

? Enterprise Monitoring
• Auto-email alerts
• JSON reports for integration
• Detailed logs for auditing

? Ease of Use
• Multilanguage interface (5 languages)
• Centralized configuration
• Simple usage with one method

?

DCT2SQLWX v28 – Advanced Schema Synchronization System
Built for robustness, security, and ease of use.