Skip to main content

​
TechStore Admin Panel Overview

This guide covers all administrative functions for managing your TechStore platform, including inventory management, order processing, analytics, and user administration.

​
Accessing the Admin Panel

​
Admin Login Requirements

Only users with the ROLE_ADMIN role can access the admin panel.
1

Log In as Admin

Navigate to the login page and sign in using your admin credentials.
2

Access Admin Panel

After successful login:
  • From the main storefront, click the “PANEL ADMINISTRADOR” floating button (bottom left)
  • Or navigate directly to admin-pedidos.html
3

Navigate Sections

Use the top navigation bar to switch between:
  • Pedidos (Orders/Dashboard)
  • Inventario (Inventory)
  • Categorías (Categories)
  • Usuarios (Users)

​
Dashboard & Sales Analytics

The default admin view provides comprehensive sales metrics and order management.

​
Key Metrics Overview

Total Sales

Cumulative revenue from all orders in the selected time period

Order Count

Total number of orders placed

Average Ticket

Average order value (Total Sales ÷ Number of Orders)

Critical Stock

Number of products with low inventory levels

​
Analytics Charts

Click “Ver Gráficos” to expand the analytics panel:
A pie chart visualization showing revenue distribution across product categories.Use this to:
  • Identify best-selling categories
  • Plan inventory purchases
  • Make marketing decisions
A bar/doughnut chart displaying order distribution by status.Shows counts for:
  • PENDIENTE (Pending)
  • PROCESANDO (Processing)
  • ENVIADO (Shipped)
  • ENTREGADO (Delivered)

​
Order Management

​
Viewing All Orders

The Pedidos section displays all customer orders in a sortable table. Table Columns:
  • ID: Unique order identifier
  • Fecha: Order date and time
  • Cliente: Customer name and email
  • Total: Order amount in USD
  • Estado: Current status with color-coded badge
  • Acciones: Action buttons (View Details, Update Status)

​
Filtering Orders by Date

1

Open Date Picker

Click the “Rango de fechas” input field.
2

Select Date Range

Use the Flatpickr calendar to select:
  • Start date
  • End date
3

View Filtered Results

Orders automatically filter to the selected date range. Metrics update to reflect only filtered orders.
4

Clear Filters

Click “Limpiar Filtros” to reset and show all orders.

​
Viewing Order Details

1

Locate Order

Find the order in the orders table.
2

Open Details Modal

Click the “Ver” (view) button in the Actions column.
3

Review Information

The detail modal displays:
  • Customer name and email
  • Order date
  • Current status
  • Complete product list with quantities and prices
  • Total order amount

​
Updating Order Status

1

Choose New Status

In the order row, locate the status dropdown or change status button.
2

Select Status

Choose from:
  • PENDIENTE: Order received, awaiting processing
  • PROCESANDO: Order being prepared
  • ENVIADO: Order shipped to customer
  • ENTREGADO: Order delivered successfully
3

Confirm Update

Click to confirm the status change.
4

Verify Update

The status badge updates immediately in the table.
Regularly update order statuses to keep customers informed about their delivery progress.

​
Generating Sales Reports

​
PDF Report Export

Export filtered order data as a formatted PDF report.
1

Apply Filters (Optional)

Use the date range filter to narrow down orders for the report.
2

Click Download PDF

Click the “Descargar PDF” button (red button with PDF icon).
3

Wait for Generation

The system generates the report (may take a few seconds for large datasets).
4

Download File

The PDF automatically downloads as reporte-ventas.pdf.
PDF Report Contents:
  • Report header with generation date
  • Summary metrics (total sales, order count, average ticket)
  • Detailed order table with all filtered orders
  • Footer with page numbers
Generate reports at the end of each month for accounting and performance analysis.

​
Product Management

Manage your entire product catalog from the Inventario section.

​
Viewing Products

The inventory table displays:
  • Product image (thumbnail)
  • Product name
  • Price (USD)
  • Stock quantity
  • Action buttons (Edit, Delete)

