Organização do Projeto
projeto/organizacao_projeto.html · organização operacional

Organização da Pasta Projeto

Esta página define como a pasta projeto/ deve ser usada, organizada, nomeada, mantida e integrada ao OLA, evitando confusão entre projeto como desenho técnico, projeto como plano, projeto como gestão temporária e projeto como empreendimento evolutivo.

1. Problema resolvido

A pasta projeto/ pode crescer rapidamente e misturar conteúdos de natureza diferente: visão geral, método, entregas, planejamento, decisões, escopo, evolução, operação e valor.

Problema resolvido: esta página define critérios para organizar a pasta projeto/ como área do empreendimento evolutivo do OLA, evitando que ela se torne apenas uma coleção solta de páginas ou um depósito genérico de planejamento.

A organização da pasta precisa preservar três coisas: o sentido semântico da área, a coerência com o restante do OLA e a rastreabilidade entre necessidade, decisão, entrega, operação, manutenção e evolução.

2. Função desta página

Esta página é a terceira peça da tríade organizadora da pasta projeto/.

Página Tipo Função
index_projeto.html Índice Apresenta a área, cataloga páginas e funciona como entrada principal da pasta.
mapa_projeto.html Mapa Explicita relações, fluxo, posição semântica e conexões com outras áreas do OLA.
organizacao_projeto.html Organização Define critérios de uso, nomeação, classificação, manutenção e evolução da pasta.
Diretriz: o índice mostra o que existe; o mapa mostra como se relaciona; a organização mostra como manter a área coerente.

3. Escopo da pasta projeto/

A pasta projeto/ deve conter páginas que tratem da condução do OLA como empreendimento evolutivo.

Visão e direção

Páginas que explicam por que o OLA existe, o que pretende realizar e qual direção orienta sua evolução.

Método e ciclo de vida

Páginas que mostram como o OLA transforma necessidades em artefatos, operação, manutenção, evolução e valor.

Escopo e entregas

Páginas que organizam o que será produzido, o que já foi produzido e como as entregas se relacionam.

Decisões e evolução

Páginas que registram decisões relevantes, mudanças de direção, refatorações e aprendizado do projeto.

Definição operacional: entra em projeto/ aquilo que explica, organiza ou registra a transformação do OLA de intenção em sistema vivo, operável, mantido e evolutivo.

4. O que não pertence diretamente à pasta projeto/

Para evitar duplicação e confusão, alguns conteúdos devem ser direcionados a outras áreas.

Conteúdo Melhor área Motivo
Regras canônicas, padrões e critérios normativos governanca/ São elementos de orientação, controle e coerência do sistema.
Componentes, funcionalidades, entradas e saídas arquitetura/ Tratam da estrutura da solução e de seus componentes funcionais.
Funcionamento sistêmico, fronteiras, estados e operação do sistema sistema/ Tratam do OLA como sistema em funcionamento.
Conceitos teóricos, epistemológicos e metodológicos gerais fundamentos/ Sustentam conceitualmente o OLA.
Conteúdos por tema, área de conhecimento ou demanda externa dominios/ São instâncias de conhecimento organizadas por domínio.
Trilhas, objetos, práticas, avaliação e progressão aprendizagem/ Tratam do processo educacional.
Lacunas, necessidades, progresso e acompanhamento do sujeito que aprende aprendiz/ Tratam da entidade aprendiz.
Laboratórios, experimentos e protótipos autorais ainda instáveis autor/lab/ Devem amadurecer antes de serem incorporados ao projeto formal.

5. Estrutura sugerida da pasta projeto/

A estrutura abaixo organiza a pasta por funções. Nem todos os arquivos precisam existir imediatamente, mas a estrutura serve como referência evolutiva.

projeto/ ├── index_projeto.html ├── mapa_projeto.html ├── organizacao_projeto.html │ ├── visao_geral.html ├── metodo.html ├── escopo_ola.html ├── entregas_ola.html ├── ciclo_vida_solucao_ola.html ├── plano_evolucao_ola.html ├── decisoes_projeto_ola.html ├── valor_ola.html │ ├── historico/ │ ├── historico_projeto_ola.html │ └── versoes_projeto_ola.html │ ├── acompanhamento/ │ ├── acompanhamento_entregas_ola.html │ ├── acompanhamento_refatoracoes_ola.html │ └── acompanhamento_pendencias_ola.html │ └── registros/ ├── registro_decisoes_ola.html ├── registro_mudancas_ola.html └── registro_aprendizados_projeto.html
Observação: as subpastas historico/, acompanhamento/ e registros/ só devem ser criadas quando houver volume suficiente para justificar a separação física.

6. Regras de nomeação

A nomeação dos arquivos deve ser previsível, sem acentos, sem espaços e semanticamente clara.

Tipo de página Padrão sugerido Exemplo
Índice da área index_projeto.html Página de entrada da pasta projeto/
Mapa da área mapa_projeto.html Página âncora conceitual e relacional
Organização da área organizacao_projeto.html Página com critérios físicos e operacionais
Página conceitual tema_especifico_ola.html ciclo_vida_solucao_ola.html
Página de acompanhamento acompanhamento_tema_ola.html acompanhamento_entregas_ola.html
Página de registro registro_tema_ola.html registro_decisoes_ola.html
Página histórica historico_tema_ola.html historico_projeto_ola.html
Regra curta: nomes de arquivos devem indicar claramente a função da página e seu objeto de tratamento.

7. Classificação das páginas da pasta projeto/

Cada página em projeto/ deve poder ser classificada por tipo, função e nível de abstração.

