feat/user-facing profile view and edit pages

README.md

@@ -111,13 +111,8 @@ pnpm dev
 
 ## Running Tests
 
-Tests run against a dedicated `nexus_test` Postgres database on the same Docker container as dev — this keeps test transaction/rollback semantics identical to prod (SQLite doesn't support the savepoints the test fixtures rely on). Create it once:
+Tests run against a dedicated `nexus_test` Postgres database on the same Docker container as dev — this keeps test transaction/rollback semantics identical to prod (SQLite doesn't support the savepoints the test fixtures rely on). `nexus_test` is created automatically by `db-init/01-create-test-db.sql` the first time the container starts on a fresh `postgres_data` volume (Postgres's `docker-entrypoint-initdb.d` convention) — no manual step needed, including after `docker-compose down -v`.
 
-```bash
-docker exec backend-db-1 createdb -U nexus nexus_test
-```
-
-Then run:
 ```bash
 cd backend
 pytest

backend/.gitignore

@@ -16,6 +16,8 @@ credentials.json
 # Database
 *.db
 *.sqlite
+*.dump
+.db-backup/
 
 # Testing
 .pytest_cache/

backend/app/api/routes/users.py

@@ -7,7 +7,7 @@
 from app.core.users import check_if_email_exists, find_user_by_id
 from app.core.profile_status import compute_missing_profile_fields, is_profile_complete
 from app.db.session import get_db
-from app.models.models import User
+from app.models.models import User, UserCompetitionExperience, UserVolunteerExperience, Event
 from app.schemas.user import (
     UserFullResponse, UserMeFullResponse, UserSlimResponse,
     UserMeSlimResponse, UserUpdate, AdminUserUpdate
@@ -108,12 +108,15 @@ def get_me(
     if full:
         user = (
             db.query(User)
-            .options(selectinload(User.competition_experience), selectinload(User.volunteer_experience))
+            .options(
+                selectinload(User.competition_experience).selectinload(UserCompetitionExperience.event).selectinload(Event.category),
+                selectinload(User.volunteer_experience).selectinload(UserVolunteerExperience.event).selectinload(Event.category),
+            )
             .filter(User.id == current_user.id)
             .first()
         )
         response = UserMeFullResponse.model_validate(user)
-        response.missing_profile_fields = compute_missing_profile_fields(user)  # relationships loaded, no db needed
+        response.missing_profile_fields = compute_missing_profile_fields(user)
         return response
 
     response = UserMeSlimResponse.model_validate(current_user)

backend/app/core/profile_status.py

@@ -27,7 +27,7 @@ def _has_volunteer_rows(user: User, db: Optional[Session]) -> bool:
 
 
 def compute_missing_profile_fields(user: User, *, db: Optional[Session] = None) -> list[str]:
-    always_required = ["phone", "date_of_birth", "pronouns", "shirt_size", "dietary_restriction"]
+    always_required = ["phone", "date_of_birth", "shirt_size", "dietary_restriction"]
     missing = [f for f in always_required if not getattr(user, f)]
 
     if not user.student_status:

backend/app/schemas/event.py

@@ -21,7 +21,7 @@ class EventCategoryUpdate(BaseModel):
 class EventResponse(BaseModel):
     id: int
     name: str
-    category_id: int
+    category: EventCategoryResponse
 
     model_config = {"from_attributes": True}
 

backend/app/schemas/user_experience.py

@@ -1,6 +1,8 @@
 from pydantic import BaseModel, model_validator
 from typing import Optional
 
+from app.schemas.event import EventResponse
+
 
 class CompetitionExperienceCreate(BaseModel):
     event_id: int
@@ -14,7 +16,7 @@ class CompetitionExperienceUpdate(BaseModel):
 
 class CompetitionExperienceResponse(BaseModel):
     id: int
-    event_id: int
+    event: EventResponse
     school: str
     notes: Optional[str] = None
 
@@ -50,7 +52,7 @@ class VolunteerExperienceResponse(BaseModel):
 
     tournament_name: str
     year: int
-    event_id: Optional[int] = None
+    event: Optional[EventResponse] = None
     role: str
 
     notes: Optional[VolunteerExperienceNotes] = None

backend/db-init/01-create-test-db.sql

@@ -0,0 +1,5 @@
+-- Runs automatically on first init of a fresh postgres_data volume
+-- (docker-entrypoint-initdb.d convention). Creates the dedicated test
+-- database so `pytest` works without a manual `createdb` step, even
+-- after the volume has been dropped and recreated.
+CREATE DATABASE nexus_test;

backend/docker-compose.yaml

@@ -10,6 +10,7 @@ services:
       - "5432:5432"
     volumes:
       - postgres_data:/var/lib/postgresql/data
+      - ./db-init:/docker-entrypoint-initdb.d
 
 volumes:
   postgres_data:

backend/tests/api/test_events.py

@@ -32,7 +32,7 @@ def test_admin_can_create_event(self, client, admin_user, event_category):
         assert res.status_code == 201
         data = res.json()
         assert data["name"] == "Boomilever"
-        assert data["category_id"] == event_category.id
+        assert data["category"]["id"] == event_category.id
 
     def test_non_admin_forbidden(self, client, td_user, event_category):
         login(client, "td@test.com", "tdpass")
@@ -67,7 +67,7 @@ def test_update_category_id(self, client, admin_user, event_category_factory, ev
         login(client, "admin@test.com", "adminpass")
         res = client.patch(f"/events/{event.id}/", json={"category_id": other_category.id})
         assert res.status_code == 200
-        assert res.json()["category_id"] == other_category.id
+        assert res.json()["category"]["id"] == other_category.id
 
     def test_missing_event_404(self, client, admin_user):
         login(client, "admin@test.com", "adminpass")

backend/tests/api/test_user_experience.py

@@ -16,7 +16,7 @@ def test_valid_event_and_school(self, client, td_user, event):
         })
         assert res.status_code == 201
         data = res.json()
-        assert data["event_id"] == event.id
+        assert data["event"]["id"] == event.id
         assert data["school"] == "MIT"
 
     def test_invalid_event_id_404(self, client, td_user):
@@ -49,7 +49,7 @@ def test_partial_update(self, client, db, td_user, event):
         assert res.status_code == 200
         data = res.json()
         assert data["school"] == "Caltech"
-        assert data["event_id"] == event.id  # untouched
+        assert data["event"]["id"] == event.id  # untouched
 
     def test_missing_entry_404(self, client, td_user):
         login(client, "td@test.com", "tdpass")
@@ -116,7 +116,7 @@ def test_minimal_fields(self, client, td_user):
         assert data["tournament_name"] == "Regionals"
         assert data["year"] == 2025
         assert data["role"] == "Event Supervisor"
-        assert data["event_id"] is None
+        assert data["event"] is None
         assert data["notes"] is None
 
     def test_with_event_id_no_notes_event(self, client, td_user, event):
@@ -128,7 +128,7 @@ def test_with_event_id_no_notes_event(self, client, td_user, event):
             "event_id": event.id,
         })
         assert res.status_code == 201
-        assert res.json()["event_id"] == event.id
+        assert res.json()["event"]["id"] == event.id
 
     def test_with_notes_event_no_event_id(self, client, td_user):
         login(client, "td@test.com", "tdpass")
@@ -140,7 +140,7 @@ def test_with_notes_event_no_event_id(self, client, td_user):
         })
         assert res.status_code == 201
         data = res.json()
-        assert data["event_id"] is None
+        assert data["event"] is None
         assert data["notes"]["event"] == "Custom Event Name"
 
     def test_event_id_and_notes_event_mutually_exclusive(self, client, td_user, event):

backend/tests/api/test_users.py

@@ -216,7 +216,7 @@ def test_competition_and_volunteer_experience_populated(self, client, td_user, d
 
         assert len(data["competition_experience"]) == 1
         assert data["competition_experience"][0]["school"] == "MIT"
-        assert data["competition_experience"][0]["event_id"] == event.id
+        assert data["competition_experience"][0]["event"]["id"] == event.id
 
         assert len(data["volunteer_experience"]) == 1
         assert data["volunteer_experience"][0]["tournament_name"] == "Regionals"