Profile
+Loading your profile…
+ )}
+
+ {loadStatus === "error" && (
+
+
+ )}
+
+ {loadStatus === "ready" && user && (
+ <>
+ {loadError}
+ +
+
+
+
+ {!isEditing && (
+
+ )}
+
+
+ {user.display_name}
++ {formatMemberSince(user.created_at) + ? `Explorer since ${formatMemberSince(user.created_at)}` + : "Explorer"} +
+
+ Profile updated.
+
+ )}
+
+ Account Settings
+ + {!isEditing && ( + <> +
+
+
+
+ Display Name
+ {user.display_name}
+
+
+
+
+ Home Currency
+ {user.home_currency || DEFAULT_CURRENCY}
+
+
+ Notifications
+ Coming soon
+
+
+
+ )}
+
+ {isEditing && (
+
+ )}
+ Help & Support
+ Coming soon
+ 
+
+### Users
+| Column Name | Type | Description |
+| ------------- | ---------- | ------------------------------------------------------------- |
+| id | integer | Primary key, auto-increment |
+| email | varchar | Unique email address, required |
+| password_hash | varchar | Hashed password, required |
+| display_name | varchar | User's display name |
+| home_currency | varchar(3) | Default currency (`USD`) |
+| created_at | timestamp | Timestamp when account was created (defaults to current time) |
+
+### Trips
+| Column Name | Type | Description |
+| ----------- | ------------- | ---------------------------------------------------------- |
+| id | integer | Primary key, auto-increment |
+| user_id | integer | Foreign key referencing `users.id` |
+| title | varchar | Trip title, required |
+| start_date | date | Trip start date |
+| end_date | date | Trip end date |
+| budget | decimal(12,2) | Planned budget |
+| created_at | timestamp | Timestamp when trip was created (defaults to current time) |
+
+### Destinations
+| Column Name | Type | Description |
+| ------------- | ---------- | ---------------------------------------------- |
+| id | integer | Primary key, auto-increment |
+| trip_id | integer | Foreign key referencing `trips.id` |
+| city | varchar | Destination city, required |
+| country | varchar | Destination country, required |
+| currency_code | varchar(3) | Local currency code |
+| arrival_order | integer | Order of this destination in a multi-stop trip |
+| start_date | date | Arrival/start date |
+| end_date | date | Departure/end date |
+
+### Activities
+| Column Name | Type | Description |
+| ---------------- | ------- | ----------------------------------------- |
+| id | integer | Primary key, auto-increment |
+| destination_id | integer | Foreign key referencing `destinations.id` |
+| name | varchar | Activity name, required |
+| scheduled_date | date | Date of the activity (optional) |
+| start_time | time | Planned start time |
+| duration_minutes | integer | Estimated duration in minutes |
+| notes | text | Additional activity notes |
+
+### Expenses
+| Column Name | Type | Description |
+| ---------------- | ------- | ----------------------------------------- |
+| id | integer | Primary key, auto-increment |
+| destination_id | integer | Foreign key referencing `destinations.id` |
+| name | varchar | Activity name, required |
+| scheduled_date | date | Date of the activity (optional) |
+| start_time | time | Planned start time |
+| duration_minutes | integer | Estimated duration in minutes |
+| notes | text | Additional activity notes |
+
+### Packing List
+| Column Name | Type | Description |
+| ----------------- | ------- | ---------------------------------------------------------------------- |
+| id | integer | Primary key, auto-increment |
+| trip_id | integer | Foreign key referencing `trips.id` |
+| name | varchar | Item name, required |
+| is_packed | boolean | Whether the item has been packed (defaults to `false`) |
+| is_auto_generated | boolean | Whether the app automatically suggested the item (defaults to `false`) |
+
-| Column Name | Type | Description |
-|-------------|------|-------------|
-| id | integer | primary key |
-| name | text | name of the shoe model |
-| ... | ... | ... |
diff --git a/planning/img/Activities (For a Destination).png b/planning/img/Activities (For a Destination).png
new file mode 100644
index 000000000..785b57869
Binary files /dev/null and b/planning/img/Activities (For a Destination).png differ
diff --git a/planning/img/Edit Trip.png b/planning/img/Edit Trip.png
new file mode 100644
index 000000000..f5afb7063
Binary files /dev/null and b/planning/img/Edit Trip.png differ
diff --git a/planning/img/My Trips (Dashboard).png b/planning/img/My Trips (Dashboard).png
new file mode 100644
index 000000000..adb4874d9
Binary files /dev/null and b/planning/img/My Trips (Dashboard).png differ
diff --git a/planning/img/Ramblr ERD.png b/planning/img/Ramblr ERD.png
new file mode 100644
index 000000000..b8d1ba758
Binary files /dev/null and b/planning/img/Ramblr ERD.png differ
diff --git a/planning/img/Signup.png b/planning/img/Signup.png
new file mode 100644
index 000000000..a8578e100
Binary files /dev/null and b/planning/img/Signup.png differ
diff --git a/planning/img/Trip Dashboard (Overview).png b/planning/img/Trip Dashboard (Overview).png
new file mode 100644
index 000000000..76c87c6d1
Binary files /dev/null and b/planning/img/Trip Dashboard (Overview).png differ
diff --git a/planning/user_stories.md b/planning/user_stories.md
index 1e55ecbcd..71761da62 100644
--- a/planning/user_stories.md
+++ b/planning/user_stories.md
@@ -4,10 +4,37 @@ Reference the Writing User Stories final project guide in the course portal for
## Outline User Roles
-[👉🏾👉🏾👉🏾 Include at least at least 1, but no more than 3, user roles.]
+- [ ] **Traveler** — A user planning to travel who creates trips and organizes everything (itinerary, budget, packing, etc.) in one place
## Draft User Stories
+
+### Profile & Trip Management
+- [ ] As a traveler, I want to have a profile so that I can view all the trips I have made in one place
+- [ ] As a traveler, I want to create a new trip so that I can start planning
+- [ ] As a traveler, I want to edit or delete a trip so that I can keep my trip list accurate
+- [ ] As a traveler, I want to filter my trips by budget so that I can quickly find trips that fit my price range
+### Itinerary & Activities
+- [ ] As a traveler, I want to set a start and end date for my trip so that my itinerary is organized into specific days
+- [ ] As a traveler, I want to add activities for each day of the trip so that I can plan an itinerary
+- [ ] As a traveler, I want to assign a time to an activity so that I know when it's happening during the day
+- [ ] As a traveler, I want to add an activity without assigning it to a specific day so that I can keep a flexible list of things I might want to do
+- [ ] As a traveler, I want to move an unscheduled activity onto a specific day so that I can lock it into my itinerary once I decide
+- [ ] As a traveler, I want to move a scheduled activity back to "unscheduled" so that I can un-commit to plans that change
+- [ ] As a traveler, I want to edit or remove activities so that I can adjust my plans as they change
+- [ ] As a traveler, I want to add destinations to my trip so that I can organize multi-stop travel
-[👉🏾👉🏾👉🏾 Include at least at least 10 user stories in this format:]
-1. As a [user role], I want to [what], so that [why].
+### Budget & Expenses
+- [ ] As a traveler, I want to add my expenses in advance so that I can budget for my trip before I leave
+- [ ] As a traveler, I want to log my expenses throughout the trip so that I can keep track of my spending in real time
+- [ ] As a traveler, I want to see a summary of my total spending so that I can tell if I'm staying within budget
+- [ ] As a traveler, I want to see the current exchange rate between my home currency and my destination's currency (e.g., $1 ≈ ¥150) so that I have a quick reference while spending. For now I think we can just default this to USD -> Destination Currency
+### Packing List
+- [ ] As a traveler, I want to create a packing list for my trip so that I don't forget anything
+- [ ] As a traveler, I want the app to autogenerate a packing checklist based on my trip details (destination, weather, length) so that I can save time planning
+### Weather
+- [ ] As a traveler, I want to check the weather for each day of the trip so that I can plan my activities accordingly
+ - NOTE: This might have to be conditionally rendered to only show for when the trip is getting closer (MY suggestion is 2 weeks) since its impossible to tell the weather 6 months in.
+### Trip Countdown
+- [ ] As a traveler, I want to see a countdown to my trip so that I can build excitement and stay on top of prep deadlines
+
diff --git a/planning/wireframes.md b/planning/wireframes.md
index fbcd15a0c..de0481e77 100644
--- a/planning/wireframes.md
+++ b/planning/wireframes.md
@@ -4,18 +4,29 @@ Reference the Creating an Entity Relationship Diagram final project guide in the
## List of Pages
-[👉🏾👉🏾👉🏾 List the pages you expect to have in your app, with a ⭐ next to pages you have wireframed]
+| Page | Wireframed? |
+|------|-------------|
+| Home / Dashboard | ⭐ |
+| Create Trip | ⭐ |
+| Trip Details | ⭐ |
+| Destination Details | ⭐ |
+| Create Activity | |
+| Budget & Expenses | |
+| Packing List | |
+| Login | ⭐ |
-## Wireframe 1: [page title]
-[👉🏾👉🏾👉🏾 include wireframe 1]
+## Wireframe 1: Login/Signup
-## Wireframe 2: [page title]
+
-[👉🏾👉🏾👉🏾 include wireframe 2]
+## Wireframe 2: My Trips (User Dashboard)
-## Wireframe 3: [page title]
+.png "Trips")
+
+## Wireframe 3: Trip Dashboard
+
+.png "Trip")
-[👉🏾👉🏾👉🏾 include wireframe 3]
[👉🏾👉🏾👉🏾 include more wireframes as desired]
diff --git a/server/.env.example b/server/.env.example
new file mode 100644
index 000000000..be7284905
--- /dev/null
+++ b/server/.env.example
@@ -0,0 +1,3 @@
+PORT=3000
+NODE_ENV=development
+DATABASE_URL=postgres://user:password@localhost:5432/ramblr
diff --git a/server/config/database.js b/server/config/database.js
new file mode 100644
index 000000000..6271bf598
--- /dev/null
+++ b/server/config/database.js
@@ -0,0 +1,14 @@
+import pg from "pg";
+
+const config = {
+ user: process.env.PGUSER,
+ password: process.env.PGPASSWORD,
+ host: process.env.PGHOST,
+ port: process.env.PGPORT,
+ database: process.env.PGDATABASE,
+ ssl: {
+ rejectUnauthorized: false,
+ },
+};
+
+export const pool = new pg.Pool(config);
diff --git a/server/config/dotenv.js b/server/config/dotenv.js
new file mode 100644
index 000000000..4bf698f32
--- /dev/null
+++ b/server/config/dotenv.js
@@ -0,0 +1,5 @@
+// Connects my env variables via process.env
+// Without it, process.env.DATABASE_URL would just be undefined — Node doesn't automatically read .env files. dotenv.config() is what bridges the gap between the file and your code
+
+import dotenv from "dotenv";
+dotenv.config({ path: "./server/.env" });
diff --git a/server/config/reset.js b/server/config/reset.js
new file mode 100644
index 000000000..9823da204
--- /dev/null
+++ b/server/config/reset.js
@@ -0,0 +1,130 @@
+// Where all the database reset and seeding logic is located. This file is run with the command `npm run reset` in the terminal.
+
+import "./dotenv.js";
+import { pool } from "./database.js";
+import { users } from "../data/users.js";
+
+// Down/Up comments is convention when it comes to db migrations.
+// It tells the order of operations when rolling back (down) or applying (up) migrations.
+// In our simple case, the down migration is always run first, so we can safely drop tables before creating them again.
+// In bigger migration cases, the order of operations matters more and should be carefully considered/documented! But this is for practice!
+
+// Down: DROP TABLE IF EXISTS users CASCADE;
+// Up: CREATE TABLE users (...) below.
+
+// CASCADE also drops trips and destinations (and any future table referencing
+// users), since this DROP always runs first and trips.user_id depends on
+// users.id, with destinations depending on trips in turn.
+const createUsersTableQuery = `
+ DROP TABLE IF EXISTS users CASCADE;
+
+ CREATE TABLE users (
+ id SERIAL PRIMARY KEY,
+ display_name VARCHAR NOT NULL,
+ home_currency VARCHAR(3) NOT NULL DEFAULT 'USD',
+ created_at TIMESTAMP NOT NULL DEFAULT NOW()
+ );
+`;
+
+const createUsersTable = async () => {
+ try {
+ await pool.query(createUsersTableQuery);
+ console.log("✅ users table created successfully");
+ } catch (error) {
+ console.error("⚠️ Error creating users table:", error);
+ }
+};
+
+const insertUserQuery =
+ "INSERT INTO users (display_name, home_currency) VALUES ($1, $2)";
+
+const seedUsers = async () => {
+ await createUsersTable();
+
+ for (const user of users) {
+ try {
+ await pool.query(insertUserQuery, [user.displayName, user.homeCurrency]);
+ console.log(`✅ Seeded user: ${user.displayName}`);
+ } catch (error) {
+ console.error(`⚠️ Error seeding user ${user.displayName}:`, error);
+ }
+ }
+};
+
+// Down: DROP TABLE IF EXISTS trips CASCADE;
+// Up: CREATE TABLE trips (...) below.
+
+// New Concept: CASCADE: In our case, it mostly relates to FK. Can think of it as automatic cleanup of child records when a parent record is deleted.
+// In this case, if a trip is deleted, all its child records (destinations, packing_list, etc.) should also be deleted. This is done by adding ON DELETE CASCADE to the FK constraint in the child table.
+
+// CASCADE here also drops destinations (and any future table referencing
+// trips), so this reset always succeeds regardless of what state the shared
+// dev database is in.
+// Future child tables (activities, packing_list, etc.) should put
+// ON DELETE CASCADE on their own trip_id/destination_id FK instead of here,
+// so a trip delete cascades all the way down.
+const createTripsTableQuery = `
+ DROP TABLE IF EXISTS trips CASCADE;
+
+ CREATE TABLE trips (
+ id SERIAL PRIMARY KEY,
+ user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+ title VARCHAR NOT NULL,
+ start_date DATE,
+ end_date DATE,
+ budget DECIMAL(12, 2),
+ created_at TIMESTAMP NOT NULL DEFAULT NOW()
+ );
+`;
+
+const createTripsTable = async () => {
+ try {
+ await pool.query(createTripsTableQuery);
+ console.log("✅ trips table created successfully");
+ } catch (error) {
+ console.error("⚠️ Error creating trips table:", error);
+ }
+};
+
+// Down: DROP TABLE IF EXISTS destinations;
+// Up: CREATE TABLE destinations (...) below.
+
+// Future child tables (activities) should put ON DELETE CASCADE on their own
+// destination_id FK instead of here, so a destination delete cascades too.
+const createDestinationsTableQuery = `
+ DROP TABLE IF EXISTS destinations;
+
+ CREATE TABLE destinations (
+ id SERIAL PRIMARY KEY,
+ trip_id INTEGER NOT NULL REFERENCES trips(id) ON DELETE CASCADE,
+ city VARCHAR NOT NULL,
+ country VARCHAR NOT NULL,
+ currency_code VARCHAR(3),
+ arrival_order INTEGER,
+ start_date DATE,
+ end_date DATE
+ );
+`;
+
+const createDestinationsTable = async () => {
+ try {
+ await pool.query(createDestinationsTableQuery);
+ console.log("✅ destinations table created successfully");
+ } catch (error) {
+ console.error("⚠️ Error creating destinations table:", error);
+ }
+};
+
+const seedDBs = async () => {
+ try {
+ await seedUsers();
+ await createTripsTable();
+ await createDestinationsTable();
+ console.log("Database seeding complete.");
+ } catch (err) {
+ console.error("Database seeding failed:", err);
+ process.exitCode = 1;
+ }
+};
+
+seedDBs();
diff --git a/server/controllers/activitiesController.js b/server/controllers/activitiesController.js
new file mode 100644
index 000000000..655d84304
--- /dev/null
+++ b/server/controllers/activitiesController.js
@@ -0,0 +1,40 @@
+import { pool } from "../config/database.js";
+
+// TODO: placeholder query, adjust columns/table once the activities schema is finalized
+const getAllActivities = async (req, res) => {
+ try {
+ const { rows } = await pool.query("SELECT * FROM activities");
+ res.json(rows);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// TODO: placeholder query, adjust columns/table once the activities schema is finalized
+const getActivityById = async (req, res) => {
+ try {
+ const { id } = req.params;
+ const { rows } = await pool.query("SELECT * FROM activities WHERE id = $1", [id]);
+ if (!rows.length) return res.status(404).json({ error: "Activity not found" });
+ res.json(rows[0]);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// TODO: not implemented yet
+const createActivity = async (req, res) => {
+ res.status(501).json({ error: "Not implemented" });
+};
+
+// TODO: not implemented yet
+const updateActivity = async (req, res) => {
+ res.status(501).json({ error: "Not implemented" });
+};
+
+// TODO: not implemented yet
+const deleteActivity = async (req, res) => {
+ res.status(501).json({ error: "Not implemented" });
+};
+
+export { getAllActivities, getActivityById, createActivity, updateActivity, deleteActivity };
diff --git a/server/controllers/destinations.js b/server/controllers/destinations.js
new file mode 100644
index 000000000..df97d80ac
--- /dev/null
+++ b/server/controllers/destinations.js
@@ -0,0 +1,203 @@
+import { pool } from "../config/database.js";
+import { getCurrentUserId } from "../helpers/currentUser.js";
+import { getOwnedTrip } from "../helpers/tripOwnership.js";
+import { getCurrencyForCountry } from "../helpers/currency.js";
+import { isValidId, isValidDate } from "../helpers/validation.js";
+import { isDateBefore, isDateAfter } from "../helpers/dates.js";
+
+// Destinations have no user_id of their own; ownership is checked via the parent trip through this join.
+const getOwnedDestination = async (destinationId, userId) => {
+ const { rows } = await pool.query(
+ `SELECT destinations.*
+ FROM destinations
+ JOIN trips ON destinations.trip_id = trips.id
+ WHERE destinations.id = $1 AND trips.user_id = $2`,
+ [destinationId, userId],
+ );
+ return rows[0] ?? null;
+};
+
+// GET /api/trips/:tripId/destinations — list a trip's destinations, ordered for a multi-stop itinerary.
+const getDestinationsForTrip = async (req, res) => {
+ const { tripId } = req.params;
+ if (!isValidId(tripId)) return res.status(400).json({ error: "Invalid trip id" });
+
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const trip = await getOwnedTrip(tripId, userId);
+ if (!trip) return res.status(404).json({ error: "Trip not found" });
+
+ const { rows } = await pool.query(
+ `SELECT * FROM destinations
+ WHERE trip_id = $1
+ ORDER BY arrival_order ASC NULLS LAST, start_date ASC NULLS LAST`,
+ [tripId],
+ );
+ res.json(rows);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// POST /api/trips/:tripId/destinations — add a destination to a trip; currency_code is derived from country.
+const createDestination = async (req, res) => {
+ const { tripId } = req.params;
+ const { city, country, startDate, endDate, arrivalOrder } = req.body;
+
+ if (!isValidId(tripId)) return res.status(400).json({ error: "Invalid trip id" });
+ if (!city) return res.status(400).json({ error: "city is required" });
+ if (!country) return res.status(400).json({ error: "country is required" });
+ if (startDate !== undefined && !isValidDate(startDate)) {
+ return res.status(400).json({ error: "start_date is invalid" });
+ }
+ if (endDate !== undefined && !isValidDate(endDate)) {
+ return res.status(400).json({ error: "end_date is invalid" });
+ }
+ if (arrivalOrder !== undefined && Number.isNaN(Number(arrivalOrder))) {
+ return res.status(400).json({ error: "arrival_order is invalid" });
+ }
+ if (startDate && endDate && isDateBefore(endDate, startDate)) {
+ return res.status(400).json({ error: "end_date cannot precede start_date" });
+ }
+
+ // country is a free-text country name, e.g. "United States" -> resolves to "USD" via data/countryCurrency.js
+ const currencyCode = getCurrencyForCountry(country);
+ if (!currencyCode) return res.status(400).json({ error: "Unknown country" });
+
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const trip = await getOwnedTrip(tripId, userId);
+ if (!trip) return res.status(404).json({ error: "Trip not found" });
+
+ // reject destination dates that fall outside the parent trip's range
+ if (trip.start_date && startDate && isDateBefore(startDate, trip.start_date)) {
+ return res.status(400).json({ error: "start_date falls before the trip's start_date" });
+ }
+ if (trip.end_date && endDate && isDateAfter(endDate, trip.end_date)) {
+ return res.status(400).json({ error: "end_date falls after the trip's end_date" });
+ }
+
+ const { rows } = await pool.query(
+ `INSERT INTO destinations (trip_id, city, country, currency_code, arrival_order, start_date, end_date)
+ VALUES ($1, $2, $3, $4, $5, $6, $7)
+ RETURNING *`,
+ [tripId, city, country, currencyCode, arrivalOrder, startDate, endDate],
+ );
+ res.status(201).json(rows[0]);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// GET /api/destinations/:id — get one destination owned (via its trip) by the current user.
+const getDestinationById = async (req, res) => {
+ const { id } = req.params;
+ if (!isValidId(id)) return res.status(400).json({ error: "Invalid destination id" });
+
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const destination = await getOwnedDestination(id, userId);
+ if (!destination) return res.status(404).json({ error: "Destination not found" });
+ res.json(destination);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// PATCH /api/destinations/:id — edit a destination owned (via its trip) by the current user.
+const updateDestination = async (req, res) => {
+ const { id } = req.params;
+ const { city, country, startDate, endDate, arrivalOrder } = req.body;
+
+ if (!isValidId(id)) return res.status(400).json({ error: "Invalid destination id" });
+ if (startDate !== undefined && !isValidDate(startDate)) {
+ return res.status(400).json({ error: "start_date is invalid" });
+ }
+ if (endDate !== undefined && !isValidDate(endDate)) {
+ return res.status(400).json({ error: "end_date is invalid" });
+ }
+ if (arrivalOrder !== undefined && Number.isNaN(Number(arrivalOrder))) {
+ return res.status(400).json({ error: "arrival_order is invalid" });
+ }
+
+ // country is a free-text country name, e.g. "United States" -> resolves to "USD" via data/countryCurrency.js
+ // only re-derive currency_code if the caller is actually changing the country
+ let currencyCode;
+ if (country !== undefined) {
+ currencyCode = getCurrencyForCountry(country);
+ if (!currencyCode) return res.status(400).json({ error: "Unknown country" });
+ }
+
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const existingDestination = await getOwnedDestination(id, userId);
+ if (!existingDestination) return res.status(404).json({ error: "Destination not found" });
+
+ const trip = await getOwnedTrip(existingDestination.trip_id, userId);
+
+ // a PATCH can send either date, both, or neither; for whichever one isn't
+ // sent, fall back to the destination's existing value, then validate that pair
+ const mergedStartDate = startDate ?? existingDestination.start_date;
+ const mergedEndDate = endDate ?? existingDestination.end_date;
+ if (mergedStartDate && mergedEndDate && isDateBefore(mergedEndDate, mergedStartDate)) {
+ return res.status(400).json({ error: "end_date cannot precede start_date" });
+ }
+ if (trip.start_date && mergedStartDate && isDateBefore(mergedStartDate, trip.start_date)) {
+ return res.status(400).json({ error: "start_date falls before the trip's start_date" });
+ }
+ if (trip.end_date && mergedEndDate && isDateAfter(mergedEndDate, trip.end_date)) {
+ return res.status(400).json({ error: "end_date falls after the trip's end_date" });
+ }
+
+ const { rows } = await pool.query(
+ `UPDATE destinations
+ SET city = COALESCE($1, city),
+ country = COALESCE($2, country),
+ currency_code = COALESCE($3, currency_code),
+ arrival_order = COALESCE($4, arrival_order),
+ start_date = COALESCE($5, start_date),
+ end_date = COALESCE($6, end_date)
+ WHERE id = $7
+ RETURNING *`,
+ [city, country, currencyCode, arrivalOrder, startDate, endDate, id],
+ );
+ res.json(rows[0]);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// DELETE /api/destinations/:id — delete a destination owned (via its trip) by the current user.
+const deleteDestination = async (req, res) => {
+ const { id } = req.params;
+ if (!isValidId(id)) return res.status(400).json({ error: "Invalid destination id" });
+
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const destination = await getOwnedDestination(id, userId);
+ if (!destination) return res.status(404).json({ error: "Destination not found" });
+
+ await pool.query("DELETE FROM destinations WHERE id = $1", [id]);
+ res.status(204).send();
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+export {
+ getDestinationsForTrip,
+ createDestination,
+ getDestinationById,
+ updateDestination,
+ deleteDestination,
+};
diff --git a/server/controllers/expenses.js b/server/controllers/expenses.js
new file mode 100644
index 000000000..202468428
--- /dev/null
+++ b/server/controllers/expenses.js
@@ -0,0 +1,40 @@
+import { pool } from "../config/database.js";
+
+// TODO: placeholder query, adjust columns/table once the expenses schema is finalized
+const getAllExpenses = async (req, res) => {
+ try {
+ const { rows } = await pool.query("SELECT * FROM expenses");
+ res.json(rows);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// TODO: placeholder query, adjust columns/table once the expenses schema is finalized
+const getExpenseById = async (req, res) => {
+ try {
+ const { id } = req.params;
+ const { rows } = await pool.query("SELECT * FROM expenses WHERE id = $1", [id]);
+ if (!rows.length) return res.status(404).json({ error: "Expense not found" });
+ res.json(rows[0]);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// TODO: not implemented yet
+const createExpense = async (req, res) => {
+ res.status(501).json({ error: "Not implemented" });
+};
+
+// TODO: not implemented yet
+const updateExpense = async (req, res) => {
+ res.status(501).json({ error: "Not implemented" });
+};
+
+// TODO: not implemented yet
+const deleteExpense = async (req, res) => {
+ res.status(501).json({ error: "Not implemented" });
+};
+
+export { getAllExpenses, getExpenseById, createExpense, updateExpense, deleteExpense };
diff --git a/server/controllers/packingList.js b/server/controllers/packingList.js
new file mode 100644
index 000000000..1f49ba0ba
--- /dev/null
+++ b/server/controllers/packingList.js
@@ -0,0 +1,46 @@
+import { pool } from "../config/database.js";
+
+// TODO: placeholder query, adjust columns/table once the packing list schema is finalized
+const getAllPackingListItems = async (req, res) => {
+ try {
+ const { rows } = await pool.query("SELECT * FROM packing_list_items");
+ res.json(rows);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// TODO: placeholder query, adjust columns/table once the packing list schema is finalized
+const getPackingListItemById = async (req, res) => {
+ try {
+ const { id } = req.params;
+ const { rows } = await pool.query("SELECT * FROM packing_list_items WHERE id = $1", [id]);
+ if (!rows.length) return res.status(404).json({ error: "Packing list item not found" });
+ res.json(rows[0]);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// TODO: not implemented yet
+const createPackingListItem = async (req, res) => {
+ res.status(501).json({ error: "Not implemented" });
+};
+
+// TODO: not implemented yet
+const updatePackingListItem = async (req, res) => {
+ res.status(501).json({ error: "Not implemented" });
+};
+
+// TODO: not implemented yet
+const deletePackingListItem = async (req, res) => {
+ res.status(501).json({ error: "Not implemented" });
+};
+
+export {
+ getAllPackingListItems,
+ getPackingListItemById,
+ createPackingListItem,
+ updatePackingListItem,
+ deletePackingListItem,
+};
diff --git a/server/controllers/trips.js b/server/controllers/trips.js
new file mode 100644
index 000000000..bed529c5b
--- /dev/null
+++ b/server/controllers/trips.js
@@ -0,0 +1,154 @@
+import { pool } from "../config/database.js";
+import { getCurrentUserId } from "../helpers/currentUser.js";
+import { isValidId, isValidDate, isValidBudget } from "../helpers/validation.js";
+import { isDateBefore } from "../helpers/dates.js";
+
+// GET /api/trips — list the current user's trips.
+const getAllTrips = async (req, res) => {
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const { rows } = await pool.query(
+ "SELECT * FROM trips WHERE user_id = $1 ORDER BY id ASC",
+ [userId],
+ );
+ res.json(rows);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// GET /api/trips/:id — get one trip owned by the current user.
+const getTripById = async (req, res) => {
+ const { id } = req.params;
+ if (!isValidId(id)) return res.status(400).json({ error: "Invalid trip id" });
+
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const { rows } = await pool.query(
+ "SELECT * FROM trips WHERE id = $1 AND user_id = $2",
+ [id, userId],
+ );
+ if (!rows.length) return res.status(404).json({ error: "Trip not found" });
+ res.json(rows[0]);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// POST /api/trips — create a trip owned by the current user.
+const createTrip = async (req, res) => {
+ const { title, startDate, endDate, budget } = req.body;
+
+ if (!title) return res.status(400).json({ error: "title is required" });
+ if (startDate !== undefined && !isValidDate(startDate)) {
+ return res.status(400).json({ error: "start_date is invalid" });
+ }
+ if (endDate !== undefined && !isValidDate(endDate)) {
+ return res.status(400).json({ error: "end_date is invalid" });
+ }
+ if (budget !== undefined && !isValidBudget(budget)) {
+ return res.status(400).json({ error: "budget is invalid" });
+ }
+ if (startDate && endDate && new Date(endDate) < new Date(startDate)) {
+ return res
+ .status(400)
+ .json({ error: "end_date cannot precede start_date" });
+ }
+
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const { rows } = await pool.query(
+ `INSERT INTO trips (user_id, title, start_date, end_date, budget)
+ VALUES ($1, $2, $3, $4, $5)
+ RETURNING *`,
+ [userId, title, startDate, endDate, budget],
+ );
+ res.status(201).json(rows[0]);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// PATCH /api/trips/:id — edit a trip owned by the current user (only fields present in the body are changed).
+const updateTrip = async (req, res) => {
+ const { id } = req.params;
+ const { title, startDate, endDate, budget } = req.body;
+ if (!isValidId(id)) return res.status(400).json({ error: "Invalid trip id" });
+ if (startDate !== undefined && !isValidDate(startDate)) {
+ return res.status(400).json({ error: "start_date is invalid" });
+ }
+ if (endDate !== undefined && !isValidDate(endDate)) {
+ return res.status(400).json({ error: "end_date is invalid" });
+ }
+ if (budget !== undefined && !isValidBudget(budget)) {
+ return res.status(400).json({ error: "budget is invalid" });
+ }
+
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const existingTrip = await pool.query(
+ "SELECT * FROM trips WHERE id = $1 AND user_id = $2",
+ [id, userId],
+ );
+ if (!existingTrip.rows.length)
+ return res.status(404).json({ error: "Trip not found" });
+
+ // a PATCH can send either date, both, or neither; for whichever one isn't
+ // sent, fall back to the trip's existing value, then validate that pair
+ const mergedStartDate = startDate ?? existingTrip.rows[0].start_date;
+ const mergedEndDate = endDate ?? existingTrip.rows[0].end_date;
+ if (
+ mergedStartDate &&
+ mergedEndDate &&
+ isDateBefore(mergedEndDate, mergedStartDate)
+ ) {
+ return res
+ .status(400)
+ .json({ error: "end_date cannot precede start_date" });
+ }
+
+ const { rows } = await pool.query(
+ `UPDATE trips
+ SET title = COALESCE($1, title),
+ start_date = COALESCE($2, start_date),
+ end_date = COALESCE($3, end_date),
+ budget = COALESCE($4, budget)
+ WHERE id = $5 AND user_id = $6
+ RETURNING *`,
+ [title, startDate, endDate, budget, id, userId],
+ );
+ res.json(rows[0]);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// DELETE /api/trips/:id — delete a trip owned by the current user.
+const deleteTrip = async (req, res) => {
+ const { id } = req.params;
+ if (!isValidId(id)) return res.status(400).json({ error: "Invalid trip id" });
+
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const { rows } = await pool.query(
+ "DELETE FROM trips WHERE id = $1 AND user_id = $2 RETURNING *",
+ [id, userId],
+ );
+ if (!rows.length) return res.status(404).json({ error: "Trip not found" });
+ res.status(204).send();
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+export { getAllTrips, getTripById, createTrip, updateTrip, deleteTrip };
diff --git a/server/controllers/users.js b/server/controllers/users.js
new file mode 100644
index 000000000..f7985bbad
--- /dev/null
+++ b/server/controllers/users.js
@@ -0,0 +1,45 @@
+import { pool } from "../config/database.js";
+import { getCurrentUserId } from "../helpers/currentUser.js";
+
+// GET /api/users/me — get the current user's profile.
+const getCurrentUser = async (req, res) => {
+ const getQuery = "SELECT * FROM users WHERE id = $1";
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const { rows } = await pool.query(getQuery, [userId]);
+ if (!rows.length) return res.status(404).json({ error: "User not found" });
+ res.status(200).json(rows[0]);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+// PATCH /api/users/me — update the current user's displayName and/or homeCurrency.
+// This only updates the displayName and homeCurrency fields, since those are the only fields that are editable for a user in this app. If more fields are added to the user model in the future, this function should be updated to handle those fields (example password).
+const updateCurrentUser = async (req, res) => {
+ const { displayName, homeCurrency } = req.body;
+
+ // To follow PATCH protocol, we use COALESCE to only update fields that are provided in the request body. If a field is not provided, it will retain its current value.
+ const updateQuery = `
+ UPDATE users
+ SET display_name = COALESCE($1, display_name),
+ home_currency = COALESCE($2, home_currency)
+ WHERE id = $3
+ RETURNING *
+ `;
+
+ try {
+ const userId = await getCurrentUserId();
+ if (!userId) return res.status(404).json({ error: "User not found" });
+
+ const { rows } = await pool.query(updateQuery, [displayName, homeCurrency, userId]);
+ if (!rows.length) return res.status(404).json({ error: "User not found" });
+ res.json(rows[0]);
+ } catch (err) {
+ res.status(500).json({ error: err.message });
+ }
+};
+
+export { getCurrentUser, updateCurrentUser };
diff --git a/server/data/countryCurrency.js b/server/data/countryCurrency.js
new file mode 100644
index 000000000..d3350b8b6
--- /dev/null
+++ b/server/data/countryCurrency.js
@@ -0,0 +1,53 @@
+// Country name (lowercase) -> ISO 4217 currency code.
+// Not exhaustive -- covers common travel destinations for now.
+// Lookup should normalize (trim + lowercase) the incoming country before checking this map.
+export const countryCurrency = {
+ "united states": "USD",
+ "usa": "USD",
+ "canada": "CAD",
+ "mexico": "MXN",
+ "united kingdom": "GBP",
+ "uk": "GBP",
+ "ireland": "EUR",
+ "france": "EUR",
+ "germany": "EUR",
+ "spain": "EUR",
+ "italy": "EUR",
+ "portugal": "EUR",
+ "netherlands": "EUR",
+ "belgium": "EUR",
+ "austria": "EUR",
+ "greece": "EUR",
+ "switzerland": "CHF",
+ "norway": "NOK",
+ "sweden": "SEK",
+ "denmark": "DKK",
+ "iceland": "ISK",
+ "poland": "PLN",
+ "czech republic": "CZK",
+ "hungary": "HUF",
+ "japan": "JPY",
+ "china": "CNY",
+ "south korea": "KRW",
+ "india": "INR",
+ "thailand": "THB",
+ "vietnam": "VND",
+ "singapore": "SGD",
+ "malaysia": "MYR",
+ "indonesia": "IDR",
+ "philippines": "PHP",
+ "australia": "AUD",
+ "new zealand": "NZD",
+ "brazil": "BRL",
+ "argentina": "ARS",
+ "chile": "CLP",
+ "peru": "PEN",
+ "colombia": "COP",
+ "south africa": "ZAR",
+ "egypt": "EGP",
+ "morocco": "MAD",
+ "turkey": "TRY",
+ "united arab emirates": "AED",
+ "uae": "AED",
+ "israel": "ILS",
+};
diff --git a/server/data/users.js b/server/data/users.js
new file mode 100644
index 000000000..3801d04cb
--- /dev/null
+++ b/server/data/users.js
@@ -0,0 +1,9 @@
+// My default user for testing purposes
+
+// DEV NOTE: id and created_at omitted from seed since it is auto generated in SQL statements
+export const users = [
+ {
+ displayName: "Jane Doe",
+ homeCurrency: "USD",
+ },
+];
diff --git a/server/helpers/currency.js b/server/helpers/currency.js
new file mode 100644
index 000000000..8cc9ff0e1
--- /dev/null
+++ b/server/helpers/currency.js
@@ -0,0 +1,9 @@
+import { countryCurrency } from "../data/countryCurrency.js";
+
+// Returns the ISO 4217 currency code for a country name, or null if unrecognized.
+const getCurrencyForCountry = (country) => {
+ if (typeof country !== "string") return null;
+ return countryCurrency[country.trim().toLowerCase()] ?? null;
+};
+
+export { getCurrencyForCountry };
diff --git a/server/helpers/currentUser.js b/server/helpers/currentUser.js
new file mode 100644
index 000000000..34ea28744
--- /dev/null
+++ b/server/helpers/currentUser.js
@@ -0,0 +1,15 @@
+import { pool } from "../config/database.js";
+
+// Single source of truth for "who is the current user."
+// No auth yet, so this resolves to the one seeded user.
+// It is used extensively in the controllers to ensure that all operations are scoped to the current user
+
+// TODO: once auth exists, resolve the user id from the session/token instead.
+const getCurrentUserId = async () => {
+ const { rows } = await pool.query(
+ "SELECT id FROM users ORDER BY id ASC LIMIT 1",
+ );
+ return rows[0]?.id;
+};
+
+export { getCurrentUserId };
diff --git a/server/helpers/dates.js b/server/helpers/dates.js
new file mode 100644
index 000000000..9a5c57606
--- /dev/null
+++ b/server/helpers/dates.js
@@ -0,0 +1,20 @@
+// pg parses DATE columns into JS Date objects at local midnight, while
+// request bodies give plain "YYYY-MM-DD" strings (parsed elsewhere as UTC
+// midnight if ever turned into a Date). Comparing those two forms directly
+// with `new Date(a) < new Date(b)` can misjudge the same calendar date as
+// earlier/later. Normalize both to a "YYYY-MM-DD" string first and compare
+// those instead, since it sorts identically to chronological order.
+const toDateOnly = (value) => {
+ if (value instanceof Date) {
+ const year = value.getFullYear();
+ const month = String(value.getMonth() + 1).padStart(2, "0");
+ const day = String(value.getDate()).padStart(2, "0");
+ return `${year}-${month}-${day}`;
+ }
+ return value;
+};
+
+const isDateBefore = (a, b) => toDateOnly(a) < toDateOnly(b);
+const isDateAfter = (a, b) => toDateOnly(a) > toDateOnly(b);
+
+export { isDateBefore, isDateAfter };
diff --git a/server/helpers/tripOwnership.js b/server/helpers/tripOwnership.js
new file mode 100644
index 000000000..60c40ff0d
--- /dev/null
+++ b/server/helpers/tripOwnership.js
@@ -0,0 +1,13 @@
+import { pool } from "../config/database.js";
+
+// Destinations (and other trip-scoped resources) have no user_id of their own,
+// so ownership must be checked by confirming the parent trip belongs to the user.
+const getOwnedTrip = async (tripId, userId) => {
+ const { rows } = await pool.query(
+ "SELECT * FROM trips WHERE id = $1 AND user_id = $2",
+ [tripId, userId],
+ );
+ return rows[0] ?? null;
+};
+
+export { getOwnedTrip };
diff --git a/server/helpers/validation.js b/server/helpers/validation.js
new file mode 100644
index 000000000..fe5e56697
--- /dev/null
+++ b/server/helpers/validation.js
@@ -0,0 +1,5 @@
+const isValidId = (id) => /^\d+$/.test(id);
+const isValidDate = (value) => !Number.isNaN(Date.parse(value));
+const isValidBudget = (value) => !Number.isNaN(Number(value));
+
+export { isValidId, isValidDate, isValidBudget };
diff --git a/server/routes/activities.js b/server/routes/activities.js
new file mode 100644
index 000000000..be943ecd9
--- /dev/null
+++ b/server/routes/activities.js
@@ -0,0 +1,18 @@
+import { Router } from "express";
+import {
+ getAllActivities,
+ getActivityById,
+ createActivity,
+ updateActivity,
+ deleteActivity,
+} from "../controllers/activitiesController.js";
+
+const router = Router();
+
+router.get("/", getAllActivities);
+router.get("/:id", getActivityById);
+router.post("/", createActivity);
+router.put("/:id", updateActivity);
+router.delete("/:id", deleteActivity);
+
+export default router;
diff --git a/server/routes/destinations.js b/server/routes/destinations.js
new file mode 100644
index 000000000..646b1e194
--- /dev/null
+++ b/server/routes/destinations.js
@@ -0,0 +1,15 @@
+// Mounted at /api/destinations — get a single destination, or edit/delete it by its own id.
+import { Router } from "express";
+import {
+ getDestinationById,
+ updateDestination,
+ deleteDestination,
+} from "../controllers/destinations.js";
+
+const router = Router();
+
+router.get("/:id", getDestinationById);
+router.patch("/:id", updateDestination);
+router.delete("/:id", deleteDestination);
+
+export default router;
diff --git a/server/routes/destinationsForTrip.js b/server/routes/destinationsForTrip.js
new file mode 100644
index 000000000..fb6b1ca6a
--- /dev/null
+++ b/server/routes/destinationsForTrip.js
@@ -0,0 +1,10 @@
+// Mounted at /api/trips/:tripId/destinations — list all destinations for a trip, or create a new one.
+import { Router } from "express";
+import { getDestinationsForTrip, createDestination } from "../controllers/destinations.js";
+
+const router = Router({ mergeParams: true });
+
+router.get("/", getDestinationsForTrip);
+router.post("/", createDestination);
+
+export default router;
diff --git a/server/routes/expenses.js b/server/routes/expenses.js
new file mode 100644
index 000000000..ac44e04e5
--- /dev/null
+++ b/server/routes/expenses.js
@@ -0,0 +1,18 @@
+import { Router } from "express";
+import {
+ getAllExpenses,
+ getExpenseById,
+ createExpense,
+ updateExpense,
+ deleteExpense,
+} from "../controllers/expenses.js";
+
+const router = Router();
+
+router.get("/", getAllExpenses);
+router.get("/:id", getExpenseById);
+router.post("/", createExpense);
+router.put("/:id", updateExpense);
+router.delete("/:id", deleteExpense);
+
+export default router;
diff --git a/server/routes/packingList.js b/server/routes/packingList.js
new file mode 100644
index 000000000..71f923b56
--- /dev/null
+++ b/server/routes/packingList.js
@@ -0,0 +1,18 @@
+import { Router } from "express";
+import {
+ getAllPackingListItems,
+ getPackingListItemById,
+ createPackingListItem,
+ updatePackingListItem,
+ deletePackingListItem,
+} from "../controllers/packingList.js";
+
+const router = Router();
+
+router.get("/", getAllPackingListItems);
+router.get("/:id", getPackingListItemById);
+router.post("/", createPackingListItem);
+router.put("/:id", updatePackingListItem);
+router.delete("/:id", deletePackingListItem);
+
+export default router;
diff --git a/server/routes/trips.js b/server/routes/trips.js
new file mode 100644
index 000000000..a9b8ebf3a
--- /dev/null
+++ b/server/routes/trips.js
@@ -0,0 +1,18 @@
+import { Router } from "express";
+import {
+ getAllTrips,
+ getTripById,
+ createTrip,
+ updateTrip,
+ deleteTrip,
+} from "../controllers/trips.js";
+
+const router = Router();
+
+router.get("/", getAllTrips);
+router.get("/:id", getTripById);
+router.post("/", createTrip);
+router.patch("/:id", updateTrip);
+router.delete("/:id", deleteTrip);
+
+export default router;
diff --git a/server/routes/users.js b/server/routes/users.js
new file mode 100644
index 000000000..201c2cbf9
--- /dev/null
+++ b/server/routes/users.js
@@ -0,0 +1,11 @@
+import { Router } from "express";
+import { getCurrentUser, updateCurrentUser } from "../controllers/users.js";
+
+// DEV NOTE: /me is the observed pattern for getting the current user in many APIs. It is used here to avoid confusion with the /users/:id route, which is not implemented yet since we don't have auth yet.
+const router = Router();
+
+router.get("/me", getCurrentUser);
+// Using PATCH here instead of PUT since we are only updating homeCurrency and displayName. This is more in line with RESTful principles.
+router.patch("/me", updateCurrentUser);
+
+export default router;
diff --git a/server/server.js b/server/server.js
new file mode 100644
index 000000000..c02a265c3
--- /dev/null
+++ b/server/server.js
@@ -0,0 +1,38 @@
+import express from "express";
+import path from "path";
+import dotenv from "dotenv";
+import tripsRouter from "./routes/trips.js";
+import activitiesRouter from "./routes/activities.js";
+import expensesRouter from "./routes/expenses.js";
+import packingListRouter from "./routes/packingList.js";
+import usersRouter from "./routes/users.js";
+import destinationsForTripRouter from "./routes/destinationsForTrip.js";
+import destinationsRouter from "./routes/destinations.js";
+
+dotenv.config();
+
+const PORT = process.env.PORT || 3000;
+
+const app = express();
+
+app.use(express.json());
+
+if (process.env.NODE_ENV === "production") {
+ app.use(express.static("public"));
+}
+
+app.use("/api/trips", tripsRouter);
+app.use("/api/activities", activitiesRouter);
+app.use("/api/expenses", expensesRouter);
+app.use("/api/packing-list", packingListRouter);
+app.use("/api/users", usersRouter);
+app.use("/api/trips/:tripId/destinations", destinationsForTripRouter);
+app.use("/api/destinations", destinationsRouter);
+
+if (process.env.NODE_ENV === "production") {
+ app.get("/*", (_, res) => res.sendFile(path.resolve("public", "index.html")));
+}
+
+app.listen(PORT, () => {
+ console.log(`server listening on http://localhost:${PORT}`);
+});