Especificação da Entrada Pública do LAK
Especificação da entrega pública criada para orientar visitantes externos.
especificação entrada pública por demanda LAK
Objetivo
Oferecer uma entrada simples para visitantes externos que ainda não conhecem a estrutura do livro-sistema, orientando a navegação a partir de uma demanda inicial.
Decisão de arquitetura da experiência
A entrada pública deve ser organizada em duas etapas:
| Etapa | Pergunta respondida | Artefato |
|---|---|---|
| 1. Entrada por demanda | Cheguei ao LAK. Por onde começo? | por_onde_comecar.html |
| 2. Modelo integrado | Depois que entrei, como o LAK atua, se organiza e pode ser lido/modelado? | capa_ola_lak_modelo_integrado.png |
Escopo da entrega
| Inclui | Não inclui agora |
|---|---|
| Apresentação pública do nome LAK. | Renomear fisicamente todas as pastas e arquivos antigos com OLA. |
| Página “Por onde começar?” com entradas por demanda. | Alterar o modelo integrado conceitual. |
| Explicação de que o modelo integrado vem depois da entrada. | Criar sistema de busca ou backend. |
| Links para decisão, demanda, capa e páginas relacionadas. | Publicar automaticamente no provedor. |
Requisitos funcionais
| ID | Requisito |
|---|---|
| RF-01 | A página inicial deve destacar LAK — Livro Ajustável de Conhecimento. |
| RF-02 | A primeira chamada de ação deve levar para por_onde_comecar.html. |
| RF-03 | A página por_onde_comecar.html deve oferecer entradas por demanda. |
| RF-04 | A imagem do modelo integrado deve aparecer como explicação posterior, não como primeira entrada. |
| RF-05 | A demanda principal deve registrar a existência da nova entrada pública. |
| RF-06 | A decisão de nome público deve explicar a escolha de LAK e sua relação com OLA. |
Requisitos de conteúdo
- Usar LAK como nome público principal.
- Usar Livro Ajustável de Conhecimento como expansão em português.
- Usar Conhecimento organizado por demanda como subtítulo.
- Evitar explicar o modelo completo antes de orientar a entrada do visitante.
- Manter nota de transição para arquivos que ainda possuem nomes com OLA.
Entradas por demanda previstas
| Entrada | Resposta esperada |
|---|---|
| Quero aprender algo | Levar a trilhas, conceitos, exemplos e práticas. |
| Quero entender um problema | Levar a contexto, cenário, hipóteses e requisitos. |
| Quero organizar conhecimento | Levar a categorias, mapas, modelos e vocabulário. |
| Quero produzir uma entrega | Levar a demanda, escopo, requisitos, artefato e evolução. |
| Quero consultar rapidamente | Levar a busca, índice, glossário, mapa ou página pública. |
| Quero ver exemplos | Levar a casos já trabalhados no livro-sistema. |
Critérios de aceitação
| Critério | Verificação |
|---|---|
| Clareza da entrada | O visitante entende que deve começar por uma demanda. |
| Coerência do nome | A página usa LAK como nome público principal. |
| Não confusão com o modelo integrado | A imagem aparece como segunda explicação, não como porta inicial. |
| Links mínimos funcionando | index.html, por_onde_comecar.html, decisão, demanda e capa estão conectados. |
| Transição preservada | Arquivos com nome antigo são explicados em nota de transição. |
Observação sobre nomes físicos
O arquivo continua chamado especificacao_descobrir_ola.html por continuidade e para evitar quebra de links. O conteúdo, porém, já especifica a entrada pública do LAK.