Polish RoadAffordanceLab research portfolio

[drxadqz]

What changed

• rebuilt the repository landing page as an English/Chinese research-engineering portfolio;
• added a project hero, C3-FaRNet architecture diagram, verified metric overview and all-class F1 plot;
• generated every result figure directly from committed CSV/JSON evidence;
• added a model card, engineering guide, release inventory links and honest non-SOTA boundary;
• added lightweight release-contract CI, issue forms, contribution/security policies and citation metadata;
• reduced unused lightweight-install dependencies and refreshed package metadata.

Why

The previous repository contained strong result evidence and checkpoint provenance, but its first page did not communicate the research question, architecture, engineering depth or reproducibility story quickly enough. It also lacked CI that could prevent the README figures from drifting away from machine-readable results.

The new landing page is designed for two readers: a recruiter can understand the project in under a minute, while an ML engineer can continue into exact configs, checkpoints, metrics and code.

Scientific boundary

The page reports the frozen standalone S7 checkpoint result (90.632% Top-1, 88.920% Macro-F1 on 49,500 images) as verified internal evidence. It explicitly does not claim a new public SOTA. Active ARCQ/TACT experiments remain excluded until their validation protocol is completed and frozen.

Validation

• python -m compileall -q src scripts train.py validate.py test.py
• python train.py --help
• python validate.py --help
• python test.py --help
• python scripts/verify_release.py
• python scripts/generate_readme_assets.py --check
• git diff --check
• targeted scan for credential prefixes and accidental absolute user paths

All checks passed locally on Python 3.11.

[drxadqz]

Superseded by the merged bilingual portfolio in #3. Closing this draft to keep the public repository history focused.