114 lines
2.9 KiB
Markdown
114 lines
2.9 KiB
Markdown
# Especificação — Ciclo de Desenvolvimento Prometeu
|
|
**Versão:** 0.1
|
|
**Status:** Conceitual / Filosófico
|
|
|
|
---
|
|
|
|
## 1. Princípio Central
|
|
|
|
O Prometeu é uma plataforma didática de desenvolvimento de software interativo.
|
|
Seu ciclo de desenvolvimento é projetado para separar claramente:
|
|
|
|
- Criação de código
|
|
- Compilação
|
|
- Execução
|
|
- Observação e explicação
|
|
|
|
Cada etapa possui uma ferramenta própria, especializada e não sobreposta.
|
|
|
|
---
|
|
|
|
## 2. Ferramentas do Ciclo
|
|
|
|
O ciclo utiliza quatro pilares:
|
|
|
|
1. **Editor de Código**
|
|
Ambiente livre (ex: WebStorm) onde o desenvolvedor escreve em TypeScript.
|
|
|
|
2. **Compilador Prometeu**
|
|
Converte código fonte em bytecode executável pela runtime Prometeu.
|
|
|
|
3. **Runtime Prometeu**
|
|
Executa jogos e aplicações em seu próprio ambiente gráfico.
|
|
|
|
4. **Prometeu Debugger**
|
|
Ferramenta didática de observação, análise e explicação do comportamento interno do sistema.
|
|
|
|
Nenhuma dessas ferramentas tenta substituir a outra.
|
|
Elas cooperam através de contratos claros.
|
|
|
|
---
|
|
|
|
## 3. Fluxo Geral
|
|
|
|
O ciclo segue sempre a mesma sequência conceitual:
|
|
|
|
1. O desenvolvedor escreve código em TypeScript.
|
|
2. O código é compilado para bytecode Prometeu.
|
|
3. O bytecode é empacotado como cartucho.
|
|
4. O cartucho é executado pela runtime.
|
|
5. O comportamento interno pode ser observado pelo Prometeu Debugger.
|
|
|
|
---
|
|
|
|
## 4. Modos de Execução
|
|
|
|
O Prometeu possui dois modos conceituais de execução:
|
|
|
|
### Execução Normal (Run)
|
|
|
|
- O cartucho é empacotado e executado.
|
|
- A runtime funciona de forma autônoma.
|
|
- O Debugger atua apenas como observador.
|
|
|
|
### Execução Assistida (Debug)
|
|
|
|
- O cartucho é empacotado e executado.
|
|
- A runtime aguarda conexão do Prometeu Debugger.
|
|
- O Debugger passa a controlar e observar a execução.
|
|
|
|
---
|
|
|
|
## 5. Separação de Papéis
|
|
|
|
Cada parte do ciclo tem responsabilidade única:
|
|
|
|
| Etapa | Papel principal |
|
|
|-----------|--------------------------------------|
|
|
| Editor | Criar código |
|
|
| Compilador| Transformar código em bytecode |
|
|
| Runtime | Executar |
|
|
| Debugger | Observar, explicar e ensinar |
|
|
|
|
Essa separação é intencional e parte da filosofia do Prometeu.
|
|
|
|
---
|
|
|
|
## 6. Filosofia Didática
|
|
|
|
O Prometeu não é apenas uma engine.
|
|
Ele é uma plataforma para aprender como software interativo funciona por dentro.
|
|
|
|
O ciclo de desenvolvimento é pensado para:
|
|
|
|
- Tornar a execução visível
|
|
- Tornar decisões técnicas observáveis
|
|
- Tornar erros explicáveis
|
|
- Tornar desempenho mensurável
|
|
|
|
O Debugger não é apenas uma ferramenta de correção, mas um instrumento pedagógico.
|
|
|
|
---
|
|
|
|
## 7. Síntese
|
|
|
|
O Ciclo de Desenvolvimento Prometeu é:
|
|
|
|
- Modular
|
|
- Observável
|
|
- Didático
|
|
- Não acoplado a uma IDE específica
|
|
- Orientado a aprendizado e compreensão profunda
|
|
|
|
Ele existe para que o desenvolvedor não apenas escreva programas, mas entenda como eles vivem dentro da máquina.
|