@muni-sanfer/types-gestor-documental 0.0.1-beta.4 → 0.0.1-beta.6

package/src/entities/partsOffice/partsOffice.entity.ts

@@ -0,0 +1,103 @@
+import {
+  type DocumentDispatchResponseEntity,
+  type DocumentExternalRecipientResponseEntity,
+  type DocumentLinkEntity,
+} from '../document';
+
+/** Institución del Estado en DocDigital. */
+export interface DocDigitalEntityEntity {
+  id: number;
+  name: string;
+  /** Organismo al que pertenece (la entidad padre). */
+  organism: string | null;
+}
+
+/** Usuario habilitado de una institución en DocDigital. */
+export interface DocDigitalUserEntity {
+  id: number;
+  name: string;
+  position: string | null;
+}
+
+export interface DocDigitalDocumentTypeEntity {
+  id: number;
+  name: string;
+}
+
+/** Si DocDigital está configurado en el gestor y cada cuánto se revisa lo recibido. */
+export interface PartsOfficeStatusEntity {
+  configured: boolean;
+  syncMinutes: number;
+}
+
+/** Totales del Panel de Partes. */
+export interface PartsOfficeSummaryEntity {
+  toDispatch: number;
+  received: number;
+}
+
+/** Documento firmado que va a otras instituciones: lo despacha Oficina de Partes. */
+export interface PartsOfficeDispatchEntity extends DocumentDispatchResponseEntity {
+  document: DocumentLinkEntity & { accessLevel: string };
+  externalRecipients: DocumentExternalRecipientResponseEntity[];
+  createdAt: string;
+}
+
+/** Documento que llegó por DocDigital. */
+export interface PartsOfficeInboundEntity {
+  id: string;
+  docDigitalDocumentId: string;
+  status: 'Pending' | 'Registered' | 'Returned';
+  subject: string;
+  description: string | null;
+  folio: string | null;
+  folioDate: string | null;
+  typeName: string | null;
+  reserved: boolean;
+  senderEntityName: string | null;
+  senderName: string | null;
+  senderPosition: string | null;
+  fileName: string | null;
+  hasFile: boolean;
+  attachments: { name: string; url: string | null; hasFile: boolean }[];
+  createdAt: string;
+  registeredAt: string | null;
+  registeredByFullName: string | null;
+  acknowledgedAt: string | null;
+  acknowledgeError: string | null;
+  returnedAt: string | null;
+  returnedByFullName: string | null;
+  returnReason: string | null;
+  /** El documento con que quedó ingresado al gestor. */
+  document: { id: string; intakeNumber: number | null; intakeYear: number | null } | null;
+}
+
+export interface PartsOfficeOkResponseEntity {
+  id: string;
+  ok: boolean;
+  /** Documento al que corresponde el despacho (al despachar o devolver). */
+  documentId?: string;
+}
+
+export interface PartsOfficeSyncResponseEntity {
+  /** Recibidos nuevos que se trajeron. */
+  created: number;
+  /** Los que no se pudieron traer (se reintentan en la próxima revisión). */
+  failed: number;
+}
+
+export interface PartsOfficeRegisterResponseEntity {
+  id: string;
+  documentId: string;
+  intakeNumber: number;
+  intakeYear: number;
+  /** `false` si DocDigital no aceptó el acuse de recibo: se puede reintentar. */
+  acknowledged: boolean;
+  ok: boolean;
+}
+
+/** Archivo de un recibido, ya copiado al gestor. */
+export interface PartsOfficeFileEntity {
+  fileId: string;
+  fileName: string;
+}

package/src/entities/registerBook/index.ts

@@ -0,0 +1 @@
+export * from './registerBook.entity';

package/src/entities/registerBook/registerBook.entity.ts

@@ -0,0 +1,46 @@
+/** Libro de registro: el de un tipo documental (sus números) o el de ingresos de Oficina de Partes. */
+export type RegisterBookKind = 'documentType' | 'intake';
+
+/**
+ * Estado de un número en el libro: vigente, en tramitación (numerado con la primera firma, aún sin todas las firmas),
+ * documento anulado, número anulado por un rechazo, o número sin registro en el gestor (un salto en la numeración).
+ */
+export type RegisterBookRowState = 'Valid' | 'InProgress' | 'Annulled' | 'NumberAnnulled' | 'Unused';
+
+export interface RegisterBookRowEntity {
+  number: number;
+  /** Fecha del número (o del ingreso), en ISO 8601. `null` en un salto. */
+  date: string | null;
+  state: RegisterBookRowState;
+  documentId: string | null;
+  subject: string | null;
+  /** Quién redactó el documento (o, en el libro de ingresos, quién lo ingresó). */
+  author: string | null;
+  signers: string[];
+  /** Libro de ingresos: institución que lo envió y su folio. */
+  sender: string | null;
+  externalFolio: string | null;
+  /** Libro de ingresos: a quiénes se derivó. */
+  recipients: string[];
+  /** Despacho por DocDigital: «DocDigital N° 777001 · 14-10-2026». */
+  dispatch: string | null;
+  /** Motivo de la anulación (del documento o del número). */
+  observation: string | null;
+}
+
+export interface RegisterBookEntity {
+  kind: RegisterBookKind;
+  /** «Decreto alcaldicio exento» o «Ingresos de Oficina de Partes». */
+  title: string;
+  year: number;
+  month: number | null;
+  rows: RegisterBookRowEntity[];
+  totals: Record<RegisterBookRowState, number>;
+}
+
+/** Libro exportado, listo para descargar. */
+export interface RegisterBookExportEntity {
+  fileName: string;
+  contentType: string;
+  contentBase64: string;
+}