João Henrique
b9bf3b2863
criado repositório jhonny-editor no Gitea adicionado script admin/deploy.command com commit automático atualizado admin/DEV-NOTES.md com template limpo Resumo: - 48 arquivos alterados - 26 novos - 19 modificados - 3 removidos 22 files changed, 658 insertions(+), 568 deletions(-) Arquivos: - AGENTS.md - admin/DEV-NOTES.md - admin/OpenCut.command - admin/commit.command - admin/deploy.command - admin/update.command - code/cep-plugin/index.html - code/cep-plugin/main.js - code/cep-plugin/styles.css - code/engine/ARQUITETURA.md - code/engine/arquitetura/README.md - code/engine/gerar_relatorio_timeline.py - code/engine/integracoes/apple_speech/apple_speech_transcriber.swift - code/engine/integracoes/apple_speech/provider_de_transcricao_apple.py - code/engine/integracoes/midia/__init__.py - code/engine/integracoes/whisper/provider_de_transcricao_local.py - code/engine/scanner/__init__.py - code/engine/scanner/coordenacao/__init__.py - code/engine/scanner/descoberta/__init__.py - code/engine/scanner/modelos.py - code/engine/scanner/transcricao_da_timeline.py - code/src/tools/discovery.ts - :memory:.ses - admin/Jhonny.command - admin/inativos/OpenCut.command - admin/inativos/update.command - code/docs/glossario-analise-emocional.md - code/docs/levantamento-apple-vision-e-apple-intelligence.md - code/docs/levantamento-ferramentas-analise-visual-local.md - code/engine/arquitetura/biblioteca-inteligente-de-videos.md - code/engine/executar_scanner.py - code/engine/integracoes/huggingface/ - code/engine/integracoes/midia/extracao_de_metadados.py - code/engine/integracoes/visual/ - code/engine/requirements-visual.txt - code/engine/scanner/configuracao_visual.py - code/engine/scanner/descoberta/descoberta_de_arquivos.py - code/engine/scanner/metadados.py - code/engine/scanner/relatorio_visual.py - code/engine/scanner/retakes/ - code/engine/scanner/visual.py - code/engine/testes/test_analise_visual_local.py - code/engine/testes/test_arquivos_e_metadados.py - code/engine/testes/test_provider_de_transcricao_apple.py - code/relatorios/analise-brools/ - code/relatorios/analise-visual/ - code/relatorios/audio/arquivos/ - code/relatorios/transcricao-timeline.md
1.9 KiB
1.9 KiB
Arquitetura do Sistema
Esta pasta concentra a especificação arquitetural do novo sistema Python orientado a objetos.
Objetivo
Documentar previamente:
- a estrutura geral do sistema;
- os módulos e submódulos;
- as responsabilidades de cada classe;
- o que cada classe não deve fazer;
- os fluxos entre os módulos;
- as regras de dependência e integração;
- as decisões arquiteturais do projeto.
Regra de nomenclatura
Todos os nomes de módulos, classes, métodos, funções e variáveis serão sempre em PT-BR.
Organização da documentação
Cada módulo principal deverá possuir um documento próprio nesta pasta.
arquitetura/
├── README.md
├── scanner.md
├── biblioteca-inteligente-de-videos.md
├── integracao-com-premiere.md
├── leitura-da-timeline-via-mcp.md
├── plano-primeira-etapa-scanner-e-mcp.md
├── planos-proximas-etapas.md
├── analisador-de-conteudo.md
├── motor-de-decisao.md
├── gerador-de-plano-de-edicao.md
├── aplicador-de-plano.md
├── validador.md
├── providers-de-ia.md
├── modelo-de-dominio.md
├── persistencia.md
├── configuracao.md
├── logging.md
└── testes.md
Os documentos serão criados conforme cada módulo for projetado. Não devemos escrever código de implementação antes de definir sua arquitetura neste diretório.
Princípios gerais
- O domínio deve ser independente de infraestrutura e de ferramentas externas.
- Cada módulo deve ter uma responsabilidade clara.
- As dependências devem ser recebidas por abstrações bem definidas.
- Integrações externas devem ser implementadas por adaptadores substituíveis.
- O fluxo entre módulos deve ser explícito e documentado.
- Cada classe deve declarar suas responsabilidades e suas proibições.
- O sistema deve ser testável sem depender de serviços externos reais.