F1.1 · Inspección multi-Acta y firma diferida

Implementa el nuevo núcleo operativo: múltiples Actas por Inspección, un Informe por Acta, cierre de campo independiente y firma de empresa diferida con conformidad/disidencia.
2026-09-05 14:46:26 -03:00
parent 8e2d0dfe19
commit cd24736df8
34 changed files with 452 additions and 85 deletions
@@ -93,6 +93,7 @@ export {
  InspectionActSignatureSource,
  InspectionActSignatureStatus,
  InspectionActSignerType,
+  InspectionCompanySignatureManifestation,
 } from './inspection-act-signature.entity';
 export { FindingCategory } from './finding-category.entity';
 export { FindingCatalogItem } from './finding-catalog-item.entity';
@@ -17,6 +17,11 @@ export enum InspectionActSignatureSource {
  ANDROID = 'ANDROID',
 }

+export enum InspectionCompanySignatureManifestation {
+  CONFORMITY = 'CONFORMITY',
+  DISSENT = 'DISSENT',
+}
+
@Entity({ name: 'inspection_act_signatures' })
@Index('idx_inspection_act_signatures_act_created', ['actId', 'createdAt'])
@Index('idx_inspection_act_signatures_sha256', ['signaturePayloadSha256'])
@@ -51,6 +56,12 @@ export class InspectionActSignature {
  @Column({ type: 'text', nullable: true })
  reason!: string | null;

+  @Column({ name: 'company_manifestation', type: 'varchar', length: 20, nullable: true })
+  companyManifestation!: InspectionCompanySignatureManifestation | null;
+
+  @Column({ name: 'company_statement', type: 'text', nullable: true })
+  companyStatement!: string | null;
+
  @Column({ name: 'original_name', type: 'varchar', length: 255, nullable: true })
  originalName!: string | null;

@@ -10,7 +10,7 @@ export enum InspectionActStatus {
 }

@Entity({ name: 'inspection_acts' })
-@Index('uq_inspection_acts_visit', ['visitId'], { unique: true })
+@Index('uq_inspection_acts_one_draft_per_visit', ['visitId'], { unique: true, where: "status = 'DRAFT'" })
@Index('uq_inspection_acts_year_number', ['actYear', 'actNumber'], { unique: true })
@Index('uq_inspection_acts_code', ['code'], { unique: true })
@Index('idx_inspection_acts_visit_status', ['visitId', 'status'])
@@ -25,7 +25,7 @@ export enum InspectionReportReviewStatus {
 }

@Entity({ name: 'inspection_reports' })
-@Index('uq_inspection_reports_visit', ['visitId'], { unique: true })
+@Index('idx_inspection_reports_visit_id', ['visitId'])
@Index('uq_inspection_reports_act', ['actId'], { unique: true })
@Index('uq_inspection_reports_year_number', ['reportYear', 'reportNumber'], { unique: true })
@Index('uq_inspection_reports_code', ['code'], { unique: true })
@@ -0,0 +1,108 @@
+import { MigrationInterface, QueryRunner } from 'typeorm';
+
+export class PhaseF11MultiActInspections1789495200000 implements MigrationInterface {
+  name = 'PhaseF11MultiActInspections1789495200000';
+
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      ALTER TABLE inspection_acts
+      DROP CONSTRAINT IF EXISTS uq_inspection_acts_visit
+    `);
+    await queryRunner.query(`
+      CREATE UNIQUE INDEX uq_inspection_acts_one_draft_per_visit
+      ON inspection_acts (visit_id)
+      WHERE status = 'DRAFT'
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE inspection_reports
+      DROP CONSTRAINT IF EXISTS uq_inspection_reports_visit
+    `);
+    await queryRunner.query(`
+      CREATE INDEX idx_inspection_reports_visit_id
+      ON inspection_reports (visit_id)
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE inspection_act_signatures
+        ADD COLUMN company_manifestation varchar(20),
+        ADD COLUMN company_statement text
+    `);
+    await queryRunner.query(`
+      UPDATE inspection_act_signatures
+      SET company_manifestation = 'CONFORMITY'
+      WHERE signer_type = 'COMPANY_RESPONSIBLE'
+        AND status = 'SIGNED'
+    `);
+    await queryRunner.query(`
+      ALTER TABLE inspection_act_signatures
+      ADD CONSTRAINT chk_inspection_act_signatures_company_manifestation CHECK (
+        (
+          signer_type = 'COMPANY_RESPONSIBLE'
+          AND status = 'SIGNED'
+          AND company_manifestation IN ('CONFORMITY', 'DISSENT')
+          AND (
+            (company_manifestation = 'CONFORMITY' AND company_statement IS NULL)
+            OR
+            (company_manifestation = 'DISSENT' AND LENGTH(TRIM(COALESCE(company_statement, ''))) >= 10)
+          )
+        )
+        OR
+        (
+          NOT (signer_type = 'COMPANY_RESPONSIBLE' AND status = 'SIGNED')
+          AND company_manifestation IS NULL
+          AND company_statement IS NULL
+        )
+      )
+    `);
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.query(`
+      DO $$
+      BEGIN
+        IF EXISTS (
+          SELECT visit_id FROM inspection_acts
+          GROUP BY visit_id HAVING COUNT(*) > 1
+        ) THEN
+          RAISE EXCEPTION 'F1.1 no puede revertirse: existen inspecciones con múltiples actas';
+        END IF;
+        IF EXISTS (
+          SELECT visit_id FROM inspection_reports
+          GROUP BY visit_id HAVING COUNT(*) > 1
+        ) THEN
+          RAISE EXCEPTION 'F1.1 no puede revertirse: existen inspecciones con múltiples informes';
+        END IF;
+        IF EXISTS (
+          SELECT 1 FROM inspection_act_signatures
+          WHERE company_manifestation = 'DISSENT'
+        ) THEN
+          RAISE EXCEPTION 'F1.1 no puede revertirse: existen firmas en disidencia';
+        END IF;
+      END
+      $$
+    `);
+
+    await queryRunner.query(`
+      ALTER TABLE inspection_act_signatures
+      DROP CONSTRAINT chk_inspection_act_signatures_company_manifestation
+    `);
+    await queryRunner.query(`
+      ALTER TABLE inspection_act_signatures
+        DROP COLUMN company_statement,
+        DROP COLUMN company_manifestation
+    `);
+
+    await queryRunner.query(`DROP INDEX idx_inspection_reports_visit_id`);
+    await queryRunner.query(`
+      ALTER TABLE inspection_reports
+      ADD CONSTRAINT uq_inspection_reports_visit UNIQUE (visit_id)
+    `);
+
+    await queryRunner.query(`DROP INDEX uq_inspection_acts_one_draft_per_visit`);
+    await queryRunner.query(`
+      ALTER TABLE inspection_acts
+      ADD CONSTRAINT uq_inspection_acts_visit UNIQUE (visit_id)
+    `);
+  }
+}
@@ -308,7 +308,7 @@ export class InspectionActsService {
      const visit = await this.lockVisit(manager, visitId);
      this.assertVisitOpen(visit);
      await this.assertActorAssigned(manager, visitId, principal);
-      await this.assertVisitHasNoAct(manager, visitId);
+      await this.assertVisitHasNoDraftAct(manager, visitId);
      await this.assertVisitAssets(manager, visitId, dto.assetIds);
      const occurredAt = new Date(dto.occurredAt);
      const actYear = await this.yearAtProjectTimezone(manager, occurredAt);
@@ -632,20 +632,20 @@ export class InspectionActsService {
    }
  }

-  private async assertVisitHasNoAct(
+  private async assertVisitHasNoDraftAct(
    manager: EntityManager,
    visitId: string,
  ): Promise<void> {
    const rows = (await manager.query(`
      SELECT code
      FROM inspection_acts
-      WHERE visit_id = $1
+      WHERE visit_id = $1 AND status = 'DRAFT'
      LIMIT 1
    `, [visitId])) as Array<{ code: string }>;
    if (rows.length > 0) {
      throw new ConflictException({
-        code: 'INSPECTION_VISIT_ACT_ALREADY_EXISTS',
-        message: 'La visita ya tiene un acta; cada visita admite una única acta',
+        code: 'INSPECTION_VISIT_DRAFT_ACT_ALREADY_EXISTS',
+        message: 'La inspección ya tiene un acta en borrador; preparala o cancelala antes de crear otra',
      });
    }
  }
@@ -0,0 +1,19 @@
+import { Transform } from 'class-transformer';
+import { IsEnum, IsOptional, IsString, MaxLength, MinLength, ValidateIf } from 'class-validator';
+import { InspectionCompanySignatureManifestation } from '../../database/entities';
+import { CreateInspectionSignatureDto } from './create-inspection-signature.dto';
+
+export class CreateCompanySignatureDto extends CreateInspectionSignatureDto {
+  @IsOptional()
+  @IsEnum(InspectionCompanySignatureManifestation)
+  manifestation?: InspectionCompanySignatureManifestation;
+
+  @ValidateIf((dto: CreateCompanySignatureDto) =>
+    dto.manifestation === InspectionCompanySignatureManifestation.DISSENT,
+  )
+  @Transform(({ value }) => (typeof value === 'string' ? value.trim() : value))
+  @IsString()
+  @MinLength(10)
+  @MaxLength(4000)
+  statement?: string;
+}
@@ -19,6 +19,7 @@ import type { AuthPrincipal, RequestWithContext } from '../common/http/request-c
 import { CloseInspectionActDto } from './dto/close-inspection-act.dto';
 import { CreateCompanyOutcomeDto } from './dto/create-company-outcome.dto';
 import { CreateInspectionSignatureDto } from './dto/create-inspection-signature.dto';
+import { CreateCompanySignatureDto } from './dto/create-company-signature.dto';
 import { UpsertInspectionResponsibleDto } from './dto/upsert-inspection-responsible.dto';
 import { InspectionClosingService } from './inspection-closing.service';
 import {
@@ -89,7 +90,7 @@ export class InspectionClosingController {
  }))
  companySignature(
    @Param('actId', new ParseUUIDPipe({ version: '4' })) actId: string,
-    @Body() dto: CreateInspectionSignatureDto,
+    @Body() dto: CreateCompanySignatureDto,
    @UploadedFile() file: UploadedInspectionSignatureFile | undefined,
    @CurrentAuth() principal: AuthPrincipal,
    @Req() request: RequestWithContext,
@@ -21,6 +21,7 @@ import {
  InspectionActSignatureSource,
  InspectionActSignatureStatus,
  InspectionActSignerType,
+  InspectionCompanySignatureManifestation,
  InspectionActStatus,
  InspectionActUploadMode,
  InspectionActVersionEvent,
@@ -33,6 +34,7 @@ import type { CloseInspectionActDto } from './dto/close-inspection-act.dto';
 import { InspectionReportsService } from '../inspection-reports/inspection-reports.service';
 import type { CreateCompanyOutcomeDto } from './dto/create-company-outcome.dto';
 import type { CreateInspectionSignatureDto } from './dto/create-inspection-signature.dto';
+import type { CreateCompanySignatureDto } from './dto/create-company-signature.dto';
 import type { UpsertInspectionResponsibleDto } from './dto/upsert-inspection-responsible.dto';
 import {
  inspectInspectionSignatureFile,
@@ -70,6 +72,8 @@ interface SignatureView {
  position: string | null;
  status: InspectionActSignatureStatus;
  reason: string | null;
+  companyManifestation: InspectionCompanySignatureManifestation | null;
+  companyStatement: string | null;
  mimeType: string | null;
  sizeBytes: number | null;
  imageSha256: string | null;
@@ -429,7 +433,7 @@ export class InspectionClosingService {

  async signCompany(
    actId: string,
-    dto: CreateInspectionSignatureDto,
+    dto: CreateCompanySignatureDto,
    file: UploadedInspectionSignatureFile | undefined,
    principal: AuthPrincipal,
    request: RequestWithContext,
@@ -447,7 +451,7 @@ export class InspectionClosingService {
    assertMobileInspector(principal);
    return this.dataSource.transaction(async (manager) => {
      const { act, visit } = await this.lockContext(manager, actId);
-      this.assertReadyInProgress(act, visit);
+      this.assertReadyForCompanyOutcome(act, visit);
      await this.assertActorAssigned(manager, visit.id, principal, true);
      const responsible = await this.requireResponsible(manager, actId);
      if (
@@ -540,7 +544,8 @@ export class InspectionClosingService {
    assertMobileInspector(principal);
    const closed = await this.dataSource.transaction(async (manager) => {
      const { act, visit } = await this.lockContext(manager, actId);
-      this.assertReadyInProgress(act, visit);
+      this.assertReadyForFinalClosure(act, visit);
+      await this.assertActorAssigned(manager, visit.id, principal, true);
      const closure = await this.requireClosure(manager, actId);
      const signatures = await this.loadSignatures(manager, actId);
      if (!signatures.some((item) => (
@@ -576,6 +581,8 @@ export class InspectionClosingService {
        position: item.position,
        status: item.status,
        reason: item.reason,
+        companyManifestation: item.companyManifestation,
+        companyStatement: item.companyStatement,
        imageSha256: item.imageSha256,
        consentText: item.consentText,
        consentVersion: item.consentVersion,
@@ -636,14 +643,6 @@ export class InspectionClosingService {
        WHERE id = $1
        RETURNING current_version AS "versionNumber"
      `, [actId, serverClosedAt, principal.userId, finalSha256])) as Array<{ versionNumber: number }>;
