---
sidebar_position: 1
title: "Guia de Desenvolvimento"
---

Esta documentação técnica descreve como desenvolver a plataforma com base no código atual em `app/`.

## Visão geral

O repositório concentra três frentes técnicas independentes, integradas localmente via Docker:

```mermaid
graph TD
    A[decoda] --> B["**app/** - React + Vite"]
    A --> C["**docs/** - Docusaurus"]
    A --> D["**jupyter/** - JupyterLite"]
    B --> E[Atividades de **Programação**]
    B --> F[Atividades de **Letramento**]
```

- Aplicação principal em React, com atividades interativas em `app/`.
- Documentação em Docusaurus em `docs/`.
- Instância JupyterLite em `jupyter/` para material de apoio.

Referências externas:

- React: https://react.dev/
- Docusaurus: https://docusaurus.io/
- JupyterLite: https://jupyterlite.readthedocs.io/

## Estrutura real da aplicação

Na aplicação principal, o código está organizado principalmente em:

- `app/src/atividades/programacao`: atividades com Blockly, interpretador e renderização.
- `app/src/atividades/letramento`: atividades em HTML autocontido executadas em iframe.
- `app/src/contexts`: estado global da aplicação.
- `app/src/interpreters`: execução segura de código.
- `app/src/services`: persistência local e serviços auxiliares.
- `app/src/components`: componentes reutilizáveis de interface.

## Como usar esta documentação

Comece por estas seções, conforme o contexto:

1. `plataforma/pre-requisitos`: ambiente local em Windows, macOS e Linux.
2. `documentacao/monorepo`: build e subida local via Docker.
3. `plataforma/arquitetura/intro`: visão geral da arquitetura do site.
4. `plataforma/atividades_programacao/intro`: conteúdo específico de atividades de programação.
5. `plataforma/letramento/intro`: conteúdo específico de atividades de letramento.

## Escopo desta doc

Esta doc é voltada para quem já tem acesso ao código-fonte. O foco é manutenção e evolução interna do projeto.
