Louis Barton Zona Franca Design Docs

Phase I prototype design — Jetson edge compute + Amcrest cameras + Auth0 + Excel parity. Open-source by intent; internal data is gated.

Project charter Architecture All decisions (ADRs) Internal docs (sign-in required)

Project charter

What we’re building, scope, phases. The single canonical statement of the work.

Read the charter →

Hardware specification

Jetson Orin Nano Super, Amcrest IP8M-2779EW-AI cameras, TP-Link PoE switch. BOM, install runbook, network topology.

Open hardware section →

ML pipeline

YOLOv8n + TensorRT, 3–5 fps cycle-event detection, ROI calibration, failure modes and monitoring.

Open ML section →

Research & paper

Validation methodology, related work, reproducibility plan. Authorship strategy and COI disclosure are sign-in required.

Open research →

Reading orders by stakeholder

Different stakeholders want different paths through the docs. Below are six suggested reading orders — use whichever matches your role. Items marked (auth-gated) live under the sign-in-required /private-docs/ tier on lbzfai.com.

A. First-time public visitor

Someone who landed on lbzfai.com/docs/ via search or a link, with no prior context.

README — what this project is + the two-tier structure overview
project-charter — what we’re building and why, in plain English
40-prototype/architecture — one-page system diagram
30-decisions/accepted/ — skim the 6 ADRs to see what’s locked
50-research/paper-plan — IEEE publication target, claims, venue (auth-gated)

B. ITBA collaborator (research-focused)

A PhD on the BA twin-hardware install or paper co-author candidate.

project-charter — project scope, phases, current state
40-prototype/orientation/the-factory — what LBZF is, what Angela module looks like (auth-gated)
40-prototype/architecture — system overview
50-research/paper-plan — venue, authorship Options A/B/C, where ITBA fits (auth-gated)
50-research/methods/validation-methodology — paper Methods section anchor
50-research/itba/data-sharing-agreement — what ITBA can and cannot do with LBZF data
50-research/related-work — verified prior art
40-prototype/hardware/argentina-twin-set — the hardware they received
20-questions/01-itba/ — open questions ITBA owns (auth-gated)

C. Mariana / Executive / family-business decision-maker

Mariana understanding scope, costs, risks, and what she needs to sign off on.

project-charter — overview, phases, current status
30-decisions/accepted/ — what’s been locked (hardware, software, deployment)
40-prototype/lbzf/budget-resources — costs (auth-gated)
40-prototype/lbzf/risk-register — top risks (auth-gated)
40-prototype/lbzf/privacy-consent-labor-law — operator consent + Ley 1581 posture (auth-gated, requires her sign-off)
40-prototype/lbzf/stakeholder-comms-plan — comms cadence (auth-gated)
50-research/ethics-and-coi — family-business COI disclosure for the paper (auth-gated)

D. Ronald / On-floor industrial engineer

Ronald validating Sophia’s understanding of the factory and reviewing the dashboard / Excel proposal.

40-prototype/orientation/current-workflow — Sophia’s documented understanding of how Angela operates today (for Ronald to verify accuracy) (auth-gated)
40-prototype/orientation/the-factory — factory layout + Phase I scope (auth-gated)
40-prototype/frontend/ronald-dashboard-ux — proposed dashboard layout for his daily use
40-prototype/backend/excel-export — Excel export format (must match his INDICADORES)
40-prototype/lbzf/privacy-consent-labor-law — operator consent process he’ll be involved in (auth-gated)
20-questions/04-customer-requirements/ — open questions awaiting his confirmation (auth-gated)

E. Paper reviewer / IEEE academic

External IEEE reviewer doing a methodology check on the published paper.

50-research/paper-plan — claim and hypotheses (auth-gated)
50-research/methods/validation-methodology — experimental design
50-research/reproducibility/reproducibility-and-artifacts — what’s reproducible
50-research/related-work — prior art coverage
50-research/ethics-and-coi — ethics + COI disclosure (auth-gated)
50-research/itba/data-sharing-agreement — multi-site data governance
ADR-003-yolov8n-phase-i and ADR-004-frame-rate-3-5-fps — model + sampling decisions

F. Future Claude agent / new contributor

LLM agent or new human contributor picking up the project cold.

README — top-level structure + audience map
CONVENTIONS — frontmatter, OPEN-question grammar, status labels
project-charter — what + why
40-prototype/architecture — one-page system map
30-decisions/accepted/ — locked decisions (don’t re-litigate)
20-questions/ — open questions by topic (auth-gated)
90-meta/agents-handbook — handbook for agents (auth-gated)
90-meta/round-1-reports/ — original 5-bucket investigation reports if deep context needed (auth-gated)

What’s not on this site

By design, this site excludes the PM overlay (00-now/, 10-gates/, STATUS.md) and operational data (40-prototype/orientation/data/). The full source tree lives in the repo.