How zephyrstudio-tech/v0-pos-arte21 works
Arte21 POS is a retail point-of-sale and omnichannel operations system. Store operators use the POS to manage products, customers, cash sessions, sales and returns; administrators manage catalog, online orders, customers and reporting. The documented architecture connects the web application to Supabase and WooCommerce, and sends invoices to VeriFACTU. The source excerpts also show server-side sale and catalog logic. Some feature areas are represented by their exact tree paths, but their internal calls were not sampled, so uncertain links are omitted.
Main entry points: layout.tsx Arte21 web app · web-orders/route.ts Online order handling · page.tsx POS workspace · create/route.ts Sale processing
Components 21
Store POS
- POS workspace
app/(pos)/pos/page.tsx - POS ticket state
lib/store/usePosStore.ts - Sale processing
app/api/sales/create/route.ts
Commerce Operations
- Online order desk
app/(admin)/admin/pedidos-web/page.tsx - Online order handling
app/api/admin/web-orders/route.ts - Order shipping
lib/web-order-shipping.ts - Invoice services
lib/invoices.ts - Customer club
lib/club-credencial-servidor.ts
Administration
- Catalog management
app/(admin)/admin/products/page.tsx - Catalog API
app/api/admin/products/route.ts - Stock management
app/(admin)/admin/stock/page.tsx - Dashboard metrics
app/api/admin/dashboard/route.ts - Customer records
app/api/admin/customers/route.ts
Platform Services
- Arte21 web app
app/layout.tsx - Office assistant
lib/oficina/ejecutar.ts - Background sync
lib/sync-queue.ts - Supabase database
Other components
- Store operator
- Administrator
- WooCommerce
- AEAT VeriFACTU
Connections 19
- Store operator → Arte21 web app: uses
- Administrator → Arte21 web app: manages
- Arte21 web app → Supabase database: reads and writes
- Arte21 web app → WooCommerce: syncs stock and prices
- WooCommerce → Arte21 web app: sends webhooks
- Arte21 web app → AEAT VeriFACTU: registers invoices
- POS workspace → POS ticket state: uses ticket state
app/(pos)/pos/page.tsx - POS workspace → Sale processing: submits sales
- Sale processing → Supabase database: creates sales
app/api/sales/create/route.ts - Catalog management → Catalog API: manages products
- Catalog API → Supabase database: reads and writes
app/api/admin/products/route.ts - Stock management → Supabase database: manages stock
- Dashboard metrics → Supabase database: queries metrics
app/api/admin/dashboard/route.ts - Customer records → Supabase database: reads customer data
app/api/admin/customers/route.ts - Online order desk → Online order handling: manages orders
- Online order handling → Supabase database: reads orders
app/api/admin/web-orders/route.ts - Online order handling → Order shipping: uses shipping display
app/api/admin/web-orders/route.ts - Background sync → WooCommerce: syncs asynchronously
- Invoice services → AEAT VeriFACTU: registers fiscal documents