HCV Learn and Earn pilot
Field attendance first. Policy-pack ready after approval.
The wireframe keeps payroll operations simple: youth scan, supervisors verify exceptions, Rashaa exports timesheets, and only approved rollups become canonical participation records for the SCF demo path.
Identity and access
Passkey-backed program profile, no wallet setup.
The intended production path uses the partner Behavioral Attestation and Identity Layer. Students and staff sign in with a passkey-backed profile while the system manages the abstracted Stellar account in the background.
Continue with passkey
Face ID, Touch ID, Windows Hello, or device passkey starts the session.
Link program profile
HCV roster data binds the user to the correct student, supervisor, coach, or admin role.
Abstracted account
The user never handles seed phrases, gas, or wallet extensions.
Binding status
Jeffrey/Admin view
- Zoho rosterVerified
- Partner subjectVerified
- Abstracted AddressReady
- PasskeyActive
Supervisor workspace
Exception-first, not micromanagement-first.
Supervisors should not manage every punch. The system elevates exceptions and supports quick verification or override with a reason.
Coach workflow
Weekly readiness by worksite.
See which worksites still have missing checkouts or unverified corrections.
Coach can confirm attendance when a student had phone, QR, or Wi-Fi issues.
Rashaa receives cleaner weekly records before ADP entry.
Admin dashboard
Payroll risk
- Missing checkoutReview
- Approaching capWarn
- Ready to exportReady
Data flow
Evidence becomes payroll record before it becomes policy record.
Evidence capture
QR scans, break events, geolocation hints, and overrides are stored in the pilot database.
Timesheet rollup
Supervisor or coach verification plus admin readiness creates the canonical record.
Optional TD mint
Time Dollars can mint from approved hours only when the policy pack enables it.
Program Director / Operator
Rashaa: summary first, full timesheet detail on demand.
The base view stays scannable for accessibility. Use More info to open evidence events, verification chain, cap math, and export status without cluttering the default screen.
Pick a student to preview the director drill-down. Keyboard: Tab to results, Enter to select.
More info: timesheet and evidence for this student
Weekly timesheet (mock)
- Mon–Thu: complete rows with in, break out/in, out.
- Fri: short day; supervisor verified early release.
- Flags: none pending for payroll export.
Evidence trail (off-chain)
- QR check-ins tied to rotating site token.
- Optional geolocation confidence stored as signal, not sole proof.
- Overrides show actor, timestamp, and required reason.
Verification chain
- Student passkey confirmation on checkout.
- Site supervisor batch verification.
- AmeriCorps coach exception resolution when needed.
- Program Director review before weekly export lock.
Cap math
- Weekly progress: 73% of tier weekly cap.
- Summer progress: 44% of tier summer cap.
- Warnings fire before hard limits; actual hours still recorded.
Aggregate by site
Where payroll risk clusters.
Each card summarizes a worksite. Expand for director-level timesheet and staffing context.
More info: site timesheet and roster context
Site rollup
- Per-student weekly status and exception counts.
- Supervisor and co-supervisor on duty (nested roles).
- AmeriCorps coach coverage for weekly pickup.
Tier mix (mock)
- Tier split shown as badges in live product.
- Cap warnings grouped by tier rule set.
More info: site timesheet and roster context
Site rollup
- Per-student weekly status and exception counts.
- Supervisor and co-supervisor on duty (nested roles).
- AmeriCorps coach coverage for weekly pickup.
Tier mix (mock)
- Tier split shown as badges in live product.
- Cap warnings grouped by tier rule set.
More info: site timesheet and roster context
Site rollup
- Per-student weekly status and exception counts.
- Supervisor and co-supervisor on duty (nested roles).
- AmeriCorps coach coverage for weekly pickup.
Tier mix (mock)
- Tier split shown as badges in live product.
- Cap warnings grouped by tier rule set.
Program-wide aggregate
Tier-aware totals across Learn and Earn.
Director view compares tiers using the same base table pattern for screen reader clarity.
| Tier | Youth | Weekly cap | Summer cap | Avg week h | Risk note |
|---|---|---|---|---|---|
| Tier 1 (14) | 40 | 15 h | 140 h | 12.4 | 2 sites over break-rule flags |
| Tier 2 (15–19) | 60 | 20 h | 140 h | 16.8 | 7 youth above 85% weekly cap |
| Tier 3 (20–23) | 12 | 40 h | 280 h | 28.1 | 1 apprenticeship variance |
More info: program-level payroll and policy readiness
Payroll readiness
- Count of weekly packs blocked on missing checkout.
- Count blocked on supervisor verification backlog.
- Count cleared for ADP export batch.
Policy-pack alignment
- Canonical participation records only after weekly approval.
- SCF demo trace stays separate from daily field flow.
Rashaa output review
Align exports with Phase 4 sign-in and ADP Individual Timecard.
Source: Phase 4 Learning Center Sign-In Sheet.docx and ADP Workforce Now screenshots Screenshot (241).png, Screenshot (242).png in learn_and_earn/discovery_meetings/. Keep this section summary-first; use More info for long tables.
More info: output format matrix
| Artifact | Primary owner | Parity note |
|---|---|---|
| Printable weekly packet | Rashaa / site file | Matches Phase 4 field order: Name, Time In/Out, Lunch In/Out, Signature |
| CSV / spreadsheet export | Jeffrey / data | Machine-readable rows for roster + week + daily punches |
| ADP manual-entry summary | Rashaa | Column alignment to Individual Timecard (see mapping below) |
| Exception cover sheet | Coach / supervisor | One page per site/week of unresolved items before close |
| Canonical participation hash | SCF / policy | After weekly approval only; not per QR scan |
More info: critical inputs checklist
- Roster row + HCV/Zoho system ID (`hcvSystemId`)
- Worksite assignment + week date range
- Per day: Time In, Time Out, Time In Lunch, Time Out Lunch (or mapped break fields)
- Student daily confirm (app log; partner JWS when Phase C)
- Supervisor or co-supervisor signature / verification timestamp
- Exception and override with actor + reason
- Tier + weekly/summer cap context for warnings
- Export status (draft, verified, locked for ADP)
Weekly packet parity
Phase 4 Learning Center Sign-In
Week of: 06/30–07/05 — layout mirrors Rashaa’s Word packet: one block per weekday with Name, Time In, Time Out, Time In Lunch, Time Out Lunch, Signature. Confirm with Rashaa whether “Time In Lunch” means break start vs return from lunch.
Monday: 06/30
- Name
- Aaliyah M. (mock)
- Time In
- 8:58
- Time Out
- 3:04
- Time In Lunch
- 12:35
- Time Out Lunch
- 12:05
- Signature
- Supervisor OK
Tuesday: 07/01
- Name
- Aaliyah M. (mock)
- Time In
- 8:58
- Time Out
- 3:04
- Time In Lunch
- 12:35
- Time Out Lunch
- 12:05
- Signature
- Supervisor OK
Wednesday: 07/02
- Name
- Aaliyah M. (mock)
- Time In
- 8:58
- Time Out
- 3:04
- Time In Lunch
- 12:35
- Time Out Lunch
- 12:05
- Signature
- Supervisor OK
Thursday: 07/03
- Name
- Aaliyah M. (mock)
- Time In
- 8:58
- Time Out
- 3:04
- Time In Lunch
- 12:35
- Time Out Lunch
- 12:05
- Signature
- Supervisor OK
Friday: 07/04 — HOLIDAY
- Name
- —
- Time In
- —
- Time Out
- —
- Time In Lunch
- —
- Time Out Lunch
- —
- Signature
- N/A
More info: print and export actions
- Print: PDF with same field labels as Word packet for filing.
- CSV: one row per student per day with legacy column headers option.
- Holiday rows: export as zero hours + HOLIDAY flag, or omit — confirm with Rashaa.
ADP screenshot field mapping
Source field → app field → export column
Rows reflect ADP Workforce Now Individual Timecard patterns from Rashaa’s screenshots. Mark each Confirmed after a short working session with Rashaa or Jeffrey.
| Screenshot / source field | App source | Export / ADP column | Confirmed? |
|---|---|---|---|
| Employee / Individual Timecard (ADP Workforce Now) | Student profile + selected pay period week | N/A — identity context | Review |
| Tier label (e.g. TIER1 - Career Explorer) | Student.tier + program track label | Optional metadata row on export | Review |
| Department (e.g. 100111 - ACDHS…) | worksite.departmentCode or cost center | Department | Review |
| Day / Date row | TimesheetDay.date | Date | Yes |
| In - Out (combined punch display) | timeIn + timeOut (and break pair) | In-Out or separate columns per HCV choice | Review |
| Pay Code | Optional pay code mapping (REG default) | Pay Code | Review |
| Hours + Daily Totals + REGULAR / OVERTIME | dailyTotalHours + split rules if ADP requires | Hours, Daily Totals, REG, OT | Review |
| Approve checkbox / Approve Timecard | supervisorVerificationStatus + director week lock | Verification audit trail (export) | Review |
Weekly timesheet preview
Payroll-friendly record Rashaa can review.
SCF testnet demo trace
Approved timesheet to anchored participation to policy-bound TDs.
This panel is intentionally separate from the daily student scan flow. It shows reviewer-facing proof that approved records can move through the Village policy-pack path without minting from every scan.
Weekly total: 24.6 approved hours after exception review.
canonicalHash: sha256:canonical-participation-record
Third-party partner path preferred; in-house adapter fallback supported.
AttestationAnchored on Stellar testnet with community_id and policy_pack_id.
timebank approval references the canonical hash for idempotency.
Mint is derived from approved hours only because policy enables TDs.