How nopparuj-an/devpool-restaurants works
Restaurants is a reservation and review community: people discover restaurants, inspect availability, book or manage reservations, and leave reviews; owners manage listings and bookings, while admins moderate users and restaurants. The frontend uses shared query/API clients to reach the Go HTTP API, whose domain modules apply booking rules and persist data in PostgreSQL; image handling uses S3-compatible storage. The README documents these capabilities, but many backend wiring details and page implementations were not excerpted, so unverified links are omitted. The design gallery is a documented frontend capability and is represented separately.
Main entry points: server.go HTTP server · queries.ts Query hooks · page.tsx Design routes · gallery.tsx Components gallery
Components 29
Web application
- App routes
frontend/app - Product screens
frontend/components/screens/screens.tsx - Page components
frontend/components/pages/pages.tsx - Restaurant editor
frontend/components/app/restaurant-form.tsx - Query hooks
frontend/lib/queries.ts - API client
frontend/lib/api-client.ts - API data types
frontend/lib/types.ts
Restaurant domain
- Restaurant listings
backend/internal/restaurant/service/restaurant_service.go - Booking rules
backend/internal/booking - Reservations
backend/internal/reservation/service/reservation_service.go - Reviews
backend/internal/review/service/review_service.go - Image processing
backend/internal/platform/imageproc/imageproc.go
Identity and moderation
- Login and signup
frontend/components/app/auth-form.tsx - Authentication
backend/internal/auth/service/auth_service.go - Google login
backend/internal/auth/google_handler.go - Admin moderation
backend/internal/admin/service/admin_service.go - Public profiles
backend/internal/profile
API runtime and persistence
- Image object storage
backend/internal/platform/storage/storage.go - HTTP server
backend/internal/server/server.go - PostgreSQL
backend/internal/platform/database/database.go
Design gallery
- Design routes
frontend/app/design/page.tsx - Gallery navigation
frontend/app/design/nav.tsx - Components gallery
frontend/app/design/gallery.tsx - Screen registry
frontend/app/design/registry.tsx - Gallery screen list
frontend/app/design/screen-list.ts - Preview mock data
frontend/lib/mock.ts - Responsive frame
frontend/app/design/frame.tsx
Other components
- Diners, owners, admins
- Garage S3 storage
Connections 36
- Diners, owners, admins → App routes: uses
- App routes → Product screens: renders
- Product screens → Page components: uses
- Product screens → Query hooks: reads through
- Page components → Query hooks: reads through
- Restaurant editor → Query hooks: submits through
- Login and signup → Query hooks: submits through
- Query hooks → API client: fetches with
frontend/lib/queries.ts - API client → HTTP server: HTTP requests
frontend/lib/api-client.ts - Diners, owners, admins → Login and signup: signs in
- HTTP server → Authentication: routes requests
- HTTP server → Admin moderation: routes requests
- HTTP server → Public profiles: routes requests
- HTTP server → Restaurant listings: routes requests
- HTTP server → Reservations: routes requests
- HTTP server → Reviews: routes requests
- Google login → Authentication: supports login
- Diners, owners, admins → Restaurant listings: discovers listings
- Diners, owners, admins → Reservations: books tables
- Diners, owners, admins → Reviews: writes reviews
- Diners, owners, admins → Admin moderation: moderates
- Reservations → Booking rules: applies rules
- Restaurant listings → Image processing: processes images
- Image processing → Image object storage: stores images
- Image object storage → Garage S3 storage: S3 operations
- HTTP server → PostgreSQL: database access
- Design routes → Gallery navigation: renders
frontend/app/design/page.tsx - Design routes → Components gallery: renders
frontend/app/design/page.tsx - Design routes → Gallery screen list: lists screens
frontend/app/design/page.tsx - Design routes → Responsive frame: frames previews
frontend/app/design/page.tsx - Components gallery → Preview mock data: uses previews
frontend/app/design/gallery.tsx - Components gallery → Screen registry: shows components
frontend/app/design/gallery.tsx - Screen registry → Preview mock data: renders mock data
- Screen registry → Product screens: renders screens
frontend/app/design/registry.tsx - Gallery navigation → Gallery screen list: reads sections
frontend/app/design/nav.tsx - Components gallery → API data types: uses data shapes