termo_core 0.1.7 → 0.1.8

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,107 +2,831 @@ 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 `/board`.
5
+ * Parâmetros de consulta e de cabeçalho de `/anexo/filtro`.
6
6
  */
7
- export interface ParametrosDeBuscarPaginadorBoard {
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 {
8
15
  pagina?: number;
9
16
  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 {
10
31
  nome?: string;
11
- favoritos?: boolean;
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;
12
43
  }
13
44
  /**
14
- * Parâmetros de consulta e de cabeçalho de `/board/autocomplete`.
45
+ * Parâmetros de consulta e de cabeçalho de `/comentario/filtro`.
15
46
  */
16
- export interface ParametrosDeBuscarAutoCompleteBoard {
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;
17
64
  busca?: string;
18
65
  pagina?: number;
19
66
  tamanho?: number;
20
67
  }
21
68
  /**
22
- * Parâmetros de consulta e de cabeçalho de `/board/filtro`.
69
+ * Parâmetros de consulta e de cabeçalho de `/documento/filtro`.
23
70
  */
24
- export interface ParametrosDeBuscarPeloFiltroBoard {
71
+ export interface ParametrosDeBuscarPeloFiltroDocumento {
72
+ aplicativo_id?: string;
25
73
  nome?: string;
26
- favoritos?: boolean;
27
- dono_id?: 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;
28
104
  }
29
105
  /**
30
- * Lista os boards paginados
106
+ * Só para a documentação: os valores aceitos em `tipo` (`TIPOS_DE_NOTIFICACAO`).
107
+ */
108
+ export type BuscarPaginadorNotificacaoTipo = "ATRIBUICAO" | "COMENTARIO" | "MENCAO" | "STATUS" | "PRAZO" | "TICKET";
109
+ /**
110
+ * Parâmetros de consulta e de cabeçalho de `/notificacao`.
111
+ */
112
+ export interface ParametrosDeBuscarPaginadorNotificacao {
113
+ pagina?: number;
114
+ tamanho?: number;
115
+ lida?: boolean;
116
+ /**
117
+ * Um dos tipos da notificação; vazio é sem filtro, outro valor responde `400`.
118
+ */
119
+ tipo?: BuscarPaginadorNotificacaoTipo;
120
+ }
121
+ /**
122
+ * Só para a documentação: os valores aceitos em `tipo` (`TIPOS_DE_NOTIFICACAO`).
123
+ */
124
+ export type BuscarPeloFiltroNotificacaoTipo = "ATRIBUICAO" | "COMENTARIO" | "MENCAO" | "STATUS" | "PRAZO" | "TICKET";
125
+ /**
126
+ * Parâmetros de consulta e de cabeçalho de `/notificacao/filtro`.
127
+ */
128
+ export interface ParametrosDeBuscarPeloFiltroNotificacao {
129
+ lida?: boolean;
130
+ /**
131
+ * Um dos tipos da notificação; vazio é sem filtro, outro valor responde `400`.
132
+ */
133
+ tipo?: BuscarPeloFiltroNotificacaoTipo;
134
+ }
135
+ /**
136
+ * Parâmetros de consulta e de cabeçalho de `/projeto`.
137
+ */
138
+ export interface ParametrosDeBuscarPaginadorProjeto {
139
+ pagina?: number;
140
+ tamanho?: number;
141
+ busca?: string;
142
+ status?: string;
143
+ aplicativo_id?: string;
144
+ membro_id?: string;
145
+ arquivado?: boolean;
146
+ }
147
+ /**
148
+ * Parâmetros de consulta e de cabeçalho de `/projeto/autocomplete`.
149
+ */
150
+ export interface ParametrosDeBuscarAutoCompleteProjeto {
151
+ busca?: string;
152
+ aplicativo_id?: string;
153
+ pagina?: number;
154
+ tamanho?: number;
155
+ }
156
+ /**
157
+ * Parâmetros de consulta e de cabeçalho de `/projeto/filtro`.
158
+ */
159
+ export interface ParametrosDeBuscarPeloFiltroProjeto {
160
+ /**
161
+ * Trecho do nome ou da descrição.
162
+ */
163
+ busca?: string;
164
+ status?: string;
165
+ aplicativo_id?: string;
166
+ /**
167
+ * Projetos em que o colaborador é dono ou membro.
168
+ */
169
+ membro_id?: string;
170
+ /**
171
+ * Padrão `false`: os arquivados só aparecem quando pedidos.
172
+ */
173
+ arquivado?: boolean;
174
+ }
175
+ /**
176
+ * Parâmetros de consulta e de cabeçalho de `/publico/ticket`.
177
+ */
178
+ export interface ParametrosDeCriarPeloAplicativoTicket {
179
+ /**
180
+ * Chave pública do aplicativo (pk_live_...)
181
+ *
182
+ * Enviado no cabeçalho `X-Chave-Publica`.
183
+ */
184
+ "X-Chave-Publica": string;
185
+ }
186
+ /**
187
+ * Parâmetros de consulta e de cabeçalho de `/secao`.
188
+ */
189
+ export interface ParametrosDeBuscarPaginadorSecao {
190
+ projeto_id?: string;
191
+ pagina?: number;
192
+ tamanho?: number;
193
+ }
194
+ /**
195
+ * Parâmetros de consulta e de cabeçalho de `/secao/autocomplete`.
196
+ */
197
+ export interface ParametrosDeBuscarAutoCompleteSecao {
198
+ projeto_id?: string;
199
+ busca?: string;
200
+ pagina?: number;
201
+ tamanho?: number;
202
+ }
203
+ /**
204
+ * Parâmetros de consulta e de cabeçalho de `/secao/filtro`.
205
+ */
206
+ export interface ParametrosDeBuscarPeloFiltroSecao {
207
+ projeto_id?: string;
208
+ nome?: string;
209
+ }
210
+ /**
211
+ * Parâmetros de consulta e de cabeçalho de `/tarefa`.
212
+ */
213
+ export interface ParametrosDeBuscarPaginadorTarefa {
214
+ pagina?: number;
215
+ tamanho?: number;
216
+ projeto_id?: string;
217
+ responsavel_id?: string;
218
+ concluida?: boolean;
219
+ busca?: string;
220
+ }
221
+ /**
222
+ * Parâmetros de consulta e de cabeçalho de `/tarefa/autocomplete`.
223
+ */
224
+ export interface ParametrosDeBuscarAutoCompleteTarefa {
225
+ busca?: string;
226
+ projeto_id?: string;
227
+ pagina?: number;
228
+ tamanho?: number;
229
+ }
230
+ /**
231
+ * Parâmetros de consulta e de cabeçalho de `/tarefa/filtro`.
232
+ */
233
+ export interface ParametrosDeBuscarPeloFiltroTarefa {
234
+ projeto_id?: string;
235
+ secao_id?: string;
236
+ responsavel_id?: string;
237
+ tarefa_pai_id?: string;
238
+ ticket_id?: string;
239
+ /**
240
+ * Tarefas dos projetos ligados a esse aplicativo.
241
+ */
242
+ aplicativo_id?: string;
243
+ etiqueta_id?: string;
244
+ /**
245
+ * `true` deixa de fora as subtarefas.
246
+ */
247
+ somente_principais?: boolean;
248
+ concluida?: boolean;
249
+ prazo_de?: string;
250
+ prazo_ate?: string;
251
+ /**
252
+ * Trecho do título ou da descrição.
253
+ */
254
+ busca?: string;
255
+ /**
256
+ * `true` ordena pelo prazo (mais próximo primeiro); senão pela coluna e pela ordem do quadro.
257
+ */
258
+ ordenar_por_prazo?: boolean;
259
+ }
260
+ /**
261
+ * Parâmetros de consulta e de cabeçalho de `/ticket`.
262
+ */
263
+ export interface ParametrosDeBuscarPaginadorTicket {
264
+ pagina?: number;
265
+ tamanho?: number;
266
+ aplicativo_id?: string;
267
+ status?: string;
268
+ abertos?: boolean;
269
+ responsavel_id?: string;
270
+ sem_responsavel?: boolean;
271
+ solicitante_id?: string;
272
+ prioridade?: string;
273
+ tipo?: string;
274
+ atrasados?: boolean;
275
+ busca?: string;
276
+ }
277
+ /**
278
+ * Parâmetros de consulta e de cabeçalho de `/ticket/autocomplete`.
279
+ */
280
+ export interface ParametrosDeBuscarAutoCompleteTicket {
281
+ busca?: string;
282
+ aplicativo_id?: string;
283
+ pagina?: number;
284
+ tamanho?: number;
285
+ }
286
+ /**
287
+ * Parâmetros de consulta e de cabeçalho de `/ticket/filtro`.
288
+ */
289
+ export interface ParametrosDeBuscarPeloFiltroTicket {
290
+ aplicativo_id?: string;
291
+ status?: string;
292
+ /**
293
+ * `true` traz só os que não estão resolvidos nem fechados; `false`, só os resolvidos e fechados.
294
+ */
295
+ abertos?: boolean;
296
+ responsavel_id?: string;
297
+ /**
298
+ * `true` traz só os tickets sem responsável.
299
+ */
300
+ sem_responsavel?: boolean;
301
+ solicitante_id?: string;
302
+ prioridade?: string;
303
+ tipo?: string;
304
+ /**
305
+ * `true` traz só os que estouraram o prazo.
306
+ */
307
+ atrasados?: boolean;
308
+ /**
309
+ * Trecho do título, da descrição, do solicitante ou o número.
310
+ */
311
+ busca?: string;
312
+ }
313
+ /**
314
+ * Anexa um arquivo ou link
315
+ *
316
+ * 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.
317
+ *
318
+ * `POST /anexo`
319
+ */
320
+ export declare function criar_anexo(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.AnexoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Anexo>;
321
+ /**
322
+ * Lista os anexos de uma tarefa ou ticket
323
+ *
324
+ * 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`.
325
+ *
326
+ * `GET /anexo/filtro`
327
+ */
328
+ export declare function buscar_pelo_filtro_anexo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroAnexo, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Anexo>>;
329
+ /**
330
+ * Baixa um anexo pelo id
331
+ *
332
+ * 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.
333
+ *
334
+ * `GET /anexo/{id}`
335
+ */
336
+ export declare function buscar_pelo_id_anexo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.AnexoComConteudo>;
337
+ /**
338
+ * Renomeia um anexo pelo id
339
+ *
340
+ * Exige a permissão `editar` na área `projetos` ou `tickets`. Troca o `nome` (obrigatório, até 200 caracteres).
341
+ *
342
+ * `PATCH /anexo/{id}`
343
+ */
344
+ 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>;
345
+ /**
346
+ * Exclui um anexo pelo id
347
+ *
348
+ * Exige a permissão `deletar` na área `projetos` ou `tickets`. Exclusão lógica.
349
+ *
350
+ * `DELETE /anexo/{id}`
351
+ */
352
+ export declare function deletar_pelo_id_anexo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
353
+ /**
354
+ * Lista os aplicativos paginados
355
+ *
356
+ * 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.
357
+ *
358
+ * `GET /aplicativo`
359
+ */
360
+ export declare function buscar_paginador_aplicativo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAplicativo>;
361
+ /**
362
+ * Lista básica de aplicativos para seleção
363
+ *
364
+ * 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.
365
+ *
366
+ * `GET /aplicativo/autocomplete`
367
+ */
368
+ export declare function buscar_auto_complete_aplicativo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaAplicativoAutoComplete>;
369
+ /**
370
+ * Busca aplicativos por filtro
371
+ *
372
+ * 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.
373
+ *
374
+ * `GET /aplicativo/filtro`
375
+ */
376
+ export declare function buscar_pelo_filtro_aplicativo(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Aplicativo>>;
377
+ /**
378
+ * Busca um aplicativo pelo id
379
+ *
380
+ * 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.
381
+ *
382
+ * `GET /aplicativo/{id}`
383
+ */
384
+ export declare function buscar_pelo_id_aplicativo(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Aplicativo>;
385
+ /**
386
+ * Lista os comentários paginados
387
+ *
388
+ * 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.
389
+ *
390
+ * `GET /comentario`
391
+ */
392
+ export declare function buscar_paginador_comentario(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorComentario, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaComentario>;
393
+ /**
394
+ * Comenta numa tarefa ou ticket
395
+ *
396
+ * 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.
397
+ *
398
+ * `POST /comentario`
399
+ */
400
+ export declare function criar_comentario(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ComentarioCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Comentario>;
401
+ /**
402
+ * Lista a conversa de uma tarefa ou ticket
403
+ *
404
+ * 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`.
405
+ *
406
+ * `GET /comentario/filtro`
407
+ */
408
+ export declare function buscar_pelo_filtro_comentario(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroComentario, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Comentario>>;
409
+ /**
410
+ * Busca um comentário pelo id
411
+ *
412
+ * 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.
413
+ *
414
+ * `GET /comentario/{id}`
415
+ */
416
+ export declare function buscar_pelo_id_comentario(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Comentario>;
417
+ /**
418
+ * Edita um comentário pelo id
419
+ *
420
+ * 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`.
421
+ *
422
+ * `PATCH /comentario/{id}`
423
+ */
424
+ 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>;
425
+ /**
426
+ * Exclui um comentário pelo id
427
+ *
428
+ * Exige a permissão `deletar` na área `projetos` ou `tickets`. Exclusão lógica. Só quem escreveu exclui.
429
+ *
430
+ * `DELETE /comentario/{id}`
431
+ */
432
+ export declare function deletar_pelo_id_comentario(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
433
+ /**
434
+ * Lista os documentos paginados
435
+ *
436
+ * 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.
437
+ *
438
+ * `GET /documento`
439
+ */
440
+ export declare function buscar_paginador_documento(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorDocumento, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaDocumento>;
441
+ /**
442
+ * Cadastra um documento de um aplicativo
443
+ *
444
+ * 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).
445
+ *
446
+ * `POST /documento`
447
+ */
448
+ export declare function criar_documento(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.DocumentoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Documento>;
449
+ /**
450
+ * Lista básica de documentos para seleção
451
+ *
452
+ * 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.
453
+ *
454
+ * `GET /documento/autocomplete`
455
+ */
456
+ export declare function buscar_auto_complete_documento(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteDocumento, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaDocumentoAutoComplete>;
457
+ /**
458
+ * Busca documentos por filtro
459
+ *
460
+ * 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.
461
+ *
462
+ * `GET /documento/filtro`
463
+ */
464
+ export declare function buscar_pelo_filtro_documento(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroDocumento, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Documento>>;
465
+ /**
466
+ * Busca um documento pelo id
467
+ *
468
+ * 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.
469
+ *
470
+ * `GET /documento/{id}`
471
+ */
472
+ export declare function buscar_pelo_id_documento(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Documento>;
473
+ /**
474
+ * Atualiza um documento pelo id
475
+ *
476
+ * 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.
477
+ *
478
+ * `PATCH /documento/{id}`
479
+ */
480
+ 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>;
481
+ /**
482
+ * Exclui um documento pelo id
483
+ *
484
+ * 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.
485
+ *
486
+ * `DELETE /documento/{id}`
487
+ */
488
+ export declare function deletar_pelo_id_documento(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
489
+ /**
490
+ * Lista as etiquetas paginadas
491
+ *
492
+ * 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.
493
+ *
494
+ * `GET /etiqueta`
495
+ */
496
+ export declare function buscar_paginador_etiqueta(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorEtiqueta, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaEtiqueta>;
497
+ /**
498
+ * Cadastra uma etiqueta
499
+ *
500
+ * 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`).
501
+ *
502
+ * `POST /etiqueta`
503
+ */
504
+ export declare function criar_etiqueta(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.EtiquetaCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Etiqueta>;
505
+ /**
506
+ * Lista básica de etiquetas para seleção
507
+ *
508
+ * 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.
509
+ *
510
+ * `GET /etiqueta/autocomplete`
511
+ */
512
+ export declare function buscar_auto_complete_etiqueta(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteEtiqueta, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaEtiquetaResumo>;
513
+ /**
514
+ * Busca etiquetas por filtro
515
+ *
516
+ * 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.
517
+ *
518
+ * `GET /etiqueta/filtro`
519
+ */
520
+ export declare function buscar_pelo_filtro_etiqueta(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroEtiqueta, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Etiqueta>>;
521
+ /**
522
+ * Busca uma etiqueta pelo id
523
+ *
524
+ * 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.
525
+ *
526
+ * `GET /etiqueta/{id}`
527
+ */
528
+ export declare function buscar_pelo_id_etiqueta(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Etiqueta>;
529
+ /**
530
+ * Atualiza uma etiqueta pelo id
531
+ *
532
+ * Exige a permissão `editar` na área `projetos`. Atualização parcial de `nome` e `cor`, com as mesmas regras do cadastro.
533
+ *
534
+ * `PATCH /etiqueta/{id}`
535
+ */
536
+ 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>;
537
+ /**
538
+ * Exclui uma etiqueta pelo id
539
+ *
540
+ * Exige a permissão `deletar` na área `projetos`. Exclusão lógica: a etiqueta some das leituras e sai das tarefas que a usavam.
541
+ *
542
+ * `DELETE /etiqueta/{id}`
543
+ */
544
+ export declare function deletar_pelo_id_etiqueta(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
545
+ /**
546
+ * Atividade de uma tarefa ou ticket
547
+ *
548
+ * 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`.
549
+ *
550
+ * `GET /historico/filtro`
551
+ */
552
+ export declare function buscar_pelo_filtro_historico(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroHistorico, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Historico>>;
553
+ /**
554
+ * Caixa de entrada paginada
555
+ *
556
+ * 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` e `tipo` (`ATRIBUICAO`, `COMENTARIO`, `MENCAO`, `STATUS`, `PRAZO` ou `TICKET`; vazio é sem filtro) filtram; `nao_lidas` traz o total ainda não lido (o número do sino), com qualquer filtro.
557
+ *
558
+ * `GET /notificacao`
559
+ */
560
+ export declare function buscar_paginador_notificacao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorNotificacao, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaNotificacao>;
561
+ /**
562
+ * Marca todas as notificações como lidas
563
+ *
564
+ * 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`.
565
+ *
566
+ * `PATCH /notificacao`
567
+ */
568
+ export declare function marcar_todas_notificacao(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.NotificacaoMarcarTodas, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.NotificacoesMarcadas>;
569
+ /**
570
+ * Busca notificações por filtro
571
+ *
572
+ * 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`.
573
+ *
574
+ * `GET /notificacao/filtro`
575
+ */
576
+ export declare function buscar_pelo_filtro_notificacao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroNotificacao, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Notificacao>>;
577
+ /**
578
+ * Busca uma notificação pelo id
579
+ *
580
+ * Livre para qualquer usuário autenticado: vale sempre para o colaborador de quem está logado. Só encontra as notificações da própria pessoa.
581
+ *
582
+ * `GET /notificacao/{id}`
583
+ */
584
+ export declare function buscar_pelo_id_notificacao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Notificacao>;
585
+ /**
586
+ * Marca uma notificação como lida ou não lida
587
+ *
588
+ * 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.
589
+ *
590
+ * `PATCH /notificacao/{id}`
591
+ */
592
+ 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>;
593
+ /**
594
+ * Exclui uma notificação pelo id
595
+ *
596
+ * 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).
597
+ *
598
+ * `DELETE /notificacao/{id}`
599
+ */
600
+ export declare function deletar_pelo_id_notificacao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
601
+ /**
602
+ * Lista os projetos paginados
603
+ *
604
+ * 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.
605
+ *
606
+ * `GET /projeto`
607
+ */
608
+ export declare function buscar_paginador_projeto(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorProjeto, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaProjeto>;
609
+ /**
610
+ * Cadastra um projeto
611
+ *
612
+ * 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").
613
+ *
614
+ * `POST /projeto`
615
+ */
616
+ export declare function criar_projeto(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.ProjetoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Projeto>;
617
+ /**
618
+ * Lista básica de projetos para seleção
619
+ *
620
+ * 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.
621
+ *
622
+ * `GET /projeto/autocomplete`
623
+ */
624
+ export declare function buscar_auto_complete_projeto(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteProjeto, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaProjetoAutoComplete>;
625
+ /**
626
+ * Busca projetos por filtro
627
+ *
628
+ * 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.
629
+ *
630
+ * `GET /projeto/filtro`
631
+ */
632
+ export declare function buscar_pelo_filtro_projeto(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroProjeto, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Projeto>>;
633
+ /**
634
+ * Busca um projeto pelo id
635
+ *
636
+ * 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.
637
+ *
638
+ * `GET /projeto/{id}`
639
+ */
640
+ export declare function buscar_pelo_id_projeto(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Projeto>;
641
+ /**
642
+ * Atualiza um projeto pelo id
643
+ *
644
+ * 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.
645
+ *
646
+ * `PATCH /projeto/{id}`
647
+ */
648
+ 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>;
649
+ /**
650
+ * Exclui um projeto pelo id
651
+ *
652
+ * 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.
653
+ *
654
+ * `DELETE /projeto/{id}`
655
+ */
656
+ export declare function deletar_pelo_id_projeto(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
657
+ /**
658
+ * Abre um ticket pelo aplicativo atendido
659
+ *
660
+ * 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.
661
+ *
662
+ * `POST /publico/ticket`
663
+ */
664
+ export declare function criar_pelo_aplicativo_ticket(parametros: ParametrosDeCriarPeloAplicativoTicket, corpo_da_requisicao: tipos.TicketDoAplicativo, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.TicketAberto>;
665
+ /**
666
+ * Lista as seções paginadas
667
+ *
668
+ * 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.
669
+ *
670
+ * `GET /secao`
671
+ */
672
+ export declare function buscar_paginador_secao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorSecao, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaSecao>;
673
+ /**
674
+ * Cadastra uma seção (coluna do quadro)
675
+ *
676
+ * 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.
677
+ *
678
+ * `POST /secao`
679
+ */
680
+ export declare function criar_secao(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.SecaoCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Secao>;
681
+ /**
682
+ * Lista básica de seções para seleção
683
+ *
684
+ * 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.
685
+ *
686
+ * `GET /secao/autocomplete`
687
+ */
688
+ export declare function buscar_auto_complete_secao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteSecao, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaSecaoAutoComplete>;
689
+ /**
690
+ * Busca seções por filtro
691
+ *
692
+ * 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.
693
+ *
694
+ * `GET /secao/filtro`
695
+ */
696
+ export declare function buscar_pelo_filtro_secao(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroSecao, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Secao>>;
697
+ /**
698
+ * Busca uma seção pelo id
699
+ *
700
+ * 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.
701
+ *
702
+ * `GET /secao/{id}`
703
+ */
704
+ export declare function buscar_pelo_id_secao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Secao>;
705
+ /**
706
+ * Atualiza uma seção pelo id
707
+ *
708
+ * 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). `conclui_tarefa: true` faz dela a coluna que conclui do projeto (uma só): desliga a anterior, conclui as tarefas principais abertas dela e traz para o fim dela as concluídas das outras colunas, com a linha na atividade de cada tarefa; `false` só desliga, sem mexer em tarefa.
709
+ *
710
+ * `PATCH /secao/{id}`
711
+ */
712
+ 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>;
713
+ /**
714
+ * Exclui uma seção pelo id
715
+ *
716
+ * 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 (a que conclui só se não sobrar outra, e aí as abertas são concluídas). A coluna que conclui não sai: desligue a opção antes.
717
+ *
718
+ * `DELETE /secao/{id}`
719
+ */
720
+ export declare function deletar_pelo_id_secao(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
721
+ /**
722
+ * Lista as tarefas paginadas
723
+ *
724
+ * 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.
725
+ *
726
+ * `GET /tarefa`
727
+ */
728
+ export declare function buscar_paginador_tarefa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorTarefa, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaTarefa>;
729
+ /**
730
+ * Cadastra uma tarefa
731
+ *
732
+ * Exige a permissão `criar` na área `projetos`. Cria a tarefa no projeto. Sem `secao_id`, entra na primeira coluna que não conclui tarefas (na que conclui, já nasce concluída); 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` e `prazo` são obrigatórios (título até 300 caracteres); sem `inicio`, ele é hoje (São Paulo) e não pode passar do `prazo`; sem `responsavel_id`, quem criou vira o responsável. `descricao` até 20000; `prioridade` é `BAIXA`, `MEDIA`, `ALTA` ou `URGENTE`; `estimativa` de 0 a 10000 pontos. 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.
733
+ *
734
+ * `POST /tarefa`
735
+ */
736
+ export declare function criar_tarefa(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.TarefaCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Tarefa>;
737
+ /**
738
+ * Lista básica de tarefas para seleção
739
+ *
740
+ * 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.
741
+ *
742
+ * `GET /tarefa/autocomplete`
743
+ */
744
+ export declare function buscar_auto_complete_tarefa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteTarefa, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaTarefaAutoComplete>;
745
+ /**
746
+ * Busca tarefas por filtro
747
+ *
748
+ * 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.
749
+ *
750
+ * `GET /tarefa/filtro`
751
+ */
752
+ export declare function buscar_pelo_filtro_tarefa(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroTarefa, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Tarefa>>;
753
+ /**
754
+ * Busca uma tarefa pelo id
31
755
  *
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.
756
+ * 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.
33
757
  *
34
- * `GET /board`
758
+ * `GET /tarefa/{id}`
35
759
  */
36
- export declare function buscar_paginador_board(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorBoard, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaBoard>;
760
+ export declare function buscar_pelo_id_tarefa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Tarefa>;
37
761
  /**
38
- * Cria um board
762
+ * Atualiza uma tarefa pelo id
39
763
  *
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).
764
+ * 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`. Na tarefa principal, a coluna que conclui manda: entrar nela conclui e sair reabre (vence um `concluida` contraditório); marcar `concluida` fora dela leva a tarefa para o fim dela; desmarcar dentro dela devolve a tarefa para o fim da coluna anterior. `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.
41
765
  *
42
- * `POST /board`
766
+ * `PATCH /tarefa/{id}`
43
767
  */
44
- export declare function criar_board(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.BoardCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
768
+ 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>;
45
769
  /**
46
- * Lista básica de boards para seleção
770
+ * Exclui uma tarefa pelo id
47
771
  *
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.
772
+ * 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.
49
773
  *
50
- * `GET /board/autocomplete`
774
+ * `DELETE /tarefa/{id}`
51
775
  */
52
- export declare function buscar_auto_complete_board(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteBoard, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaBoardAutoComplete>;
776
+ export declare function deletar_pelo_id_tarefa(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
53
777
  /**
54
- * Busca boards por filtro
778
+ * Fila de tickets paginada
55
779
  *
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.
780
+ * 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`.
57
781
  *
58
- * `GET /board/filtro`
782
+ * `GET /ticket`
59
783
  */
60
- export declare function buscar_pelo_filtro_board(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroBoard, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Board>>;
784
+ export declare function buscar_paginador_ticket(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPaginadorTicket, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaTicket>;
61
785
  /**
62
- * Baixa uma imagem do canvas guardada no banco
786
+ * Abre um ticket de suporte
63
787
  *
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.
788
+ * 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.
65
789
  *
66
- * `GET /board/imagem/{id}`
790
+ * `POST /ticket`
67
791
  */
68
- export declare function buscar_imagem_board(id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
792
+ export declare function criar_ticket(credencial_de_acesso: CredencialDeAcesso, corpo_da_requisicao: tipos.TicketCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Ticket>;
69
793
  /**
70
- * Busca um board pelo id
794
+ * Lista básica de tickets para seleção
71
795
  *
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.
796
+ * 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.
73
797
  *
74
- * `GET /board/{id}`
798
+ * `GET /ticket/autocomplete`
75
799
  */
76
- export declare function buscar_pelo_id_board(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
800
+ export declare function buscar_auto_complete_ticket(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarAutoCompleteTicket, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.PaginaTicketAutoComplete>;
77
801
  /**
78
- * Atualiza um board pelo id
802
+ * Busca tickets por filtro
79
803
  *
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.
804
+ * 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 #).
81
805
  *
82
- * `PATCH /board/{id}`
806
+ * `GET /ticket/filtro`
83
807
  */
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>;
808
+ export declare function buscar_pelo_filtro_ticket(credencial_de_acesso: CredencialDeAcesso, parametros?: ParametrosDeBuscarPeloFiltroTicket, opcoes_da_chamada?: OpcoesDaChamada): Promise<Array<tipos.Ticket>>;
85
809
  /**
86
- * Exclui um board pelo id
810
+ * Busca um ticket pelo id
87
811
  *
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.
812
+ * 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.
89
813
  *
90
- * `DELETE /board/{id}`
814
+ * `GET /ticket/{id}`
91
815
  */
92
- export declare function deletar_pelo_id_board(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;
816
+ export declare function buscar_pelo_id_ticket(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Ticket>;
93
817
  /**
94
- * Duplica um board
818
+ * Atualiza um ticket pelo id
95
819
  *
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.
820
+ * 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.
97
821
  *
98
- * `POST /board/{id}/duplicar`
822
+ * `PATCH /ticket/{id}`
99
823
  */
100
- export declare function duplicar_board(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
824
+ 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>;
101
825
  /**
102
- * Envia uma imagem para o canvas
826
+ * Exclui um ticket pelo id
103
827
  *
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}`).
828
+ * Exige a permissão `deletar` na área `tickets`. Exclusão lógica. As tarefas criadas a partir do ticket continuam nos projetos.
105
829
  *
106
- * `POST /board/{id}/imagem`
830
+ * `DELETE /ticket/{id}`
107
831
  */
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>;
832
+ export declare function deletar_pelo_id_ticket(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<void>;