Create Your Account
Register for a Tambo360 account with your email and password.Password Requirements:
apps/backend/src/controllers/authController.ts:11-39
- Minimum 8 characters
- At least one uppercase letter
- At least one lowercase letter
- At least one number
- At least one special character (@$!%*?&)
- Maximum 50 characters
After registration, you’ll receive a verification email. Check your inbox and verify your account before logging in.
Verify Your Email
Click the verification link in your email or use the verification token.The verification token expires in 24 hours. If it expires, you can request a new verification email.
apps/backend/src/services/userService.ts:89-138
Log In
Sign in with your verified email and password.Upon successful login, you’ll receive:
- A JWT token stored in an HTTP-only cookie
- User profile information
- List of your establishments
The authentication token is automatically included in subsequent requests via cookies.
Create Your First Establishment
Set up your dairy farm establishment with location details.Example Request:Response:
apps/backend/src/schemas/establishmentSchema.ts
Currently, Tambo360 supports one establishment per user. This establishment will be used for all production tracking.
Create Your First Production Batch
Track a production batch for cheese or milk.Example Request:Response:
apps/backend/src/services/batchService.ts:8-55
- Date format: Use
DD/MM/YYYY(e.g., “08/03/2024”) - Units:
kgfor cheese,litrosfor milk - Auto-numbering:
numeroLoteincrements automatically - Estado: Defaults to
false(batch is open for tracking)
Track Waste (Optional)
Record any production waste associated with your batch.Waste Types:
Natural- Expected waste from natural production processesTecnica- Technical failures or equipment issuesAdministrativa- Administrative errors or miscountsDanio- Product damage during handling
Track Direct Costs (Optional)
Add costs associated with this production batch.Cost Concepts:
insumos_basicos- Basic production suppliesleche_cruda- Raw milk costscuajo_y_fermentos- Rennet and fermentsrefrigeracion- Refrigeration and cooling
Amounts support up to 13 digits with 2 decimal places (e.g., 99999999999.99).
Complete the Batch
Lock the batch to include it in analytics and reporting.This sets
estado: true, marking the batch as complete. Once completed:- ✅ The batch is included in monthly dashboard analytics
- ✅ You can’t add new waste or costs to this batch
- ✅ The batch data is locked for historical reporting
You can still view the batch details, but modification is restricted to maintain data integrity.
View Your Dashboard
Navigate to the dashboard to see your production analytics.The dashboard shows:
- Monthly KPIs: Cheese production, milk sales, waste percentage, total costs
- Month-over-month trends: Percentage changes vs. previous month
- 6-month historical charts: Track production, waste, and costs over time
- Daily production log: Recent batches at a glance
- Alerts: AI-powered insights from TamboEngine (requires 15+ batches)
apps/frontend/src/pages/Dashboard.tsx
What’s Next?
Explore Features
Learn about authentication, multi-establishment support, and more
API Reference
Integrate with the Tambo360 REST API
Set Up Production
Deploy Tambo360 to production
View Architecture
Understand the system architecture and tech stack
Troubleshooting
Email verification not received
Email verification not received
- Check your spam/junk folder
- Verify you entered the correct email address
- Request a new verification email via
POST /api/auth/reenviar-verificacion - Verification tokens expire after 24 hours
Invalid date format error
Invalid date format error
Ensure you’re using the
DD/MM/YYYY format:- ✅ Correct:
"08/03/2024" - ❌ Incorrect:
"2024-03-08","03/08/2024","8/3/24"
Cannot create production batch
Cannot create production batch
Common causes:
- You haven’t created an establishment yet
- Invalid product ID - verify the product exists
- Date format is incorrect (use DD/MM/YYYY)
- Unit doesn’t match product category (use
kgfor cheese,litrosfor milk)
Waste exceeds batch quantity
Waste exceeds batch quantity
The sum of all waste entries cannot exceed the batch production quantity. Check:
- Total waste across all entries for this batch
- Ensure quantities are in the same units
- Review existing waste entries:
GET /api/mermas?idLote={batchId}
Dashboard shows no data
Dashboard shows no data
The dashboard requires at least one completed batch:
- Create a production batch
- Optionally add waste and costs
- Mark the batch as complete:
PUT /api/lote/{id}/completar - Refresh the dashboard to see updated metrics
Need Help?
View Full Documentation
Explore the complete Tambo360 documentation
