120 lines
2.8 KiB
Markdown
120 lines
2.8 KiB
Markdown
---
|
|
layer: wiki
|
|
title: PROC-DEV-STANDARD — Referência Rápida
|
|
description: >-
|
|
> Este ficheiro é um resumo/índice do PROC-DEV-STANDARD.md completo
|
|
type: Reference
|
|
code: D7-SIS-006
|
|
date: 2026-05-16
|
|
timestamp: 2026-05-16T00:00:00+01:00
|
|
tags: [protocolo, referência, desenvolvimento]
|
|
---
|
|
|
|
# PROC-DEV-STANDARD — Referência Rápida
|
|
|
|
> Este ficheiro é um resumo/índice do PROC-DEV-STANDARD.md completo.
|
|
> **Versão completa:** `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/Sistema/PROC-DEV-STANDARD.md`
|
|
|
|
---
|
|
|
|
## Código & Versão
|
|
|
|
- **Código:** D7-SIS-006
|
|
- **Versão:** 1.0
|
|
- **Data:** 2026-05-16
|
|
|
|
---
|
|
|
|
## Princípios Core
|
|
|
|
1. Pesquisa antes de spec
|
|
2. Spec antes de código
|
|
3. CI verde é gate obrigatório
|
|
4. Issue-First para bugs
|
|
5. Contexto partilhado (MEMORY.md + STATUS.md)
|
|
6. Causa raiz — resolver sempre a causa, não o sintoma
|
|
|
|
---
|
|
|
|
## Fluxo Completo
|
|
|
|
```
|
|
Ideia → Pesquisa → Spec → Plan → Desenvolvimento → Quality Gates → Code Review → Deploy
|
|
```
|
|
|
|
---
|
|
|
|
## Estrutura Obrigatória de Projecto
|
|
|
|
```
|
|
docs/
|
|
├── PLANS/ # Planos de implementação
|
|
├── SPECS/ # Specs + notas de pesquisa
|
|
└── audit/ # Auditorias (se activo)
|
|
├── audit.md
|
|
├── security.md
|
|
├── tech-debt.md
|
|
└── findings/
|
|
|
|
AGENTS.md, CHANGELOG.md, MEMORY.md, STATUS.md, .desk-project
|
|
```
|
|
|
|
---
|
|
|
|
## Ficheiros Cross-Agent
|
|
|
|
| Ficheiro | Acção no Início | Acção no Fim |
|
|
|----------|-----------------|--------------|
|
|
| `MEMORY.md` | Ler/Criar | Escrever decisão |
|
|
| `STATUS.md` | Ler/Criar | Actualizar estado |
|
|
| `CHANGELOG.md` | — | Actualizar versão |
|
|
|
|
---
|
|
|
|
## 8 Fases do Desenvolvimento
|
|
|
|
| Fase | Input | Output |
|
|
|------|-------|--------|
|
|
| 1. Ideia | Pedido | Decisão avançar |
|
|
| 2. Pesquisa | Âmbito | `docs/SPECS/research-*.md` |
|
|
| 3. Spec | Nota pesquisa | `SPEC.md` aprovado |
|
|
| 4. Plan | Spec | `docs/PLANS/YYYY-MM-DD-*.md` |
|
|
| 5. Desenvolvimento | Plano | Commits atómicos |
|
|
| 6. Quality Gates | Código | CI verde |
|
|
| 7. Code Review | PR | Aprovação |
|
|
| 8. Deploy | PR merge | Produção |
|
|
|
|
---
|
|
|
|
## Gitea vs Desk CRM
|
|
|
|
| Gitea | Desk CRM |
|
|
|-------|----------|
|
|
| Bugs, issues, PRs, código | Projectos, sprints, tempo, facturação |
|
|
|
|
---
|
|
|
|
## Auditoria (PROC-AUDIT-STANDARD — D7-SIS-007)
|
|
|
|
| Tipo | Frequência | Gatilho |
|
|
|------|------------|---------|
|
|
| AUDIT-CODE | Mensal | Pre-deploy prod |
|
|
| AUDIT-SEC | Mensal | Pre-deploy prod |
|
|
| AUDIT-ECO | Trimestral | Mudança agente |
|
|
| AUDIT-PROJ | Semanal/sprint | Início sprint |
|
|
|
|
**Ver:** `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/Sistema/PROC-AUDIT-STANDARD.md`
|
|
|
|
---
|
|
|
|
## Referências
|
|
|
|
- `PROC-DEV-STANDARD.md` — D7-SIS-006 (completo)
|
|
- `PROC-AUDIT-STANDARD.md` — D7-SIS-007
|
|
- `PROC-DEPLOY-STANDARD.md` — D7-SIS-005
|
|
- `ECOSYSTEM.md` — regras partilhadas
|
|
|
|
---
|
|
|
|
**Modelo-Organizacao-Proc-Dev** — Template canónico
|
|
**Desk CRM:** Task #2134 |