Maritime Geographic Training Web Application Stage 1 Prototype – Scope Lock, Milestones, and Acceptance Checklist Budget Target (Stage 1): $100–$300 This document is the scope-lock for Stage 1 (Prototype). It includes clear milestone deliverables and a pass/fail acceptance checklist to ensure the prototype is delivered correctly. 1. Stage 1 Scope Summary (What Must Be Built) - Web-based app (runs in browser). - NOAA nautical chart basemap (chart-style map, not standard Google map styling). - 114 Charleston AOR locations (names provided; developer must geocode + verify). - Game modes: Pin Drop + Multiple Choice. - Image-based questions (image URL support). - Scoring + Pass/Fail result screen. - No login (local progress storage only). - Minimal Admin panel (password protected) with CSV import/export and tolerance settings. - Code handoff + basic setup instructions. 2. Map Requirement (NOAA Chart) - Map baselayer must be a NOAA nautical chart style basemap. - Developer may use a lightweight mapping library (Leaflet recommended) for Stage 1. - Must support smooth zoom/pan and accurate click-to-coordinate behavior. 3. Data & Images - Developer must create a verified dataset for the 114 locations: name, latitude, longitude. - Some locations/questions include an image prompt (e.g., bridge, landmark, station, buoy). - Stage 1 images can be provided as URLs (no file upload required). - Any images sourced by developer must be public domain or properly licensed; sources must be documented. - USCG-style imagery may be included, but official seals/logos should be avoided unless explicitly permitted. 4. Game Modes (Functional Requirements) 4.1 Pin Drop Mode User Flow: 1) Show location name (and image if applicable). 2) User drops a pin on the NOAA chart. 3) App calculates error distance to correct coordinates. 4) App displays: user pin, correct pin, line between them, error distance. 5) Next question button advances quiz. Scoring: distance-based (tiered or threshold), with admin-adjustable tolerance thresholds. 4.2 Multiple Choice Mode User Flow: 1) Show location name (and image if applicable). 2) Display 4 candidate answers (pins or list). 3) User selects an answer; immediate feedback (correct/incorrect). 4) Next question advances quiz. Scoring: correct/incorrect counts + percentage. 5. Pass/Fail Rules (Prototype Standard) - Default quiz length: 15 questions. - Passing threshold: 80% or higher. - End screen must clearly show PASS or FAIL, accuracy %, and basic stats. - Note: Admin can adjust distance tolerance used to determine correctness in Pin Drop mode. 6. Progress Tracking (No Login) - Store progress locally in browser (LocalStorage or equivalent). - Must show at minimum: questions answered, correct answers, accuracy %, average distance error (Pin Drop). 7. Admin Panel (Minimum Required) - Password-protected admin page. - Add/Edit/Delete locations. - Upload CSV (name, lat, long, optional image URL). - Export dataset CSV/JSON. - Adjust distance tolerance thresholds. - Toggle availability of modes (Pin Drop / Multiple Choice). 8. Milestones (Payment Tied to Deliverables) Recommended: 3 milestones. Each milestone is accepted only if its checklist passes. Milestone 1 – NOAA Map + Pin Drop Core Deliverables: ☐ NOAA nautical chart basemap loads and renders correctly. ☐ User can drop a pin; click-to-coordinate works accurately. ☐ Correct answer coordinates can be loaded for a question. ☐ Error distance is calculated and displayed (meters or yards). ☐ Feedback displays user pin + correct pin + connecting line. ☐ Basic UI shell (question panel + map). Acceptance: Milestone 1 is PASS only if all boxes above work in a live demo. Milestone 2 – Multiple Choice + Images + Pass/Fail Screen Deliverables: ☐ Multiple Choice mode works end-to-end with 15-question quiz. ☐ Immediate correct/incorrect feedback works. ☐ Image questions supported via image URL (image loads reliably). ☐ Scoring updates across questions (correct count + accuracy %). ☐ Final results screen shows PASS/FAIL based on 80% threshold. Acceptance: Milestone 2 is PASS only if all boxes above work in a live demo. Milestone 3 – Admin Panel + CSV + Final Handoff Deliverables: ☐ Admin login works (password protected). ☐ Admin can Add/Edit/Delete locations. ☐ CSV upload imports name/lat/long/(optional image URL) correctly. ☐ Dataset export (CSV or JSON) works. ☐ Admin can change distance tolerance thresholds. ☐ No critical console errors; basic documentation provided. ☐ Source code delivered; app runs locally with setup instructions. Acceptance: Milestone 3 is PASS only if all boxes above work and code handoff is complete. 9. Final Acceptance Checklist (Stage 1 Pass/Fail) Stage 1 is COMPLETE only if ALL of the following pass: ☐ NOAA chart basemap loads without error. ☐ Pin Drop mode works for at least 15 questions continuously without breaking. ☐ Distance calculations are accurate and consistent. ☐ Multiple Choice mode works for at least 15 questions continuously without breaking. ☐ Image questions load (no broken images) and are tied to correct locations. ☐ PASS/FAIL screen correctly triggers at 80% threshold. ☐ Admin panel works (CRUD + CSV import/export + tolerance settings). ☐ All 114 locations are present in the dataset with verified coordinates. ☐ App runs locally from provided instructions without developer assistance. ☐ No critical browser console errors during normal use. ☐ Source code + dataset + documentation are delivered. 10. Future Phases (Not in Stage 1, But Must Be Possible Later) The Stage 1 architecture should be clean and modular so it can expand later into additional modules, such as: - Additional regions/AORs (multiple chart areas). - Board Mode (timed, pass/fail certification at higher thresholds). - Boat-specific knowledge testing modules. - Crewman / Coxswain responsibilities modules. - Seamanship + Navigation knowledge question banks. - Scenario-based decision trees and risk management. Note: These are future enhancements and are not required for Stage 1 delivery.