# Donc -- Documentacao

Documentacao tecnica da plataforma Donc (Field Service Management).

## Estrutura

```
docs/
├── README.md                          ← este arquivo
├── architecture/                      ← arquitetura e visao estrategica
│   ├── visao-geral.md                 ← arquitetura IA-First, etapas, stack
│   └── repositorio-ia-first.md        ← como estruturar repositorio para LLMs
├── app/                               ← app mobile (DoncMobile)
│   ├── arquitetura.md                 ← guia MVVM, BaseViewModel, DI, Refit
│   ├── release-android.md             ← passo a passo de release Android
│   └── api-mobile.md                  ← arquitetura da API mobile (Dapper)
├── integrations/                      ← integracao com ERPs e APIs externas
│   ├── guia-integracao-jobs.md        ← API de criacao de Jobs (endpoints, payloads)
│   ├── api-agendamento.md             ← API de agendamento (disponibilidade + reserva)
│   ├── api-agendamento-proximo-dia.md ← API consulta agendamentos D+1
│   ├── webhooks.md                    ← webhooks: acoes, payload, configuracao
│   └── clientes.md                   ← integracoes por cliente (Berlanda, Koerich, LojasMM, Multiloja, Osirnet)
├── sprints/                           ← backlog + changelog por sprint
│   └── sprint-9.md
└── templates/                         ← templates e prompts
    └── prompt-padrao-documentacao.md  ← template padrao para gerar docs
```

## Convencoes

- **Formato:** 100% Markdown -- sem PDFs, sem HTML, sem DOCX
- **Idioma:** Portugues (BR), sem acentos nos nomes de arquivo
- **Nomes de arquivo:** kebab-case, sem espacos, sem caracteres especiais
- **Sprints:** um arquivo por sprint com backlog + changelog, organizado por data (mais recente primeiro)

## Links rapidos

### Arquitetura
- [Visao geral e plano de execucao](architecture/visao-geral.md)
- [Repositorio IA-First](architecture/repositorio-ia-first.md)

### App Mobile
- [Arquitetura do App MAUI](app/arquitetura.md)
- [Guia de Release Android](app/release-android.md)
- [Arquitetura da API Mobile](app/api-mobile.md)

### Integracoes
- [Guia de Integracao de Jobs (API)](integrations/guia-integracao-jobs.md)
- [API de Agendamento](integrations/api-agendamento.md)
- [API de Agendamento Proximo Dia](integrations/api-agendamento-proximo-dia.md)
- [Webhooks](integrations/webhooks.md)
- [Integracoes por Cliente](integrations/clientes.md) -- Berlanda, Koerich, LojasMM, Multiloja, Osirnet

### Sprints
- [Sprint 9](sprints/sprint-9.md)