README_FIRST.md: read first; explains staging purpose and safety rules.DEPLOY_MANIFEST.md: exact files intended for Raspberry Pi copy.REVIEW_REQUIRED.md: remaining open review gates plus links to completed verification records.CHANGELOG_STAGING.md: staging changes, completed verification, and remaining verification.MASTER_INDEX.md: this index.
hardware/: copied schematics, PCB fabrication/source files, BOM-related material if present, datasheets, and hardware map workspace.software/: active staged Python package. Folders identify the subsystem and filenames identify the role. Physical assignments live insoftware/station/station_hardware_map.py; Python entrypoints live insoftware/commands/; operator-facing wrappers live inbin/.deployment/: operator notes for Pi setup, copy commands, and first test sequence. These files are procedures only.project_control/: review gates, verification records, templates, and archived project-control notes.test_records/: observed test results, pass/fail notes, command outputs, and verification evidence from lab testing.docs/active/: current high-level hardware/project documents copied from the hardware repository.docs/wiring/: wiring diagrams and PCB connection guides.docs/audit_reports/: audit reports plus crash recovery materials.docs/reference_only/: Word docs, old notes, and source references that are not active deployment instructions.legacy_deprecated/: historical scripts and generated material kept for reference only.source_archive_index/: audit indexes and search reports for remaining stale or review-required references.
- Active scripts:
software/ - Human-facing commands:
bin/ - Python command entrypoints:
software/commands/ - Reusable diagnostics: the corresponding
software/<subsystem>/folder - Hardware schematics and PCB files:
hardware/schematics/andhardware/pcb/ - Deployment order:
deployment/test_run_order/FIRST_PI_TEST_SEQUENCE.md - Open review gates:
REVIEW_REQUIRED.mdandproject_control/review_pending/ - Completed verification records:
project_control/verification_completed/ - Observed test results:
test_records/ - Material not to run:
legacy_deprecated/anddocs/reference_only/