hbox-docs/docs/tableros/unidad.md

269 lines
16 KiB
Markdown

---
title: "Expediente de unidad"
description: "Todo lo registrado para una serie: actas, fotos, logs y trazabilidad de la tarjeta al puerto."
template: tablero.html
hide:
- toc
---
<div class="tb tb-unidad">
<header class="tb-cab">
<div class="tb-cab__t"><h1 id="titulo">Expediente de unidad</h1><span class="meta" id="meta">Elige una unidad para ver todo su historial.</span></div>
<div class="tb-cab__acc"><a class="boton sec" href="/tableros/campo/"><svg class="i" viewBox="0 0 24 24" aria-hidden="true"><path d="M12 3.5a8.5 8.5 0 1 0 0 17 8.5 8.5 0 0 0 0-17zM12 7v5l3.2 2"/></svg>Visitas de campo</a><button type="button" class="sec" onclick="window.print()"><svg class="i" viewBox="0 0 24 24" aria-hidden="true"><path d="M7 8.5V4h10v4.5M7 17H5a1.5 1.5 0 0 1-1.5-1.5v-5A1.5 1.5 0 0 1 5 9h14a1.5 1.5 0 0 1 1.5 1.5v5A1.5 1.5 0 0 1 19 17h-2M7 14h10v6H7z"/></svg>Imprimir</button></div>
</header>
<div class="buscar">
<select id="sel"><option value="">— elegir unidad —</option></select>
<input id="libre" placeholder="…o escribe una serie: RTK-014, ARD-007, V5-03">
<button id="ir">Ver expediente</button>
</div>
<div id="cont"></div>
</div>
<script src="/formularios/flota.js"></script>
<script>
(function () {
const el=(t,a,...k)=>{const e=document.createElement(t); if(a) for(const p in a){ if(p==='html')e.innerHTML=a[p]; else if(p==='text')e.textContent=a[p]; else e.setAttribute(p,a[p]); } k.forEach(c=>e.append(c)); return e;};
const $=i=>document.getElementById(i);
const cont=$('cont');
const fecha=s=>(s||'').replace('T',' ').slice(0,16);
const kb=n=>n>1048576?(n/1048576).toFixed(1)+' MB':Math.max(1,Math.round(n/1024))+' kB';
const NOMBRE={'diagnostico-campo':['Diagnóstico en campo','campo'],'diagnostico-banco':['Diagnóstico en banco','banco'],
'reflasheo':['Reflasheo','flash'],'instalacion-campo':['Instalación en sitio','campo'],
'dano':['Daño o incidente','falla'],'envio':['Envío','prod'],'recepcion':['Recepción','prod'],
'prueba-v5':['Prueba de tarjeta V5','prod'],'prueba-v4':['Prueba de tarjeta V4','prod'],
'modulo-ard':['Módulo ArduSimple','prod'],'modulo-4g':['Módem 4G','prod'],
'integracion':['Integración RTK + 4G','prod'],'ensamble':['Ensamble de unidad','prod']};
// lista de unidades: la flota + lo que el servidor ya tenga guardado
(async () => {
const vistas = new Set();
(window.FLOTA||[]).forEach(u => {
vistas.add(u.serie);
$('sel').append(el('option',{value:u.serie,text:u.serie+' — '+(u.maquina||'')}));
});
try{
const j = await (await fetch('/api/series')).json();
(j.series||[]).forEach(s => { if(!vistas.has(s.serie))
$('sel').append(el('option',{value:s.serie,text:s.serie+' ('+s.tipos.join(', ')+')'})); });
}catch(e){}
const q = new URLSearchParams(location.search).get('serie');
if(q){ $('sel').value=q; $('libre').value=q; cargar(q); }
})();
$('ir').addEventListener('click',()=>{ const s=($('libre').value||$('sel').value||'').trim().toUpperCase(); if(s) irA(s); });
$('sel').addEventListener('change',()=>{ if($('sel').value){ $('libre').value=''; irA($('sel').value); } });
$('libre').addEventListener('keydown',e=>{ if(e.key==='Enter') $('ir').click(); });
function irA(s){ history.replaceState(null,'','?serie='+encodeURIComponent(s)); cargar(s); }
async function detalle(tipo, serie, archivo, caja){
caja.textContent='Cargando…';
try{
const j = await (await fetch(`/api/acta?tipo=${encodeURIComponent(tipo)}&serie=${encodeURIComponent(serie)}&archivo=${encodeURIComponent(archivo)}`)).json();
if(!j.exists) throw new Error('no encontrada');
const t=el('table',{class:'det'}); const res=j.acta.respuestas||{};
Object.keys(res).forEach(k=>{
const v=res[k]; if(v.val===''||v.val===false||v.val==null) return;
t.append(el('tr',null, el('td',{class:'k',text:(v.lbl||k).replace(/<[^>]+>/g,'')}),
el('td',{text: v.val===true?'sí':String(v.val)})));
});
caja.innerHTML=''; caja.append(t.rows.length?t:el('div',{class:'vacio',text:'El acta no tiene respuestas guardadas.'}));
}catch(e){ caja.textContent='No se pudo cargar el detalle.'; }
}
function galeria(rutas){
const g=el('div',{class:'fotos'});
rutas.forEach(r=>{
const a=el('a',{href:'/api/adjunto?ruta='+encodeURIComponent(r),target:'_blank'});
a.append(el('img',{src:'/api/adjunto?ruta='+encodeURIComponent(r),loading:'lazy'}));
g.append(a);
});
return g;
}
function render(j){
cont.innerHTML='';
const u=(window.FLOTA||[]).find(x=>x.serie===j.serie);
$('titulo').textContent='Expediente · '+j.serie;
$('meta').innerHTML = u
? '<b>'+(u.maquina||'')+'</b> · '+(u.terminal||'')+(u.nota?'<br>'+u.nota:'')
: 'Esta serie no está en el registro de flota (flota.js).';
if(j.marca){
const m=j.marca_acta||{};
cont.append(el('div',{class:'err',style:j.marca==='BAJA'?'':'background:var(--aviso-bg);color:var(--aviso);border-color:var(--aviso)',
html:(j.marca==='BAJA'?'<b>Serie dada de BAJA</b>':'<b>Serie marcada como DAÑADA</b>')
+(m.fecha?' desde el '+m.fecha:'')+(m.clasificacion?' — '+m.clasificacion:'')+(m.resumen?'<br>'+m.resumen:'')
+(m.accion?'<br>Disposición: '+m.accion:'')}));
}
const kp=el('div',{class:'kpis'});
[[j.total,'Actas registradas'],[j.total_fotos,'Fotos'],[j.total_logs,'Archivos de log'],
[j.relacionadas.length,'Actas que la mencionan']]
.forEach(([n,l])=>kp.append(el('div',{class:'kpi'},el('div',{class:'n',text:String(n)}),el('div',{class:'l',text:l}))));
cont.append(kp);
// ---- trazabilidad: cadena de producción y cadena de campo ----
cont.append(trazabilidad(j));
// ---- línea de tiempo ----
const b=el('section',{class:'bloque'});
b.append(el('h2',{text:'Historial'}), el('p',{class:'sub',text:'Todo lo registrado para esta serie, de lo más reciente a lo más viejo.'}));
if(!j.actas.length) b.append(el('div',{class:'vacio',text:'Todavía no hay ninguna acta para esta unidad.'}));
else{
const lt=el('div',{class:'linea'});
j.actas.forEach(a=>{
const [nom,cls]=NOMBRE[a.tipo]||[a.tipo,'pend'];
const ev=el('div',{class:'ev '+cls});
const cab=el('div',{class:'cab'});
cab.append(el('div',null, el('div',{class:'t',text:nom}),
el('div',{class:'f',text:(a.fecha?a.fecha+' · ':'')+fecha(a.recibido)+' · '+(a.tecnico||'—')+(a.maquina?' · '+a.maquina:'')})));
const r=String(a.resultado||'');
cab.append(el('span',{class:'pill '+(r==='FALLA'?'falla':r?'ok':'pend'),text:r||'—'}));
ev.append(cab);
if(a.motivo) ev.append(el('div',{class:'cl',text:'Motivo: '+a.motivo}));
if(a.clasificacion) ev.append(el('div',{class:'cl',html:'<b>'+a.clasificacion+'</b>'}));
if(a.accion) ev.append(el('div',{class:'cl',text:'→ '+a.accion}));
if(a.fotos.length) ev.append(galeria(a.fotos));
if(a.archivos.length){
const g=el('div',{class:'logs'});
a.archivos.forEach(x=>g.append(el('a',{href:'/api/adjunto?ruta='+encodeURIComponent(x.ruta),
target:'_blank',text:(x.nombre||'captura')})));
ev.append(g);
}
const det=el('details'); det.append(el('summary',{text:'Ver todas las respuestas'}));
const caja=el('div'); det.append(caja);
det.addEventListener('toggle',()=>{ if(det.open&&!caja.dataset.l){ caja.dataset.l='1'; detalle(a.tipo,j.serie,a.archivo,caja);} });
ev.append(det);
lt.append(ev);
});
b.append(lt);
}
cont.append(b);
// ---- todos los archivos ----
const f=el('section',{class:'bloque'});
f.append(el('h2',{text:'Archivos de log'}),
el('p',{class:'sub',text:'Todas las capturas subidas para esta serie, vengan del acta que vengan.'}));
if(!j.logs.length) f.append(el('div',{class:'vacio',text:'Sin archivos de log.'}));
else{
const g=el('div',{class:'logs'});
j.logs.forEach(l=>g.append(el('a',{href:'/api/adjunto?ruta='+encodeURIComponent(l.ruta),target:'_blank',
text:l.nombre+' ('+kb(l.bytes)+')'})));
f.append(g);
}
cont.append(f);
const ph=el('section',{class:'bloque'});
ph.append(el('h2',{text:'Todas las fotos'}), el('p',{class:'sub',text:j.total_fotos+' foto(s) acumuladas.'}));
if(!j.fotos.length) ph.append(el('div',{class:'vacio',text:'Sin fotos.'}));
else ph.append(galeria(j.fotos.map(x=>x.ruta)));
cont.append(ph);
if(j.relacionadas.length){
const r=el('section',{class:'bloque'});
r.append(el('h2',{text:'Aparece como componente en'}),
el('p',{class:'sub',text:'Actas de otras unidades que incluyen esta serie entre sus módulos.'}));
j.relacionadas.forEach(a=>{
const [nom]=NOMBRE[a.tipo]||[a.tipo];
r.append(el('div',{class:'ev'},
el('div',{class:'t',html:nom+' — <a href="?serie='+encodeURIComponent(a.serie)+'">'+a.serie+'</a>'}),
el('div',{class:'f',text:fecha(a.recibido)+' · '+(a.tecnico||'—')+' · '+(a.resultado||'')})));
});
cont.append(r);
}
}
// ---------- trazabilidad ----------
// Cadena de producción (tarjeta → módulos → integración → ensamble → configuración) y cadena de
// campo (envío → recepción → instalación → diagnósticos → daños), con fecha y sitio. Para una unidad
// HBOX, las actas de sus módulos viven en OTRAS series (componentes del ensamble): se consultan aparte.
let SITIOS = null;
async function nombreSitio(id){
if(!id) return '';
if(!SITIOS){ try{ SITIOS = ((await (await fetch('/api/sitios?todos=1')).json()).sitios)||[]; }catch(e){ SITIOS=[]; } }
const s = SITIOS.find(x=>x.id===id); return s ? s.nombre : id;
}
function paso(nombre, cls, estado, detalle){
const p=el('div',{class:'paso '+cls}); p.append(el('div',{class:'n',text:nombre}), el('div',{class:'e',text:estado}));
if(detalle) p.append(el('div',{class:'d',html:detalle}));
return p;
}
function ultima(actas, tipos){ return actas.filter(a=>tipos.includes(a.tipo))[0]||null; } // ya vienen de reciente a vieja
function pasoActa(nombre, a, textoOK, textoPend){
if(!a) return paso(nombre,'pend',textoPend||'sin acta');
const falla = a.resultado==='FALLA';
return paso(nombre, falla?'falla':'ok', falla?'Falla':(textoOK||(a.resultado||'OK')), (a.fecha||fecha(a.recibido).slice(0,10))+(a.tecnico?' · '+a.tecnico:''));
}
function trazabilidad(j){
const sec=el('section',{class:'bloque'});
sec.append(el('h2',{text:'Trazabilidad'}), el('p',{class:'sub',text:'De la tarjeta al puerto: cada paso con su acta, fecha y sitio. Gris = todavía no hay acta.'}));
const A=j.actas, esHbox=/^HBOX/i.test(j.serie);
// --- producción
sec.append(el('div',{class:'cad-t',text:'Producción'}));
const prod=el('div',{class:'cadena'}); sec.append(prod);
const ens=ultima(A,['ensamble']);
let comp=(ens&&ens.componentes)||{};
// sin acta de ensamble, los módulos se deducen del número de unidad: HBOX5-E02-A002-R0002 → V5-02 · ARD-002 · RTK-0002
const mSer=!comp.einar && j.serie.match(/^HBOX5-E(\d+)-A(\d+)-R(\d+)$/i);
if(mSer) comp={einar:'V5-'+mSer[1].padStart(2,'0'), ard:'ARD-'+mSer[2].padStart(3,'0'), modem:'RTK-'+mSer[3].padStart(4,'0')};
if(esHbox){
// módulos: se consultan por su serie
const m=[['Tarjeta EinarBoard','prueba-v5',comp.einar],['ArduSimple','modulo-ard',comp.ard],['Módem 4G','modulo-4g',comp.modem]];
const ph={}; m.forEach(([n,,s])=>{ const p=paso(n,'pend',s?'consultando…':'sin ensamble', s?'<a href="?serie='+encodeURIComponent(s)+'">'+s+'</a>':''); ph[n]=p; prod.append(p); });
const integ=paso('Integración','pend',comp.ard&&comp.modem?'consultando…':'—'); prod.append(integ);
(async()=>{
for(const [n,tipo,s] of m){
if(!s) continue;
let txt='sin acta', cls='pend';
try{ const r=await (await fetch(`/api/acta?tipo=${tipo}&serie=${encodeURIComponent(s)}`)).json();
if(r.exists){ cls=r.acta.resultado==='FALLA'?'falla':'ok'; txt=cls==='ok'?'Aprobada':'Falla'; ph[n].querySelector('.d').innerHTML+=' · '+(r.acta.fecha||fecha(r.acta._recibido).slice(0,10)); } }catch(e){}
ph[n].className='paso '+cls; ph[n].querySelector('.e').textContent=txt;
}
if(comp.ard&&comp.modem){
const si='INT-A'+(String(comp.ard).match(/(\d+)\s*$/)||[,''])[1]+'-R'+(String(comp.modem).match(/(\d+)\s*$/)||[,''])[1];
let txt='sin acta', cls='pend';
try{ const r=await (await fetch(`/api/acta?tipo=integracion&serie=${encodeURIComponent(si)}`)).json();
if(r.exists){ cls=r.acta.resultado==='FALLA'?'falla':'ok'; txt=cls==='ok'?'Aprobada':'Falla'; integ.append(el('div',{class:'d',html:'<a href="?serie='+encodeURIComponent(si)+'">'+si+'</a> · '+(r.acta.fecha||fecha(r.acta._recibido).slice(0,10))})); } }catch(e){}
integ.className='paso '+cls; integ.querySelector('.e').textContent=txt;
}
})();
prod.append(pasoActa('Ensamble',ens,'Unidad lista'));
prod.append(pasoActa('Configuración / pruebas',ultima(A,['reflasheo','prueba-ethernet-serie','prueba-bateria-modem']),null,'sin acta'));
} else {
// pieza suelta: su propia acta de prueba, y en qué unidad quedó
prod.append(pasoActa('Acta de la pieza',ultima(A,['prueba-v5','prueba-v4','modulo-ard','modulo-4g'])));
const integ=j.relacionadas.find(r=>r.tipo==='integracion'), ensR=j.relacionadas.find(r=>r.tipo==='ensamble');
prod.append(integ?paso('Integración',integ.resultado==='FALLA'?'falla':'ok',integ.resultado==='FALLA'?'Falla':'En pareja','<a href="?serie='+encodeURIComponent(integ.serie)+'">'+integ.serie+'</a>'):paso('Integración','pend','sin acta'));
prod.append(ensR?paso('Ensamble',ensR.resultado==='FALLA'?'falla':'info',ensR.resultado==='FALLA'?'Falla':'Montada en unidad','<a href="?serie='+encodeURIComponent(ensR.serie)+'">'+ensR.serie+'</a>'):paso('Ensamble','pend','libre (no está en una unidad)'));
prod.append(pasoActa('Banco / reflasheo',ultima(A,['diagnostico-banco','reflasheo']),null,'—'));
}
// --- campo
sec.append(el('div',{class:'cad-t',text:'Campo'}));
const campo=el('div',{class:'cadena'}); sec.append(campo);
const env=ultima(A,['envio']), rec=ultima(A,['recepcion']), ins=A.filter(a=>a.tipo==='instalacion-campo'&&a.resultado!=='FALLA')[0]||ultima(A,['instalacion-campo']);
const diags=A.filter(a=>a.tipo==='diagnostico-campo'), danos=A.filter(a=>a.tipo==='dano');
const conSitio=async(p,a)=>{ if(a&&a.sitio){ const n=await nombreSitio(a.sitio); let d=p.querySelector('.d'); if(!d){ d=el('div',{class:'d'}); p.append(d); } d.innerHTML+=' · <a href="/tableros/sitio/?id='+encodeURIComponent(a.sitio)+'">'+n+'</a>'; } };
const pEnv=env?paso('Envío',env.accion&&/detenida/i.test(env.accion)?'info':'ok',env.accion||'Enviada',(env.fecha||'')+(env.clasificacion?' · '+env.clasificacion:'')):paso('Envío','pend','sin acta'); campo.append(pEnv); conSitio(pEnv,env);
const pRec=rec?paso('Recepción',rec.resultado==='FALLA'?'falla':'ok',rec.accion||rec.resultado||'Recibida',(rec.fecha||'')+(rec.clasificacion?' · '+rec.clasificacion:'')):paso('Recepción','pend','sin acta'); campo.append(pRec); conSitio(pRec,rec);
const pIns=ins?paso('Instalación',ins.resultado==='FALLA'?'falla':'ok',ins.accion||(ins.resultado==='FALLA'?'Falla':'Instalada'),(ins.fecha||'')+(ins.maquina?' · '+ins.maquina:'')):paso('Instalación','pend','sin acta','<a href="/formularios/instalacion.html">llenar acta</a>'); campo.append(pIns); conSitio(pIns,ins);
const pDg=diags.length?paso('Diagnósticos',diags[0].resultado==='FALLA'?'falla':'info',diags.length+' visita(s)',(diags[0].fecha||'')+(diags[0].accion?' · '+diags[0].accion:'')):paso('Diagnósticos','pend','ninguno'); campo.append(pDg); conSitio(pDg,diags[0]);
const pDn=j.marca?paso('Daños',j.marca==='BAJA'?'falla':'falla',j.marca==='BAJA'?'Baja':'Dañada',(j.marca_acta&&j.marca_acta.fecha)||''):(danos.length?paso('Daños','ok','reparada / sin marca',danos.length+' acta(s)'):paso('Daños','ok','sin daños')); campo.append(pDn); conSitio(pDn,danos[0]);
return sec;
}
async function cargar(serie){
cont.innerHTML='<p class="vacio">Cargando…</p>';
try{
const j=await (await fetch('/api/unidad?serie='+encodeURIComponent(serie),{cache:'no-store'})).json();
if(!j.ok) throw new Error(j.error||'error');
render(j);
}catch(e){
cont.innerHTML='';
cont.append(el('div',{class:'err',text:'No se pudo leer el expediente: '+e.message}));
}
}
})();
</script>