Quickstart

Welcome!

This guide will walk you through setting up the Restaurant Reservation System and creating your first test reservation. By the end, you’ll have a fully functional reservation system running on your device.

Prerequisites

Before starting, ensure you have:

Flutter SDK

Version 3.7.2 or higher

Firebase Account

Free Google account for Firebase

Git

For cloning the repository

IDE

VS Code or Android Studio

Verify Flutter installation:

flutter --version

You should see Flutter 3.7.2 or higher. If not, follow the Flutter installation guide.

Clone the Repository

Clone the source code to your local machine:

git clone https://github.com/AgustinLuconi/Software_Restaurante.git
cd Software_Restaurante

Install Dependencies

Install all Flutter packages defined in pubspec.yaml:

flutter pub get

This will install essential packages:

firebase_core: ^3.3.0 - Firebase SDK

cloud_firestore: ^5.6.12 - Database

firebase_auth: ^5.1.0 - Authentication

flutter_bloc: ^8.1.3 - State management

get_it: ^7.6.4 - Dependency injection

go_router: ^13.0.0 - Navigation

Set Up Firebase Project

Create and configure your Firebase project:

Firebase Console

Go to Firebase Console
Click Add project
Enter project name (e.g., “my-restaurant-app”)
Disable Google Analytics (optional for testing)
Click Create project

Enable Firestore

In Firebase Console, go to Build → Firestore Database
Click Create database
Select Start in test mode (for development)
Choose a location closest to you
Click Enable

Enable Authentication

Go to Build → Authentication
Click Get started
Enable Email/Password provider
Enable Google provider
Add support email

Test mode security rules allow anyone to read/write your database. Update rules before production deployment.

Configure Firebase for Flutter

Install Firebase CLI and configure your app:

# Install Firebase CLI
npm install -g firebase-tools

# Login to Firebase
firebase login

# Install FlutterFire CLI
dart pub global activate flutterfire_cli

# Configure Firebase for your Flutter app
flutterfire configure

During configuration:

Select your Firebase project

Choose platforms (iOS, Android, Web, etc.)

Accept the generated configuration

This creates lib/firebase_options.dart with your project configuration.

Add Firebase Configuration Files

The project needs a .firebaserc file in the root directory:

{
  "projects": {
    "default": "your-project-id"
  }
}

Replace your-project-id with your actual Firebase project ID from the Firebase Console.

Initialize Firestore Data

The app requires initial business data. You can either:

Option A: Use Firebase Console UI

Go to Firestore Database in Firebase Console

Start collection: negocios

Add a document with auto-generated ID

Add fields:

nombre: “Mi Restaurante” (string)
email: “[email protected]” (string)
telefono: “+123456789” (string)
direccion: “123 Main St” (string)
maxDiasAnticipacionReserva: 14 (number)
duracionPromedioMinutos: 60 (number)

Option B: Use Firestore Rules to Allow Initialization

Update firestore.rules:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    // Allow read/write for development
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

Deploy rules:

firebase deploy --only firestore:rules

Run the Application

Now you’re ready to run the app!

Terminal

# Start an emulator or connect a device
flutter devices

# Run the app in debug mode
flutter run

Build for specific platform

# Android
flutter run -d android

# iOS (macOS only)
flutter run -d ios

# Web
flutter run -d chrome

Release build

# Create APK (Android)
flutter build apk

# Create iOS build
flutter build ios

The app will compile and launch on your device. You should see the main screen with navigation options.

Create Your First Business

Set up your restaurant profile:

Open the app and navigate to the owner section

Sign in with Google (for owners)

Create business profile:

Name: “Test Restaurant”
Email: [email protected]
Phone: +1234567890
Address: “123 Test Street”

Configure settings:

Max advance booking: 14 days
Average duration: 60 minutes

Save your business profile

Add Tables

Create tables for your restaurant:

Go to Table Management

Click Add Table

Enter table details:

Name: “Mesa 1” (Table 1)
Capacity: 2 persons
Status: Available

Repeat for more tables:

Mesa 2 (4 persons)
Mesa 3 (6 persons)

Click Save

Tables use smart capacity matching. A table can accommodate +3 persons above party size (e.g., a 6-person table can host 3-6 guests).

Set Operating Hours

Define when your restaurant is open:

Navigate to Operating Hours

For each day of the week:

Toggle Open/Closed
Set Opening time: 11:00 AM
Set Closing time: 10:00 PM

Save the schedule

Make a Test Reservation

