# Contexto de Trabalho - Jean / FastApp

Este documento registra o modo generico de trabalho no projeto FastApp.
Ele deve servir para qualquer sprint, sem depender de uma feature especifica.

## Principios

- O FastApp e um construtor de apps orientado por objetos em JSON.
- Objetos viram CRUDs, views, formularios, automacoes, dados e experiencias
  dinamicas.
- A IA deve entender o sistema antes de implementar: ler a Task 1 da sprint,
  arquitetura, schemas, componentes dinamicos e APIs relevantes.
- O desenvolvimento segue Spec Driven Development, mas as tasks executaveis da
  sprint vivem no Task Board dinamico da FastApp.
- A partir deste fluxo, o contexto especifico da sprint deve estar na Task 1 do
  Task Board. Nao criar arquivos de sprint como `docs/<sprint>/CONTEXT.md` ou
  `docs/<sprint>/SPEC.md`, salvo se o usuario pedir explicitamente.
- A Task 1 deve conter tudo que a IA precisa para entender a sprint: objetivo,
  arquivos a ler, arquitetura impactada, regras, riscos, criterios de aceite e
  plano macro.

## Fluxo de Sprint

1. Criar branch a partir da `main`, com nome `feat/<nome-da-sprint>`.
2. Conferir `git status --short --branch` antes de qualquer alteracao.
3. Ler `docs/jean/CONTEXTO.md`, `docs/jean/PROMPTSTART` e a Task 1 da sprint.
4. Criar cards no Task Board com titulo, descricao completa e prompt otimizado.
5. Ao criar/mover cards, respeitar o painel de Comunicados. Cards nao devem ser
   inseridos de forma silenciosa sem disparar regras configuradas.
6. Mover a task para `EM_ANDAMENTO` antes de implementar.
7. Fazer commits pequenos e claros na branch da sprint.
8. Fazer push para o GitHub a cada entrega importante.
9. Ao concluir uma task, mover o card para `CONCLUIDA` e garantir notificacao.
10. Ao fim da sprint, trazer `main` para a branch, validar, levar a sprint para
    `main` e criar release quando o usuario pedir.

## Task Board

- App: `task-board`.
- Objeto: `task_item`.
- Cards devem ter prefixo da sprint, por exemplo:
  `[Nome Sprint] Task 1 - Contexto e arquitetura`.
- A Task 1 e obrigatoria e deve ser o contexto completo da sprint.
- O contexto da sprint deve ficar no corpo da Task 1, nao em arquivo separado.
- As demais tasks devem quebrar a entrega em blocos pequenos e commitaveis.
- Status padrao:
  - `BACKLOG`
  - `TODO`
  - `EM_ANDAMENTO`
  - `CONCLUIDA`
- Sempre preencher:
  - `titulo`
  - `descricao`
  - `prompt_otimizado`
  - `feature`
  - `taxonomia_n1`
  - `taxonomia_n2`
  - `taxonomia_n3`
  - `prioridade`
  - `status`
  - `ordem`
  - `app_origem_id`

## Comunicados

O painel de Comunicados e parte do fluxo de trabalho.

- Criacao de card deve notificar.
- Update de card deve notificar.
- Mudanca para `TODO`, `EM_ANDAMENTO` e `CONCLUIDA` deve notificar por regra
  especifica.
- Update generico deve enviar email tipo "Seu card foi atualizado" com resumo
  do que mudou.
- Se uma operacao precisar ser feita via script, o script deve reproduzir as
  regras ativas de `comunicado_config`.

## Commits

- Commits devem ser pequenos, rastreaveis e associados a uma task.
- Mensagens recomendadas:
  - `docs: add working process context`
  - `feat: add <capability>`
  - `test: cover <behavior>`
  - `docs: finalize <sprint> handoff`
- Depois de cada commit importante, fazer `git push origin <branch>`.

## Como a IA Deve Agir

- Trabalhar de forma autonoma quando a tarefa estiver clara.
- Buscar contexto no repo antes de assumir arquitetura.
- Usar padroes existentes do FastApp em vez de criar uma arquitetura paralela.
- Preferir `rg` para buscas.
- Usar `apply_patch` para edicoes manuais.
- Nao reverter alteracoes do usuario.
- Validar com testes disponiveis.
- Reportar claramente quando `npm run build` ou outro comando nao concluir.
- Manter o usuario informado com updates curtos durante trabalhos longos.

## Arquivos Para Entender a FastApp

Leia estes arquivos antes de iniciar uma sprint que mexe em objetos, CRUDs,
formularios, CMS, API dinamica ou automacoes:

- `package.json`
- `ARCHITECTURE.md`
- `app/types/schema.ts`
- `app/pages/[app]/[module]/[object]/index.vue`
- `app/pages/[app]/[module]/index.vue`
- `app/components/core/DynamicCRUD.vue`
- `app/components/core/DynamicForm.vue`
- `app/components/core/DynamicTable.vue`
- `app/components/core/DynamicList.vue`
- `app/components/core/DynamicKanban.vue`
- `app/components/core/FieldRenderer.vue`
- `app/components/core/PropertyField.vue`
- `app/components/core/cms/CoreCmsRenderer.vue`
- `app/composables/useCmsBinding.ts`
- `server/api/v1/data/[app]/[object]/index.get.ts`
- `server/api/v1/data/[app]/[object]/index.post.ts`
- `server/api/v1/data/[app]/[object]/[id].patch.ts`
- `server/utils/dynamic-db.ts`
- `server/utils/query-parser.ts`
- `server/utils/meta-resolver.ts`
- `server/utils/meta-validation.ts`
- `server/utils/rbac-data-scope.ts`
- `server/utils/data-source-resolver.ts`
- `server/utils/comunicado-dispatcher.ts`
- `task-board-app.json`

## Task 1 Como Fonte De Contexto

Toda sprint deve ter uma Task 1 dedicada a contexto. Ela deve responder:

- Qual e o objetivo da sprint?
- Por que isso importa para o produto?
- Quais arquivos a IA deve ler antes de implementar?
- Quais objetos, componentes, APIs e schemas podem ser impactados?
- Quais decisoes tecnicas ja estao assumidas?
- Quais duvidas ou riscos precisam ser resolvidos?
- Quais sao os criterios de aceite da sprint?
- Quais sao as tasks seguintes e a ordem sugerida?

Se a sessao cair, se outra IA assumir ou se houver perda de contexto, a IA deve
retomar lendo `docs/jean/CONTEXTO.md`, `docs/jean/PROMPTSTART` e a Task 1 da
sprint no Task Board.