149 lines
4.6 KiB
Markdown
149 lines
4.6 KiB
Markdown
---
|
|
layer: wiki
|
|
type: Document
|
|
title: "Ciclo de Vida de Projecto — Sequência Obrigatória"
|
|
description: >-
|
|
Sequência canónica de todas as fases de um projecto Descomplicar — da ideia
|
|
ao deploy. Obrigatória para todos os projectos, com ou sem código.
|
|
tags: [projecto, ciclo-vida, sequencia, obrigatorio, spec, brainstorming, deploy]
|
|
timestamp: 2026-06-29T23:00:00+01:00
|
|
status: active
|
|
---
|
|
|
|
# Ciclo de Vida de Projecto — Sequência Obrigatória
|
|
|
|
> **Regra de ouro:** Nunca saltar fases. Cada fase produz um artefacto concreto.
|
|
> Sem artefacto → fase não concluída → não avançar.
|
|
|
|
---
|
|
|
|
## A Sequência
|
|
|
|
```
|
|
1. IDEIA
|
|
↓
|
|
2. BRIEFING
|
|
↓
|
|
3. PESQUISA ← obrigatória (Web + NLM + Mem0 + Wiki)
|
|
↓
|
|
4. BRAINSTORMING
|
|
↓
|
|
5. SPEC (aprovada por Emanuel)
|
|
↓
|
|
6. PLAN (validado antes de tocar em código)
|
|
↓
|
|
7. REPO GIT (se projecto com código)
|
|
↓
|
|
8. IMPLEMENTAÇÃO
|
|
↓
|
|
9. CI/CD (se aplicável — paralelo ao deploy)
|
|
↓
|
|
10. DEPLOY
|
|
```
|
|
|
|
---
|
|
|
|
## Detalhe por Fase
|
|
|
|
### 1. Ideia
|
|
- Capturar em `00-Inbox/` do Hub ou comentário Desk
|
|
- **Artefacto:** nota de ideia (1 parágrafo mínimo)
|
|
|
|
### 2. Briefing
|
|
- Definir: contexto, problema, objectivo, stakeholders, restrições
|
|
- Registar no Desk CRM como tarefa ou ticket
|
|
- **Artefacto:** `docs/SPECS/BRIEF.md` ou comentário Desk
|
|
|
|
### **3. Pesquisa — OBRIGATÓRIA** ⚠️
|
|
Antes de qualquer decisão de arquitectura ou implementação:
|
|
|
|
| Fonte | O que pesquisar |
|
|
|-------|----------------|
|
|
| **Web** | Estado da arte, soluções existentes, benchmarks |
|
|
| **NotebookLM** | Notebooks temáticos relevantes |
|
|
| **Mem0** | `search_memories("contexto do projecto")` — o que já sabemos |
|
|
| **Wiki IJFW** | Conhecimento curado existente |
|
|
| **Hub** | PROCs, QRs, decisões anteriores relacionadas |
|
|
|
|
> **Regra:** Se a pesquisa revelar que a solução já existe → usar o que existe, não reinventar.
|
|
- **Artefacto:** notas de pesquisa em `docs/` ou resumo no BRIEF
|
|
|
|
### 4. Brainstorming
|
|
- Explorar abordagens alternativas
|
|
- Avaliar trade-offs com evidência da pesquisa
|
|
- Envolver Mem0 para contexto de decisões passadas
|
|
- **Artefacto:** `docs/PLANS/BRAINSTORM.md` com opções e decisão
|
|
|
|
### 5. SPEC
|
|
- Especificação completa: arquitectura, componentes, interfaces, critérios de aceitação
|
|
- **Aprovação explícita por Emanuel antes de avançar**
|
|
- **Artefacto:** `docs/SPECS/SPEC.md` com status `approved`
|
|
|
|
### 6. Plan
|
|
- Plano de implementação detalhado: fases, tarefas, dependências, estimativas
|
|
- Validação humana antes de tocar em código
|
|
- Registar tarefas no Desk CRM
|
|
- **Artefacto:** `docs/PLANS/PLAN.md` + tarefas Desk
|
|
|
|
### 7. Repo Git
|
|
- Criar repositório em `git.descomplicar.pt` (Gitea)
|
|
- Seguir PROC INF-EZP-001 para deploy no EasyPanel
|
|
- Configurar `.desk-project` na raiz
|
|
- **Artefacto:** repo criado, README.md inicial, estrutura XDP-PRJ-001
|
|
|
|
### 8. Implementação
|
|
- Seguir o PLAN por fases
|
|
- Registar progresso em `MEMORY.md` por sessão
|
|
- Cada decisão arquitectural → comentário Desk
|
|
- **Artefacto:** código funcional + testes
|
|
|
|
### 9. CI/CD *(se aplicável)*
|
|
- Configurar via Gitea Actions → EasyPanel webhook
|
|
- Ver `PROC-Gitea-Runners-CICD.md`
|
|
- **Artefacto:** pipeline funcional com deploy automático
|
|
|
|
### 10. Deploy
|
|
- Seguir PROC INF-EZP-001 (EasyPanel) ou PROC adequado
|
|
- Validar com E2E após deploy
|
|
- Actualizar `STATUS.md` → estado `deployed`
|
|
- **Artefacto:** serviço em produção + STATUS.md actualizado
|
|
|
|
---
|
|
|
|
## Artefactos por Fase (resumo)
|
|
|
|
| Fase | Artefacto obrigatório |
|
|
|------|----------------------|
|
|
| Ideia | Nota capturada |
|
|
| Briefing | BRIEF.md ou comentário Desk |
|
|
| **Pesquisa** | **Notas de pesquisa (Web + NLM + Mem0 + Wiki)** |
|
|
| Brainstorming | BRAINSTORM.md com decisão |
|
|
| SPEC | SPEC.md aprovada |
|
|
| Plan | PLAN.md + tarefas Desk |
|
|
| Repo Git | Repositório Gitea + estrutura |
|
|
| Implementação | Código + testes + MEMORY.md |
|
|
| CI/CD | Pipeline funcional |
|
|
| Deploy | Serviço em produção + STATUS.md |
|
|
|
|
---
|
|
|
|
## Anti-Padrões (proibido)
|
|
|
|
- ❌ Começar a implementar sem SPEC aprovada
|
|
- ❌ Saltar a pesquisa — "já sei o que fazer"
|
|
- ❌ Deploy sem testes passados
|
|
- ❌ Criar repositório antes do PLAN estar validado
|
|
- ❌ Reinventar o que já existe (Mem0 evita isto)
|
|
|
|
---
|
|
|
|
## Referências
|
|
|
|
- `PROC-Estrutura-Pasta-Projecto.md` (XDP-PRJ-001) — ficheiros obrigatórios por pasta
|
|
- `06-Operacoes/Procedimentos/D7-Tecnologia/Infraestrutura/PROC-EasyPanel-Deployment.md` — deploy
|
|
- `06-Operacoes/Procedimentos/D7-Tecnologia/Infraestrutura/PROC-Gitea-Runners-CICD.md` — CI/CD
|
|
|
|
---
|
|
|
|
*Criado: 29-06-2026 | Descomplicar® | Sequência obrigatória para todos os projectos*
|