Time to create your first reservation!

Navigate to Availability (customer view)

Select date: Choose tomorrow’s date

Select time: 2:00 PM (14:00)

Number of guests: 2 persons

Click Search Available Tables

You should see available tables matching your criteria!

Select a table: Choose “Mesa 1”

Enter customer details:

Name: “Juan Pérez”
Email: “[email protected]”
Phone: “+1234567890” (optional)

Click Create Reservation

Verify the Reservation

The system will send a verification code:

Email Verification

Check the console output for verification code
In production, this would be sent via email
Enter the 6-digit code in the app
Click Verify

Confirmation

Once verified, you’ll see:

✅ Reservation Confirmed
Reservation ID
Table name
Date and time
Party size

View Your Reservations

Check the reservation dashboard:

Go to My Reservations (customer view)

See your confirmed booking:

Date: Tomorrow
Time: 14:00 - 15:00
Table: Mesa 1
Status: Confirmed

As a business owner:

Go to Owner Dashboard

View all reservations

See customer details

Option to cancel if needed

Test Conflict Detection

Verify the system prevents double-booking:

Try to make another reservation for:

Same table: Mesa 1
Same date: Tomorrow
Same time: 14:00

Click Search Available Tables

Mesa 1 should NOT appear in available tables. The system detects the conflict!

Try a different time slot: 15:00 (3:00 PM)

Mesa 1 should now be available ✅

Understanding Time Slots

The system uses 1-hour fixed intervals:

// Reservation structure
Reservation {
  fechaHora: DateTime(2026, 03, 10, 14, 0),  // 2:00 PM
  duracionMinutos: 60,                       // 1 hour duration
  horaFin: DateTime(2026, 03, 10, 15, 0),   // Calculated: 3:00 PM
}

// Conflict detection logic
Reserva 1: [14:00 - 15:00)
Reserva 2: [14:30 - 15:30)  → CONFLICT ❌
Reserva 2: [15:00 - 16:00)  → NO CONFLICT ✅

The overlap algorithm uses half-open intervals [start, end). Two reservations conflict if startB < endA AND endB > startA.

What You’ve Accomplished

✅ Application Setup

Installed Flutter and dependencies
Configured Firebase project
Connected app to Firestore database

✅ Business Configuration

Created restaurant profile
Added tables with capacities
Set operating hours

✅ Reservation System

Made your first reservation
Verified email confirmation flow
Tested conflict detection

Next Steps

Customize Settings

Adjust reservation duration, advance booking limits, and email templates

Deploy to Production

Set up proper Firestore security rules and deploy to app stores

Add Features

Implement recurring reservations, waitlists, and advanced analytics

Integration Guide

Connect with payment systems, SMS notifications, and third-party APIs

Troubleshooting

Firebase not initialized error

Problem: App crashes with “Firebase not initialized”Solution: Run flutterfire configure again and ensure firebase_options.dart exists in lib/.

No tables available

Problem: Search returns no available tablesSolution:

Verify tables are created in Firestore (mesas collection)
Check table capacity matches or exceeds party size
Ensure operating hours include selected time
Confirm no conflicting reservations exist

Verification code not working

Problem: Email verification failsSolution: In development, verification codes are printed to console. Check Flutter logs for the 6-digit code.

Build errors after pub get

Problem: Compilation errors after installing dependenciesSolution:

flutter clean
flutter pub get
flutter pub upgrade
flutter run

Need Help?

If you encounter issues:

Check the Installation Guide for detailed setup instructions
Review Firebase Console for configuration errors
Verify all dependencies are correctly installed
Check Flutter and Firebase versions compatibility

For detailed architecture information and code examples, see the Introduction page.

Get Started

For Customers

For Business Owners

Architecture

Guides

Welcome!

Flutter SDK

Firebase Account

Git

IDE

Understanding Time Slots

What You’ve Accomplished

Next Steps

Customize Settings

Deploy to Production

Add Features

Integration Guide

Troubleshooting

Need Help?

Build docs developers (and LLMs) love

Get Started

For Customers

For Business Owners

Architecture

Guides

​Welcome!

Flutter SDK

Firebase Account

Git

IDE

​Understanding Time Slots

​What You’ve Accomplished

​Next Steps

Customize Settings

Deploy to Production

Add Features

Integration Guide

​Troubleshooting

​Need Help?

Build docs developers (and LLMs) love

Welcome!

Understanding Time Slots

What You’ve Accomplished

Next Steps

Troubleshooting

Need Help?