How saadullah990123/veloura-naturals works
Veloura Naturals is a single-product direct-to-consumer storefront with an admin management hub. Customers browse product and review content, submit orders, track them, or contact the business; admins authenticate and manage products, orders, reviews, account details, and business settings. Order creation validates input, checks live stock and settings, calculates totals server-side, and persists the order atomically. PostgreSQL-backed data access, validation, authentication, and rate limiting support these workflows. The README documents major capabilities whose route implementations were not sampled; their links are shown only where documented, and unsampled internal call paths are not inferred.
Main entry points: index.ts PostgreSQL · orders/route.ts Order creation · reviews/route.ts Review submission · admin Admin APIs
Components 28
Customer storefront
- Home page
src/app/page.tsx - Product page
src/app/product/page.tsx - Review display
src/components/reviews-section.tsx - Review dialogs
src/components/review-modal.tsx - Contact page
src/app/contact/page.tsx - Contact form
src/components/contact-form.tsx - Track order page
src/app/track-order/page.tsx - Tracking form
src/components/track-order-form.tsx
Commerce workflows
- Order form
src/components/order-form.tsx - Order creation
src/app/api/orders/route.ts - Review submission
src/app/api/reviews/route.ts - Order lookup
src/app/api/track-order/route.ts - Contact endpoint
src/app/api/contact/route.ts
Admin management
- Admin login
src/app/admin/login/page.tsx - Admin workspace
src/components/admin/admin-shell.tsx - Management pages
src/app/admin/(protected) - Product editor
src/components/admin/product-form-modal.tsx - Admin API client
src/lib/admin-fetch.ts - Admin APIs
src/app/api/admin
Security controls
- Input validation
src/lib/validation/schemas.ts - Rate limiting
src/lib/auth/rate-limit.ts - Admin authorization
src/lib/auth/require-admin.ts - Session signing
src/lib/auth/session.ts
Data platform
- Store data access
src/lib/data.ts - PostgreSQL
src/lib/db/index.ts - Data schema
src/lib/db/schema.ts
Other components
- Customer
- Administrator
Connections 36
- Customer → Home page: browses
README.md - Customer → Product page: browses
README.md - Customer → Contact page: contacts
README.md - Customer → Track order page: tracks order
README.md - Home page → Store data access: loads content
src/app/page.tsx - Product page → Store data access: loads product
src/app/product/page.tsx - Home page → Review display: renders
src/app/page.tsx - Review display → Review dialogs: uses dialogs
src/components/reviews-section.tsx - Product page → Order form: renders
src/app/product/page.tsx - Order form → Order creation: submits order
- Order creation → Input validation: validates input
src/app/api/orders/route.ts - Order creation → Rate limiting: limits attempts
src/app/api/orders/route.ts - Order creation → PostgreSQL: checks and writes
src/app/api/orders/route.ts - Customer → Review submission: submits review
README.md - Review submission → Input validation: validates input
src/app/api/reviews/route.ts - Review submission → Rate limiting: limits attempts
src/app/api/reviews/route.ts - Review submission → PostgreSQL: stores pending review
src/app/api/reviews/route.ts - Contact page → Contact form: renders
src/app/contact/page.tsx - Contact form → Contact endpoint: sends message
- Contact endpoint → Input validation: validates input
src/app/api/contact/route.ts - Track order page → Tracking form: renders
- Tracking form → Order lookup: looks up order
- Order lookup → Store data access: finds orders
src/app/api/track-order/route.ts - Store data access → PostgreSQL: queries records
src/lib/data.ts - PostgreSQL → Data schema: uses definitions
src/lib/db/index.ts - Administrator → Admin login: signs in
README.md - Administrator → Management pages: manages store
README.md - Admin login → Session signing: creates session
- Admin workspace → Management pages: frames workspace
- Management pages → Admin API client: calls admin APIs
src/app/admin/(protected)/products/page.tsx - Product editor → Admin API client: sends edits
src/components/admin/product-form-modal.tsx - Admin API client → Admin APIs: sends requests
- Admin APIs → Admin authorization: checks access
src/app/api/admin/products/route.ts - Admin authorization → Session signing: verifies session
src/lib/auth/require-admin.ts - Admin APIs → PostgreSQL: manages records
src/app/api/admin/products/route.ts - Admin APIs → Input validation: validates changes
src/app/api/admin/products/route.ts