evo360-types 1.3.784 → 1.3.787
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.
- package/dist/apps/evo-chat/forward/zod-schemas.d.ts +4 -4
- package/dist/apps/evo-finops/zod-schemas.d.ts +465 -30
- package/dist/apps/evo-finops/zod-schemas.js +123 -2
- package/dist/apps/evo-finops/zod-schemas.ts +131 -0
- package/dist/types/evo-finops/common/contract.d.ts +8 -0
- package/dist/types/evo-finops/common/contract.ts +8 -0
- package/dist/types/evo-finops/common/proposal.d.ts +25 -0
- package/dist/types/evo-finops/common/proposal.ts +28 -0
- package/dist/types/nex-vendas/adhesion.d.ts +253 -0
- package/dist/types/nex-vendas/adhesion.js +15 -0
- package/dist/types/nex-vendas/adhesion.ts +280 -0
- package/dist/types/nex-vendas/index.d.ts +3 -0
- package/dist/types/nex-vendas/index.js +3 -0
- package/dist/types/nex-vendas/index.ts +3 -0
- package/dist/types/nex-vendas/journey.d.ts +82 -4
- package/dist/types/nex-vendas/journey.ts +86 -3
- package/dist/types/nex-vendas/notifications.d.ts +14 -0
- package/dist/types/nex-vendas/notifications.js +21 -0
- package/dist/types/nex-vendas/notifications.ts +21 -0
- package/dist/types/nex-vendas/offer.d.ts +129 -0
- package/dist/types/nex-vendas/offer.js +10 -0
- package/dist/types/nex-vendas/offer.ts +154 -0
- package/package.json +1 -1
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
import type { NexFinopsProposalOrigem } from '../evo-finops/common/proposal';
|
|
2
|
+
import type { INexVendasJourneyLeadRef } from './journey';
|
|
3
|
+
/**
|
|
4
|
+
* Como o cliente formaliza o contrato:
|
|
5
|
+
* - `assinatura_eletronica`: envelope D4Sign (caminho original da feat-130);
|
|
6
|
+
* - `adesao`: click-wrap — o cliente lê as Condições Gerais (CG) + o quadro-resumo
|
|
7
|
+
* da jornada e aceita por clique, sem provider de assinatura.
|
|
8
|
+
*
|
|
9
|
+
* O tipo MORA NO MODELO DE CONTRATO (`contract-templates/{key}.contract_type`) e é
|
|
10
|
+
* copiado congelado na proposta (ao escolher o modelo), na jornada (no submit dos
|
|
11
|
+
* dados) e no contrato finops. **Ausente = `assinatura_eletronica`** em todos esses
|
|
12
|
+
* documentos: modelos, propostas, jornadas e contratos anteriores à feat-325 são
|
|
13
|
+
* todos D4Sign. Use `NEX_VENDAS_DEFAULT_CONTRACT_TYPE` para resolver o ausente.
|
|
14
|
+
*/
|
|
15
|
+
export type NexVendasContractType = 'assinatura_eletronica' | 'adesao';
|
|
16
|
+
/** Leitura do `contract_type` ausente (legado). */
|
|
17
|
+
export declare const NEX_VENDAS_DEFAULT_CONTRACT_TYPE: NexVendasContractType;
|
|
18
|
+
/** Valor de `signature.provider` gravado pelo aceite por adesão (D3: status segue `contrato_assinado`). */
|
|
19
|
+
export declare const NEX_VENDAS_ADHESION_SIGNATURE_PROVIDER = "adesao";
|
|
20
|
+
/**
|
|
21
|
+
* Versão das Condições Gerais (CG) em PDF estático, subida pelo Nexus no modelo de
|
|
22
|
+
* adesão (D1). O `sha256` é dos BYTES do PDF, calculado pelo backend no upload.
|
|
23
|
+
*/
|
|
24
|
+
export interface INexVendasContractTemplateAdhesionCg {
|
|
25
|
+
/** Rótulo da versão, legível (ex.: `2026.11-v1`). */
|
|
26
|
+
version: string;
|
|
27
|
+
/** SHA-256 hex dos bytes do PDF. */
|
|
28
|
+
sha256: string;
|
|
29
|
+
/** Caminho do objeto no bucket, sem `gs://` e sem o nome do bucket. */
|
|
30
|
+
storage_path: string;
|
|
31
|
+
/** Data civil `YYYY-MM-DD` a partir da qual esta versão vale. */
|
|
32
|
+
effective_from: string;
|
|
33
|
+
/** Nome original do arquivo enviado (exibição/download). */
|
|
34
|
+
filename: string;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* Bloco `adhesion` do modelo de contrato. Só existe quando `contract_type === 'adesao'`.
|
|
38
|
+
*/
|
|
39
|
+
export interface INexVendasContractTemplateAdhesion {
|
|
40
|
+
cg: INexVendasContractTemplateAdhesionCg;
|
|
41
|
+
/**
|
|
42
|
+
* D4 — exigir OTP por e-mail antes do aceite. Ausente/`false` = sem OTP (MVP).
|
|
43
|
+
* O jurídico decide por modelo.
|
|
44
|
+
*/
|
|
45
|
+
require_email_otp?: boolean | null;
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* Campos que a feat-325 acrescenta ao modelo de contrato
|
|
49
|
+
* (`core/nexus/apps/nex-vendas/contract-templates/{key}`). O documento completo é
|
|
50
|
+
* tipado no `@evo/nex-model` (`INexVendasContractTemplate`), que estende este
|
|
51
|
+
* fragmento.
|
|
52
|
+
*/
|
|
53
|
+
export interface INexVendasContractTemplateFormalization {
|
|
54
|
+
/** Ausente = `assinatura_eletronica` (`NEX_VENDAS_DEFAULT_CONTRACT_TYPE`). */
|
|
55
|
+
contract_type?: NexVendasContractType | null;
|
|
56
|
+
adhesion?: INexVendasContractTemplateAdhesion | null;
|
|
57
|
+
}
|
|
58
|
+
/**
|
|
59
|
+
* Quadro-resumo da jornada, renderizado pelo `nex_vendas_pdf` com os dados da
|
|
60
|
+
* proposta/cliente, mais a versão das CG congelada NO RENDER (D15: o cliente aceita
|
|
61
|
+
* o que vê). Correção de dados ou virada do dia civil (SP, D16) regera o quadro —
|
|
62
|
+
* hash novo — e `corrections_count` sobe.
|
|
63
|
+
*/
|
|
64
|
+
export interface INexVendasJourneyAdhesionDocument {
|
|
65
|
+
/** SHA-256 hex dos BYTES do PDF do quadro-resumo. */
|
|
66
|
+
summary_sha256: string;
|
|
67
|
+
/** Caminho do rascunho do quadro no bucket (sem `gs://` e sem o bucket). */
|
|
68
|
+
summary_storage_path: string;
|
|
69
|
+
/** Versão das CG congelada neste render. */
|
|
70
|
+
cg_version: string;
|
|
71
|
+
/** SHA-256 hex das CG congeladas neste render. */
|
|
72
|
+
cg_sha256: string;
|
|
73
|
+
/** Caminho das CG no bucket (o do modelo no momento do render). */
|
|
74
|
+
cg_storage_path?: string | null;
|
|
75
|
+
/** Data de emissão impressa no quadro (`YYYY-MM-DD`, dia civil em SP). */
|
|
76
|
+
issued_on?: string | null;
|
|
77
|
+
rendered_at: Date;
|
|
78
|
+
/** Quantas vezes o quadro foi regerado por correção de dados (teto D10). */
|
|
79
|
+
corrections_count: number;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Resumo do aceite gravado na jornada (o registro completo é `INexVendasAcceptance`).
|
|
83
|
+
* Os campos preenchidos depois do aceite (comprovante, evidência no bucket) moram
|
|
84
|
+
* aqui, não no registro imutável.
|
|
85
|
+
*/
|
|
86
|
+
export interface INexVendasJourneyAcceptanceRef {
|
|
87
|
+
/** Id do doc em `acceptances/` (= protocolo em minúsculas). */
|
|
88
|
+
acceptance_id: string;
|
|
89
|
+
/** Protocolo exibido ao cliente. */
|
|
90
|
+
protocol: string;
|
|
91
|
+
accepted_at: Date;
|
|
92
|
+
/** Cópia dos PDFs para o bucket de evidências: `pending` até conferir o hash da cópia. */
|
|
93
|
+
evidence_status?: 'pending' | 'stored' | null;
|
|
94
|
+
/** Comprovante PDF, gerado depois do aceite. */
|
|
95
|
+
receipt?: INexVendasAcceptanceReceipt | null;
|
|
96
|
+
}
|
|
97
|
+
/**
|
|
98
|
+
* `data` do evento `contract_accepted` da jornada (gravado na transação do aceite,
|
|
99
|
+
* idempotente). Entra em `JOURNEY_STATUS_ENTRY_EVENTS` ao lado de `contract_signed`.
|
|
100
|
+
*/
|
|
101
|
+
export interface INexVendasJourneyContractAcceptedEventData {
|
|
102
|
+
acceptance_id: string;
|
|
103
|
+
protocol: string;
|
|
104
|
+
summary_sha256: string;
|
|
105
|
+
cg_sha256: string;
|
|
106
|
+
cg_version: string;
|
|
107
|
+
declaration_version: string;
|
|
108
|
+
}
|
|
109
|
+
/** Collection `core/nexus/apps/nex-vendas/acceptances/{acceptance_id}` (append-only). */
|
|
110
|
+
export declare const NEX_VENDAS_ACCEPTANCES_COLLECTION = "acceptances";
|
|
111
|
+
export interface INexVendasAcceptanceCg {
|
|
112
|
+
version: string;
|
|
113
|
+
sha256: string;
|
|
114
|
+
/** Caminho da cópia no bucket de evidências. */
|
|
115
|
+
storage_path: string;
|
|
116
|
+
effective_from?: string | null;
|
|
117
|
+
filename?: string | null;
|
|
118
|
+
}
|
|
119
|
+
export interface INexVendasAcceptanceSummary {
|
|
120
|
+
sha256: string;
|
|
121
|
+
/** Caminho da cópia no bucket de evidências. */
|
|
122
|
+
storage_path: string;
|
|
123
|
+
issued_on?: string | null;
|
|
124
|
+
}
|
|
125
|
+
/** Declaração exibida ao lado do checkbox, como estava no momento do aceite. */
|
|
126
|
+
export interface INexVendasAcceptanceDeclaration {
|
|
127
|
+
version: string;
|
|
128
|
+
text: string;
|
|
129
|
+
/** SHA-256 hex do `text` (UTF-8). */
|
|
130
|
+
sha256: string;
|
|
131
|
+
}
|
|
132
|
+
/**
|
|
133
|
+
* Identidade COMO DECLARADA no formulário da jornada — não verificada por documento.
|
|
134
|
+
*/
|
|
135
|
+
export interface INexVendasAcceptanceIdentity {
|
|
136
|
+
name: string;
|
|
137
|
+
email: string;
|
|
138
|
+
/** E.164. */
|
|
139
|
+
phone: string;
|
|
140
|
+
document_type?: 'cpf' | 'cnpj' | null;
|
|
141
|
+
/** CPF ou CNPJ do contratante, só dígitos. */
|
|
142
|
+
document?: string | null;
|
|
143
|
+
/** CPF de quem aceita (responsável no PJ), só dígitos. */
|
|
144
|
+
responsible_cpf?: string | null;
|
|
145
|
+
company_legal_name?: string | null;
|
|
146
|
+
/** Verificação de identidade feita antes do aceite (D4: `none` no MVP). */
|
|
147
|
+
verification?: {
|
|
148
|
+
method: 'none' | 'email_otp';
|
|
149
|
+
verified_at?: Date | null;
|
|
150
|
+
} | null;
|
|
151
|
+
}
|
|
152
|
+
/** Dados capturados da requisição do aceite (telemetria do cliente + cabeçalhos). */
|
|
153
|
+
export interface INexVendasAcceptanceClient {
|
|
154
|
+
/** IP resolvido pelo número de hops confiáveis (não o 1º item do XFF). */
|
|
155
|
+
ip: string | null;
|
|
156
|
+
/** `x-forwarded-for` completo, para perícia. */
|
|
157
|
+
ip_chain: string[];
|
|
158
|
+
user_agent: string | null;
|
|
159
|
+
accept_language: string | null;
|
|
160
|
+
/** D11 — só telemetria: o aceite não depende da rolagem. */
|
|
161
|
+
viewed_to_end: boolean | null;
|
|
162
|
+
}
|
|
163
|
+
export interface INexVendasAcceptanceServer {
|
|
164
|
+
/** Relógio do servidor, dentro da transação do aceite. */
|
|
165
|
+
accepted_at: Date;
|
|
166
|
+
/** `x-cloud-trace-context`: liga ao log da requisição enquanto ele existir. */
|
|
167
|
+
trace_id: string | null;
|
|
168
|
+
/** `K_REVISION` da function que gravou. */
|
|
169
|
+
function_revision: string | null;
|
|
170
|
+
}
|
|
171
|
+
export interface INexVendasAcceptanceReceipt {
|
|
172
|
+
storage_path: string;
|
|
173
|
+
sha256: string;
|
|
174
|
+
}
|
|
175
|
+
/**
|
|
176
|
+
* Registro imutável do aceite por adesão (spec feat-325 §Auditoria 1; BA §4.2).
|
|
177
|
+
*
|
|
178
|
+
* Append-only: rules sem update/delete; o model expõe só `createInTransaction` e
|
|
179
|
+
* leitura. Nasce completo, com exceção de `receipt` (null na criação; o comprovante
|
|
180
|
+
* e o `evidence_status` vivem no resumo da jornada, `INexVendasJourneyAcceptanceRef`).
|
|
181
|
+
*
|
|
182
|
+
* Doc id determinístico (`acceptance_id`) — repetição do aceite com os mesmos hashes
|
|
183
|
+
* devolve o mesmo protocolo.
|
|
184
|
+
*/
|
|
185
|
+
export interface INexVendasAcceptance {
|
|
186
|
+
/** = doc id. */
|
|
187
|
+
id: string;
|
|
188
|
+
schema_version: 1;
|
|
189
|
+
/** Protocolo legível e único exibido ao cliente. */
|
|
190
|
+
protocol: string;
|
|
191
|
+
short_code: string;
|
|
192
|
+
/** Id da proposta (doc em `nex-finops/proposals`). */
|
|
193
|
+
proposal_id: string;
|
|
194
|
+
/** Id do contrato finops (draft no momento do aceite), ou null se ainda não criado. */
|
|
195
|
+
contract_id: string | null;
|
|
196
|
+
contract_type: 'adesao';
|
|
197
|
+
template_key: string;
|
|
198
|
+
template_revision: number;
|
|
199
|
+
cg: INexVendasAcceptanceCg;
|
|
200
|
+
summary: INexVendasAcceptanceSummary;
|
|
201
|
+
declaration: INexVendasAcceptanceDeclaration;
|
|
202
|
+
identity: INexVendasAcceptanceIdentity;
|
|
203
|
+
client: INexVendasAcceptanceClient;
|
|
204
|
+
server: INexVendasAcceptanceServer;
|
|
205
|
+
lead_ref: INexVendasJourneyLeadRef | null;
|
|
206
|
+
origem: NexFinopsProposalOrigem;
|
|
207
|
+
/** Slug do site do shop onde o aceite aconteceu (`site-hm`, `lp-dermato`…). */
|
|
208
|
+
site: string | null;
|
|
209
|
+
/** `client_request_id` do request (idempotência do lado do navegador). */
|
|
210
|
+
client_request_id?: string | null;
|
|
211
|
+
/** Comprovante PDF. Null na criação (ver doc da interface). */
|
|
212
|
+
receipt: INexVendasAcceptanceReceipt | null;
|
|
213
|
+
created_at: Date;
|
|
214
|
+
}
|
|
215
|
+
/**
|
|
216
|
+
* Corpo de `POST /journeys/:short_code/contract/accept` (público, `short_code`).
|
|
217
|
+
*
|
|
218
|
+
* Os hashes são dos BYTES que o shop exibiu; divergência do documento atual ⇒ 409
|
|
219
|
+
* `document_changed` e nada é gravado. IP, user-agent, idioma e trace o servidor lê
|
|
220
|
+
* da requisição — nunca do corpo.
|
|
221
|
+
*/
|
|
222
|
+
export interface INexVendasAcceptanceRequest {
|
|
223
|
+
cg_sha256: string;
|
|
224
|
+
summary_sha256: string;
|
|
225
|
+
declaration_version: string;
|
|
226
|
+
viewed_to_end: boolean;
|
|
227
|
+
/** UUID gerado pelo navegador por tentativa de aceite. */
|
|
228
|
+
client_request_id: string;
|
|
229
|
+
}
|
|
230
|
+
/** Resposta do aceite: o resumo público (a projeção completa vem no GET da jornada). */
|
|
231
|
+
export interface INexVendasAcceptanceResponse {
|
|
232
|
+
protocol: string;
|
|
233
|
+
accepted_at: Date;
|
|
234
|
+
}
|
|
235
|
+
/** Doc `core/nexus/apps/nex-vendas/config/adhesion`. */
|
|
236
|
+
export declare const NEX_VENDAS_ADHESION_CONFIG_DOC = "adhesion";
|
|
237
|
+
export declare const NEX_VENDAS_ADHESION_DEFAULT_DOCUMENT_ACCESS_DAYS = 30;
|
|
238
|
+
export declare const NEX_VENDAS_ADHESION_DEFAULT_CORRECTIONS_PER_HOUR = 10;
|
|
239
|
+
/**
|
|
240
|
+
* Configuração operacional da adesão — troca sem deploy (D5, D9, D10).
|
|
241
|
+
*/
|
|
242
|
+
export interface INexVendasAdhesionConfig {
|
|
243
|
+
/** D5 — declaração exibida ao lado do checkbox; trocar o texto exige nova `version`. */
|
|
244
|
+
declaration: {
|
|
245
|
+
version: string;
|
|
246
|
+
text: string;
|
|
247
|
+
};
|
|
248
|
+
/** D9 — dias de acesso aos documentos pelo `short_code` após o aceite. Ausente = 30. */
|
|
249
|
+
document_access_days?: number | null;
|
|
250
|
+
/** D10 — teto de regerações do quadro por correção, por jornada/hora. Ausente = 10. */
|
|
251
|
+
corrections_per_hour?: number | null;
|
|
252
|
+
updated_at?: Date | null;
|
|
253
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.NEX_VENDAS_ADHESION_DEFAULT_CORRECTIONS_PER_HOUR = exports.NEX_VENDAS_ADHESION_DEFAULT_DOCUMENT_ACCESS_DAYS = exports.NEX_VENDAS_ADHESION_CONFIG_DOC = exports.NEX_VENDAS_ACCEPTANCES_COLLECTION = exports.NEX_VENDAS_ADHESION_SIGNATURE_PROVIDER = exports.NEX_VENDAS_DEFAULT_CONTRACT_TYPE = void 0;
|
|
4
|
+
/** Leitura do `contract_type` ausente (legado). */
|
|
5
|
+
exports.NEX_VENDAS_DEFAULT_CONTRACT_TYPE = 'assinatura_eletronica';
|
|
6
|
+
/** Valor de `signature.provider` gravado pelo aceite por adesão (D3: status segue `contrato_assinado`). */
|
|
7
|
+
exports.NEX_VENDAS_ADHESION_SIGNATURE_PROVIDER = 'adesao';
|
|
8
|
+
// ── Registro imutável do aceite ──
|
|
9
|
+
/** Collection `core/nexus/apps/nex-vendas/acceptances/{acceptance_id}` (append-only). */
|
|
10
|
+
exports.NEX_VENDAS_ACCEPTANCES_COLLECTION = 'acceptances';
|
|
11
|
+
// ── Configuração da adesão ──
|
|
12
|
+
/** Doc `core/nexus/apps/nex-vendas/config/adhesion`. */
|
|
13
|
+
exports.NEX_VENDAS_ADHESION_CONFIG_DOC = 'adhesion';
|
|
14
|
+
exports.NEX_VENDAS_ADHESION_DEFAULT_DOCUMENT_ACCESS_DAYS = 30;
|
|
15
|
+
exports.NEX_VENDAS_ADHESION_DEFAULT_CORRECTIONS_PER_HOUR = 10;
|
|
@@ -0,0 +1,280 @@
|
|
|
1
|
+
import type { NexFinopsProposalOrigem } from '../evo-finops/common/proposal';
|
|
2
|
+
import type { INexVendasJourneyLeadRef } from './journey';
|
|
3
|
+
|
|
4
|
+
// ── Tipo de formalização do contrato (feat-325) ──
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Como o cliente formaliza o contrato:
|
|
8
|
+
* - `assinatura_eletronica`: envelope D4Sign (caminho original da feat-130);
|
|
9
|
+
* - `adesao`: click-wrap — o cliente lê as Condições Gerais (CG) + o quadro-resumo
|
|
10
|
+
* da jornada e aceita por clique, sem provider de assinatura.
|
|
11
|
+
*
|
|
12
|
+
* O tipo MORA NO MODELO DE CONTRATO (`contract-templates/{key}.contract_type`) e é
|
|
13
|
+
* copiado congelado na proposta (ao escolher o modelo), na jornada (no submit dos
|
|
14
|
+
* dados) e no contrato finops. **Ausente = `assinatura_eletronica`** em todos esses
|
|
15
|
+
* documentos: modelos, propostas, jornadas e contratos anteriores à feat-325 são
|
|
16
|
+
* todos D4Sign. Use `NEX_VENDAS_DEFAULT_CONTRACT_TYPE` para resolver o ausente.
|
|
17
|
+
*/
|
|
18
|
+
export type NexVendasContractType = 'assinatura_eletronica' | 'adesao';
|
|
19
|
+
|
|
20
|
+
/** Leitura do `contract_type` ausente (legado). */
|
|
21
|
+
export const NEX_VENDAS_DEFAULT_CONTRACT_TYPE: NexVendasContractType = 'assinatura_eletronica';
|
|
22
|
+
|
|
23
|
+
/** Valor de `signature.provider` gravado pelo aceite por adesão (D3: status segue `contrato_assinado`). */
|
|
24
|
+
export const NEX_VENDAS_ADHESION_SIGNATURE_PROVIDER = 'adesao';
|
|
25
|
+
|
|
26
|
+
// ── Modelo de contrato de adesão ──
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* Versão das Condições Gerais (CG) em PDF estático, subida pelo Nexus no modelo de
|
|
30
|
+
* adesão (D1). O `sha256` é dos BYTES do PDF, calculado pelo backend no upload.
|
|
31
|
+
*/
|
|
32
|
+
export interface INexVendasContractTemplateAdhesionCg {
|
|
33
|
+
/** Rótulo da versão, legível (ex.: `2026.11-v1`). */
|
|
34
|
+
version: string;
|
|
35
|
+
/** SHA-256 hex dos bytes do PDF. */
|
|
36
|
+
sha256: string;
|
|
37
|
+
/** Caminho do objeto no bucket, sem `gs://` e sem o nome do bucket. */
|
|
38
|
+
storage_path: string;
|
|
39
|
+
/** Data civil `YYYY-MM-DD` a partir da qual esta versão vale. */
|
|
40
|
+
effective_from: string;
|
|
41
|
+
/** Nome original do arquivo enviado (exibição/download). */
|
|
42
|
+
filename: string;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* Bloco `adhesion` do modelo de contrato. Só existe quando `contract_type === 'adesao'`.
|
|
47
|
+
*/
|
|
48
|
+
export interface INexVendasContractTemplateAdhesion {
|
|
49
|
+
cg: INexVendasContractTemplateAdhesionCg;
|
|
50
|
+
/**
|
|
51
|
+
* D4 — exigir OTP por e-mail antes do aceite. Ausente/`false` = sem OTP (MVP).
|
|
52
|
+
* O jurídico decide por modelo.
|
|
53
|
+
*/
|
|
54
|
+
require_email_otp?: boolean | null;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* Campos que a feat-325 acrescenta ao modelo de contrato
|
|
59
|
+
* (`core/nexus/apps/nex-vendas/contract-templates/{key}`). O documento completo é
|
|
60
|
+
* tipado no `@evo/nex-model` (`INexVendasContractTemplate`), que estende este
|
|
61
|
+
* fragmento.
|
|
62
|
+
*/
|
|
63
|
+
export interface INexVendasContractTemplateFormalization {
|
|
64
|
+
/** Ausente = `assinatura_eletronica` (`NEX_VENDAS_DEFAULT_CONTRACT_TYPE`). */
|
|
65
|
+
contract_type?: NexVendasContractType | null;
|
|
66
|
+
adhesion?: INexVendasContractTemplateAdhesion | null;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
// ── Jornada: documento de adesão e resumo do aceite ──
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Quadro-resumo da jornada, renderizado pelo `nex_vendas_pdf` com os dados da
|
|
73
|
+
* proposta/cliente, mais a versão das CG congelada NO RENDER (D15: o cliente aceita
|
|
74
|
+
* o que vê). Correção de dados ou virada do dia civil (SP, D16) regera o quadro —
|
|
75
|
+
* hash novo — e `corrections_count` sobe.
|
|
76
|
+
*/
|
|
77
|
+
export interface INexVendasJourneyAdhesionDocument {
|
|
78
|
+
/** SHA-256 hex dos BYTES do PDF do quadro-resumo. */
|
|
79
|
+
summary_sha256: string;
|
|
80
|
+
/** Caminho do rascunho do quadro no bucket (sem `gs://` e sem o bucket). */
|
|
81
|
+
summary_storage_path: string;
|
|
82
|
+
/** Versão das CG congelada neste render. */
|
|
83
|
+
cg_version: string;
|
|
84
|
+
/** SHA-256 hex das CG congeladas neste render. */
|
|
85
|
+
cg_sha256: string;
|
|
86
|
+
/** Caminho das CG no bucket (o do modelo no momento do render). */
|
|
87
|
+
cg_storage_path?: string | null;
|
|
88
|
+
/** Data de emissão impressa no quadro (`YYYY-MM-DD`, dia civil em SP). */
|
|
89
|
+
issued_on?: string | null;
|
|
90
|
+
rendered_at: Date;
|
|
91
|
+
/** Quantas vezes o quadro foi regerado por correção de dados (teto D10). */
|
|
92
|
+
corrections_count: number;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/**
|
|
96
|
+
* Resumo do aceite gravado na jornada (o registro completo é `INexVendasAcceptance`).
|
|
97
|
+
* Os campos preenchidos depois do aceite (comprovante, evidência no bucket) moram
|
|
98
|
+
* aqui, não no registro imutável.
|
|
99
|
+
*/
|
|
100
|
+
export interface INexVendasJourneyAcceptanceRef {
|
|
101
|
+
/** Id do doc em `acceptances/` (= protocolo em minúsculas). */
|
|
102
|
+
acceptance_id: string;
|
|
103
|
+
/** Protocolo exibido ao cliente. */
|
|
104
|
+
protocol: string;
|
|
105
|
+
accepted_at: Date;
|
|
106
|
+
/** Cópia dos PDFs para o bucket de evidências: `pending` até conferir o hash da cópia. */
|
|
107
|
+
evidence_status?: 'pending' | 'stored' | null;
|
|
108
|
+
/** Comprovante PDF, gerado depois do aceite. */
|
|
109
|
+
receipt?: INexVendasAcceptanceReceipt | null;
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* `data` do evento `contract_accepted` da jornada (gravado na transação do aceite,
|
|
114
|
+
* idempotente). Entra em `JOURNEY_STATUS_ENTRY_EVENTS` ao lado de `contract_signed`.
|
|
115
|
+
*/
|
|
116
|
+
export interface INexVendasJourneyContractAcceptedEventData {
|
|
117
|
+
acceptance_id: string;
|
|
118
|
+
protocol: string;
|
|
119
|
+
summary_sha256: string;
|
|
120
|
+
cg_sha256: string;
|
|
121
|
+
cg_version: string;
|
|
122
|
+
declaration_version: string;
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
// ── Registro imutável do aceite ──
|
|
126
|
+
|
|
127
|
+
/** Collection `core/nexus/apps/nex-vendas/acceptances/{acceptance_id}` (append-only). */
|
|
128
|
+
export const NEX_VENDAS_ACCEPTANCES_COLLECTION = 'acceptances';
|
|
129
|
+
|
|
130
|
+
export interface INexVendasAcceptanceCg {
|
|
131
|
+
version: string;
|
|
132
|
+
sha256: string;
|
|
133
|
+
/** Caminho da cópia no bucket de evidências. */
|
|
134
|
+
storage_path: string;
|
|
135
|
+
effective_from?: string | null;
|
|
136
|
+
filename?: string | null;
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
export interface INexVendasAcceptanceSummary {
|
|
140
|
+
sha256: string;
|
|
141
|
+
/** Caminho da cópia no bucket de evidências. */
|
|
142
|
+
storage_path: string;
|
|
143
|
+
issued_on?: string | null;
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
/** Declaração exibida ao lado do checkbox, como estava no momento do aceite. */
|
|
147
|
+
export interface INexVendasAcceptanceDeclaration {
|
|
148
|
+
version: string;
|
|
149
|
+
text: string;
|
|
150
|
+
/** SHA-256 hex do `text` (UTF-8). */
|
|
151
|
+
sha256: string;
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
/**
|
|
155
|
+
* Identidade COMO DECLARADA no formulário da jornada — não verificada por documento.
|
|
156
|
+
*/
|
|
157
|
+
export interface INexVendasAcceptanceIdentity {
|
|
158
|
+
name: string;
|
|
159
|
+
email: string;
|
|
160
|
+
/** E.164. */
|
|
161
|
+
phone: string;
|
|
162
|
+
document_type?: 'cpf' | 'cnpj' | null;
|
|
163
|
+
/** CPF ou CNPJ do contratante, só dígitos. */
|
|
164
|
+
document?: string | null;
|
|
165
|
+
/** CPF de quem aceita (responsável no PJ), só dígitos. */
|
|
166
|
+
responsible_cpf?: string | null;
|
|
167
|
+
company_legal_name?: string | null;
|
|
168
|
+
/** Verificação de identidade feita antes do aceite (D4: `none` no MVP). */
|
|
169
|
+
verification?: { method: 'none' | 'email_otp'; verified_at?: Date | null } | null;
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/** Dados capturados da requisição do aceite (telemetria do cliente + cabeçalhos). */
|
|
173
|
+
export interface INexVendasAcceptanceClient {
|
|
174
|
+
/** IP resolvido pelo número de hops confiáveis (não o 1º item do XFF). */
|
|
175
|
+
ip: string | null;
|
|
176
|
+
/** `x-forwarded-for` completo, para perícia. */
|
|
177
|
+
ip_chain: string[];
|
|
178
|
+
user_agent: string | null;
|
|
179
|
+
accept_language: string | null;
|
|
180
|
+
/** D11 — só telemetria: o aceite não depende da rolagem. */
|
|
181
|
+
viewed_to_end: boolean | null;
|
|
182
|
+
}
|
|
183
|
+
|
|
184
|
+
export interface INexVendasAcceptanceServer {
|
|
185
|
+
/** Relógio do servidor, dentro da transação do aceite. */
|
|
186
|
+
accepted_at: Date;
|
|
187
|
+
/** `x-cloud-trace-context`: liga ao log da requisição enquanto ele existir. */
|
|
188
|
+
trace_id: string | null;
|
|
189
|
+
/** `K_REVISION` da function que gravou. */
|
|
190
|
+
function_revision: string | null;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
export interface INexVendasAcceptanceReceipt {
|
|
194
|
+
storage_path: string;
|
|
195
|
+
sha256: string;
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* Registro imutável do aceite por adesão (spec feat-325 §Auditoria 1; BA §4.2).
|
|
200
|
+
*
|
|
201
|
+
* Append-only: rules sem update/delete; o model expõe só `createInTransaction` e
|
|
202
|
+
* leitura. Nasce completo, com exceção de `receipt` (null na criação; o comprovante
|
|
203
|
+
* e o `evidence_status` vivem no resumo da jornada, `INexVendasJourneyAcceptanceRef`).
|
|
204
|
+
*
|
|
205
|
+
* Doc id determinístico (`acceptance_id`) — repetição do aceite com os mesmos hashes
|
|
206
|
+
* devolve o mesmo protocolo.
|
|
207
|
+
*/
|
|
208
|
+
export interface INexVendasAcceptance {
|
|
209
|
+
/** = doc id. */
|
|
210
|
+
id: string;
|
|
211
|
+
schema_version: 1;
|
|
212
|
+
/** Protocolo legível e único exibido ao cliente. */
|
|
213
|
+
protocol: string;
|
|
214
|
+
short_code: string;
|
|
215
|
+
/** Id da proposta (doc em `nex-finops/proposals`). */
|
|
216
|
+
proposal_id: string;
|
|
217
|
+
/** Id do contrato finops (draft no momento do aceite), ou null se ainda não criado. */
|
|
218
|
+
contract_id: string | null;
|
|
219
|
+
contract_type: 'adesao';
|
|
220
|
+
template_key: string;
|
|
221
|
+
template_revision: number;
|
|
222
|
+
cg: INexVendasAcceptanceCg;
|
|
223
|
+
summary: INexVendasAcceptanceSummary;
|
|
224
|
+
declaration: INexVendasAcceptanceDeclaration;
|
|
225
|
+
identity: INexVendasAcceptanceIdentity;
|
|
226
|
+
client: INexVendasAcceptanceClient;
|
|
227
|
+
server: INexVendasAcceptanceServer;
|
|
228
|
+
lead_ref: INexVendasJourneyLeadRef | null;
|
|
229
|
+
origem: NexFinopsProposalOrigem;
|
|
230
|
+
/** Slug do site do shop onde o aceite aconteceu (`site-hm`, `lp-dermato`…). */
|
|
231
|
+
site: string | null;
|
|
232
|
+
/** `client_request_id` do request (idempotência do lado do navegador). */
|
|
233
|
+
client_request_id?: string | null;
|
|
234
|
+
/** Comprovante PDF. Null na criação (ver doc da interface). */
|
|
235
|
+
receipt: INexVendasAcceptanceReceipt | null;
|
|
236
|
+
created_at: Date;
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
/**
|
|
240
|
+
* Corpo de `POST /journeys/:short_code/contract/accept` (público, `short_code`).
|
|
241
|
+
*
|
|
242
|
+
* Os hashes são dos BYTES que o shop exibiu; divergência do documento atual ⇒ 409
|
|
243
|
+
* `document_changed` e nada é gravado. IP, user-agent, idioma e trace o servidor lê
|
|
244
|
+
* da requisição — nunca do corpo.
|
|
245
|
+
*/
|
|
246
|
+
export interface INexVendasAcceptanceRequest {
|
|
247
|
+
cg_sha256: string;
|
|
248
|
+
summary_sha256: string;
|
|
249
|
+
declaration_version: string;
|
|
250
|
+
viewed_to_end: boolean;
|
|
251
|
+
/** UUID gerado pelo navegador por tentativa de aceite. */
|
|
252
|
+
client_request_id: string;
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
/** Resposta do aceite: o resumo público (a projeção completa vem no GET da jornada). */
|
|
256
|
+
export interface INexVendasAcceptanceResponse {
|
|
257
|
+
protocol: string;
|
|
258
|
+
accepted_at: Date;
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
// ── Configuração da adesão ──
|
|
262
|
+
|
|
263
|
+
/** Doc `core/nexus/apps/nex-vendas/config/adhesion`. */
|
|
264
|
+
export const NEX_VENDAS_ADHESION_CONFIG_DOC = 'adhesion';
|
|
265
|
+
|
|
266
|
+
export const NEX_VENDAS_ADHESION_DEFAULT_DOCUMENT_ACCESS_DAYS = 30;
|
|
267
|
+
export const NEX_VENDAS_ADHESION_DEFAULT_CORRECTIONS_PER_HOUR = 10;
|
|
268
|
+
|
|
269
|
+
/**
|
|
270
|
+
* Configuração operacional da adesão — troca sem deploy (D5, D9, D10).
|
|
271
|
+
*/
|
|
272
|
+
export interface INexVendasAdhesionConfig {
|
|
273
|
+
/** D5 — declaração exibida ao lado do checkbox; trocar o texto exige nova `version`. */
|
|
274
|
+
declaration: { version: string; text: string };
|
|
275
|
+
/** D9 — dias de acesso aos documentos pelo `short_code` após o aceite. Ausente = 30. */
|
|
276
|
+
document_access_days?: number | null;
|
|
277
|
+
/** D10 — teto de regerações do quadro por correção, por jornada/hora. Ausente = 10. */
|
|
278
|
+
corrections_per_hour?: number | null;
|
|
279
|
+
updated_at?: Date | null;
|
|
280
|
+
}
|
|
@@ -15,3 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
|
15
15
|
};
|
|
16
16
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
17
|
__exportStar(require("./journey"), exports);
|
|
18
|
+
__exportStar(require("./adhesion"), exports);
|
|
19
|
+
__exportStar(require("./notifications"), exports);
|
|
20
|
+
__exportStar(require("./offer"), exports);
|