carmanagement/docs/project-design/AUDIT.md

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.