translate to english!

This commit is contained in:
Nilton Constantino
2026-01-19 07:28:14 +00:00
parent 38ec13b248
commit 0f3105d622
49 changed files with 2488 additions and 2488 deletions
+64 -64
View File
@@ -1,113 +1,113 @@
# Especificação — Ciclo de Desenvolvimento Prometeu
**Versão:** 0.1
**Status:** Conceitual / Filosófico
# Specification — Prometeu Development Cycle
**Version:** 0.1
**Status:** Conceptual / Philosophical
---
## 1. Princípio Central
## 1. Central Principle
O Prometeu é uma plataforma didática de desenvolvimento de software interativo.
Seu ciclo de desenvolvimento é projetado para separar claramente:
Prometeu is a didactic platform for interactive software development.
Its development cycle is designed to clearly separate:
- Criação de código
- Compilação
- Execução
- Observação e explicação
- Code creation
- Compilation
- Execution
- Observation and explanation
Cada etapa possui uma ferramenta própria, especializada e não sobreposta.
Each stage has its own specialized, non-overlapping tool.
---
## 2. Ferramentas do Ciclo
## 2. Cycle Tools
O ciclo utiliza quatro pilares:
The cycle uses four pillars:
1. **Editor de Código**
Ambiente livre (ex: WebStorm) onde o desenvolvedor escreve em TypeScript.
1. **Code Editor**
Free environment (e.g., WebStorm) where the developer writes in TypeScript.
2. **Compilador Prometeu**
Converte código fonte em bytecode executável pela runtime Prometeu.
2. **Prometeu Compiler**
Converts source code into executable bytecode for the Prometeu runtime.
3. **Runtime Prometeu**
Executa jogos e aplicações em seu próprio ambiente gráfico.
3. **Prometeu Runtime**
Executes games and applications in its own graphical environment.
4. **Prometeu Debugger**
Ferramenta didática de observação, análise e explicação do comportamento interno do sistema.
A didactic tool for observation, analysis, and explanation of the system's internal behavior.
Nenhuma dessas ferramentas tenta substituir a outra.
Elas cooperam através de contratos claros.
None of these tools try to replace each other.
They cooperate through clear contracts.
---
## 3. Fluxo Geral
## 3. General Flow
O ciclo segue sempre a mesma sequência conceitual:
The cycle always follows the same conceptual sequence:
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.
1. The developer writes code in TypeScript.
2. The code is compiled to Prometeu bytecode.
3. The bytecode is packaged as a cartridge.
4. The cartridge is executed by the runtime.
5. Internal behavior can be observed by the Prometeu Debugger.
---
## 4. Modos de Execução
## 4. Execution Modes
O Prometeu possui dois modos conceituais de execução:
Prometeu has two conceptual execution modes:
### Execução Normal (Run)
### Normal Execution (Run)
- O cartucho é empacotado e executado.
- A runtime funciona de forma autônoma.
- O Debugger atua apenas como observador.
- The cartridge is packaged and executed.
- The runtime operates autonomously.
- The Debugger acts only as an observer.
### Execução Assistida (Debug)
### Assisted Execution (Debug)
- O cartucho é empacotado e executado.
- A runtime aguarda conexão do Prometeu Debugger.
- O Debugger passa a controlar e observar a execução.
- The cartridge is packaged and executed.
- The runtime waits for a connection from the Prometeu Debugger.
- The Debugger begins to control and observe the execution.
---
## 5. Separação de Papéis
## 5. Separation of Roles
Cada parte do ciclo tem responsabilidade única:
Each part of the cycle has a unique responsibility:
| Etapa | Papel principal |
|-----------|--------------------------------------|
| Editor | Criar código |
| Compilador| Transformar código em bytecode |
| Runtime | Executar |
| Debugger | Observar, explicar e ensinar |
| Stage | Main Role |
|------------|------------------------------------|
| Editor | Create code |
| Compiler | Transform code into bytecode |
| Runtime | Execute |
| Debugger | Observe, explain, and teach |
Essa separação é intencional e parte da filosofia do Prometeu.
This separation is intentional and part of the Prometeu philosophy.
---
## 6. Filosofia Didática
## 6. Didactic Philosophy
O Prometeu não é apenas uma engine.
Ele é uma plataforma para aprender como software interativo funciona por dentro.
Prometeu is not just an engine.
It is a platform for learning how interactive software works from the inside.
O ciclo de desenvolvimento é pensado para:
The development cycle is designed to:
- Tornar a execução visível
- Tornar decisões técnicas observáveis
- Tornar erros explicáveis
- Tornar desempenho mensurável
- Make execution visible
- Make technical decisions observable
- Make errors explainable
- Make performance measurable
O Debugger não é apenas uma ferramenta de correção, mas um instrumento pedagógico.
The Debugger is not just a fix tool, but a pedagogical instrument.
---
## 7. Síntese
## 7. Synthesis
O Ciclo de Desenvolvimento Prometeu é:
The Prometeu Development Cycle is:
- Modular
- Observável
- Didático
- Não acoplado a uma IDE específica
- Orientado a aprendizado e compreensão profunda
- Observable
- Didactic
- Not coupled to a specific IDE
- Oriented towards learning and deep understanding
Ele existe para que o desenvolvedor não apenas escreva programas, mas entenda como eles vivem dentro da máquina.
It exists so that the developer does not just write programs, but understands how they live inside the machine.