Maritime Navigation Training Map App -- 2

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.