/* ============================================================ DOCUMENTS MODULE ============================================================ */ /** Shared table, also used on a component's Documentation tab. `Th` is only passed * by the module's own list, which sorts; the embedded tab just shows plain headers. */ function DocumentTable({documents, idx, go, onUnlink, onOpen, Th}){ const Head = Th || ((props) => { const rest = Object.assign({}, props); delete rest.k; delete rest.label; return {props.label}; }); return (
{onUnlink && } {documents.map(d => { const owner = resolveParty(d.owner, idx); const overdue = isOverdue(d.reviewDue) && d.status !== 'Retired'; return ( onOpen && onOpen(d)}> {onUnlink && } ); })}
Components
{d.title}
{d.reference && {d.reference} · } {d.summary ? d.summary.slice(0, 90) : ''}
{d.docType} {d.status} {owner ? {owner.name} : —} {d.version || '—'} {d.reviewDue ? {fmtDate(d.reviewDue)} : —}
{(d.componentIds||[]).slice(0,2).map(cid => idx.comp[cid] ? { e.stopPropagation(); go({view:'component', id:cid}); }}> {idx.comp[cid].identifier} : null)} {(d.componentIds||[]).length > 2 && +{d.componentIds.length - 2}} {!(d.componentIds||[]).length && Standalone}
e.stopPropagation()}>
); } function DocumentsModule({state, idx, go, act, toast, route}){ const [q, setQ] = useState(()=>urlParam('q')); const [fType, setFType] = useState(()=>urlParam('type')); const [fStatus, setFStatus] = useState(()=>urlParam('status')); const [fScope, setFScope] = useState(()=>urlParam('scope')); const [fOwner, setFOwner] = useState(()=>urlParam('owner')); const [editing, setEditing] = useState(null); const [open, setOpen] = useState(null); const {sort, sorted, Th} = useSort('title', { title: d => d.title, type: d => d.docType, status: d => d.status, owner: d => partyName(d.owner, idx) || 'zzz', version: d => d.version || '', review: d => d.reviewDue || '9999' }); useFilterUrlSync({q:[q,''], type:[fType,''], status:[fStatus,''], scope:[fScope,''], owner:[fOwner,'']}); const canEdit = (id) => { const ids = state.permissions.editableDocumentIds; return ids === '*' || (Array.isArray(ids) && ids.includes(id)); }; const canCreate = state.permissions.editableDocumentIds === '*' || state.permissions.editableComponentIds === '*' || (Array.isArray(state.permissions.editableComponentIds) && state.permissions.editableComponentIds.length > 0); useEffect(()=>{ if (route && route.action === 'new' && canCreate) setEditing(NEW_DOCUMENT()); }, [route]); const docTypes = state.lookups.doc_type || []; const rows = useMemo(()=>{ const term = q.trim().toLowerCase(); const list = state.documents.filter(d => { if (fType && d.docType !== fType) return false; if (fStatus && d.status !== fStatus) return false; if (fOwner && partyKey(d.owner) !== fOwner) return false; if (fScope === 'standalone' && (d.componentIds||[]).length) return false; if (fScope === 'linked' && !(d.componentIds||[]).length) return false; if (fScope === 'overdue' && !(isOverdue(d.reviewDue) && d.status !== 'Retired')) return false; if (!term) return true; return [d.title, d.reference, d.summary, d.docType, d.version, partyName(d.owner, idx), (d.tags||[]).join(' ')].join(' ').toLowerCase().includes(term); }); return sorted(list); }, [state.documents, q, fType, fStatus, fScope, fOwner, sort, idx]); const overdue = state.documents.filter(d => isOverdue(d.reviewDue) && d.status !== 'Retired'); const soon = state.documents.filter(d => { const n = daysUntil(d.reviewDue); return n != null && n >= 0 && n <= 30 && d.status !== 'Retired'; }); const ownerOptions = [ ...state.people.map(p=>({k:'person:'+p.id, label:p.name})), ...state.roles.map(r=>({k:'role:'+r.id, label:r.name + ' (role)'})) ].sort((a,b)=>a.label.localeCompare(b.label)); const exportList = () => exportCsv('fuse-documents.csv', ['Reference','Title','Type','Status','Version','Owner','Last reviewed','Next review','Components','URL'], rows.map(d => [d.reference, d.title, d.docType, d.status, d.version, partyName(d.owner, idx), d.lastReviewed, d.reviewDue, (d.componentIds||[]).map(cid => (idx.comp[cid]||{}).identifier).filter(Boolean).join(' '), d.url])); return (
{state.documents.length}
Documents
{state.documents.filter(d=>!(d.componentIds||[]).length).length}
Standalone
{overdue.length}
Overdue review
{soon.length}
Due in 30 days
{state.documents.filter(d=>d.attachments.length).length}
With files
{(q||fType||fStatus||fScope||fOwner) && }
{rows.length} shown
Click a row to open
{rows.length ? : } title="No documents match" action={(q||fType||fStatus||fScope||fOwner) ? : null}/>}
{open && d.id === open.id) || open} state={state} idx={idx} go={go} act={act} toast={toast} editable={canEdit(open.id)} onClose={()=>setOpen(null)} onEdit={()=>{ setEditing(state.documents.find(d => d.id === open.id)); setOpen(null); }}/>} {editing && setEditing(null)} onSave={async (v)=>{ const isNew = !v.id; const ok = await act(isNew ? API.post('/api/documents', v) : API.put(`/api/documents/${v.id}`, v), isNew ? 'Document created' : 'Document saved'); if (ok) setEditing(null); }}/>}
); } const NEW_DOCUMENT = () => ({ id:'', reference:'', title:'', url:'', docType:'Reference', status:'Current', version:'', owner:null, lastReviewed:'', reviewDue:'', summary:'', tags:[], componentIds:[] }); function DocumentDetail({doc, state, idx, go, act, toast, editable, onClose, onEdit}){ const owner = resolveParty(doc.owner, idx); const overdue = isOverdue(doc.reviewDue) && doc.status !== 'Retired'; const linked = (doc.componentIds||[]).map(id => idx.comp[id]).filter(Boolean); return ( {editable && } }>
{doc.status} {doc.docType} {doc.version && {doc.version}} {overdue && Review overdue} {doc.url && Open document}
{doc.summary &&

{doc.summary}

}
Reference
{doc.reference || —}
Owner
{owner ? {owner.name} {owner.sub} : Not assigned}
Last reviewed
{fmtDate(doc.lastReviewed) || Never}
Next review
{doc.reviewDue ? {fmtDate(doc.reviewDue)} : Not scheduled}
Created
{fmtDateTime(doc.createdAt)} by {doc.createdBy}
Last updated
{fmtDateTime(doc.updatedAt)} by {doc.updatedBy}
{(doc.tags||[]).length > 0 && <>
Tags
{doc.tags.map(t => {t})}
}
Components covered
{linked.length ?
{linked.map(c => { onClose(); go({view:'component', id:c.id}); }}> {c.name})}
:

Standalone document, not tied to a component.

}
); } function DocumentForm({value, state, onClose, onSave}){ const [d, setD] = useState(()=>clone(value)); const [tagText, setTagText] = useState((value.tags||[]).join(', ')); const [busy, setBusy] = useState(false); const set = (k,v) => setD(x => ({...x, [k]:v})); const isNew = !value.id; const docTypes = state.lookups.doc_type || ['Reference']; return ( }>
set('title', e.target.value)} placeholder="e.g. Customer portal runbook"/> set('reference', e.target.value)}/>