Arquivo Tipo Função Nível predominante
index_projeto.html Índice Entrada principal e catálogo da área M1 / M2
mapa_projeto.html Mapa Relações, fluxo e posição semântica M2
organizacao_projeto.html Organização Critérios físicos, lógicos e operacionais M2 / M1
visao_geral.html Visão Explica o OLA como empreendimento M3 / M2
metodo.html Método Explica como o OLA é desenvolvido M2
escopo_ola.html Escopo Define limites evolutivos e abrangência atual M2 / M1
entregas_ola.html Entregas Organiza produtos, artefatos e resultados M1 / M0
ciclo_vida_solucao_ola.html Ciclo de vida Mostra transformação de necessidade em valor M2
decisoes_projeto_ola.html Registro Preserva rastreabilidade de decisões M1 / M0
índice mapa organização visão método escopo entrega decisão evolução valor

8. Regras operacionais da pasta projeto/

As regras abaixo ajudam a manter a pasta coerente, compreensível e integrada ao restante do OLA.

Projeto significa empreendimento evolutivo

Toda página da pasta deve respeitar o entendimento de projeto/ como área que organiza a condução do OLA enquanto empreendimento evolutivo.

Não confundir projeto com governança

A pasta projeto/ pode mencionar regras e critérios, mas a formalização normativa deve ser registrada em governanca/.

Não confundir projeto com arquitetura

A pasta projeto/ registra a condução e evolução; a pasta arquitetura/ registra componentes, relações, funcionalidades e estrutura da solução.

Toda entrega relevante deve ser rastreável

Uma entrega importante deve poder ser relacionada à sua necessidade, decisão, integração, uso, manutenção e evolução.

O índice deve ser atualizado quando nova página estrutural for criada

Páginas estruturais novas devem ser referenciadas em index_projeto.html.

O mapa deve ser atualizado quando houver nova relação conceitual

Se uma página alterar a compreensão do papel do projeto no OLA, ela deve ser refletida em mapa_projeto.html.

A organização deve ser atualizada quando houver novo padrão operacional

Se surgir novo tipo de página, nova subpasta ou novo critério de nomeação, esta página deve ser atualizada.

9. Integração com outras áreas

A pasta projeto/ não deve funcionar isolada. Ela é uma área de condução e precisa manter vínculos com governança, arquitetura, fundamentos, sistema, domínios e aprendizagem.

Quando acontecer... Atualizar também... Motivo
Criação de nova página estrutural em projeto/ index_projeto.html Manter o catálogo da área atualizado.
Nova relação entre projeto e outra área mapa_projeto.html Manter o mapa semântico coerente.
Nova regra ou critério normativo governanca/quadro_regras_ola.html Formalizar a regra no lugar adequado.
Nova decisão arquitetural arquitetura/index_arquitetura.html e mapas relacionados Registrar impacto estrutural da solução.
Nova base conceitual relevante fundamentos/index_fundamentos.html Conectar a decisão a seus fundamentos.
Nova demanda por área de conhecimento dominios/index_dominios.html Instanciar o conhecimento no domínio correto.
Nova trilha ou objeto de aprendizagem aprendizagem/index_aprendizagem.html Conectar a entrega ao processo educacional.
Regra de integração: toda mudança relevante em projeto/ deve ser avaliada quanto ao impacto em governança, arquitetura, fundamentos, sistema, domínios e aprendizagem.

10. Manutenção e evolução da pasta projeto/

A pasta projeto/ deve acompanhar a evolução do próprio OLA. Por isso, sua manutenção não é apenas técnica; é também conceitual e semântica.

Manutenção técnica

Corrigir links, caminhos relativos, responsividade, layout, acessibilidade, impressão e compatibilidade entre dispositivos.

Manutenção conceitual

Atualizar conceitos, definições, classificações, distinções e relações conforme o OLA amadurece.

Manutenção estrutural

Reorganizar páginas, subpastas, índices e mapas quando houver crescimento ou mudança de função.

Evolução sistêmica

Incorporar novos ciclos, novas entregas, novos padrões, novas decisões e novas formas de geração de valor.

Critério de revisão: sempre que o entendimento do OLA mudar de patamar, a pasta projeto/ deve ser revisada para refletir essa mudança.

11. Checklist para criar nova página em projeto/

Antes de criar uma nova página dentro de projeto/, use o checklist abaixo.

Checklist semântico
  • A página trata do OLA como empreendimento evolutivo?
  • Ela está relacionada a visão, método, escopo, entrega, decisão, ciclo de vida, evolução ou valor?
  • Ela não pertence mais diretamente à governança, arquitetura, fundamentos, sistema, domínios ou aprendizagem?
  • O objeto da página está claro?
  • O problema resolvido está explícito?
Checklist estrutural
  • O nome do arquivo está sem acentos, sem espaços e com sentido claro?
  • A página possui breadcrumb físico e semântico?
  • A página possui links para index_projeto.html e, se necessário, para mapa_projeto.html?
  • As tabelas largas possuem rolagem horizontal?
  • O layout é responsivo para celular, tablet, desktop e TV?
Checklist de integração
  • É preciso atualizar index_projeto.html?
  • É preciso atualizar mapa_projeto.html?
  • É preciso criar ou atualizar regra em governanca/?
  • Há impacto em arquitetura/, fundamentos/, sistema/, dominios/ ou aprendizagem/?
  • A entrega precisa ser registrada em página de decisões, entregas ou evolução?

12. Próximos passos

Com esta página, a tríade da pasta projeto/ fica estabelecida:

Próximo desdobramento recomendado: criar ou atualizar projeto/ciclo_vida_solucao_ola.html, pois ele detalha o miolo do projeto: necessidade, objeto, análise, projeto, design, implementação, implantação, operação, manutenção, evolução e valor.