Filosofia e documentação

Quando trabalhei para a Control Data (na verdade, uma subsidiária), cada esquema recebia um número de identificação simples, organizado em ordem crescente. O mesmo acontecia com desenhos mecânicos e placas de circuito impresso. Embora eu tenha trabalhado no departamento de documentação, devo admitir que não me lembro como todos eles se juntaram para criar o minicomputador em que estávamos trabalhando.

Naquela época, tudo era gerado à mão - o esquema era desenhado e entregue ao departamento de desenho e eles o transpunham para pergaminho (também papel vegetal, embora para leitores mais jovens ambos os conceitos possam ser tão estranhos quanto papel carbono) usando símbolos padrão frequentemente alcançar uniformidade usando estênceis. Um desenhista especialista faria o layout do PCB usando ponto e fita e um engenheiro mecânico criaria a embalagem em uma mesa de desenho. A comunicação interna era feita por meio de memorandos, relatórios, reuniões e, é claro, interação individual. Fiz um blog sobre minhas memórias de como as coisas eram “Como era:Layout de PCB de Rubylith a ponto e fita a CAD”.

À medida que o design auxiliado por computador melhorou, os desenhos tornaram-se eletrônicos com uma trilha de papel, mas era apenas uma maneira mais conveniente de implementar o status quo na documentação. No que dizia respeito ao PCB, o esquema era apenas uma forma de obter a netlist. O desenho mecânico precisava de uma ou duas etapas para converter a saída do PCB em um arquivo .dxf para importar para o Autocad. Foi fácil separar e categorizar as diferentes saídas de documentos.

Os produtos nos quais trabalho são construídos em estágios, portanto, existem subconjuntos. Sempre nos preocupamos com isso. Vamos supor que temos vários builds usando diferentes componentes. Na hierarquia de documentação, há um ponto onde há uma construção parcial que é um antecedente comum. A que nível pertence o esquema? Ele reside no nível mais antigo, onde não há valores de componente atribuídos ou há um esquema único em cada um dos níveis superiores com a exibição do valor do componente selecionado. Até certo ponto, a escolha pode ser determinada para que o esquema está sendo usado:está sendo usado para depurar o sistema, está fornecendo uma visão geral para a produção ou está sendo usado para serviço.

Ao longo dos anos, o sistema de documentação do meu empregador evoluiu de forma inconsistente e aleatória. Visto que várias pessoas o influenciaram e eles trouxeram sua experiência de outras organizações, presumo que alguns elementos serão familiares a todos vocês. Um princípio fundamental que tentei implementar foi retirado da indústria aeroespacial. Existe apenas um documento e não pode existir em dois lugares, pois manter mais de um é complicado e sujeito a erros.

Figura 1. Um dos produtos um pouco mais complexos que fabricamos. A lista de materiais completa do produto para A inclui desenhos que cobrem as etiquetas laterais (B), o alojamento (C), os desenhos para o painel frontal (D), os conectores de encaixe e os desenhos para a etiquetagem no conector (E &F), o subconjunto (G) e não mostrado, os documentos para o firmware a ser programado no micro em G. A embalagem também é adicionada. O subconjunto consiste em um PCB e todos os componentes montados nele. Onde na hierarquia colocamos o esquema? (Fonte:Autor)

Cada produto que fabricamos possui um número de identificação (em sua maioria alocado sequencialmente) que chamamos de “número de catálogo”. Todos os documentos em seu nível (nível superior) na hierarquia são compostos por um prefixo de letra, o número do catálogo e um sufixo da revisão. Por exemplo, o esquema (rev C) do número de catálogo de 330924 seria W330924C, o desenho mecânico (ref F) seria M330924F e o BOM (rev G) seria P330924G. Se houver um subconjunto, ele seria alocado com seu próprio número sequencial (por exemplo, SB00123) e os documentos necessários para esse nível seriam numerados de acordo com o uso da mesma ideia de um prefixo-SB00123-sufixo. Os documentos só estão presentes quando necessários, e o esquema, por exemplo, iria afundar ao nível do antecedente comum. Os valores dos componentes que podem mudar nas construções são marcados com um símbolo que indica que o valor está definido na lista de materiais. As montagens mecânicas e o firmware seguem a mesma ideia. Da mesma forma, o PCB obtém um número sequencial e uma revisão - sem prefixos.

Mas o mundo do CAD mudou e o enigma se tornou mais enigmático. Pacotes como o Altium integram muitos aspectos do design. O esquema, PCB, desenho de montagem, mecânico e possivelmente até firmware fazem parte do mesmo ambiente de design. Tanto é verdade que nosso desenhista insiste que o PCB é a manifestação física do esquema e, portanto, ambos devem estar sempre em sincronia usando a mesma revisão. Portanto, se o valor de um componente mudar, a revisão do PCB deve mudar! O que você faz? E, além disso, qual é o número alocado para os desenhos esquemáticos, de montagem e mecânicos que são modificados sempre que o PCB é alterado (incluindo coisas possivelmente triviais como atualizações de tela de seda)? Onde eles se encontram na hierarquia - estão associados ao número de catálogo ou ao número do PCB? E onde você os arquiva para que, quando um engenheiro atualiza um desenho, o desenhista trabalhe a partir do desenho alterado e não daquele automaticamente armazenado como parte do pacote PCB? AJUDA!

Alguém conhece um sistema que seja moderno, consistente e se possível descrito em algum lugar para que eu possa tentar atualizar nosso sistema? Alguém conhece algum aluno de PhD em filosofia procurando material para sua tese? Por favor, adicione suas idéias e descrições de sua experiência abaixo.