termo_core 0.1.6 → 0.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2,816 +2,107 @@ import type * as tipos from "./tipos.js";
2
2
  import type { CredencialDeAcesso } from "../base/credencial.js";
3
3
  import { type OpcoesDaChamada } from "../base/requisicao.js";
4
4
  /**
5
- * Parâmetros de consulta e de cabeçalho de `/anexo/filtro`.
5
+ * Parâmetros de consulta e de cabeçalho de `/board`.
6
6
  */
7
- export interface ParametrosDeBuscarPeloFiltroAnexo {
8
- tarefa_id?: string;
9
- ticket_id?: string;
10
- }
11
- /**
12
- * Parâmetros de consulta e de cabeçalho de `/aplicativo`.
13
- */
14
- export interface ParametrosDeBuscarPaginadorAplicativo {
7
+ export interface ParametrosDeBuscarPaginadorBoard {
15
8
  pagina?: number;
16
9
  tamanho?: number;
17
- }
18
- /**
19
- * Parâmetros de consulta e de cabeçalho de `/aplicativo/autocomplete`.
20
- */
21
- export interface ParametrosDeBuscarAutoCompleteAplicativo {
22
- busca?: string;
23
- somente_ativos?: boolean;
24
- pagina?: number;
25
- tamanho?: number;
26
- }
27
- /**
28
- * Parâmetros de consulta e de cabeçalho de `/aplicativo/filtro`.
29
- */
30
- export interface ParametrosDeBuscarPeloFiltroAplicativo {
31
10
  nome?: string;
32
- endereco?: string;
33
- ativo?: boolean;
34
- }
35
- /**
36
- * Parâmetros de consulta e de cabeçalho de `/comentario`.
37
- */
38
- export interface ParametrosDeBuscarPaginadorComentario {
39
- tarefa_id?: string;
40
- ticket_id?: string;
41
- pagina?: number;
42
- tamanho?: number;
43
- }
44
- /**
45
- * Parâmetros de consulta e de cabeçalho de `/comentario/filtro`.
46
- */
47
- export interface ParametrosDeBuscarPeloFiltroComentario {
48
- tarefa_id?: string;
49
- ticket_id?: string;
50
- }
51
- /**
52
- * Parâmetros de consulta e de cabeçalho de `/documento`.
53
- */
54
- export interface ParametrosDeBuscarPaginadorDocumento {
55
- aplicativo_id?: string;
56
- pagina?: number;
57
- tamanho?: number;
58
- }
59
- /**
60
- * Parâmetros de consulta e de cabeçalho de `/documento/autocomplete`.
61
- */
62
- export interface ParametrosDeBuscarAutoCompleteDocumento {
63
- aplicativo_id?: string;
64
- busca?: string;
65
- pagina?: number;
66
- tamanho?: number;
67
- }
68
- /**
69
- * Parâmetros de consulta e de cabeçalho de `/documento/filtro`.
70
- */
71
- export interface ParametrosDeBuscarPeloFiltroDocumento {
72
- aplicativo_id?: string;
73
- nome?: string;
74
- tipo?: string;
75
- conteudo?: string;
76
- }
77
- /**
78
- * Parâmetros de consulta e de cabeçalho de `/etiqueta`.
79
- */
80
- export interface ParametrosDeBuscarPaginadorEtiqueta {
81
- pagina?: number;
82
- tamanho?: number;
83
- }
84
- /**
85
- * Parâmetros de consulta e de cabeçalho de `/etiqueta/autocomplete`.
86
- */
87
- export interface ParametrosDeBuscarAutoCompleteEtiqueta {
88
- busca?: string;
89
- pagina?: number;
90
- tamanho?: number;
91
- }
92
- /**
93
- * Parâmetros de consulta e de cabeçalho de `/etiqueta/filtro`.
94
- */
95
- export interface ParametrosDeBuscarPeloFiltroEtiqueta {
96
- nome?: string;
97
- }
98
- /**
99
- * Parâmetros de consulta e de cabeçalho de `/historico/filtro`.
100
- */
101
- export interface ParametrosDeBuscarPeloFiltroHistorico {
102
- tarefa_id?: string;
103
- ticket_id?: string;
104
- }
105
- /**
106
- * Parâmetros de consulta e de cabeçalho de `/notificacao`.
107
- */
108
- export interface ParametrosDeBuscarPaginadorNotificacao {
109
- pagina?: number;
110
- tamanho?: number;
111
- lida?: boolean;
112
- }
113
- /**
114
- * Parâmetros de consulta e de cabeçalho de `/notificacao/filtro`.
115
- */
116
- export interface ParametrosDeBuscarPeloFiltroNotificacao {
117
- lida?: boolean;
118
- tipo?: string;
119
- }
120
- /**
121
- * Parâmetros de consulta e de cabeçalho de `/projeto`.
122
- */
123
- export interface ParametrosDeBuscarPaginadorProjeto {
124
- pagina?: number;
125
- tamanho?: number;
126
- busca?: string;
127
- status?: string;
128
- aplicativo_id?: string;
129
- membro_id?: string;
130
- arquivado?: boolean;
131
- }
132
- /**
133
- * Parâmetros de consulta e de cabeçalho de `/projeto/autocomplete`.
134
- */
135
- export interface ParametrosDeBuscarAutoCompleteProjeto {
136
- busca?: string;
137
- aplicativo_id?: string;
138
- pagina?: number;
139
- tamanho?: number;
140
- }
141
- /**
142
- * Parâmetros de consulta e de cabeçalho de `/projeto/filtro`.
143
- */
144
- export interface ParametrosDeBuscarPeloFiltroProjeto {
145
- /**
146
- * Trecho do nome ou da descrição.
147
- */
148
- busca?: string;
149
- status?: string;
150
- aplicativo_id?: string;
151
- /**
152
- * Projetos em que o colaborador é dono ou membro.
153
- */
154
- membro_id?: string;
155
- /**
156
- * Padrão `false`: os arquivados só aparecem quando pedidos.
157
- */
158
- arquivado?: boolean;
159
- }
160
- /**
161
- * Parâmetros de consulta e de cabeçalho de `/publico/ticket`.
162
- */
163
- export interface ParametrosDeCriarPeloAplicativoTicket {
164
- /**
165
- * Chave pública do aplicativo (pk_live_...)
166
- *
167
- * Enviado no cabeçalho `X-Chave-Publica`.
168
- */
169
- "X-Chave-Publica": string;
170
- }
171
- /**
172
- * Parâmetros de consulta e de cabeçalho de `/secao`.
173
- */
174
- export interface ParametrosDeBuscarPaginadorSecao {
175
- projeto_id?: string;
176
- pagina?: number;
177
- tamanho?: number;
11
+ favoritos?: boolean;
178
12
  }
179
13
  /**
180
- * Parâmetros de consulta e de cabeçalho de `/secao/autocomplete`.
14
+ * Parâmetros de consulta e de cabeçalho de `/board/autocomplete`.
181
15
  */
182
- export interface ParametrosDeBuscarAutoCompleteSecao {
183
- projeto_id?: string;
16
+ export interface ParametrosDeBuscarAutoCompleteBoard {
184
17
  busca?: string;
185
18
  pagina?: number;
186
19
  tamanho?: number;
187
20
  }
188
21
  /**
189
- * Parâmetros de consulta e de cabeçalho de `/secao/filtro`.
22
+ * Parâmetros de consulta e de cabeçalho de `/board/filtro`.
190
23
  */
191
- export interface ParametrosDeBuscarPeloFiltroSecao {
192
- projeto_id?: string;
24
+ export interface ParametrosDeBuscarPeloFiltroBoard {
193
25
  nome?: string;
26
+ favoritos?: boolean;
27
+ dono_id?: string;
194
28
  }
195
29
  /**
196
- * Parâmetros de consulta e de cabeçalho de `/tarefa`.
197
- */
198
- export interface ParametrosDeBuscarPaginadorTarefa {
199
- pagina?: number;
200
- tamanho?: number;
201
- projeto_id?: string;
202
- responsavel_id?: string;
203
- concluida?: boolean;
204
- busca?: string;
205
- }
206
- /**
207
- * Parâmetros de consulta e de cabeçalho de `/tarefa/autocomplete`.
208
- */
209
- export interface ParametrosDeBuscarAutoCompleteTarefa {
210
- busca?: string;
211
- projeto_id?: string;
212
- pagina?: number;
213
- tamanho?: number;
214
- }
215
- /**
216
- * Parâmetros de consulta e de cabeçalho de `/tarefa/filtro`.
217
- */
218
- export interface ParametrosDeBuscarPeloFiltroTarefa {
219
- projeto_id?: string;
220
- secao_id?: string;
221
- responsavel_id?: string;
222
- tarefa_pai_id?: string;
223
- ticket_id?: string;
224
- /**
225
- * Tarefas dos projetos ligados a esse aplicativo.
226
- */
227
- aplicativo_id?: string;
228
- etiqueta_id?: string;
229
- /**
230
- * `true` deixa de fora as subtarefas.
231
- */
232
- somente_principais?: boolean;
233
- concluida?: boolean;
234
- prazo_de?: string;
235
- prazo_ate?: string;
236
- /**
237
- * Trecho do título ou da descrição.
238
- */
239
- busca?: string;
240
- /**
241
- * `true` ordena pelo prazo (mais próximo primeiro); senão pela coluna e pela ordem do quadro.
242
- */
243
- ordenar_por_prazo?: boolean;
244
- }
245
- /**
246
- * Parâmetros de consulta e de cabeçalho de `/ticket`.
247
- */
248
- export interface ParametrosDeBuscarPaginadorTicket {
249
- pagina?: number;
250
- tamanho?: number;
251
- aplicativo_id?: string;
252
- status?: string;
253
- abertos?: boolean;
254
- responsavel_id?: string;
255
- sem_responsavel?: boolean;
256
- solicitante_id?: string;
257
- prioridade?: string;
258
- tipo?: string;
259
- atrasados?: boolean;
260
- busca?: string;
261
- }
262
- /**
263
- * Parâmetros de consulta e de cabeçalho de `/ticket/autocomplete`.
264
- */
265
- export interface ParametrosDeBuscarAutoCompleteTicket {
266
- busca?: string;
267
- aplicativo_id?: string;
268
- pagina?: number;
269
- tamanho?: number;
270
- }
271
- /**
272
- * Parâmetros de consulta e de cabeçalho de `/ticket/filtro`.
273
- */
274
- export interface ParametrosDeBuscarPeloFiltroTicket {
275
- aplicativo_id?: string;
276
- status?: string;
277
- /**
278
- * `true` traz só os que não estão resolvidos nem fechados; `false`, só os resolvidos e fechados.
279
- */
280
- abertos?: boolean;
281
- responsavel_id?: string;
282
- /**
283
- * `true` traz só os tickets sem responsável.
284
- */
285
- sem_responsavel?: boolean;
286
- solicitante_id?: string;
287
- prioridade?: string;
288
- tipo?: string;
289
- /**
290
- * `true` traz só os que estouraram o prazo.
291
- */
292
- atrasados?: boolean;
293
- /**
294
- * Trecho do título, da descrição, do solicitante ou o número.
295
- */
296
- busca?: string;
297
- }
298
- /**
299
- * Anexa um arquivo ou link
300
- *
301
- * Exige a permissão `criar` na área `projetos` ou `tickets`. Anexa a uma tarefa (`tarefa_id`) ou ticket (`ticket_id`), nunca aos dois. Mande o arquivo em `arquivo_base64` (com ou sem o prefixo `data:...;base64,`, até 10 MB, `tipo_mime` informa o formato) ou um link em `url` (`http://` ou `https://`, até 1000 caracteres). Com `importar_url: true`, o servidor baixa a imagem de `url` e guarda o arquivo no lugar do link (é o caminho para anexar imagens pelo MCP): só `https://`, sem redirecionamento, servidor de IP público, resposta `image/*` de até 10 MB; o `tipo_mime` vem da resposta. `nome` é obrigatório (até 200). O arquivo vai para o TermoBucket (privado, app `termo-suporte`); se o bucket falhar, fica no banco até a rotina do backend levá-lo. O corpo aceita até 16 MiB. A atividade da tarefa ou do ticket ganha a linha do anexo.
302
- *
303
- * `POST /anexo`
304
- */
305
- export declare function criar_anexo(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.AnexoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Anexo>;
306
- /**
307
- * Lista os anexos de uma tarefa ou ticket
308
- *
309
- * Exige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 500 anexos, do mais novo para o mais antigo, sem o conteúdo dos arquivos. Informe `tarefa_id` ou `ticket_id`.
310
- *
311
- * `GET /anexo/filtro`
312
- */
313
- export declare function buscar_pelo_filtro_anexo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroAnexo, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Anexo>>;
314
- /**
315
- * Baixa um anexo pelo id
316
- *
317
- * Exige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve os dados do anexo e, quando é arquivo, `url_download`: endereço de download assinado do TermoBucket (arquivo privado do app `termo-suporte`), válido por 15 minutos. `conteudo_base64` só vem preenchido enquanto o arquivo ainda está no banco (o TermoBucket falhou no envio; a rotina do backend leva ao bucket a cada 30 minutos). Os dois ficam vazios quando o anexo é um link.
318
- *
319
- * `GET /anexo/{id}`
320
- */
321
- export declare function buscar_pelo_id_anexo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.AnexoComConteudo>;
322
- /**
323
- * Renomeia um anexo pelo id
324
- *
325
- * Exige a permissão `editar` na área `projetos` ou `tickets`. Troca o `nome` (obrigatório, até 200 caracteres).
326
- *
327
- * `PATCH /anexo/{id}`
328
- */
329
- export declare function atualizar_pelo_id_anexo(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.AnexoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Anexo>;
330
- /**
331
- * Exclui um anexo pelo id
332
- *
333
- * Exige a permissão `deletar` na área `projetos` ou `tickets`. Exclusão lógica.
334
- *
335
- * `DELETE /anexo/{id}`
336
- */
337
- export declare function deletar_pelo_id_anexo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
338
- /**
339
- * Lista os aplicativos paginados
340
- *
341
- * Exige a permissão de leitura na área `aplicativos`. A lista de aplicativos é a do TermoAuth (não há cadastro, edição nem exclusão no TermoSupport): antes de responder, a rota busca os apps no TermoAuth pelo `termo_core` com o token de quem chamou e espelha nome, endereço, descrição e cor. Para um master do TermoAuth vem a lista inteira (`todos=true`) e o que sumiu de lá fica inativo; para os demais, só entram ou se atualizam os apps que a pessoa pode abrir. Falha no TermoAuth não impede a resposta: vem o que já estava sincronizado. A sincronização também roda quando um master entra. Lista os aplicativos sincronizados (com `termoauth_id`) em ordem alfabética do nome, sempre 50 por página: `tamanho` é ignorado. `pagina` começa em 1 (padrão 1; valores menores viram 1). `total` é a quantidade de aplicativos não excluídos.
342
- *
343
- * `GET /aplicativo`
344
- */
345
- export declare function buscar_paginador_aplicativo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAplicativo>;
346
- /**
347
- * Lista básica de aplicativos para seleção
348
- *
349
- * Exige a permissão de leitura na área `aplicativos`, `projetos` ou `tickets`. Devolve só id, nome e endereço, em ordem alfabética do nome, sem os excluídos. `somente_ativos=true` deixa de fora os aplicativos inativos (é o que usam os campos de projetos e tickets). `busca` procura o trecho no nome ou no endereço, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1.
350
- *
351
- * `GET /aplicativo/autocomplete`
352
- */
353
- export declare function buscar_auto_complete_aplicativo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAplicativoAutoComplete>;
354
- /**
355
- * Busca aplicativos por filtro
356
- *
357
- * Exige a permissão de leitura na área `aplicativos`. Devolve todos os aplicativos sincronizados com o TermoAuth que casam com o filtro, sem paginação, em ordem alfabética do nome. `nome` e `endereco` procuram o trecho no campo, sem diferenciar maiúsculas; `ativo` filtra pela situação. Sem filtro, devolve todos.
358
- *
359
- * `GET /aplicativo/filtro`
360
- */
361
- export declare function buscar_pelo_filtro_aplicativo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Aplicativo>>;
362
- /**
363
- * Busca um aplicativo pelo id
364
- *
365
- * Exige a permissão de leitura na área `aplicativos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Aplicativo excluído não é encontrado.
366
- *
367
- * `GET /aplicativo/{id}`
368
- */
369
- export declare function buscar_pelo_id_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Aplicativo>;
370
- /**
371
- * Lista os comentários paginados
372
- *
373
- * Exige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Do mais novo para o mais antigo, sempre 50 por página: `tamanho` é ignorado. `tarefa_id` e `ticket_id` limitam a uma tarefa ou ticket.
374
- *
375
- * `GET /comentario`
376
- */
377
- export declare function buscar_paginador_comentario(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorComentario, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaComentario>;
378
- /**
379
- * Comenta numa tarefa ou ticket
380
- *
381
- * Exige a permissão `criar` na área `projetos` ou `tickets`. Grava o comentário de quem está logado em uma tarefa (`tarefa_id`) ou um ticket (`ticket_id`), nunca nos dois. `texto` é obrigatório (até 10000 caracteres). `interno` (só no ticket) vira nota que o solicitante não acompanha. `mencionados` são os colaboradores marcados com @, que recebem notificação; o responsável e o criador da tarefa (ou o responsável e o solicitante do ticket) também são avisados. A primeira resposta pública da equipe num ticket novo registra a primeira resposta e o põe em atendimento.
382
- *
383
- * `POST /comentario`
384
- */
385
- export declare function criar_comentario(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ComentarioCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Comentario>;
386
- /**
387
- * Lista a conversa de uma tarefa ou ticket
388
- *
389
- * Exige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 1000 comentários do mais antigo para o mais novo. Informe `tarefa_id` ou `ticket_id`.
390
- *
391
- * `GET /comentario/filtro`
392
- */
393
- export declare function buscar_pelo_filtro_comentario(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroComentario, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Comentario>>;
394
- /**
395
- * Busca um comentário pelo id
396
- *
397
- * Exige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Comentário excluído não é encontrado.
398
- *
399
- * `GET /comentario/{id}`
400
- */
401
- export declare function buscar_pelo_id_comentario(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Comentario>;
402
- /**
403
- * Edita um comentário pelo id
404
- *
405
- * Exige a permissão `editar` na área `projetos` ou `tickets`. Troca o `texto` (obrigatório, até 10000 caracteres). Só quem escreveu edita; o comentário passa a mostrar `editado`.
406
- *
407
- * `PATCH /comentario/{id}`
408
- */
409
- export declare function atualizar_pelo_id_comentario(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ComentarioAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Comentario>;
410
- /**
411
- * Exclui um comentário pelo id
412
- *
413
- * Exige a permissão `deletar` na área `projetos` ou `tickets`. Exclusão lógica. Só quem escreveu exclui.
414
- *
415
- * `DELETE /comentario/{id}`
416
- */
417
- export declare function deletar_pelo_id_comentario(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
418
- /**
419
- * Lista os documentos paginados
420
- *
421
- * Exige a permissão de leitura na área `aplicativos`. Lista os documentos não excluídos em ordem alfabética do nome, sempre 50 por página: `tamanho` é ignorado. `aplicativo_id` limita a um aplicativo. `pagina` começa em 1 (padrão 1; valores menores viram 1). `total` conta os documentos com o mesmo filtro de aplicativo.
422
- *
423
- * `GET /documento`
424
- */
425
- export declare function buscar_paginador_documento(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorDocumento, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaDocumento>;
426
- /**
427
- * Cadastra um documento de um aplicativo
428
- *
429
- * Exige a permissão `criar` na área `aplicativos`. Cadastra um documento da base de conhecimento de um aplicativo. `aplicativo_id` precisa ser de um aplicativo não excluído. `nome` é obrigatório (até 120 caracteres). `tipo` é `TEXTO`, `TXT`, `MD` ou `PDF`, sem diferenciar maiúsculas (padrão `TEXTO`, gravado em maiúsculas). O conteúdo vem em `conteudo` (texto) ou em `arquivo_base64` (o arquivo em base64, com ou sem o prefixo `data:...;base64,`); quando `arquivo_base64` vem preenchido, `conteudo` é ignorado. Com `tipo` `PDF` o backend extrai o texto do PDF; nos demais tipos o arquivo precisa ser texto UTF-8. O texto final não pode ficar vazio, e `caracteres` é o tamanho dele. O corpo aceita até 8 MiB (um PDF de cerca de 5 MB em base64).
430
- *
431
- * `POST /documento`
432
- */
433
- export declare function criar_documento(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.DocumentoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Documento>;
434
- /**
435
- * Lista básica de documentos para seleção
436
- *
437
- * Exige a permissão de leitura na área `aplicativos`. Devolve só id, nome e tipo, em ordem alfabética do nome, sem os excluídos. `aplicativo_id` limita a um aplicativo e `busca` procura o trecho no nome, sem diferenciar maiúsculas. `pagina` começa em 1 (padrão 1) e `tamanho` tem padrão 10, sem máximo; valores menores que 1 viram 1.
438
- *
439
- * `GET /documento/autocomplete`
440
- */
441
- export declare function buscar_auto_complete_documento(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteDocumento, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaDocumentoAutoComplete>;
442
- /**
443
- * Busca documentos por filtro
444
- *
445
- * Exige a permissão de leitura na área `aplicativos`. Devolve todos os documentos não excluídos que casam com o filtro, sem paginação, em ordem alfabética do nome, com o texto inteiro. `aplicativo_id` limita a um aplicativo; `nome` e `conteudo` procuram o trecho no campo, sem diferenciar maiúsculas; `tipo` é exato (`TEXTO`, `TXT`, `MD` ou `PDF`, sem diferenciar maiúsculas). Sem filtro, devolve todos.
446
- *
447
- * `GET /documento/filtro`
448
- */
449
- export declare function buscar_pelo_filtro_documento(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroDocumento, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Documento>>;
450
- /**
451
- * Busca um documento pelo id
452
- *
453
- * Exige a permissão de leitura na área `aplicativos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve o documento com o texto inteiro em `conteudo`. Documento excluído não é encontrado.
454
- *
455
- * `GET /documento/{id}`
456
- */
457
- export declare function buscar_pelo_id_documento(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Documento>;
458
- /**
459
- * Atualiza um documento pelo id
460
- *
461
- * Exige a permissão `editar` na área `aplicativos`. Atualização parcial: só os campos enviados mudam; o aplicativo do documento não muda. `nome` não pode ficar vazio (até 120 caracteres) e `tipo` é `TEXTO`, `TXT`, `MD` ou `PDF`. Mandar `conteudo` ou `arquivo_base64` troca o texto, com as mesmas regras do cadastro (o arquivo é lido pelo `tipo` enviado ou, sem ele, pelo tipo atual do documento) e o texto final não pode ficar vazio. O corpo aceita até 8 MiB.
462
- *
463
- * `PATCH /documento/{id}`
464
- */
465
- export declare function atualizar_pelo_id_documento(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.DocumentoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Documento>;
466
- /**
467
- * Exclui um documento pelo id
468
- *
469
- * Exige a permissão `deletar` na área `aplicativos`. A exclusão é lógica: o documento some das leituras, mas o registro não é apagado e não há como restaurá-lo.
470
- *
471
- * `DELETE /documento/{id}`
472
- */
473
- export declare function deletar_pelo_id_documento(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
474
- /**
475
- * Lista as etiquetas paginadas
476
- *
477
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Lista em ordem alfabética, sempre 50 por página: `tamanho` é ignorado. `pagina` começa em 1.
478
- *
479
- * `GET /etiqueta`
480
- */
481
- export declare function buscar_paginador_etiqueta(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorEtiqueta, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaEtiqueta>;
482
- /**
483
- * Cadastra uma etiqueta
484
- *
485
- * Exige a permissão `criar` na área `projetos`. Cria uma etiqueta para marcar tarefas (Backend, Frontend, Dados...). `nome` é obrigatório (até 40 caracteres) e único sem diferenciar maiúsculas. `cor` segue o formato `#00397c` (padrão `#00397c`).
486
- *
487
- * `POST /etiqueta`
488
- */
489
- export declare function criar_etiqueta(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.EtiquetaCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Etiqueta>;
490
- /**
491
- * Lista básica de etiquetas para seleção
492
- *
493
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve id, nome e cor, em ordem alfabética. `busca` procura o trecho no nome. `pagina` começa em 1 e `tamanho` tem padrão 10.
494
- *
495
- * `GET /etiqueta/autocomplete`
496
- */
497
- export declare function buscar_auto_complete_etiqueta(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteEtiqueta, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaEtiquetaResumo>;
498
- /**
499
- * Busca etiquetas por filtro
500
- *
501
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve todas as etiquetas não excluídas, em ordem alfabética. `nome` procura o trecho no nome, sem diferenciar maiúsculas.
502
- *
503
- * `GET /etiqueta/filtro`
504
- */
505
- export declare function buscar_pelo_filtro_etiqueta(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroEtiqueta, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Etiqueta>>;
506
- /**
507
- * Busca uma etiqueta pelo id
508
- *
509
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Etiqueta excluída não é encontrada.
510
- *
511
- * `GET /etiqueta/{id}`
512
- */
513
- export declare function buscar_pelo_id_etiqueta(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Etiqueta>;
514
- /**
515
- * Atualiza uma etiqueta pelo id
516
- *
517
- * Exige a permissão `editar` na área `projetos`. Atualização parcial de `nome` e `cor`, com as mesmas regras do cadastro.
518
- *
519
- * `PATCH /etiqueta/{id}`
520
- */
521
- export declare function atualizar_pelo_id_etiqueta(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.EtiquetaAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Etiqueta>;
522
- /**
523
- * Exclui uma etiqueta pelo id
524
- *
525
- * Exige a permissão `deletar` na área `projetos`. Exclusão lógica: a etiqueta some das leituras e sai das tarefas que a usavam.
526
- *
527
- * `DELETE /etiqueta/{id}`
528
- */
529
- export declare function deletar_pelo_id_etiqueta(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
530
- /**
531
- * Atividade de uma tarefa ou ticket
532
- *
533
- * Exige a permissão de leitura na área `projetos` ou `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 500 linhas de atividade, da mais nova para a mais antiga: criação, mudanças de campo, anexos. O histórico é gravado pelo próprio sistema e não tem cadastro, edição nem exclusão. Informe `tarefa_id` ou `ticket_id`.
534
- *
535
- * `GET /historico/filtro`
536
- */
537
- export declare function buscar_pelo_filtro_historico(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroHistorico, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Historico>>;
538
- /**
539
- * Caixa de entrada paginada
540
- *
541
- * Livre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Lista as notificações da pessoa, da mais nova para a mais antiga, sempre 50 por página: `tamanho` é ignorado. `lida` filtra; `nao_lidas` traz o total ainda não lido (o número do sino), com qualquer filtro.
542
- *
543
- * `GET /notificacao`
544
- */
545
- export declare function buscar_paginador_notificacao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorNotificacao, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaNotificacao>;
546
- /**
547
- * Marca todas as notificações como lidas
548
- *
549
- * Livre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Marca de uma vez todas as notificações da pessoa como lidas (ou como não lidas, com `lida: false`). Devolve quantas mudaram em `alteradas`.
550
- *
551
- * `PATCH /notificacao`
552
- */
553
- export declare function marcar_todas_notificacao(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.NotificacaoMarcarTodas, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.NotificacoesMarcadas>;
554
- /**
555
- * Busca notificações por filtro
556
- *
557
- * Livre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Devolve até 500 notificações da pessoa, da mais nova para a mais antiga. `lida` filtra lidas ou não lidas e `tipo` é `ATRIBUICAO`, `COMENTARIO`, `MENCAO`, `STATUS`, `PRAZO` ou `TICKET`.
558
- *
559
- * `GET /notificacao/filtro`
560
- */
561
- export declare function buscar_pelo_filtro_notificacao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroNotificacao, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Notificacao>>;
562
- /**
563
- * Busca uma notificação pelo id
564
- *
565
- * Livre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Só encontra as notificações da própria pessoa.
566
- *
567
- * `GET /notificacao/{id}`
568
- */
569
- export declare function buscar_pelo_id_notificacao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Notificacao>;
570
- /**
571
- * Marca uma notificação como lida ou não lida
572
- *
573
- * Livre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Muda `lida` de uma notificação da própria pessoa.
574
- *
575
- * `PATCH /notificacao/{id}`
576
- */
577
- export declare function atualizar_pelo_id_notificacao(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.NotificacaoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Notificacao>;
578
- /**
579
- * Exclui uma notificação pelo id
580
- *
581
- * Livre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Tira a notificação da caixa de entrada (exclusão lógica).
582
- *
583
- * `DELETE /notificacao/{id}`
584
- */
585
- export declare function deletar_pelo_id_notificacao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
586
- /**
587
- * Lista os projetos paginados
588
- *
589
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Lista os projetos do mais recente atualizado para o mais antigo, sempre 50 por página: `tamanho` é ignorado. Aceita os mesmos filtros do `GET /projeto/filtro`. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
590
- *
591
- * `GET /projeto`
592
- */
593
- export declare function buscar_paginador_projeto(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorProjeto, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaProjeto>;
594
- /**
595
- * Cadastra um projeto
596
- *
597
- * Exige a permissão `criar` na área `projetos`. `visibilidade` é `ORGANIZACAO` (padrão: todos com a área `projetos` veem) ou `MEMBROS` (só quem está vinculado ao projeto). Cria o projeto ligado aos aplicativos de `aplicativo_ids`, com os membros de `membro_ids` (o dono e quem criou entram sempre como membros). `nome` é obrigatório (até 120 caracteres); `descricao` vai até 5000; `cor` no formato `#00397c`; `status` é `NO_PRAZO` (padrão), `EM_RISCO`, `ATRASADO`, `PAUSADO` ou `CONCLUIDO`; `dono_id` tem padrão em quem criou; `inicio` não pode passar do `prazo`. `secoes` são os nomes das colunas do quadro, na ordem (padrão "A fazer", "Em andamento" e "Concluído").
598
- *
599
- * `POST /projeto`
600
- */
601
- export declare function criar_projeto(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ProjetoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Projeto>;
602
- /**
603
- * Lista básica de projetos para seleção
604
- *
605
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve id, nome e cor dos projetos não arquivados, em ordem alfabética. `busca` procura no nome e `aplicativo_id` limita aos projetos do aplicativo. `pagina` começa em 1 e `tamanho` tem padrão 10. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
606
- *
607
- * `GET /projeto/autocomplete`
608
- */
609
- export declare function buscar_auto_complete_projeto(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteProjeto, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaProjetoAutoComplete>;
610
- /**
611
- * Busca projetos por filtro
612
- *
613
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 500 projetos em ordem alfabética. `busca` procura no nome e na descrição; `status` é exato; `aplicativo_id` traz os projetos ligados ao aplicativo; `membro_id` os projetos em que o colaborador é dono ou membro; `arquivado` tem padrão `false`. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
614
- *
615
- * `GET /projeto/filtro`
616
- */
617
- export declare function buscar_pelo_filtro_projeto(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroProjeto, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Projeto>>;
618
- /**
619
- * Busca um projeto pelo id
620
- *
621
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve o projeto com dono, aplicativos, membros e a contagem das tarefas principais (total, concluídas e atrasadas). Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
622
- *
623
- * `GET /projeto/{id}`
624
- */
625
- export declare function buscar_pelo_id_projeto(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Projeto>;
626
- /**
627
- * Atualiza um projeto pelo id
628
- *
629
- * Exige a permissão `editar` na área `projetos`. Atualização parcial com as regras do cadastro (inclusive `visibilidade`: `ORGANIZACAO` ou `MEMBROS`). Texto vazio em `descricao` apaga; `null` em `dono_id`, `inicio` ou `prazo` apaga o valor. `aplicativo_ids` e `membro_ids`, quando enviados, substituem a lista inteira (o dono continua membro). `arquivado` tira o projeto das listas. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
630
- *
631
- * `PATCH /projeto/{id}`
632
- */
633
- export declare function atualizar_pelo_id_projeto(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ProjetoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Projeto>;
634
- /**
635
- * Exclui um projeto pelo id
636
- *
637
- * Exige a permissão `deletar` na área `projetos`. Exclusão lógica do projeto, das colunas e das tarefas dele. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
638
- *
639
- * `DELETE /projeto/{id}`
640
- */
641
- export declare function deletar_pelo_id_projeto(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
642
- /**
643
- * Abre um ticket pelo aplicativo atendido
644
- *
645
- * Rota pública, sem o token do TermoAuth: o backend do aplicativo se identifica pela chave pública dele (`pk_live_...`, a mesma do cadastro do aplicativo) no cabeçalho `X-Chave-Publica`. Só aplicativo ativo abre ticket. `titulo` (até 200), `descricao` (até 20000) e `solicitante_nome` (até 120) são obrigatórios; `solicitante_email`, `origem_url` (a tela onde o problema aconteceu), `tipo` e `prioridade` seguem as regras do `POST /ticket`. O ticket entra na fila com o canal `APLICATIVO`, o status `NOVO` e o prazo do SLA. Chamada de servidor para servidor: o navegador recebe erro de CORS.
646
- *
647
- * `POST /publico/ticket`
648
- */
649
- export declare function criar_pelo_aplicativo_ticket(parametros: ParametrosDeCriarPeloAplicativoTicket, corpo_da_requisicao: tipos.TicketDoAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.TicketAberto>;
650
- /**
651
- * Lista as seções paginadas
652
- *
653
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Lista na ordem do quadro, sempre 50 por página: `tamanho` é ignorado. `projeto_id` limita a um projeto.
654
- *
655
- * `GET /secao`
656
- */
657
- export declare function buscar_paginador_secao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorSecao, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaSecao>;
658
- /**
659
- * Cadastra uma seção (coluna do quadro)
660
- *
661
- * Exige a permissão `criar` na área `projetos`. Cria a coluna no projeto. `nome` é obrigatório (até 80 caracteres). Sem `ordem`, entra no fim do quadro.
662
- *
663
- * `POST /secao`
664
- */
665
- export declare function criar_secao(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.SecaoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Secao>;
666
- /**
667
- * Lista básica de seções para seleção
668
- *
669
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve id e nome em ordem alfabética. `projeto_id` limita a um projeto e `busca` procura no nome.
670
- *
671
- * `GET /secao/autocomplete`
672
- */
673
- export declare function buscar_auto_complete_secao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteSecao, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaSecaoAutoComplete>;
674
- /**
675
- * Busca seções por filtro
676
- *
677
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve as colunas na ordem do quadro. `projeto_id` limita a um projeto e `nome` procura o trecho no nome.
678
- *
679
- * `GET /secao/filtro`
680
- */
681
- export declare function buscar_pelo_filtro_secao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroSecao, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Secao>>;
682
- /**
683
- * Busca uma seção pelo id
684
- *
685
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Seção excluída não é encontrada.
686
- *
687
- * `GET /secao/{id}`
688
- */
689
- export declare function buscar_pelo_id_secao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Secao>;
690
- /**
691
- * Atualiza uma seção pelo id
692
- *
693
- * Exige a permissão `editar` na área `projetos`. Renomeia (`nome`) ou reposiciona (`ordem`, decimal: para pôr entre duas colunas use a média das ordens delas).
694
- *
695
- * `PATCH /secao/{id}`
696
- */
697
- export declare function atualizar_pelo_id_secao(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.SecaoAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Secao>;
698
- /**
699
- * Exclui uma seção pelo id
700
- *
701
- * Exige a permissão `deletar` na área `projetos`. Exclusão lógica: as tarefas da coluna vão para a primeira coluna que sobrar no projeto.
702
- *
703
- * `DELETE /secao/{id}`
704
- */
705
- export declare function deletar_pelo_id_secao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
706
- /**
707
- * Lista as tarefas paginadas
708
- *
709
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Lista da mais recente para a mais antiga, sempre 50 por página: `tamanho` é ignorado. Filtra por `projeto_id`, `responsavel_id`, `concluida` e `busca` (título). Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
710
- *
711
- * `GET /tarefa`
712
- */
713
- export declare function buscar_paginador_tarefa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorTarefa, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaTarefa>;
714
- /**
715
- * Cadastra uma tarefa
716
- *
717
- * Exige a permissão `criar` na área `projetos`. Cria a tarefa no projeto. Sem `secao_id`, entra na primeira coluna; com `tarefa_pai_id`, vira subtarefa (sem coluna; subtarefa não tem subtarefas). `ticket_id` liga a tarefa ao ticket de suporte que a originou. `titulo` é obrigatório (até 300 caracteres); `descricao` até 20000; `prioridade` é `BAIXA`, `MEDIA`, `ALTA` ou `URGENTE`; `estimativa` de 0 a 10000 pontos; `inicio` não pode passar do `prazo`. Quem criou fica como criador, a atividade ganha a linha de criação e o responsável recebe uma notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
718
- *
719
- * `POST /tarefa`
720
- */
721
- export declare function criar_tarefa(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.TarefaCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Tarefa>;
722
- /**
723
- * Lista básica de tarefas para seleção
724
- *
725
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve id, título e nome do projeto, em ordem alfabética. `busca` procura no título e `projeto_id` limita a um projeto. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
726
- *
727
- * `GET /tarefa/autocomplete`
728
- */
729
- export declare function buscar_auto_complete_tarefa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteTarefa, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaTarefaAutoComplete>;
730
- /**
731
- * Busca tarefas por filtro
732
- *
733
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 2000 tarefas. É a leitura do quadro, da lista, do calendário, do cronograma e de "Minhas tarefas". Os filtros se somam: `projeto_id`, `secao_id`, `responsavel_id`, `tarefa_pai_id` (subtarefas de uma tarefa), `ticket_id`, `aplicativo_id` (projetos ligados ao aplicativo), `etiqueta_id`, `somente_principais` (sem subtarefas), `concluida`, `prazo_de`/`prazo_ate` e `busca` (título ou descrição). A ordem é a do quadro (coluna e posição) ou, com `ordenar_por_prazo=true`, o prazo mais próximo primeiro.
734
- *
735
- * `GET /tarefa/filtro`
736
- */
737
- export declare function buscar_pelo_filtro_tarefa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroTarefa, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Tarefa>>;
738
- /**
739
- * Busca uma tarefa pelo id
30
+ * Lista os boards paginados
740
31
  *
741
- * Exige a permissão de leitura na área `projetos` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve a tarefa com projeto, coluna, responsável, criador, etiquetas e as contagens de subtarefas, comentários e anexos. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
32
+ * Os boards que a pessoa enxerga, do mais recente para o mais antigo, sempre 50 por página: `tamanho` é ignorado. `pagina` começa em 1; aceita `nome` e `favoritos` como no filtro.
742
33
  *
743
- * `GET /tarefa/{id}`
34
+ * `GET /board`
744
35
  */
745
- export declare function buscar_pelo_id_tarefa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Tarefa>;
36
+ export declare function buscar_paginador_board(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorBoard, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaBoard>;
746
37
  /**
747
- * Atualiza uma tarefa pelo id
38
+ * Cria um board
748
39
  *
749
- * Exige a permissão `editar` na área `projetos`. Atualização parcial com as regras do cadastro. Mover no quadro é mandar `secao_id` (coluna do mesmo projeto) e `ordem` (decimal: a média entre os vizinhos). `null` em `responsavel_id`, `inicio`, `prazo`, `prioridade` ou `estimativa` apaga o valor; texto vazio em `descricao` apaga. `concluida` grava ou apaga `concluida_em`. `etiqueta_ids` substitui a lista. Cada mudança entra na atividade da tarefa; o novo responsável e, ao concluir, o criador recebem notificação. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
40
+ * Livre para todo colaborador logado; quem cria é o dono. `nome` é obrigatório (até 120 caracteres), `descricao` vai até 500, `cor` segue o formato `#00397c` (padrão `#00397c`) e `visibilidade` é `ORGANIZACAO` (padrão, todos veem e editam) ou `MEMBROS` (só o dono e os `membro_ids`). O canvas nasce vazio e é editado em tempo real em `GET /board/ws/{id}?token=<JWT>` (WebSocket no protocolo do Yjs).
750
41
  *
751
- * `PATCH /tarefa/{id}`
42
+ * `POST /board`
752
43
  */
753
- export declare function atualizar_pelo_id_tarefa(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.TarefaAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Tarefa>;
44
+ export declare function criar_board(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.BoardCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
754
45
  /**
755
- * Exclui uma tarefa pelo id
46
+ * Lista básica de boards para seleção
756
47
  *
757
- * Exige a permissão `deletar` na área `projetos`. Exclusão lógica da tarefa e das subtarefas dela. Visibilidade: projeto com `visibilidade` `MEMBROS` só aparece para o dono, os membros e o master do TermoAuth; para os demais ele, as tarefas e as seções dele somem das listas e o acesso pelo id (ou por `projeto_id`/`tarefa_id`/`secao_id` na query) responde `404`. O responsável sempre enxerga a própria tarefa.
48
+ * Id, nome e cor dos boards que a pessoa enxerga, em ordem alfabética. `busca` procura o trecho no nome. `pagina` começa em 1 e `tamanho` tem padrão 10.
758
49
  *
759
- * `DELETE /tarefa/{id}`
50
+ * `GET /board/autocomplete`
760
51
  */
761
- export declare function deletar_pelo_id_tarefa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
52
+ export declare function buscar_auto_complete_board(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteBoard, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaBoardAutoComplete>;
762
53
  /**
763
- * Fila de tickets paginada
54
+ * Busca boards por filtro
764
55
  *
765
- * Exige a permissão de leitura na área `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). A fila de atendimento: abertos primeiro, do mais urgente e com prazo mais próximo para o menos urgente; depois os resolvidos e fechados. Sempre 50 por página: `tamanho` é ignorado. Aceita os mesmos filtros do `GET /ticket/filtro`.
56
+ * Todos os boards que a pessoa enxerga, do mais recente para o mais antigo. `nome` procura o trecho no nome sem diferenciar maiúsculas, `favoritos=true` traz só os favoritos de quem pediu e `dono_id` só os de um dono.
766
57
  *
767
- * `GET /ticket`
58
+ * `GET /board/filtro`
768
59
  */
769
- export declare function buscar_paginador_ticket(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorTicket, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaTicket>;
60
+ export declare function buscar_pelo_filtro_board(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroBoard, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Board>>;
770
61
  /**
771
- * Abre um ticket de suporte
62
+ * Baixa uma imagem do canvas guardada no banco
772
63
  *
773
- * Exige a permissão `criar` na área `tickets`. Abre o ticket para um aplicativo. `titulo` (até 200) e `descricao` (até 20000) são obrigatórios. `tipo` é `BUG`, `DUVIDA` (padrão), `MELHORIA`, `ACESSO` ou `OUTRO`; `prioridade` é `BAIXA`, `MEDIA` (padrão), `ALTA` ou `URGENTE`; `canal` é `PAINEL` (padrão), `APLICATIVO`, `EMAIL`, `WHATSAPP` ou `TELEFONE`. O solicitante é o colaborador de `solicitante_id`, ou alguém de fora por `solicitante_nome` e `solicitante_email`; sem nenhum, é quem abriu. Sem `prazo`, vale o SLA da prioridade (urgente 4 h, alta 24 h, média 72 h, baixa 7 dias). Com `responsavel_id` o ticket já nasce em atendimento e o responsável é notificado.
64
+ * Pública (o `<img>` do canvas não manda token): devolve os bytes da imagem que ficou no banco porque o TermoBucket falhou, com cache longo.
774
65
  *
775
- * `POST /ticket`
66
+ * `GET /board/imagem/{id}`
776
67
  */
777
- export declare function criar_ticket(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.TicketCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Ticket>;
68
+ export declare function buscar_imagem_board(id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
778
69
  /**
779
- * Lista básica de tickets para seleção
70
+ * Busca um board pelo id
780
71
  *
781
- * Exige a permissão de leitura na área `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve id, número e título, do número maior para o menor. `busca` procura no título ou pelo número; `aplicativo_id` limita a um aplicativo.
72
+ * Devolve o board com o dono, os membros, se é favorito de quem pediu e se essa pessoa pode gerenciá-lo (`pode_gerenciar`: dono ou master do TermoAuth). Board `MEMBROS` de que a pessoa não participa responde `404`, como se não existisse.
782
73
  *
783
- * `GET /ticket/autocomplete`
74
+ * `GET /board/{id}`
784
75
  */
785
- export declare function buscar_auto_complete_ticket(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteTicket, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaTicketAutoComplete>;
76
+ export declare function buscar_pelo_id_board(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
786
77
  /**
787
- * Busca tickets por filtro
78
+ * Atualiza um board pelo id
788
79
  *
789
- * Exige a permissão de leitura na área `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve até 2000 tickets do mais novo para o mais antigo. Os filtros se somam: `aplicativo_id`, `status`, `abertos` (sem os resolvidos e fechados; `false` só eles), `responsavel_id`, `sem_responsavel`, `solicitante_id`, `prioridade`, `tipo`, `atrasados` e `busca` (título, descrição, solicitante ou número, com ou sem #).
80
+ * Atualização parcial. `nome`, `descricao` (`null` apaga) e `cor` valem para quem enxerga o board; `visibilidade` e `membro_ids` (a lista inteira) só para o dono ou o master do TermoAuth. `favorito` marca ou desmarca o board como favorito de quem pediu, e `miniatura` é o SVG (até 200 KB) da prévia mostrada na lista; esses dois não mudam a ordem de recentes.
790
81
  *
791
- * `GET /ticket/filtro`
82
+ * `PATCH /board/{id}`
792
83
  */
793
- export declare function buscar_pelo_filtro_ticket(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroTicket, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Ticket>>;
84
+ export declare function atualizar_pelo_id_board(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.BoardAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
794
85
  /**
795
- * Busca um ticket pelo id
86
+ * Exclui um board pelo id
796
87
  *
797
- * Exige a permissão de leitura na área `tickets` (qualquer das ações `ler`, `criar`, `editar` ou `deletar` libera a leitura). Devolve o ticket com aplicativo, solicitante, responsável, prazo (e se está atrasado), as tarefas de projeto criadas a partir dele e as contagens de comentários e anexos.
88
+ * Só o dono ou o master do TermoAuth. Exclusão lógica: o board some das listas e quem estava com ele aberto é desconectado.
798
89
  *
799
- * `GET /ticket/{id}`
90
+ * `DELETE /board/{id}`
800
91
  */
801
- export declare function buscar_pelo_id_ticket(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Ticket>;
92
+ export declare function deletar_pelo_id_board(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
802
93
  /**
803
- * Atualiza um ticket pelo id
94
+ * Duplica um board
804
95
  *
805
- * Exige a permissão `editar` na área `tickets`. Atualização parcial com as regras da abertura, mais `status` (`NOVO`, `EM_ATENDIMENTO`, `AGUARDANDO`, `RESOLVIDO`, `FECHADO`). Resolver ou fechar grava a data; reabrir apaga. Sair de `NOVO` conta como primeira resposta. Trocar a `prioridade` sem mandar `prazo` refaz o prazo pelo SLA a partir da abertura. `null` em `responsavel_id`, `prazo` ou `solicitante_email` apaga o valor. Cada mudança entra na atividade; o novo responsável e o solicitante (na troca de status) são notificados.
96
+ * Cria "Cópia de <nome>" com todo o conteúdo do canvas. Quem pediu vira o dono da cópia, que mantém a visibilidade do original, sem membros e sem favoritos.
806
97
  *
807
- * `PATCH /ticket/{id}`
98
+ * `POST /board/{id}/duplicar`
808
99
  */
809
- export declare function atualizar_pelo_id_ticket(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.TicketAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Ticket>;
100
+ export declare function duplicar_board(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
810
101
  /**
811
- * Exclui um ticket pelo id
102
+ * Envia uma imagem para o canvas
812
103
  *
813
- * Exige a permissão `deletar` na área `tickets`. Exclusão lógica. As tarefas criadas a partir do ticket continuam nos projetos.
104
+ * Guarda uma imagem PNG, JPG, GIF ou WEBP de até 10 MB (`arquivo_base64`, cru com `tipo` ou como data URL) e devolve o endereço público para o elemento de imagem do canvas. A imagem vai ao TermoBucket como arquivo público; se o bucket falhar, fica no banco e o endereço é relativo à API (`/board/imagem/{id}`).
814
105
  *
815
- * `DELETE /ticket/{id}`
106
+ * `POST /board/{id}/imagem`
816
107
  */
817
- export declare function deletar_pelo_id_ticket(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
108
+ export declare function guardar_imagem_board(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ImagemEnviar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ImagemGuardada>;