redefine README.md

This commit is contained in:
Nilton Constantino
2026-01-19 06:37:30 +00:00
parent 9d959a2265
commit 38ec13b248
7 changed files with 123 additions and 102 deletions
+14
View File
@@ -0,0 +1,14 @@
# PROMETEU Core
Este crate contém a biblioteca central que define o comportamento do hardware e software do PROMETEU.
## Responsabilidades
- **Hardware Lógico**: Definição de GFX, Input, Audio e Touch.
- **Máquina Virtual**: Execução de bytecode customizado (PBC - Prometeu Byte Code).
- **Virtual FS**: Gerenciamento de arquivos e acesso ao "cartucho".
- **Firmware/OS**: O sistema operacional interno que gerencia o ciclo de vida das aplicações, splash screens e o Hub Home.
## Arquitetura
O core é projetado para ser determinístico e portátil. Ele não faz chamadas diretas ao sistema operacional do host; em vez disso, define traços (traits) que os hosts devem implementar (ex: `FsBackend`).
+18
View File
@@ -0,0 +1,18 @@
# PROMETEU Desktop Runtime
Esta é a implementação de host para plataformas desktop, permitindo que o PROMETEU rode em Windows, Linux e macOS.
## Funcionalidades
- **Renderização**: Utiliza a GPU via biblioteca `pixels` para apresentar o framebuffer de baixa resolução.
- **Input**: Traduz eventos de teclado e controle (via `winit`) para os sinais de hardware do PROMETEU.
- **Áudio**: Interface com o sistema de som do host (via `cpal`).
- **Debugging**: Hospeda um servidor TCP que implementa o **DevTools Protocol**, permitindo conexões de IDEs ou debuggers externos.
## Como rodar
Geralmente executado via CLI principal (`prometeu`), mas pode ser chamado diretamente para testes:
```bash
cargo run -- --run path/to/cart
```
+14
View File
@@ -0,0 +1,14 @@
# PROMETEU CLI (Dispatcher)
O binário `prometeu` atua como o front-end unificado para o ecossistema. Ele não implementa a lógica de execução ou compilação, mas sabe onde encontrar os binários que as implementam.
## Comandos
- `prometeu run <cart>`: Executa um cartucho usando o runtime disponível.
- `prometeu debug <cart> [--port <p>]`: Inicia a execução em modo de depuração.
- `prometeu build <projectDir>`: (Planejado) Chama o compilador `prometeuc`.
- `prometeu pack <cartDir>`: (Planejado) Chama o empacotador `prometeup`.
## Funcionamento
O dispatcher localiza os binários irmãos (`prometeu-runtime`, `prometeuc`, etc.) no mesmo diretório onde ele próprio está instalado. Ele herda `stdin`, `stdout` e `stderr`, e propaga o código de saída do processo chamado.