​
Searching and Filtering Products

  1. Type in the “Buscar por nombre” search box
  2. Results filter in real-time as you type
  3. Clear the search to show all products
  1. Use the category dropdown to select a specific category
  2. Only products in that category display
  3. Click “Limpiar” to reset filters

​
Creating a New Product

1

Open Product Form

Click “Nuevo Producto” (green button, top right).
2

Fill Basic Information

Required fields:
  • Nombre: Product name
  • Precio: Price in USD (decimal format)
  • Stock: Available quantity
  • Categoría: Select from dropdown
Optional fields:
  • Descripción: Detailed product description
3

Add Product Images

Main Image (Portada):
  • Enter the URL of the primary product image
  • This image displays in the catalog grid
Gallery Images:
  • Click “Añadir otra foto a la galería” to add additional images
  • Enter URLs for each gallery image
  • These appear in the product detail carousel
4

Save Product

Click “Guardar Cambios del Producto” at the bottom.
5

Confirm Creation

You’ll see a success notification and the product appears in the inventory table.
Image URLs should be publicly accessible. Consider using a CDN or image hosting service for best performance.

​
Editing an Existing Product

1

Locate Product

Find the product in the inventory table (use search/filter if needed).
2

Open Edit Form

Click the “Editar” button for that product.
3

Modify Information

Update any fields:
  • Product name, description
  • Price or stock quantity
  • Category
  • Main image URL
  • Gallery images (add, remove, or modify URLs)
4

Save Changes

Click “Guardar Cambios del Producto”.
5

Verify Update

Changes reflect immediately in the inventory table and storefront.

​
Managing Product Image Galleries

Use high-quality images (at least 800x800px) for the best customer experience. Multiple gallery images help customers make informed purchase decisions.

​
Deleting a Product

1

Find Product

Locate the product you want to remove.
2

Click Delete

Click the “Eliminar” button (red/trash icon).
3

Confirm Deletion

Confirm the action in the popup dialog.
4

Soft Delete

The product is marked as inactive (soft delete) and removed from the storefront.
Products are soft-deleted by default, meaning they’re hidden from customers but remain in the database. This preserves order history integrity.

​
Category Management

Organize products into logical categories for easier browsing.

​
Viewing Categories

The Categorías section displays all product categories:
  • ID: Category identifier
  • Nombre: Category name
  • Acciones: Edit and Delete buttons

​
Creating a New Category

1

Open Category Form

Click “Nueva Categoría” (yellow button, top right).
2

Enter Category Name

Type the category name (e.g., “Laptops”, “Smartphones”, “Accessories”).
3

Save Category

Click “Guardar Categoría”.
4

Verify Creation

The new category appears in the table and becomes available in product forms.

​
Editing a Category

1

Find Category

Locate the category in the table.
2

Open Edit Form

Click the “Editar” button.
3

Update Name

Modify the category name as needed.
4

Save Changes

Click “Guardar Categoría”.
Changing a category name updates it for all associated products automatically.

​
Deleting a Category

1

Select Category

Find the category you want to remove.
2

Click Delete

Click the “Eliminar” button.
3

Confirm Deletion

Confirm the action.
Before deleting a category, ensure no products are assigned to it, or reassign those products to a different category.

​
User Management

Administer customer accounts and permissions.

​
Viewing Users

The Usuarios section displays all registered users:
  • ID: User identifier
  • Nombre: Full name
  • Email: Email address (login credential)
  • Rol: User role (ROLE_ADMIN or ROLE_USER)
  • Acciones: Edit and Delete buttons

​
Searching Users

1

Use Search Bar

Type in the “Buscar por nombre o email” field.
2

View Results

Users filter in real-time based on your search.
3

Clear Search

Clear the search field to show all users.

​
Editing User Information

1

Find User

Locate the user in the table (use search if needed).
2

Open Edit Modal

Click the “Editar” button.
3

Update Information

Modify:
  • Nombre Completo: User’s full name
  • Email: Email address
  • Rol: ADMIN (value: 1) or USER (value: 2)
4

Save Changes

Click “Actualizar Datos”.
Changing a user’s role to ADMIN grants them full access to the admin panel. Use this permission carefully.