-      await manager.query(`
-        UPDATE inspection_visits
-        SET status = 'CLOSED',
-            actual_closed_at = $2,
-            updated_by = $3,
-            updated_at = $2
-        WHERE id = $1
-      `, [visit.id, serverClosedAt, principal.userId]);
      await manager.query(`
        INSERT INTO inspection_act_versions (
          act_id, version_number, event, snapshot, actor_user_id, actor_username
@@ -672,6 +671,7 @@ export class InspectionClosingService {
          visitId: visit.id,
          versionNumber: Number(updated.versionNumber),
          findingsRemainOpen: true,
+          visitRemainsIndependent: true,
        },
      }, manager);
      await this.reports.ensureFrozenReport(manager, actId, principal, request);
@@ -710,7 +710,7 @@ export class InspectionClosingService {

  private async createSignedSignature(
    actId: string,
-    dto: CreateInspectionSignatureDto,
+    dto: CreateInspectionSignatureDto | CreateCompanySignatureDto,
    file: UploadedInspectionSignatureFile | undefined,
    fixedIdentity: null | {
      signerType: InspectionActSignerType;
@@ -737,7 +737,8 @@ export class InspectionClosingService {
    try {
      return await this.dataSource.transaction(async (manager) => {
        const { act, visit } = await this.lockContext(manager, actId);
-        this.assertReadyInProgress(act, visit);
+        if (fixedIdentity) this.assertReadyInProgress(act, visit);
+        else this.assertReadyForCompanyOutcome(act, visit);
        await this.assertActorAssigned(manager, visit.id, principal, !requireSelfAssignment);
        const closure = await this.requireClosure(manager, actId);
        const responsible = fixedIdentity ? null : await this.requireResponsible(manager, actId);
@@ -778,6 +779,13 @@ export class InspectionClosingService {
        const source = this.signatureSource(principal);
        const signedAt = new Date();
        const clientSignedAt = dto.clientSignedAt ? new Date(dto.clientSignedAt) : null;
+        const companyDto = fixedIdentity ? null : dto as CreateCompanySignatureDto;
+        const companyManifestation = fixedIdentity
+          ? null
+          : companyDto?.manifestation ?? InspectionCompanySignatureManifestation.CONFORMITY;
+        const companyStatement = companyManifestation === InspectionCompanySignatureManifestation.DISSENT
+          ? companyDto?.statement?.trim() ?? null
+          : null;
        const payload = {
          actId,
          preparedSha256: closure.preparedSha256,
@@ -788,6 +796,8 @@ export class InspectionClosingService {
          documentNumber: identity.documentNumber,
          position: identity.position,
          status: InspectionActSignatureStatus.SIGNED,
+          companyManifestation,
+          companyStatement,
          imageSha256,
          consentText: identity.consentText,
          consentVersion: CONSENT_VERSION,
@@ -806,6 +816,7 @@ export class InspectionClosingService {
          INSERT INTO inspection_act_signatures (
            id, act_id, signer_type, signer_user_id, signer_name,
            document_type, document_number, position, status,
+            company_manifestation, company_statement,
            original_name, stored_name, mime_type, size_bytes, image_sha256,
            consent_text, consent_version, consent_accepted_at,
            client_signed_at, signed_at, latitude, longitude, accuracy_m,
@@ -814,11 +825,12 @@ export class InspectionClosingService {
          ) VALUES (
            $1, $2, $3, $4, $5,
            $6, $7, $8, 'SIGNED',
-            $9, $10, $11, $12, $13,
-            $14, $15, $16,
-            $17, $18, $19, $20, $21,
-            $22, $23, $24, $25,
-            $26, $18
+            $9, $10,
+            $11, $12, $13, $14, $15,
+            $16, $17, $18,
+            $19, $20, $21, $22, $23,
+            $24, $25, $26, $27,
+            $28, $20
          )
        `, [
          id,
@@ -829,6 +841,8 @@ export class InspectionClosingService {
          identity.documentType,
          identity.documentNumber,
          identity.position,
+          companyManifestation,
+          companyStatement,
          inspected.originalName,
          storedName,
          inspected.mimeType,
@@ -1266,6 +1280,8 @@ export class InspectionClosingService {
        signature.position,
        signature.status,
        signature.reason,
+        signature.company_manifestation AS "companyManifestation",
+        signature.company_statement AS "companyStatement",
        signature.original_name AS "originalName",
        signature.stored_name AS "storedName",
        signature.mime_type AS "mimeType",
@@ -1365,6 +1381,26 @@ export class InspectionClosingService {
    }
  }

+  private assertReadyForCompanyOutcome(act: InspectionAct, visit: InspectionVisit): void {
+    if (act.status !== InspectionActStatus.READY
+      || ![InspectionVisitStatus.IN_PROGRESS, InspectionVisitStatus.CLOSED].includes(visit.status)) {
+      throw new ConflictException({
+        code: 'INSPECTION_ACT_NOT_READY_FOR_COMPANY',
+        message: 'El acta debe estar preparada; la firma de empresa puede completarse durante la inspección o después de su cierre',
+      });
+    }
+  }
+
+  private assertReadyForFinalClosure(act: InspectionAct, visit: InspectionVisit): void {
+    if (act.status !== InspectionActStatus.READY
+      || ![InspectionVisitStatus.IN_PROGRESS, InspectionVisitStatus.CLOSED].includes(visit.status)) {
+      throw new ConflictException({
+        code: 'INSPECTION_ACT_NOT_READY',
+        message: 'El acta debe estar preparada para completar su cierre definitivo',
+      });
+    }
+  }
+
  private async assertActorAssigned(
    manager: EntityManager,
    visitId: string,
@@ -1,4 +1,4 @@
-import { ConflictException, Injectable } from '@nestjs/common';
+import { Injectable } from '@nestjs/common';
 import type { EntityManager } from 'typeorm';

 export interface FieldDiscoveryInspectionLinkResult {
@@ -18,7 +18,7 @@ export class FieldDiscoveryInspectionLinkService {
        SELECT id, status
        FROM inspection_acts
        WHERE visit_id = $1
-          AND status <> 'CANCELLED'
+          AND status = 'DRAFT'
        ORDER BY created_at DESC
        LIMIT 1
        FOR UPDATE
@@ -26,12 +26,6 @@ export class FieldDiscoveryInspectionLinkService {
      [visitId],
    )) as Array<{ id: string; status: string }>;

-    if (act && act.status !== 'DRAFT') {
-      throw new ConflictException({
-        code: 'FIELD_DISCOVERY_ACT_NOT_EDITABLE',
-        message: 'El Acta ya no admite nuevos elementos ni Hallazgos',
-      });
-    }

    await manager.query(
      `
@@ -16,6 +16,8 @@ function lines(snapshot: Record<string, unknown>): string[] {
  const team=asArray(prepared.team);
  const assets=asArray(prepared.assets);
  const findings=asArray(prepared.findings);
+  const signatures=asArray(snapshot.signatures);
+  const companySignature=signatures.find(item=>text(item.signerType,'')==='COMPANY_RESPONSIBLE');
  const companies=[...new Set(assets.map(x=>text(asRecord(x.operatorCompany).name,'')).filter(Boolean))];
  const areas=[...new Set(assets.map(x=>text(asRecord(x.operationalArea).name,'')).filter(Boolean))];
  const inspectors=team.map(x=>`${text(x.firstName,'')} ${text(x.lastName,'')}`.trim()).filter(Boolean);
@@ -42,6 +44,15 @@ function lines(snapshot: Record<string, unknown>): string[] {
  out.push('', 'HALLAZGOS');
  if(!findings.length) out.push('Sin hallazgos registrados.');
  for(const item of findings){ out.push(...wrap(`${text(item.code)} | ${text(item.title)} | Vencimiento: ${date(item.correctionDueOn)}`)); out.push(...wrap(text(item.description))); }
+  out.push('', 'CONSTANCIA DE LA EMPRESA');
+  if(!companySignature) out.push('Firma o constancia pendiente.');
+  else if(text(companySignature.status,'')==='SIGNED'){
+    const manifestation=text(companySignature.companyManifestation,'CONFORMITY');
+    out.push(manifestation==='DISSENT'?'Firma en disidencia':'Firma en conformidad');
+    if(manifestation==='DISSENT') out.push(...wrap(text(companySignature.companyStatement)));
+  } else {
+    out.push(...wrap(`${text(companySignature.status)}: ${text(companySignature.reason)}`));
+  }
  out.push('', 'INTEGRIDAD', `Hash de cierre: ${text(asRecord(snapshot).finalSha256 ?? asRecord(snapshot).preparedSha256)}`);
  return out;
 }
@@ -0,0 +1,6 @@
+import { IsISO8601 } from 'class-validator';
+
+export class CloseInspectionVisitDto {
+  @IsISO8601({ strict: true })
+  clientClosedAt!: string;
+}
@@ -14,6 +14,7 @@ import { CurrentAuth } from '../auth/decorators/current-auth.decorator';
 import { RequirePermissions } from '../authorization/decorators/require-permissions.decorator';
 import type { AuthPrincipal, RequestWithContext } from '../common/http/request-context';
 import { ChangeInspectionVisitStatusDto } from './dto/change-inspection-visit-status.dto';
+import { CloseInspectionVisitDto } from './dto/close-inspection-visit.dto';
 import { CreateInspectionVisitDto } from './dto/create-inspection-visit.dto';
 import { ExcludeInspectionVisitAssetDto } from './dto/exclude-inspection-visit-asset.dto';
 import { ListInspectionVisitsQueryDto } from './dto/list-inspection-visits-query.dto';
@@ -154,4 +155,15 @@ export class InspectionVisitsController {
  ) {
    return this.visits.start(id, principal, request);
  }
+
+  @Post(':id/close')
+  @RequirePermissions('inspections.execute')
+  close(
+    @Param('id', new ParseUUIDPipe({ version: '4' })) id: string,
+    @Body() dto: CloseInspectionVisitDto,
+    @CurrentAuth() principal: AuthPrincipal,
+    @Req() request: RequestWithContext,
+  ) {
+    return this.visits.close(id, dto, principal, request);
+  }
 }
@@ -19,6 +19,7 @@ import {
  InspectionVisitStatus,
 } from '../database/entities';
 import type { ChangeInspectionVisitStatusDto } from './dto/change-inspection-visit-status.dto';
+import type { CloseInspectionVisitDto } from './dto/close-inspection-visit.dto';
 import type { CreateInspectionVisitDto } from './dto/create-inspection-visit.dto';
 import type { ListInspectionVisitsQueryDto } from './dto/list-inspection-visits-query.dto';
 import type { ReplaceInspectionVisitAssetsDto } from './dto/replace-inspection-visit-assets.dto';
@@ -810,6 +811,107 @@ export class InspectionVisitsService {
    });
  }

+
+  async close(
+    id: string,
+    dto: CloseInspectionVisitDto,
+    principal: AuthPrincipal,
+    request: RequestWithContext,
+  ): Promise<InspectionVisitView> {
+    assertMobileInspector(principal);
+    return this.dataSource.transaction(async (manager) => {
+      const visit = await this.lockVisit(manager, id);
+      if (visit.status !== InspectionVisitStatus.IN_PROGRESS) {
+        throw new ConflictException({
+          code: 'INSPECTION_VISIT_NOT_IN_PROGRESS',
+          message: 'La inspección debe estar en curso para cerrarse',
+        });
+      }
+      if (!principal.permissions.includes('inspections.manage')) {
+        const memberIds = await this.activeMemberIds(manager, id);
+        if (!memberIds.includes(principal.userId)) {
+          throw new ForbiddenException({
+            code: 'INSPECTION_VISIT_NOT_ASSIGNED',
+            message: 'La inspección no está asignada al usuario actual',
+          });
+        }
+      }
+      const [acts] = (await manager.query(`
+        SELECT
+          COUNT(*) FILTER (WHERE act.status = 'DRAFT')::integer AS drafts,
+          COUNT(*) FILTER (
+            WHERE act.status = 'READY'
+              AND NOT EXISTS (
+                SELECT 1 FROM inspection_act_signatures signature
+                WHERE signature.act_id = act.id
+                  AND signature.signer_type = 'INSPECTOR'
+                  AND signature.status = 'SIGNED'
+              )
+          )::integer AS "readyWithoutInspector",
+          COUNT(*) FILTER (
+            WHERE act.status = 'READY'
+              AND NOT EXISTS (
+                SELECT 1 FROM inspection_act_signatures signature
+                WHERE signature.act_id = act.id
+                  AND signature.signer_type = 'COMPANY_RESPONSIBLE'
+              )
+          )::integer AS "pendingCompany"
+        FROM inspection_acts act
+        WHERE act.visit_id = $1
+          AND act.status <> 'CANCELLED'
+      `, [id])) as Array<{ drafts: number; readyWithoutInspector: number; pendingCompany: number }>;
+      if (Number(acts?.drafts ?? 0) > 0) {
+        throw new ConflictException({
+          code: 'INSPECTION_VISIT_DRAFT_ACTS_PENDING',
+          message: 'Prepará o cancelá las actas en borrador antes de cerrar la inspección',
+        });
+      }
+      if (Number(acts?.readyWithoutInspector ?? 0) > 0) {
+        throw new ConflictException({
+          code: 'INSPECTION_VISIT_INSPECTOR_SIGNATURE_PENDING',
+          message: 'Toda acta preparada debe tener firma de inspector antes de cerrar la inspección',
+        });
+      }
+      const serverClosedAt = new Date();
+      const clientClosedAt = new Date(dto.clientClosedAt);
+      if (visit.actualStartedAt && clientClosedAt.getTime() < visit.actualStartedAt.getTime()) {
+        throw new BadRequestException({
+          code: 'INSPECTION_VISIT_INVALID_CLOSE_TIME',
+          message: 'La fecha de cierre del dispositivo no puede ser anterior al inicio de la inspección',
+        });
+      }
+      if (clientClosedAt.getTime() > serverClosedAt.getTime() + 24 * 60 * 60 * 1000) {
+        throw new BadRequestException({
+          code: 'INSPECTION_VISIT_INVALID_DEVICE_TIME',
+          message: 'La fecha informada por el dispositivo no puede estar más de 24 horas en el futuro',
+        });
+      }
+      visit.status = InspectionVisitStatus.CLOSED;
+      visit.actualClosedAt = serverClosedAt;
+      visit.updatedBy = principal.userId;
+      await manager.getRepository(InspectionVisit).save(visit);
+      const updated = await this.loadView(manager, id);
+      await this.audit.record({
+        ...administrationAuditContext(principal, request),
+        action: AuditAction.INSPECTION_VISIT_STATUS_CHANGED,
+        entityType: 'inspection_visit',
+        entityId: id,
+        beforeData: { status: InspectionVisitStatus.IN_PROGRESS },
+        afterData: {
+          status: InspectionVisitStatus.CLOSED,
+          clientClosedAt: clientClosedAt.toISOString(),
+          serverClosedAt: serverClosedAt.toISOString(),
+          pendingCompanySignatures: Number(acts?.pendingCompany ?? 0),
+        },
+        metadata: {
+          closeSource: 'ANDROID',
+          actsMayCompleteCompanySignatureLater: true,
+        },
+      }, manager);
+      return updated;
+    });
+  }
+
  private visitSelect(where: string): string {
    return `
      SELECT
@@ -1,2 +1,2 @@
-export const API_VERSION = '0.19.6-4';
-export const API_PHASE = 'D5.6.4';
+export const API_VERSION = '0.20.0-1';
+export const API_PHASE = 'F1.1';