3.3 KiB
3.3 KiB
Diretrizes do Projeto - Gestão de Manutenção
Leitura Obrigatória da Documentação
- Consulta Prévia: Antes de planejar, pesquisar ou implementar qualquer alteração, a IA deve sempre consultar a documentação relevante contida no diretório
documentacao/(comoarquitetura_do_sistema.md,fluxo_de_dados_e_sincronizacao.md,recursos_simulados_e_truncados.md) e noREADME.md. - Alinhamento Arquitetural: Certifique-se de compreender os padrões arquiteturais offline-first, sincronização, modelos de dados e restrições descritas na documentação antes de propor ou alterar o código.
Atualização Pós-Modificação
- Manutenção da Documentação: Sempre que forem feitas modificações importantes no código (ex.: novas funcionalidades, refatoração de arquitetura, novos fluxos de sincronização, alterações em modelos de dados ou Room DAO/Database, adição de configurações), a IA deve obrigatoriamente atualizar os documentos correspondentes no diretório
documentacao/ou noREADME.md. - Sincronia Código x Docs: A documentação deve refletir com exatidão as mudanças realizadas para evitar inconsistências e garantir a evolução contínua do projeto.
Controle de Versionamento Obrigatório e Atualização do Changelog
- Incremento de Versão e Registros no Changelog: Sempre que for feita qualquer modificação no código-fonte, correções de bugs, refatoração ou adição de novas funcionalidades no software, a IA deve obrigatoriamente incrementar a versão do aplicativo e atualizar o histórico no arquivo
CHANGELOG.md. - Lista de Arquivos Obrigatórios a Serem Alterados:
app/build.gradle.kts: IncrementarversionCode(ex.: de2para3) e atualizarversionNameseguindo o Semantic Versioning (ex.:1.1.0->1.1.1para correções/patches ou1.2.0para novas funcionalidades).CHANGELOG.md: Criar o bloco da nova versão com data no formato## [X.Y.Z] - YYYY-MM-DDe descrever detalhadamente todas as mudanças nas subseções apropriadas (### Adicionado,### Corrigido,### Alterado,### Removido).app/src/main/java/com/example/util/DeviceUtils.kt: Atualizar as strings padrão de fallback de versão dentro do métodogetAppVersion.README.md: Atualizar o número da Versão Atual na lista de documentação técnica do projeto.