​
User Roles Explained

ROLE_USER

Standard customer access:
  • Browse and purchase products
  • View order history
  • Manage own profile

ROLE_ADMIN

Administrative access:
  • All user permissions
  • Access admin panel
  • Manage products and categories
  • Process orders
  • View analytics
  • Manage users

​
Deleting a User

1

Select User

Find the user account to remove.
2

Click Delete

Click the “Eliminar” button.
3

Confirm Deletion

Confirm the permanent deletion.
4

Account Removed

The user account and associated data are deleted from the system.
Deleting a user is permanent and cannot be undone. The user’s order history may be affected.

​
Best Practices

​
Inventory Management

Monitor Stock Levels

Regularly check the “Stock Crítico” metric and restock low-inventory items promptly.

Update Product Information

Keep product descriptions, prices, and images current to maintain customer trust.

Use Quality Images

Upload high-resolution images with multiple angles to showcase products effectively.

Organize with Categories

Create clear, logical categories to help customers find products easily.

​
Order Processing

  • Check the admin dashboard daily for new orders
  • Move orders from PENDIENTE to PROCESANDO within 24 hours
  • Update to ENVIADO when items ship
  • Mark as ENTREGADO upon confirmation of delivery
When updating order statuses, consider:
  • Informing customers of shipping delays
  • Providing tracking information when available
  • Following up on delivered orders for satisfaction

​
Data Analysis

  • Generate monthly PDF reports for accounting
  • Review sales by category to identify trends
  • Analyze average ticket size to optimize pricing
  • Monitor order status distribution to identify bottlenecks
  • Filter orders by date range for period analysis
  • Compare metrics across different time periods
  • Identify seasonal trends and plan inventory accordingly

​
Admin Panel Navigation Tips

1

Use Top Navigation

Quickly switch between sections using the navbar:
  • Pedidos: Dashboard and order management
  • Inventario: Product catalog
  • Categorías: Category organization
  • Usuarios: User administration
2

Return to Storefront

Click “Ver Tienda” in the top right to view the customer-facing site.
3

Leverage Search and Filters

Use search boxes and filters in each section to quickly find specific items.
4

Modal Forms

Most create/edit operations open in modal dialogs - you can cancel anytime by clicking the X or clicking outside the modal.

​
Troubleshooting

Solution:
  • Verify you’re logged in with an admin account (ROLE_ADMIN)
  • Check that your account is active and verified
  • Clear browser cache and cookies
  • Try logging out and back in
Solution:
  • Ensure there’s order data available
  • Try clicking “Ver Gráficos” to expand the panel
  • Check browser console for JavaScript errors
  • Refresh the page
Solution:
  • Verify image URLs are publicly accessible
  • Check that URLs use HTTPS protocol
  • Ensure images exist at the specified URLs
  • Test URLs directly in a browser
Solution:
  • Reduce the date range filter if too many orders
  • Check browser’s pop-up blocker settings
  • Ensure sufficient disk space for download
  • Try a different browser
Solution:
  • Verify you have admin permissions
  • Check internet connection
  • Ensure the order exists and is valid
  • Refresh the page and try again
Solution:
  • Clear the search field and try again
  • Check spelling of search terms
  • Verify users exist in the system
  • Refresh the page

​
Security Reminders

Important Security Practices:
  • Protect Admin Credentials: Never share your admin login information
  • Regular Password Updates: Change your admin password periodically
  • Role Management: Only grant ADMIN role to trusted personnel
  • Data Privacy: Handle customer information according to privacy regulations
  • Audit Regularly: Monitor admin actions and user changes
  • Secure Access: Log out when finished and don’t leave sessions open on shared computers

​
Need Help?

If you encounter issues not covered in this guide:
  • Technical Support: Contact your system administrator
  • Feature Requests: Submit suggestions for platform improvements
  • Bug Reports: Document and report any unexpected behavior
  • Training: Request additional training for admin staff
Keep this guide bookmarked for quick reference while managing your TechStore platform.

Build docs developers (and LLMs) love

Get started for freeTalk to us