Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
0ea07738d8 | ||
|
|
d954ec135f | ||
|
|
4c5742c548 |
+1
-1
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "dhv2-api",
|
"name": "dhv2-api",
|
||||||
"version": "0.20.0-2",
|
"version": "0.20.0-3",
|
||||||
"private": true,
|
"private": true,
|
||||||
"license": "UNLICENSED",
|
"license": "UNLICENSED",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
|||||||
@@ -1,12 +1,22 @@
|
|||||||
|
|
||||||
import { Module } from '@nestjs/common';
|
import { Module } from '@nestjs/common';
|
||||||
import { AuditModule } from '../audit/audit.module';
|
import { AuditModule } from '../audit/audit.module';
|
||||||
import { ActAdministrationController, ActAdministrationQueueController, ActCompanyResponseContentController } from './act-administration.controller';
|
import {
|
||||||
|
ActAdministrationController,
|
||||||
|
ActAdministrationQueueController,
|
||||||
|
ActCompanyResponseContentController,
|
||||||
|
} from './act-administration.controller';
|
||||||
import { ActAdministrationService } from './act-administration.service';
|
import { ActAdministrationService } from './act-administration.service';
|
||||||
|
import { FieldBriefingController } from './field-briefing.controller';
|
||||||
|
import { FieldBriefingService } from './field-briefing.service';
|
||||||
|
|
||||||
@Module({
|
@Module({
|
||||||
imports: [AuditModule],
|
imports: [AuditModule],
|
||||||
controllers: [ActAdministrationQueueController, ActAdministrationController, ActCompanyResponseContentController],
|
controllers: [
|
||||||
providers: [ActAdministrationService],
|
ActAdministrationQueueController,
|
||||||
|
ActAdministrationController,
|
||||||
|
ActCompanyResponseContentController,
|
||||||
|
FieldBriefingController,
|
||||||
|
],
|
||||||
|
providers: [ActAdministrationService, FieldBriefingService],
|
||||||
})
|
})
|
||||||
export class ActAdministrationModule {}
|
export class ActAdministrationModule {}
|
||||||
|
|||||||
@@ -0,0 +1,14 @@
|
|||||||
|
import { Controller, Get, Param, ParseUUIDPipe } from '@nestjs/common';
|
||||||
|
import { RequirePermissions } from '../authorization/decorators/require-permissions.decorator';
|
||||||
|
import { FieldBriefingService } from './field-briefing.service';
|
||||||
|
|
||||||
|
@Controller('inspection-visits/:visitId/field-briefing')
|
||||||
|
export class FieldBriefingController {
|
||||||
|
constructor(private readonly briefing: FieldBriefingService) {}
|
||||||
|
|
||||||
|
@Get()
|
||||||
|
@RequirePermissions('inspections.read')
|
||||||
|
get(@Param('visitId', new ParseUUIDPipe({ version: '4' })) visitId: string) {
|
||||||
|
return this.briefing.forVisit(visitId);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,242 @@
|
|||||||
|
import { Injectable, NotFoundException } from '@nestjs/common';
|
||||||
|
import { DataSource } from 'typeorm';
|
||||||
|
|
||||||
|
export type FieldBriefingActState =
|
||||||
|
| 'ACT_RESPONSE_OVERDUE'
|
||||||
|
| 'ACT_RESPONSE_DUE_SOON'
|
||||||
|
| 'WAITING_RESPONSE'
|
||||||
|
| 'COMPANY_COMMITMENT_OVERDUE'
|
||||||
|
| 'VERIFICATION_PENDING'
|
||||||
|
| 'RESPONSE_RECEIVED';
|
||||||
|
|
||||||
|
export interface FieldBriefingFinding {
|
||||||
|
id: string;
|
||||||
|
code: string;
|
||||||
|
title: string;
|
||||||
|
status: string;
|
||||||
|
severity: number | null;
|
||||||
|
nextControlOn: string | null;
|
||||||
|
asset: {
|
||||||
|
id: string;
|
||||||
|
code: string;
|
||||||
|
name: string;
|
||||||
|
typeName: string;
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface FieldBriefingAct {
|
||||||
|
actId: string;
|
||||||
|
actCode: string;
|
||||||
|
occurredAt: Date;
|
||||||
|
adminState: FieldBriefingActState;
|
||||||
|
responseDueOn: string | null;
|
||||||
|
responseReceivedOn: string | null;
|
||||||
|
committedCorrectionOn: string | null;
|
||||||
|
latestResponseId: string | null;
|
||||||
|
findings: FieldBriefingFinding[];
|
||||||
|
}
|
||||||
|
|
||||||
|
@Injectable()
|
||||||
|
export class FieldBriefingService {
|
||||||
|
constructor(private readonly dataSource: DataSource) {}
|
||||||
|
|
||||||
|
async forVisit(visitId: string) {
|
||||||
|
const [visit] = (await this.dataSource.query(`
|
||||||
|
SELECT
|
||||||
|
visit.id,
|
||||||
|
visit.code,
|
||||||
|
visit.status,
|
||||||
|
visit.planned_start_at AS "plannedStartAt",
|
||||||
|
visit.operational_area_id AS "areaId",
|
||||||
|
visit.operator_company_id AS "companyId",
|
||||||
|
area.code AS "areaCode",
|
||||||
|
area.name AS "areaName",
|
||||||
|
company.code AS "companyCode",
|
||||||
|
COALESCE(profile.legal_name, company.name) AS "companyName"
|
||||||
|
FROM inspection_visits visit
|
||||||
|
LEFT JOIN assets area ON area.id = visit.operational_area_id
|
||||||
|
LEFT JOIN assets company ON company.id = visit.operator_company_id
|
||||||
|
LEFT JOIN organization_profiles profile ON profile.asset_id = company.id
|
||||||
|
WHERE visit.id = $1
|
||||||
|
`, [visitId])) as Array<Record<string, unknown>>;
|
||||||
|
|
||||||
|
if (!visit) {
|
||||||
|
throw new NotFoundException({
|
||||||
|
code: 'INSPECTION_VISIT_NOT_FOUND',
|
||||||
|
message: 'Inspección no encontrada',
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
const plannedOn = String(visit.plannedStartAt ?? new Date().toISOString()).slice(0, 10);
|
||||||
|
|
||||||
|
const rows = (await this.dataSource.query(`
|
||||||
|
WITH prior_acts AS (
|
||||||
|
SELECT
|
||||||
|
act.id AS act_id,
|
||||||
|
act.code AS act_code,
|
||||||
|
act.occurred_at,
|
||||||
|
deadline.response_due_on,
|
||||||
|
response.id AS latest_response_id,
|
||||||
|
response.received_on AS response_received_on,
|
||||||
|
response.committed_correction_on,
|
||||||
|
finding.id AS finding_id,
|
||||||
|
finding.code AS finding_code,
|
||||||
|
finding.title AS finding_title,
|
||||||
|
finding.status AS finding_status,
|
||||||
|
finding.severity,
|
||||||
|
finding.next_control_on,
|
||||||
|
asset.id AS asset_id,
|
||||||
|
asset.code AS asset_code,
|
||||||
|
asset.name AS asset_name,
|
||||||
|
asset_type.name AS asset_type_name,
|
||||||
|
CASE
|
||||||
|
WHEN response.id IS NULL
|
||||||
|
AND deadline.response_due_on IS NOT NULL
|
||||||
|
AND deadline.response_due_on < $4::date
|
||||||
|
THEN 'ACT_RESPONSE_OVERDUE'
|
||||||
|
WHEN response.id IS NULL
|
||||||
|
AND deadline.response_due_on IS NOT NULL
|
||||||
|
AND deadline.response_due_on BETWEEN $4::date AND ($4::date + 3)
|
||||||
|
THEN 'ACT_RESPONSE_DUE_SOON'
|
||||||
|
WHEN response.id IS NOT NULL
|
||||||
|
AND response.committed_correction_on IS NOT NULL
|
||||||
|
AND response.committed_correction_on < $4::date
|
||||||
|
THEN 'COMPANY_COMMITMENT_OVERDUE'
|
||||||
|
WHEN response.id IS NOT NULL
|
||||||
|
AND finding.next_control_on IS NULL
|
||||||
|
THEN 'VERIFICATION_PENDING'
|
||||||
|
WHEN response.id IS NOT NULL
|
||||||
|
THEN 'RESPONSE_RECEIVED'
|
||||||
|
ELSE 'WAITING_RESPONSE'
|
||||||
|
END AS admin_state
|
||||||
|
FROM inspection_acts act
|
||||||
|
INNER JOIN inspection_visits source_visit ON source_visit.id = act.visit_id
|
||||||
|
INNER JOIN inspection_findings finding ON finding.act_id = act.id
|
||||||
|
AND finding.status = 'OPEN'
|
||||||
|
INNER JOIN assets asset ON asset.id = finding.asset_id
|
||||||
|
INNER JOIN asset_types asset_type ON asset_type.id = asset.asset_type_id
|
||||||
|
LEFT JOIN LATERAL (
|
||||||
|
SELECT event.response_due_on
|
||||||
|
FROM inspection_act_deadline_events event
|
||||||
|
WHERE event.act_id = act.id
|
||||||
|
ORDER BY event.created_at DESC, event.id DESC
|
||||||
|
LIMIT 1
|
||||||
|
) deadline ON true
|
||||||
|
LEFT JOIN LATERAL (
|
||||||
|
SELECT company_response.id, company_response.received_on, company_response.committed_correction_on
|
||||||
|
FROM inspection_act_company_responses company_response
|
||||||
|
WHERE company_response.act_id = act.id
|
||||||
|
ORDER BY company_response.received_on DESC, company_response.created_at DESC, company_response.id DESC
|
||||||
|
LIMIT 1
|
||||||
|
) response ON true
|
||||||
|
WHERE act.status IN ('CLOSED', 'RECTIFIED')
|
||||||
|
AND source_visit.id <> $1
|
||||||
|
AND source_visit.operational_area_id = $2::uuid
|
||||||
|
AND source_visit.operator_company_id = $3::uuid
|
||||||
|
)
|
||||||
|
SELECT *
|
||||||
|
FROM prior_acts
|
||||||
|
WHERE admin_state IN (
|
||||||
|
'ACT_RESPONSE_OVERDUE',
|
||||||
|
'ACT_RESPONSE_DUE_SOON',
|
||||||
|
'COMPANY_COMMITMENT_OVERDUE',
|
||||||
|
'VERIFICATION_PENDING',
|
||||||
|
'RESPONSE_RECEIVED'
|
||||||
|
)
|
||||||
|
OR next_control_on IS NOT NULL
|
||||||
|
ORDER BY
|
||||||
|
CASE admin_state
|
||||||
|
WHEN 'ACT_RESPONSE_OVERDUE' THEN 1
|
||||||
|
WHEN 'COMPANY_COMMITMENT_OVERDUE' THEN 2
|
||||||
|
WHEN 'VERIFICATION_PENDING' THEN 3
|
||||||
|
WHEN 'ACT_RESPONSE_DUE_SOON' THEN 4
|
||||||
|
ELSE 5
|
||||||
|
END,
|
||||||
|
response_due_on NULLS LAST,
|
||||||
|
occurred_at,
|
||||||
|
act_code,
|
||||||
|
finding_code
|
||||||
|
`, [visitId, visit.areaId, visit.companyId, plannedOn])) as Array<{
|
||||||
|
act_id: string;
|
||||||
|
act_code: string;
|
||||||
|
occurred_at: Date;
|
||||||
|
response_due_on: string | null;
|
||||||
|
latest_response_id: string | null;
|
||||||
|
response_received_on: string | null;
|
||||||
|
committed_correction_on: string | null;
|
||||||
|
finding_id: string;
|
||||||
|
finding_code: string;
|
||||||
|
finding_title: string;
|
||||||
|
finding_status: string;
|
||||||
|
severity: number | null;
|
||||||
|
next_control_on: string | null;
|
||||||
|
asset_id: string;
|
||||||
|
asset_code: string;
|
||||||
|
asset_name: string;
|
||||||
|
asset_type_name: string;
|
||||||
|
admin_state: FieldBriefingActState;
|
||||||
|
}>;
|
||||||
|
|
||||||
|
const byAct = new Map<string, FieldBriefingAct>();
|
||||||
|
for (const row of rows) {
|
||||||
|
let act = byAct.get(row.act_id);
|
||||||
|
if (!act) {
|
||||||
|
act = {
|
||||||
|
actId: row.act_id,
|
||||||
|
actCode: row.act_code,
|
||||||
|
occurredAt: row.occurred_at,
|
||||||
|
adminState: row.admin_state,
|
||||||
|
responseDueOn: row.response_due_on,
|
||||||
|
responseReceivedOn: row.response_received_on,
|
||||||
|
committedCorrectionOn: row.committed_correction_on,
|
||||||
|
latestResponseId: row.latest_response_id,
|
||||||
|
findings: [],
|
||||||
|
};
|
||||||
|
byAct.set(row.act_id, act);
|
||||||
|
}
|
||||||
|
act.findings.push({
|
||||||
|
id: row.finding_id,
|
||||||
|
code: row.finding_code,
|
||||||
|
title: row.finding_title,
|
||||||
|
status: row.finding_status,
|
||||||
|
severity: row.severity,
|
||||||
|
nextControlOn: row.next_control_on,
|
||||||
|
asset: {
|
||||||
|
id: row.asset_id,
|
||||||
|
code: row.asset_code,
|
||||||
|
name: row.asset_name,
|
||||||
|
typeName: row.asset_type_name,
|
||||||
|
},
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
const acts = [...byAct.values()];
|
||||||
|
const assetIds = new Set<string>();
|
||||||
|
let findingCount = 0;
|
||||||
|
for (const act of acts) {
|
||||||
|
findingCount += act.findings.length;
|
||||||
|
for (const finding of act.findings) assetIds.add(finding.asset.id);
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
inspection: {
|
||||||
|
id: visit.id,
|
||||||
|
code: visit.code,
|
||||||
|
status: visit.status,
|
||||||
|
plannedStartAt: visit.plannedStartAt,
|
||||||
|
area: visit.areaId ? { id: visit.areaId, code: visit.areaCode, name: visit.areaName } : null,
|
||||||
|
operatorCompany: visit.companyId ? { id: visit.companyId, code: visit.companyCode, name: visit.companyName } : null,
|
||||||
|
},
|
||||||
|
plannedOn,
|
||||||
|
summary: {
|
||||||
|
acts: acts.length,
|
||||||
|
findings: findingCount,
|
||||||
|
inventoryItems: assetIds.size,
|
||||||
|
responseOverdue: acts.filter((item) => item.adminState === 'ACT_RESPONSE_OVERDUE').length,
|
||||||
|
commitmentOverdue: acts.filter((item) => item.adminState === 'COMPANY_COMMITMENT_OVERDUE').length,
|
||||||
|
verificationPending: acts.filter((item) => item.adminState === 'VERIFICATION_PENDING').length,
|
||||||
|
},
|
||||||
|
acts,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,2 +1,2 @@
|
|||||||
export const API_VERSION = '0.20.0-2';
|
export const API_VERSION = '0.20.0-3';
|
||||||
export const API_PHASE = 'F1.2';
|
export const API_PHASE = 'F1.3';
|
||||||
|
|||||||
@@ -0,0 +1,30 @@
|
|||||||
|
import assert from 'node:assert/strict';
|
||||||
|
import { readFileSync } from 'node:fs';
|
||||||
|
import { test } from 'node:test';
|
||||||
|
|
||||||
|
const service = readFileSync('src/act-administration/field-briefing.service.ts', 'utf8');
|
||||||
|
const controller = readFileSync('src/act-administration/field-briefing.controller.ts', 'utf8');
|
||||||
|
const moduleSource = readFileSync('src/act-administration/act-administration.module.ts', 'utf8');
|
||||||
|
|
||||||
|
test('F1.3 agrupa pendientes de campo por Acta y Hallazgo', () => {
|
||||||
|
assert.match(service, /inspection_act_deadline_events/);
|
||||||
|
assert.match(service, /inspection_act_company_responses/);
|
||||||
|
assert.match(service, /source_visit\.operational_area_id = \$2::uuid/);
|
||||||
|
assert.match(service, /source_visit\.operator_company_id = \$3::uuid/);
|
||||||
|
assert.match(service, /ACT_RESPONSE_OVERDUE/);
|
||||||
|
assert.match(service, /COMPANY_COMMITMENT_OVERDUE/);
|
||||||
|
assert.match(service, /VERIFICATION_PENDING/);
|
||||||
|
assert.match(service, /findings: \[\]/);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('F1.3 expone el briefing para una inspección planificada', () => {
|
||||||
|
assert.match(controller, /inspection-visits\/:visitId\/field-briefing/);
|
||||||
|
assert.match(controller, /RequirePermissions\('inspections\.read'\)/);
|
||||||
|
assert.match(moduleSource, /FieldBriefingController/);
|
||||||
|
assert.match(moduleSource, /FieldBriefingService/);
|
||||||
|
});
|
||||||
|
|
||||||
|
test('F1.3 no usa el plazo del Hallazgo como plazo administrativo', () => {
|
||||||
|
assert.doesNotMatch(service, /correction_due_on/);
|
||||||
|
assert.match(service, /deadline\.response_due_on/);
|
||||||
|
});
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
# F1.3 · Planificación inteligente de pendientes
|
||||||
|
|
||||||
|
Objetivo: al planificar una inspección para un Área/Yacimiento + Operadora, generar un paquete de campo con pendientes administrativos y operativos provenientes de Actas anteriores del mismo contexto.
|
||||||
|
|
||||||
|
Reglas:
|
||||||
|
- La unidad administrativa es el Acta.
|
||||||
|
- Los hallazgos se muestran dentro de su Acta de origen.
|
||||||
|
- El checklist de planificación incluye Actas con respuesta vencida o por vencer, respuestas de empresa con fecha comprometida de regularización, y hallazgos con control/verificación pendiente.
|
||||||
|
- El inspector puede ver antecedentes antes de salir y en la APK.
|
||||||
|
- La planificación no modifica ni cierra Actas/hallazgos previos.
|
||||||
|
- La verificación en campo se registra append-only.
|
||||||
+1
-1
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "dhv2-web",
|
"name": "dhv2-web",
|
||||||
"version": "0.20.0-2",
|
"version": "0.20.0-3",
|
||||||
"private": true,
|
"private": true,
|
||||||
"type": "module",
|
"type": "module",
|
||||||
"engines": {
|
"engines": {
|
||||||
|
|||||||
@@ -34,6 +34,7 @@ import { ReportDetailPage } from '../pages/ReportDetailPage';
|
|||||||
import { VerificationPlanningPage } from '../pages/VerificationPlanningPage';
|
import { VerificationPlanningPage } from '../pages/VerificationPlanningPage';
|
||||||
import { ActAdministrationPage } from '../pages/ActAdministrationPage';
|
import { ActAdministrationPage } from '../pages/ActAdministrationPage';
|
||||||
import { ActAdministrationDetailPage } from '../pages/ActAdministrationDetailPage';
|
import { ActAdministrationDetailPage } from '../pages/ActAdministrationDetailPage';
|
||||||
|
import { FieldBriefingsPage } from '../pages/FieldBriefingsPage';
|
||||||
|
|
||||||
const MapPage = lazy(() => import('../pages/MapPage').then((module) => ({ default: module.MapPage })));
|
const MapPage = lazy(() => import('../pages/MapPage').then((module) => ({ default: module.MapPage })));
|
||||||
|
|
||||||
@@ -65,6 +66,7 @@ export function App() {
|
|||||||
<Route element={<PermissionRoute permission="inspections.read" />}>
|
<Route element={<PermissionRoute permission="inspections.read" />}>
|
||||||
<Route path="/inspecciones" element={<InspectionVisitsPage />} />
|
<Route path="/inspecciones" element={<InspectionVisitsPage />} />
|
||||||
<Route path="/inspecciones/:id" element={<InspectionVisitEditorPage />} />
|
<Route path="/inspecciones/:id" element={<InspectionVisitEditorPage />} />
|
||||||
|
<Route path="/preparacion-campo" element={<FieldBriefingsPage />} />
|
||||||
</Route>
|
</Route>
|
||||||
<Route element={<PermissionRoute permission="inspections.manage" />}><Route path="/inspecciones/nueva" element={<InspectionVisitEditorPage />} /></Route>
|
<Route element={<PermissionRoute permission="inspections.manage" />}><Route path="/inspecciones/nueva" element={<InspectionVisitEditorPage />} /></Route>
|
||||||
<Route element={<PermissionRoute permission="inspection_acts.read" />}>
|
<Route element={<PermissionRoute permission="inspection_acts.read" />}>
|
||||||
|
|||||||
@@ -1,2 +1,2 @@
|
|||||||
export const APP_VERSION = '0.20.0-2';
|
export const APP_VERSION = '0.20.0-3';
|
||||||
export const APP_PHASE = 'Fase F1.2 · Seguimiento administrativo por Acta';
|
export const APP_PHASE = 'Fase F1.3 · Planificación inteligente de pendientes';
|
||||||
|
|||||||
@@ -16,6 +16,7 @@ interface NavItem {
|
|||||||
const operational: NavItem[] = [
|
const operational: NavItem[] = [
|
||||||
{ to: '/', label: 'Inicio', icon: 'home', permission: 'dashboard.read' },
|
{ to: '/', label: 'Inicio', icon: 'home', permission: 'dashboard.read' },
|
||||||
{ to: '/inspecciones', label: 'Inspecciones', icon: 'clipboard', permission: 'inspections.read' },
|
{ to: '/inspecciones', label: 'Inspecciones', icon: 'clipboard', permission: 'inspections.read' },
|
||||||
|
{ to: '/preparacion-campo', label: 'Preparación de campo', icon: 'clipboard', permission: 'inspections.read' },
|
||||||
];
|
];
|
||||||
|
|
||||||
const followUp: NavItem[] = [
|
const followUp: NavItem[] = [
|
||||||
|
|||||||
@@ -0,0 +1,265 @@
|
|||||||
|
import { useEffect, useMemo, useState } from 'react';
|
||||||
|
import { Link } from 'react-router';
|
||||||
|
import { SearchableSelect } from '../components/SearchableSelect';
|
||||||
|
import { Alert, EmptyState, LoadingBlock } from '../components/Feedback';
|
||||||
|
import { formatDate, formatDateOnly } from '../lib/format';
|
||||||
|
|
||||||
|
type AdminState =
|
||||||
|
| 'ACT_RESPONSE_OVERDUE'
|
||||||
|
| 'ACT_RESPONSE_DUE_SOON'
|
||||||
|
| 'WAITING_RESPONSE'
|
||||||
|
| 'COMPANY_COMMITMENT_OVERDUE'
|
||||||
|
| 'VERIFICATION_PENDING'
|
||||||
|
| 'RESPONSE_RECEIVED';
|
||||||
|
|
||||||
|
interface VisitOption {
|
||||||
|
id: string;
|
||||||
|
code: string;
|
||||||
|
status: string;
|
||||||
|
plannedStartAt: string | null;
|
||||||
|
operationalArea: { name: string } | null;
|
||||||
|
operatorCompany: { name: string } | null;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface BriefingFinding {
|
||||||
|
id: string;
|
||||||
|
code: string;
|
||||||
|
title: string;
|
||||||
|
status: string;
|
||||||
|
severity: number | null;
|
||||||
|
nextControlOn: string | null;
|
||||||
|
asset: {
|
||||||
|
id: string;
|
||||||
|
code: string;
|
||||||
|
name: string;
|
||||||
|
typeName: string;
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
interface BriefingAct {
|
||||||
|
actId: string;
|
||||||
|
actCode: string;
|
||||||
|
occurredAt: string;
|
||||||
|
adminState: AdminState;
|
||||||
|
responseDueOn: string | null;
|
||||||
|
responseReceivedOn: string | null;
|
||||||
|
committedCorrectionOn: string | null;
|
||||||
|
latestResponseId: string | null;
|
||||||
|
findings: BriefingFinding[];
|
||||||
|
}
|
||||||
|
|
||||||
|
interface FieldBriefing {
|
||||||
|
inspection: {
|
||||||
|
id: string;
|
||||||
|
code: string;
|
||||||
|
status: string;
|
||||||
|
plannedStartAt: string | null;
|
||||||
|
area: { id: string; code: string | null; name: string | null } | null;
|
||||||
|
operatorCompany: { id: string; code: string | null; name: string | null } | null;
|
||||||
|
};
|
||||||
|
plannedOn: string;
|
||||||
|
summary: {
|
||||||
|
acts: number;
|
||||||
|
findings: number;
|
||||||
|
inventoryItems: number;
|
||||||
|
responseOverdue: number;
|
||||||
|
commitmentOverdue: number;
|
||||||
|
verificationPending: number;
|
||||||
|
};
|
||||||
|
acts: BriefingAct[];
|
||||||
|
}
|
||||||
|
|
||||||
|
async function getJson<T>(url: string): Promise<T> {
|
||||||
|
const response = await fetch(url, {
|
||||||
|
credentials: 'same-origin',
|
||||||
|
headers: { Accept: 'application/json' },
|
||||||
|
});
|
||||||
|
const payload = await response.json().catch(() => ({}));
|
||||||
|
if (!response.ok) {
|
||||||
|
const message = typeof payload?.message === 'string'
|
||||||
|
? payload.message
|
||||||
|
: 'No se pudo preparar el paquete de campo.';
|
||||||
|
throw new Error(message);
|
||||||
|
}
|
||||||
|
return payload as T;
|
||||||
|
}
|
||||||
|
|
||||||
|
function adminStateLabel(state: AdminState): string {
|
||||||
|
const labels: Record<AdminState, string> = {
|
||||||
|
ACT_RESPONSE_OVERDUE: 'Respuesta del Acta vencida',
|
||||||
|
ACT_RESPONSE_DUE_SOON: 'Respuesta próxima a vencer',
|
||||||
|
WAITING_RESPONSE: 'Esperando respuesta',
|
||||||
|
COMPANY_COMMITMENT_OVERDUE: 'Compromiso de empresa vencido',
|
||||||
|
VERIFICATION_PENDING: 'Verificación pendiente',
|
||||||
|
RESPONSE_RECEIVED: 'Respuesta recibida',
|
||||||
|
};
|
||||||
|
return labels[state];
|
||||||
|
}
|
||||||
|
|
||||||
|
function findingAction(finding: BriefingFinding, act: BriefingAct, plannedOn: string) {
|
||||||
|
if (finding.nextControlOn) {
|
||||||
|
if (finding.nextControlOn <= plannedOn) {
|
||||||
|
return { label: 'Revisar en campo', detail: 'Control programado o vencido', tone: 'danger' };
|
||||||
|
}
|
||||||
|
return { label: 'Próximo control', detail: `Previsto ${formatDateOnly(finding.nextControlOn)}`, tone: 'pending' };
|
||||||
|
}
|
||||||
|
if (act.adminState === 'VERIFICATION_PENDING') {
|
||||||
|
return { label: 'Revisar en campo', detail: 'Respuesta recibida sin control programado', tone: 'danger' };
|
||||||
|
}
|
||||||
|
if (act.adminState === 'COMPANY_COMMITMENT_OVERDUE') {
|
||||||
|
return { label: 'Revisar en campo', detail: 'Regularización comprometida vencida', tone: 'danger' };
|
||||||
|
}
|
||||||
|
if (act.adminState === 'RESPONSE_RECEIVED') {
|
||||||
|
return { label: 'Antecedente', detail: 'Respuesta de empresa recibida', tone: 'pending' };
|
||||||
|
}
|
||||||
|
return { label: 'Antecedente', detail: adminStateLabel(act.adminState), tone: 'pending' };
|
||||||
|
}
|
||||||
|
|
||||||
|
export function FieldBriefingsPage() {
|
||||||
|
const [visits, setVisits] = useState<VisitOption[]>([]);
|
||||||
|
const [visitId, setVisitId] = useState('');
|
||||||
|
const [briefing, setBriefing] = useState<FieldBriefing | null>(null);
|
||||||
|
const [loadingVisits, setLoadingVisits] = useState(true);
|
||||||
|
const [loading, setLoading] = useState(false);
|
||||||
|
const [error, setError] = useState('');
|
||||||
|
|
||||||
|
useEffect(() => {
|
||||||
|
setLoadingVisits(true);
|
||||||
|
Promise.all([
|
||||||
|
getJson<{ data: VisitOption[] }>('/api/v3/inspection-visits?status=PLANNED&page=1&pageSize=100'),
|
||||||
|
getJson<{ data: VisitOption[] }>('/api/v3/inspection-visits?status=DRAFT&page=1&pageSize=100'),
|
||||||
|
]).then(([planned, drafts]) => {
|
||||||
|
const all = [...planned.data, ...drafts.data]
|
||||||
|
.sort((a, b) => String(a.plannedStartAt ?? '').localeCompare(String(b.plannedStartAt ?? '')));
|
||||||
|
setVisits(all);
|
||||||
|
const onlyVisit = all[0];
|
||||||
|
if (all.length === 1 && onlyVisit) setVisitId(onlyVisit.id);
|
||||||
|
}).catch((cause) => {
|
||||||
|
setError(cause instanceof Error ? cause.message : String(cause));
|
||||||
|
}).finally(() => setLoadingVisits(false));
|
||||||
|
}, []);
|
||||||
|
|
||||||
|
useEffect(() => {
|
||||||
|
if (!visitId) {
|
||||||
|
setBriefing(null);
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
setLoading(true);
|
||||||
|
setError('');
|
||||||
|
getJson<FieldBriefing>(`/api/v3/inspection-visits/${visitId}/field-briefing`)
|
||||||
|
.then(setBriefing)
|
||||||
|
.catch((cause) => setError(cause instanceof Error ? cause.message : String(cause)))
|
||||||
|
.finally(() => setLoading(false));
|
||||||
|
}, [visitId]);
|
||||||
|
|
||||||
|
const selected = useMemo(
|
||||||
|
() => visits.find((visit) => visit.id === visitId) ?? null,
|
||||||
|
[visits, visitId],
|
||||||
|
);
|
||||||
|
|
||||||
|
return <section className="field-briefing-page">
|
||||||
|
<div className="page-heading">
|
||||||
|
<div>
|
||||||
|
<span className="eyebrow">ANTES DE SALIR A CAMPO</span>
|
||||||
|
<h1>Preparación de campo</h1>
|
||||||
|
<p>Seleccioná la inspección y revisá los pendientes de Actas anteriores del mismo Área/Yacimiento y Operadora.</p>
|
||||||
|
</div>
|
||||||
|
{briefing && <button className="button secondary no-print" type="button" onClick={() => window.print()}>
|
||||||
|
Imprimir preparación
|
||||||
|
</button>}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="form-card no-print">
|
||||||
|
<label>Inspección planificada</label>
|
||||||
|
{loadingVisits ? <LoadingBlock label="Cargando inspecciones…" /> : <SearchableSelect
|
||||||
|
value={visitId}
|
||||||
|
onChange={(event) => setVisitId(event.target.value)}
|
||||||
|
searchPlaceholder="Buscar por código, Área u Operadora…"
|
||||||
|
>
|
||||||
|
<option value="">Seleccionar inspección…</option>
|
||||||
|
{visits.map((visit) => <option key={visit.id} value={visit.id}>
|
||||||
|
{visit.code} · {visit.operationalArea?.name ?? 'Sin Área'} · {visit.operatorCompany?.name ?? 'Sin Operadora'}
|
||||||
|
</option>)}
|
||||||
|
</SearchableSelect>}
|
||||||
|
{selected?.plannedStartAt && <small className="block-muted">Salida prevista: {formatDate(selected.plannedStartAt)}</small>}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{error && <Alert>{error}</Alert>}
|
||||||
|
{loading && <LoadingBlock label="Armando paquete de campo…" />}
|
||||||
|
|
||||||
|
{!loading && !briefing && !error && <EmptyState
|
||||||
|
title="Seleccioná una inspección"
|
||||||
|
text="El sistema reunirá automáticamente los pendientes de inspecciones anteriores del mismo contexto."
|
||||||
|
/>}
|
||||||
|
|
||||||
|
{!loading && briefing && <>
|
||||||
|
<div className="page-heading compact">
|
||||||
|
<div>
|
||||||
|
<span className="eyebrow">{briefing.inspection.code}</span>
|
||||||
|
<h2>{briefing.inspection.area?.name ?? 'Área sin definir'} · {briefing.inspection.operatorCompany?.name ?? 'Operadora sin definir'}</h2>
|
||||||
|
<p>Fecha de referencia: {formatDateOnly(briefing.plannedOn)}</p>
|
||||||
|
</div>
|
||||||
|
<Link className="button secondary no-print" to={`/inspecciones/${briefing.inspection.id}`}>
|
||||||
|
Abrir planificación
|
||||||
|
</Link>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="status-tabs briefing-summary">
|
||||||
|
<span>Actas <strong>{briefing.summary.acts}</strong></span>
|
||||||
|
<span>Hallazgos <strong>{briefing.summary.findings}</strong></span>
|
||||||
|
<span>Inventario <strong>{briefing.summary.inventoryItems}</strong></span>
|
||||||
|
<span>Respuestas vencidas <strong>{briefing.summary.responseOverdue}</strong></span>
|
||||||
|
<span>Compromisos vencidos <strong>{briefing.summary.commitmentOverdue}</strong></span>
|
||||||
|
<span>Verificaciones pendientes <strong>{briefing.summary.verificationPending}</strong></span>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{briefing.acts.length === 0 ? <EmptyState
|
||||||
|
title="Sin pendientes anteriores"
|
||||||
|
text="No hay Actas anteriores con hallazgos abiertos que requieran atención para esta inspección."
|
||||||
|
/> : briefing.acts.map((act) => <article className="table-panel" key={act.actId}>
|
||||||
|
<div className="table-summary">
|
||||||
|
<div>
|
||||||
|
<strong>{act.actCode}</strong>
|
||||||
|
<small className="block-muted">{formatDate(act.occurredAt)} · {adminStateLabel(act.adminState)}</small>
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<small>Plazo del Acta</small>
|
||||||
|
<strong>{act.responseDueOn ? formatDateOnly(act.responseDueOn) : 'Sin definir'}</strong>
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<small>Respuesta empresa</small>
|
||||||
|
<strong>{act.responseReceivedOn ? formatDateOnly(act.responseReceivedOn) : 'Pendiente'}</strong>
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<small>Compromiso empresa</small>
|
||||||
|
<strong>{act.committedCorrectionOn ? formatDateOnly(act.committedCorrectionOn) : 'Sin fecha'}</strong>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="table-scroll">
|
||||||
|
<table>
|
||||||
|
<thead><tr><th>Qué hacer</th><th>Hallazgo</th><th>Inventario</th><th>Control</th></tr></thead>
|
||||||
|
<tbody>{act.findings.map((finding) => {
|
||||||
|
const action = findingAction(finding, act, briefing.plannedOn);
|
||||||
|
return <tr key={finding.id}>
|
||||||
|
<td>
|
||||||
|
<span className={`status-badge ${action.tone}`}>{action.label}</span>
|
||||||
|
<small className="block-muted">{action.detail}</small>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<strong>{finding.code}</strong>
|
||||||
|
<small className="block-muted">{finding.title}</small>
|
||||||
|
</td>
|
||||||
|
<td>
|
||||||
|
<strong>{finding.asset.code}</strong>
|
||||||
|
<small className="block-muted">{finding.asset.name} · {finding.asset.typeName}</small>
|
||||||
|
</td>
|
||||||
|
<td>{finding.nextControlOn ? formatDateOnly(finding.nextControlOn) : 'Sin fecha'}</td>
|
||||||
|
</tr>;
|
||||||
|
})}</tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
|
</article>)}
|
||||||
|
</>}
|
||||||
|
</section>;
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user