Proposta para reorganizar a ordem dos módulos, promover a UML a módulo numerado (Etapa 7 do plano das páginas internas), criar a especialização em Svelte e completar a trilha para quem está começando em computação.
docs/plano-reorganizacao-trilha| Fase | Módulos |
|---|---|
| Fundamentos | 01 Fundamentos da Computação · 02 Lógica e Algoritmos |
| Web, interfaces e versionamento | 03 Git · 04 HTML/CSS · 05 JavaScript · 06 UI/UX |
| Backend e dados | 07 Backend e APIs · 08 Bancos de Dados |
| Ciência da computação e arquitetura | 09 Estruturas de Dados · 10 Paradigmas e Padrões · 11 Qualidade e Testes |
| Produção e sistemas | 12 Segurança · 13 DevOps e Cloud · 14 Hardware, SOs e Compiladores |
Além dos módulos: 22 especializações, 7 guias extras e o hub de projetos (39 cursos no total).
PLANO_ARQUITETURA_1_SEMESTRE.md (aprovado em 2026-08-29) define o Mod 01 como introdução (F01–F20: Von Neumann, bits e bytes, Linux, terminal, redes, formatos de dados, regex…) e o Mod 02 com C como primeira linguagem (L01–L20). O conteúdo publicado segue outra estrutura nos dois módulos.spec_sistemas_com_python. O Mod 02 mistura Portugol, C e Python.extra_engenharia_de_software e extra_guia_de_modelagem_uml).Critério: tópicos com o mesmo diagrama Mermaid (depois de remover os rótulos) e exemplos com menos de 5 linhas de código.
| Situação | Cursos |
|---|---|
| ✅ Conteúdo real nos 5 artefatos | Mods 02 a 14; guias extras; spec_sistemas_com_go, _java, _python; proj_aplicacoes_full_stack |
| ⚠️ Exemplos vazios | Mod 01 (20 de 20) |
| ⚠️ Diagramas repetidos, exemplos reais (conferir) | spec_backend_com_java_e_springboot (5 diagramas distintos em 20), _golang_e_gin (7), _python_e_fastapi (9), spec_sistemas_com_c (8) |
| ❌ Teoria e exemplos de modelo | spec_sistemas_com_typescript, spec_frontend_com_react, _angular, _vue, spec_mobile_nativo_android, spec_multiplataforma_com_flutter, spec_sistemas_com_cpp, _csharp, _rust |
Nos 9 cursos marcados com ❌, os exercícios (900 a 1.150 linhas de código nos gabaritos) e os quizzes têm conteúdo real.
| # | Decisão | Opções | Recomendação |
|---|---|---|---|
| D1 | Como renumerar | A) renomear as pastas (mod_07_backend… → mod_12_backend…) com redirecionamento no 404.html, como na Etapa 5 · B) manter as pastas e mudar só a ordem e o número exibido |
A, feita uma única vez, no fim (Etapa 7F). Com B, o número do endereço deixa de bater com o número mostrado. |
| D2 | Primeira linguagem da trilha | A) C, como no plano aprovado do 1º semestre (L08–L20) · B) Python, a linguagem dos exemplos dos Mods 07 a 11 | B. Os Mods 07, 09, 10 e 11 são em Python; o C continua em spec_sistemas_com_c e no Mod 16. Isso muda uma decisão já aprovada, por isso precisa da sua confirmação. |
| D3 | Curso de Python | A) promover spec_sistemas_com_python (já tem conteúdo real) a Mod 03, ajustando os 3 ou 4 primeiros capítulos · B) escrever um módulo novo |
A. Economiza 100 páginas. |
| D4 | Novo Mod 01 | A) reescrever seguindo F01–F20 do plano aprovado, mantendo o slug mod_01_fundamentos_da_computacao · B) outra estrutura |
A, com os ajustes da Seção 4.1. |
| D5 | Guias de UML e de Engenharia de Software | A) o guia de UML vira o novo Mod 10 com 8 capítulos do guia de Engenharia; o guia de Engenharia vira “Arquitetura de Software” e é completado · B) manter os dois guias e criar o Mod 10 do zero | A (Seção 4.4). |
| D6 | Especialização em Svelte | Área Frontend, 20 capítulos (Seção 5) | Aprovar o sumário da Seção 5. |
| D7 | Ordem das etapas | Seção 8 | Conteúdo primeiro, renumeração por último. |
| D8 | Mod 02 | A) manter a lógica (capítulos 01 a 12) e trocar os capítulos 13 a 16, que repetem o Mod 08 · B) reescrever seguindo L01–L20 | A se D2 = Python; B se D2 = C. |
| Nº | Módulo | Origem | Slug proposto (se D1 = A) |
|---|---|---|---|
| Fase 1 | Primeiros passos | ||
| 01 | Fundamentos da Computação (introdução) | Mod 01 reescrito (D4) | mod_01_fundamentos_da_computacao (mantido) |
| 02 | Lógica e Algoritmos | Mod 02 ajustado (D8) | mod_02_logica_e_algoritmos (mantido) |
| 03 | Programação com Python | spec_sistemas_com_python promovida (D3) |
mod_03_programacao_com_python |
| 04 | Git e GitHub | Mod 03 | mod_04_versionamento_com_git_e_github |
| Fase 2 | Web | ||
| 05 | HTML5 e CSS3 | Mod 04 | mod_05_html5_e_css3 |
| 06 | JavaScript e DOM | Mod 05 | mod_06_javascript_fundamentos_e_dom |
| 07 | Design UI/UX e Acessibilidade | Mod 06 | mod_07_design_de_interfaces_ui_ux |
| Fase 3 | Construção de software | ||
| 08 | Estruturas de Dados | Mod 09 | mod_08_estruturas_de_dados |
| 09 | Paradigmas e Padrões de Projeto | Mod 10 | mod_09_paradigmas_e_padroes_de_projeto |
| 10 | Engenharia de Software e Modelagem UML | guia UML + parte do guia de Engenharia (D5) | mod_10_engenharia_de_software_e_uml |
| 11 | Qualidade e Testes | Mod 11 | mod_11_qualidade_e_testes_de_software (mantido) |
| Fase 4 | Backend e dados | ||
| 12 | Backend e APIs REST | Mod 07 | mod_12_backend_e_apis |
| 13 | Bancos de Dados SQL e NoSQL | Mod 08 | mod_13_bancos_de_dados_sql_e_nosql |
| Fase 5 | Produção e sistemas | ||
| 14 | Desenvolvimento Seguro | Mod 12 | mod_14_desenvolvimento_seguro |
| 15 | DevOps e Cloud | Mod 13 | mod_15_devops_e_cloud |
| 16 | Hardware, SOs e Compiladores | Mod 14 | mod_16_hardware_e_compiladores |
Por que essa ordem:
Pré-requisitos das especializações (ajustar em _data/cursos.yml):
| Área | Hoje | Proposto |
|---|---|---|
| Backend | Mod 07 e 08 | Mod 12 e 13 |
| Frontend | Mod 05 | Mod 06 |
| Mobile | Mod 02 | Mod 03 |
| Sistemas | Mod 02 e 09 | Mod 03 e 08 (o Python sai da área Sistemas, D3) |
Base: F01–F20 do plano aprovado, com três ajustes: (a) F09 fica só com terminal e shell, porque o Git ganha o Mod 04 inteiro; (b) F17 (templates Jekyll/Liquid/Jinja2) é avançado para o 1º contato e vira “Como a web funciona: navegador, HTML, CSS e JS”; (c) o antigo capítulo 20 (IA) volta como F20 “Carreira, estudo e portfólio”, e o projeto integrador vira o último exercício.
| Bloco | Capítulos |
|---|---|
| 1. O que é computação | F01 Computação e Alan Turing · F02 Von Neumann e hardware · F03 Bits, bytes e bases numéricas · F04 Inteiros com sinal e ponto flutuante |
| 2. Dados, memória e SO | F05 Texto: ASCII, Unicode e UTF-8 · F06 Memória: cache, RAM, pilha e heap · F07 Sistemas operacionais · F08 Linux essencial |
| 3. Terminal, redes e web | F09 Terminal e shell (Bash e PowerShell) · F10 Redes e internet (IP, DNS, TCP, HTTP) · F11 Como a web funciona · F12 Software e linguagens de programação |
| 4. Linguagens e formatos | F13 Modelos de execução (compilado, bytecode, JVM) · F14 Tipagem · F15 Estilos sintáticos e convenções · F16 Formatos de dados (JSON, YAML, CSV, XML) |
| 5. Ferramentas e profissão | F17 Markdown e documentação · F18 Expressões regulares · F19 Segurança básica (senhas, hash, 2FA) · F20 Carreira, estudo e portfólio |
O que acontece com os capítulos atuais (usado nos redirecionamentos, porque os nomes dos arquivos mudam):
| Capítulo atual | Destino |
|---|---|
| 01 Álgebra booleana | Mod 16 cap. 01 |
| 02 Autômatos e Turing | novo F01 (a parte de Turing) e Mod 16 cap. 16 (autômatos no analisador léxico) |
| 03 Complexidade e P vs NP | Mod 08 cap. 02 |
| 04 Matemática discreta | Mod 08 cap. 03 (indução); o restante vira seção do novo F03 |
| 05 a 08 Estruturas, ordenação, grafos | Mod 08 (caps. 04–08, 13–17) |
| 09 Von Neumann · 10 Memória · 11 SOs | novos F02, F06 e F07 |
| 12 Compiladores | novos F12/F13 e Mod 16 cap. 16 |
| 13 Paradigmas | Mod 09 caps. 01–03 |
| 14 Bancos de dados | Mod 13 |
| 15 Engenharia de software | Mod 10 |
| 16 Redes | novo F10 |
| 17 Criptografia | novo F19 e Mod 14 cap. 05 |
| 18 Concorrência | Mod 16 cap. 10 |
| 19 Sistemas distribuídos | guia Arquitetura de Software (D5) |
| 20 IA | guia extra_inteligencia_artificial |
spec_sistemas_com_python)A especialização já tem conteúdo real nos 5 artefatos. Ajustes para um módulo de iniciante:
requests, que o Mod 12 (Backend) vai usar.Atualização (2026-09-24): a fusão dos guias de UML e de Engenharia de Software foi separada deste plano e detalhada como a Etapa 7 do plano das páginas internas, que substitui a proposta abaixo. Em resumo: um curso 20×5 com os 14 diagramas da UML, BPMN, requisitos formais, modelagem de domínio e qualidade/manutenção, mantido por enquanto como guia extra.
Montado com 13 capítulos do guia de UML e 6 do guia de Engenharia de Software, mais 1 capítulo novo (BPMN, que já aparece como lacuna em extra_engenharia_de_software/_auditoria/plano_melhorias_2026-08-10.md).
| Bloco | Capítulos (origem) |
|---|---|
| 1. Processo | 01 Ciclos de vida (ES 01) · 02 Scrum, Kanban e XP (ES 02) · 03 Engenharia de requisitos (ES 03) · 04 User stories e estimativas (ES 04) |
| 2. Estrutura | 05 Introdução à UML (UML 01) · 06 Casos de uso (UML 05, fundido com a parte de casos de uso do UML 01) · 07 Diagrama de classes (UML 02) · 08 Objetos e pacotes (UML 03 + UML 04) |
| 3. Comportamento | 09 Sequência (UML 06) · 10 Atividades (UML 09) · 11 Máquina de estados (UML 10) · 12 Modelagem de processos com BPMN (novo) |
| 4. Arquitetura | 13 Componentes (UML 13) · 14 Implantação (UML 15) · 15 Modelo C4 (UML 18) · 16 ADRs e arc42 (ES 15) |
| 5. Prática | 17 Diagramas como código: Mermaid e PlantUML (UML 17) · 18 Engenharia reversa e geração de código (UML 19) · 19 Revisão de código e inspeção (ES 12) · 20 Projeto: Documento de Arquitetura de Software (UML 20) |
extra_engenharia_de_software vira “Arquitetura de Software” e fica com o que não se repete: DDD (08), débito técnico (13), análise estática (14), SemVer (16), microsserviços (18), resiliência (19), mais os sistemas distribuídos do antigo Mod 01. São 7 capítulos; faltam 13 para fechar os 20 (sumário a definir). Os capítulos 05, 06, 07, 09, 10, 11 e 17 repetem os Mods 09, 11 e 15 e saem.uml_01_especificacao_sistema_bancario passa a apontar para o Mod 10.spec_frontend_com_svelte)proj_aplicacoes_full_stack/projetos/multilang_imc_38/svelte e criar frontend_svelte_01 (sugestão: painel de tarefas com SvelteKit e form actions).| Bloco | Capítulos |
|---|---|
| 1. Fundamentos | 01 Por que Svelte: compilador × virtual DOM, criar projeto com npx sv create · 02 Anatomia de um componente .svelte (script, marcação, estilo com escopo) · 03 Reatividade com $state e $derived · 04 Efeitos e ciclo de vida: $effect e onMount |
| 2. Componentes | 05 Props com $props e $bindable · 06 Eventos e callbacks no Svelte 5 · 07 Blocos de template: if, each, await e key · 08 Snippets e composição (#snippet e @render) |
| 3. Interface | 09 Bindings de formulário e validação · 10 Estilos: CSS com escopo, :global e classes dinâmicas · 11 Transições e animações · 12 Acessibilidade e os avisos do compilador |
| 4. SvelteKit | 13 Roteamento por arquivos: +page, +layout e parâmetros · 14 Carregamento de dados: load universal e de servidor · 15 Form actions e progressive enhancement · 16 Estado compartilhado: runes em .svelte.ts, context e stores |
| 5. Produção | 17 Rotas de API (+server.ts), hooks e autenticação · 18 Testes com Vitest, Testing Library e Playwright · 19 Build e deploy: adapters, SSR, SSG e CSR · 20 Projeto integrador |
Arquivos: 100 artefatos + 6 índices, entrada em _data/cursos.yml (Frontend), bloco em _data/navigation.yml, grade (build_indice_geral.py), catálogo de projetos. Atenção ao Liquid: a sintaxe do Svelte usa chaves simples; exemplos com chaves duplas ou com tags de controle do Liquid precisam de raw.
Em cada um dos 9 cursos abaixo, reescrever os 20 tópicos (teoria, mapa Mermaid próprio, tabelas e código real) e os 20 exemplos (código executável). Os exercícios, os quizzes e os slides são mantidos e revisados só onde a teoria nova exigir.
| Prioridade | Cursos | Arquivos |
|---|---|---|
| 1 | TypeScript, React, Vue, Angular (a área que recebe o Svelte) | 160 |
| 2 | Android, Flutter | 80 |
| 3 | C++, C#, Rust | 120 |
| — | Total | 360 |
git mv de 12 módulos, do maior número para o menor, para não haver colisão (ex.: mod_14 → mod_16 antes de mod_12 → mod_14)._data/cursos.yml (fases, números e pré-requisitos), _data/navigation.yml, grade (_scripts/build_indice_geral.py).../mod_…); o catálogo de projetos (numeração “Curso NN” e links); os pré-requisitos nos projetos; os links “próxima etapa” nos hubs._scripts/ e _artefatos_gerais/scripts/ que citam slugs; os históricos ficam como estão.404.html: um único mapa com todos os renomes. Os redirecionamentos antigos precisam apontar direto para o destino final, sem dois saltos: mod_03_design… → mod_07_design…, mod_06_versionamento… → mod_04_versionamento… e spec_seguranca… → mod_14_desenvolvimento_seguro. Entram também spec_sistemas_com_python → mod_03_programacao_com_python e os dois guias absorvidos pelo Mod 10.docs/MEMORIA_CONTEXTO.md (censo) e os links relativos em docs/.| Etapa | Escopo | Tamanho | Depende de |
|---|---|---|---|
| 7A | Corrigir os números errados nos títulos dos guias de UML, Ferramentas e Redes | pequeno | — |
| 7B | Reescrever o conteúdo de modelo dos 9 cursos (Seção 6), por prioridade, em PRs separados | 360 arquivos | — |
| 7C | Reescrever o Mod 01 (4.1) e ajustar o Mod 02 (4.2) | ~120 arquivos | D2, D4, D8 |
| 7D | Promover o Python (4.3) e montar o Mod 10 de Engenharia e UML (4.4) | ~200 arquivos | D3, D5 |
| 7E | Criar a especialização em Svelte (Seção 5) | 106 arquivos | D6 |
| 7F | Renumerar a trilha e ajustar pré-requisitos e redirecionamentos (Seção 7) | milhares de arquivos | 7C e 7D |
| 7G | Completar o guia de Arquitetura de Software (13 capítulos) | ~65 arquivos | D5 |
Validação de cada etapa: python _scripts/validate_liquid.py; estrutura 20×5 dos cursos tocados; exemplos executados antes de entrar; bash _scripts/docker_build.sh; teste visual em 375, 768 e 1280 px nos dois temas; python _scripts/test_links.py; teste dos redirecionamentos quando houver.
404.html, mas buscadores levam um tempo para atualizar. Fazer a renumeração uma única vez reduz esse custo.