translate to english!
This commit is contained in:
+64
-64
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user