## Project Design Audit

Date: 2026-05-01

### What I checked

- Compared `project_design` team-related source stubs against the live implementation in:
  - `apps/dashboard/src/components/team/*`
  - `apps/dashboard/src/app/(dashboard)/dashboard/team/page.tsx`
  - `apps/api/src/routes/team.ts`
  - `apps/api/src/routes/webhooks.ts`
  - `apps/api/src/services/teamService.ts`
  - `apps/api/src/middleware/requireRole.ts`
- Scanned the repo for obvious page- and feature-level gaps against:
  - `project_design/README.md`
  - `project_design/FEATURES.md`
  - `project_design/PAGES.md`
  - `project_design/advanced-features.md`

### Added to the project

- Copied the design documentation into `docs/project-design/`
- Copied the design source stubs into `docs/project-design/stubs/`
- Copied `project_design/rentalcardrive.png` into `apps/public-site/public/rentalcardrive.png`

### Confirmed as already implemented in the app code

- Team API route exists: `apps/api/src/routes/team.ts`
- Clerk invitation webhook route exists: `apps/api/src/routes/webhooks.ts`
- Team service exists: `apps/api/src/services/teamService.ts`
- Role middleware exists: `apps/api/src/middleware/requireRole.ts`
- Dashboard team UI exists:
  - `apps/dashboard/src/app/(dashboard)/dashboard/team/page.tsx`
  - `apps/dashboard/src/components/team/InviteModal.tsx`
  - `apps/dashboard/src/components/team/EditMemberModal.tsx`
  - `apps/dashboard/src/components/team/PermissionsMatrix.tsx`
  - `apps/dashboard/src/hooks/useTeam.ts`

These are not exact copies of the `project_design` stubs, but they cover the same implementation area and appear to be the working versions.

### Obvious gaps against the design docs

- Public-site pages from the page spec are missing or not present as app routes:
  - `/pricing`
  - `/about`
  - `/blog`
- Renter account routes described in the page spec are not present as standalone routes:
  - `/renter/notifications`
  - `/renter/saved-companies`
  - `/renter/profile`
- The marketplace renter dashboard exists, but it is not split into the separate pages described in `project_design/PAGES.md`.
- The design document should not be treated as "fully implemented" yet. There are implemented areas, but the repo still has page-level and spec-level gaps.

### Notes

- The git worktree already had many unrelated local changes before this audit. I did not overwrite or revert them.
- This audit is a practical coverage check, not a formal end-to-end verification of every feature in `project_design/FEATURES.md`.
