project-overview_skill

Overview

This skill provides a concise technical and functional overview of the Santa Lucía delivery management system for a pizzeria. It summarizes core features: trip recording, automatic distance calculation, monthly ranking with multipliers, payment liquidation by km, and full reporting and audit. The description highlights the tech stack and key business rules to help engineers, product managers, or auditors quickly understand the system.

How this skill works

The skill inspects the system design that records motoquero trips and computes distances using the Google Maps Distance Matrix API, counting only one-way kilometers from the store to the farthest delivery address. It explains how back-end logic aggregates km per shift (day/night), applies ranking and position-based multipliers, and calculates liquidations and bonuses. It also covers reporting and audit capabilities for verifying trips, payments, and historical data.

When to use it

• Onboarding engineers or stakeholders to the delivery system architecture and rules
• Auditing trip records, payments, and ranking outcomes
• Designing or extending payroll/liquidation logic based on km and multipliers
• Integrating or validating Google Maps distance calculations
• Preparing reporting, CSV exports, or financial reconciliations

Best practices

• Treat distance calculations as one-way from the store to the farthest address; do not double for return trips
• Keep API keys secure and throttle Distance Matrix requests; cache responses for repeated addresses
• Separate day and night shifts in data models and liquidations to avoid mixing periods
• Use migrations and strong schema validation (Zod + Prisma) to keep trip and payment data consistent
• Implement audit trails for trip edits and payment adjustments to support reconciliation and disputes

Example use cases

• Compute monthly payroll: aggregate km per motoquero by shift, apply multipliers and produce payment batches
• Generate ranking report: list top motoqueros by total km and apply position multipliers automatically
• Audit a suspect trip: verify recorded route, distance calculation, and any manual edits with full history
• Simulate payout scenarios: adjust multipliers or fuel price to estimate bonus and liquidation impact
• Integrate a new front-end view to display real-time rankings and per-trip details for managers