Prompt: entender um programa Progress 4GL legado sem documentação

Quando usar

Caiu no seu colo um .p de 1.500 linhas escrito em 2004, sem um comentário sequer, e o cliente quer uma alteração "simples" para ontem. Antes de mexer, você precisa saber o que aquilo faz.

O prompt

Código:

Você é um desenvolvedor Progress ABL sênior com experiência em manutenção
de sistemas legados Datasul/EMS.

Vou colar um programa em Progress 4GL. Analise e me devolva, nesta ordem:

1. PROPÓSITO — em no máximo 3 frases, o que este programa faz do ponto de
   vista de negócio. Não descreva o código, me diga a regra.

2. ENTRADAS E SAÍDAS — parâmetros de entrada/saída, temp-tables recebidas,
   arquivos lidos ou gravados, telas exibidas.

3. TABELAS TOCADAS — para cada tabela: se é leitura ou escrita, e em que
   ponto do fluxo. Marque com ATENÇÃO qualquer CREATE, DELETE ou ASSIGN
   em tabela do dicionário padrão do produto.

4. FLUXO PRINCIPAL — passo a passo em português, numerado. Um passo por
   bloco lógico, não por linha.

5. REGRAS DE NEGÓCIO ESCONDIDAS — condições, constantes mágicas e códigos
   fixos no meio do código (por exemplo IF cod-estabel = "101"). Liste cada
   uma e diga em que linha está.

6. RISCOS PARA QUEM FOR ALTERAR — transações longas, falta de NO-LOCK,
   RUN de outros programas, variáveis SHARED, dependência de ordem de
   execução.

7. SUPOSIÇÕES — o que você precisou supor por não ter o dicionário de dados
   nem os programas chamados.

Ambiente: [Progress 9.1E / OpenEdge 10.2B / OpenEdge 11.7 / OpenEdge 12.x]
Aplicação: [Datasul EMS 2.06 / EMS 5 / Totvs 11 / Logix / sistema próprio]

Não sugira melhorias ainda. Só me explique o que está aí.

Programa:
---
[COLE O CÓDIGO AQUI]
---

O que preencher

Só as duas linhas de ambiente e o código. A versão importa mais do que parece: em 9.1E não existe boa parte da sintaxe que a IA usa por padrão, e você recebe sugestão que não compila.

O que esperar de volta

O item 5 é o que vale ouro — são as constantes fixas que ninguém documentou e que quebram no dia em que o cliente abre um estabelecimento novo. O item 7 é o seu termômetro: se ela escreveu "supus que a tabela X é padrão do EMS", você já sabe onde conferir.

A segunda mensagem

Depois que ela explicou, o que costuma render mais é:

Código:

Agora liste, em ordem de risco, o que pode quebrar se eu alterar
[DESCREVA A ALTERAÇÃO]. Para cada item, diga qual trecho do código eu
preciso reler antes de mexer.