SansiStore is a full-stack e-commerce platform built for Universidad Mayor de San Simón (UMSS), Bolivia. It covers the entire order lifecycle — from customers browsing the product catalog to sellers processing orders, couriers completing deliveries, and administrators reconciling payments. The platform runs on Astro with React, Firebase, and Tailwind CSS, and is deployed to Vercel as a Progressive Web App.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ProcesosAgilesUMSS/sansistore/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Get SansiStore running locally in minutes with Bun and Firebase emulators.
Architecture
Understand the tech stack, feature modules, and how roles interact.
Data Model
Explore the Firestore collections powering every feature.
API Reference
Server-side API endpoints for admin, seller, and user operations.
What SansiStore Covers
SansiStore is designed around five distinct user roles, each with a dedicated portal and workflow:Buyer Experience
Browse products, manage a cart, place orders, and track deliveries.
Seller Portal
Receive and process orders, package items, assign couriers, and manage offers.
Courier Operations
Accept deliveries, collect payments, and manage daily cash sessions.
Inventory Management
Track stock levels, record entries and exits, and manage product packaging.
Admin Panel
Monitor KPIs, manage users, reconcile payments, and audit system activity.
Contributing
Branching model, testing strategy, and UI standards for contributors.
Get Running Quickly
Install dependencies
Install Bun and Java 21, then run
bun install inside the repo.Configure environment variables
Copy
.env.example to .env and fill in your Firebase project credentials (or use the emulator defaults for local development).Start the Firebase emulators
Run
bun run emu to start Firestore, Auth, Functions, and Pub/Sub emulators locally.Seed and run
Seed test data with
bun run seed, then start the dev server with bun dev. Open http://localhost:4321.Authentication is restricted to
@umss.edu Google accounts in production. In development with emulators, any credential works. See Environment Setup for full details.