How sopet-co-ltd/new-sopet-admin works
SOPET Admin is a Next.js dashboard for platform administrators and marketplace vendors. The documented flow is a portal page calling TanStack Query hooks, which use the API service layer to send GraphQL requests through the same-origin /graphql route to the backend. Admin routes cover platform operations, taxonomy, promotions, search and analytics; vendor capabilities are documented, but vendor page files are absent from this tree. Relationships below follow the README’s data-layer description; sampled source additionally confirms the BFF’s auth refresh and cookie handling.
Main entry points: hooks Query hooks · route.ts GraphQL BFF · admin Admin portal · api API services
Components 19
Portals
- Admin portal
src/app/admin - Vendor portal
- Auth routes
src/app/login/page.tsx
Marketplace operations
- Stores and vendors
src/app/admin/stores/page.tsx - Customers and reviews
src/app/admin/customers/page.tsx - Orders and payouts
src/hooks/usePayouts.ts - Analytics
src/app/admin/analytics/page.tsx - Settings and email
src/app/admin/settings/page.tsx
Catalog and growth
- Taxonomy
src/app/admin/taxonomy/page.tsx - Promotions
src/app/admin/promotions/page.tsx - Search tuning
src/app/admin/search/tuning/page.tsx
Data access
- Query hooks
src/hooks - API services
src/lib/api - GraphQL client
src/lib/graphql/client.ts - SOPET backend
Identity
- GraphQL BFF
src/app/graphql/route.ts - Auth BFF
src/lib/auth/bff-upstream.ts - Session endpoints
src/app/api/auth/session/route.ts
Other components
- Admin or vendor
Connections 19
- Admin or vendor → Admin portal: uses
- Admin or vendor → Vendor portal: uses
- Admin or vendor → Auth routes: authenticates
- Admin portal → Query hooks: queries via
- Vendor portal → Query hooks: queries via
- Stores and vendors → Query hooks: queries via
- Customers and reviews → Query hooks: queries via
- Orders and payouts → Query hooks: queries via
- Taxonomy → Query hooks: queries via
- Promotions → Query hooks: queries via
- Search tuning → Query hooks: queries via
- Analytics → Query hooks: queries via
- Settings and email → Query hooks: queries via
- Query hooks → API services: calls
- API services → GraphQL client: sends operations
- GraphQL client → GraphQL BFF: posts GraphQL
- GraphQL BFF → SOPET backend: forwards requests
- Session endpoints → Auth BFF: refreshes tokens
- GraphQL BFF → Auth BFF: refreshes on expiry