# BF Tutors — agency UI pack v3

60 individually named mobile HTML screens. Includes earlier onboarding, packages, matching, tutor registration and agency admin concepts plus new homes, all bottom tabs, attendance OTP, session maps/zone indicators, parent-away and zone-admin review flows.

## Open
Extract the ZIP, then open index.html to browse the screen library. For the connected attendance demo, use a local web server so every page shares browser storage:

1. Open a terminal in this extracted folder.
2. Run `python3 -m http.server 8080` (Windows: `py -m http.server 8080`).
3. Open http://localhost:8080/index.html in your browser.

Simple HTML screens work offline. Cross-page demo storage on file:// varies by browser, so localhost is recommended for the interactive OTP flow.

## Parent OTP demo
Start tutor home → Open class & attendance → Share session location → Request parent verification → confirm checkbox → Generate parent OTP → note code → switch to tutor entry → enter code → verify. Parent and tutor attendance views read the SAME resulting event. Refresh either view to see the update.

## Zone-admin demo
Reset demo from index. Tutor OTP page → Parent unavailable → provide reason → Send → open zone admin review → add review note and confirm verified presence → Approve & issue code → switch to tutor entry → enter admin code. Both records update with zone-admin source. Reset between test paths. A rejection requires a reason and creates no attendance.

## Working prototype behaviour
OTP issuance gate, expiry countdown, incorrect-code attempt counter, single use, reissue invalidation, reason-required fallback, admin review gate, shared paired attendance result and audit history. All use browser storage, fake locations and fixed demo codes; NOT security controls. No live location, SMS, authentication, payment or real assignment service. Form values outside attendance are still visual samples and do not persist.

## Business model retained
Home tuition only. Four tiers Lower/Middle/Upper/Premium with durations 6 months/1 year/2 years/4 years. Benefits, fees and allowed combinations are admin-configured. Student package data is student/authorised-admin only. Tutor registration examples ₹900/₹1,400 remain unconfirmed. Assigned-zone attendance admins do not automatically get commercial access.

## Files
- index.html: grouped screen gallery and role walkthroughs.
- assets/style.css: shared responsive styles.
- assets/app.js: selection and simple feedback controls.
- assets/attendance.js: isolated non-production attendance simulation.
- ATTENDANCE-SPEC.md: zone, OTP, location, role and atomic attendance requirements.
- FLOW.md: onboarding and attendance flowcharts.
- ACCESS-RULES.md: role visibility.
- AI-DESIGN-PROMPT.md: updated prompt for editable UI generation.
- SCREEN-INVENTORY.csv: filenames and roles.

The user's new attendance requirement is interpreted as presence verification at class arrival. Whether a separate end-of-class OTP is needed remains a BF policy decision. GPS is supporting evidence, not conclusive proof. No child-phone location is fabricated when the student has no device; use reviewed fallback.