docs: add admin machines skeleton troubleshooting

This commit is contained in:
Esdras Renan 2025-10-22 22:19:49 -03:00
parent 2a359b7a65
commit 20a5c902bc
2 changed files with 5 additions and 18 deletions

View file

@ -38,25 +38,15 @@ export function AdminMachineDetailsClient({ tenantId: _tenantId, machineId }: {
setIsHydrated(true)
}, [])
useEffect(() => {
if (!shouldLoad) {
console.debug("[admin-machine-details] Skipping probe", { shouldLoad, machineId: effectiveMachineId, fallback, single })
} else {
console.debug("[admin-machine-details] Starting probe", { machineId: effectiveMachineId, retryTick })
}
}, [shouldLoad, effectiveMachineId, fallback, single, retryTick])
useEffect(() => {
if (!shouldLoad) return
let cancelled = false
const probe = async () => {
console.debug("[admin-machine-details] Probe invocation", { machineId: effectiveMachineId, retryTick })
try {
const convexUrl = process.env.NEXT_PUBLIC_CONVEX_URL
if (convexUrl) {
try {
console.debug("[admin-machine-details] Convex probe begin", { machineId: effectiveMachineId, convexUrl })
const http = new ConvexHttpClient(convexUrl)
const data = (await http.query(api.machines.getById, {
id: effectiveMachineId as Id<"machines">,
@ -66,26 +56,22 @@ export function AdminMachineDetailsClient({ tenantId: _tenantId, machineId }: {
if (cancelled) return
if (data) {
console.info("[admin-machine-details] Convex query succeeded", { machineId: effectiveMachineId })
setFallback(data)
setLoadError(null)
return
}
if (data === null) {
console.info("[admin-machine-details] Convex query returned null", { machineId: effectiveMachineId })
setFallback(null)
setLoadError(null)
return
}
} catch (err) {
if (cancelled) return
console.warn("[admin-machine-details] Convex probe failed, falling back to API route", { machineId: effectiveMachineId, err })
}
}
try {
console.debug("[admin-machine-details] HTTP fallback begin", { machineId: effectiveMachineId })
const res = await fetch(`/api/admin/machines/${effectiveMachineId}/details`, {
credentials: "include",
cache: "no-store",
@ -101,7 +87,6 @@ export function AdminMachineDetailsClient({ tenantId: _tenantId, machineId }: {
}
if (res.ok) {
console.info("[admin-machine-details] HTTP fallback succeeded", { machineId: effectiveMachineId })
setFallback(payload ?? null)
setLoadError(null)
return
@ -113,11 +98,9 @@ export function AdminMachineDetailsClient({ tenantId: _tenantId, machineId }: {
: `Falha ao carregar (HTTP ${res.status})`
if (res.status === 404) {
console.info("[admin-machine-details] HTTP fallback returned 404", { machineId: effectiveMachineId })
setFallback(null)
setLoadError(null)
} else {
console.error("[admin-machine-details] HTTP fallback failed", { machineId: effectiveMachineId, status: res.status, message })
setLoadError(message)
}
} catch (err) {
@ -142,7 +125,6 @@ export function AdminMachineDetailsClient({ tenantId: _tenantId, machineId }: {
})
return () => {
console.debug("[admin-machine-details] Cancelling probe", { machineId: effectiveMachineId })
cancelled = true
}
}, [shouldLoad, effectiveMachineId, retryTick])