Milestone: Core Implementation Complete

Due: April 2, 2026 Sprint: Week 1 – Week 2 Project: Local History Story Map

---

Goal

All Week 1 and Week 2 deliverables of MVP are complete. Backend and frontend foundation, auth, core features, and the three primary user flows work end-to-end in the local environment. The project is ready to enter the polish, testing, and deployment phase.

---

Week 1 deliverables — Foundation (Mar 15–21)

• Project scaffolding for both backend and frontend — repo structure, linting, environment configs
• Database set up with core schema: users, stories, media, comments, likes
• Auth endpoints implemented: register, login, logout
• JWT/session middleware with role-based guards (guest, registered user, admin)
• Story CRUD endpoints and map data endpoint
• Password hashing in place
• Frontend auth screens (register, login) and route guards
• Map view skeleton with map library embedded and dummy pins rendering
• CI pipeline running lint and tests on push

Week 2 deliverables — Core Features (Mar 22–30)

• Feed endpoint with pagination, sort-by-recent, and time/location filtering
• Search endpoint searching by story title and location name
• Like and comment endpoints with remove support
• Image upload endpoint with file type (jpg/png) and size (≤2MB) validation
• Profile endpoint returning username, contribution count, and submitted stories
• Input validation and error responses on all write endpoints
• Map view: pins fetched from API, preview popup on click, opens story page
• Feed view: story cards with pagination
• Story page: full narrative, metadata, image, like button, comments section
• Story submission form with map pin selection and optional image upload
• Search bar and time/location filter panel connected to feed and map
• Profile page showing own username and submitted stories

Exit criteria

This milestone is considered complete when all of the following are true:

• An unregistered visitor can browse the map and feed without logging in
• A new user can register, log in, and submit a story with a location pin
• A logged-in user can like and comment on a story
• All API endpoints return correct responses with meaningful error messages
• Role-based access is enforced on all restricted endpoints
• All three core user flows are verified locally by end of March 30

Out of scope

The following are explicitly deferred and will not be part of this milestone: email verification, password reset via email, profile photo upload, notifications, tags, points and badges, admin moderation, sort by most popular, saved stories, and account deletion.