Event Management - TradeMaster Transactions (TMT)

Overview

Event Management is the core feature of TradeMaster Transactions, enabling clients to create and manage events from initial setup through to completion. The platform supports various event types including concerts, sports events, theater performances, and more.

Events in TMT go through multiple lifecycle stages: Instanciado (Instantiated), Activo (Active), En Progreso (In Progress), and Finalizado (Completed).

Accessing Events

Navigate to Events

From the main dashboard, click Eventos in the navigation menu

View Your Events

The events table displays all events for your client account, filtered automatically by your user ID

Search and Filter

Use the search bar to find events by name, venue, or status

Creating a New Event

Prerequisites

Before creating an event, ensure you have:

Event Venue

At least one event venue must be configured in the system

Contracts

Valid contracts and legal agreements for the event

Client Account

An active client account with appropriate permissions

Financial Setup

Legal contract with financial configuration details

Event Creation Workflow

Start Event Creation

Click the Crear Evento button in the top-right corner of the Events page

Enter Basic Information

Fill in the primary event details:

// Required event data
{
  name: "Event Name",
  description: "Full event description",
  type: "Concierto", // Concert, Sports, Theater, etc.
  client: { id: "client_id", name: "Client Name" },
  date_start: "2024-06-15T20:00:00",
  date_end: "2024-06-15T23:59:00"
}

Select Venue and Contracts

Choose the event venue and associated contracts:

Event Venue: Physical or virtual location with maximum capacity
Contracts: One or more service contracts (artist, venue, equipment)
Legal Contract: Primary financial and legal agreement

Configure Event Metadata

Add event-specific information:

Main Activity: Primary performer or attraction
Secondary Activity: Supporting acts or additional features
Terms and Conditions: Event-specific rules and policies
Event Description: Detailed information for ticket buyers

Upload Event Banner

Upload a banner image for the event:

Recommended size: 2500x900 pixels
Supported formats: JPG, PNG, GIF
Maximum file size: 2MB

Review and Save

Review all information and click Guardar to create the event

All fields marked as required must be completed before you can save the event. Missing fields will display validation errors.

Event Form Fields

Basic Information

Field	Type	Required	Description
Name	Text	Yes	Event display name
Description	Text Area	Yes	Full event description
Event Type	Dropdown	Yes	Concert, Sports, Theater, etc.
Main Activity	Text	Yes	Primary performer/attraction
Secondary Activity	Text	Yes	Supporting acts
Date Start	DateTime	Yes	Event start date and time
Date End	DateTime	Yes	Event end date and time

Relationships

// Each event is linked to a client
eventData.client_id = values.client.id;
eventData.client_name = values.client.name;

Event Metadata Structure

type_metadata: {
  main_activity: "Rock Band Name",
  secondary_activity: "Opening Act Name",
  description: "Full artist/event description",
  tos: "Terms and conditions text"
}

Event Status Lifecycle

Events progress through several status stages:

Instanciado (Instantiated)

Event has been created but is not yet active. Tickets cannot be sold.Available Actions:

Edit event details
Configure ticket types and zones
Set up pricing
Activate the event

Activo (Active)

Event is live and tickets can be sold. This is the primary operational state.Available Actions:

View and manage ticket sales
Process orders
Monitor real-time statistics
Generate reports

En Progreso (In Progress)

Event is currently happening. Typically used for day-of-event operations.Available Actions:

Scan and validate tickets
Handle at-door sales
Monitor attendance
Manage access control

Finalizado (Completed)

Event has concluded. No further sales are possible.Available Actions:

View final reports
Process refunds
Export data
Archive event

Events Table Interface

The events table provides a comprehensive view of all your events:

Table Columns

Event Name and Image

Displays event name with banner thumbnail
Shows event type below the name
Click anywhere on the row to view event details

// Event name cell structure
<Avatar src={event.media[0]} alt={event.name} />
<Box>
  <Typography variant="subtitle1">{event.name}</Typography>
  <Typography variant="body2">{event.type}</Typography>
</Box>

Date and Time

Shows the event start date in a readable format. Sort by this column to view chronologically.

Status Indicator

Color-coded status chip:

🟡 Yellow: Instanciado
🟢 Green: Activo
🔵 Blue: En Progreso
⚪ Gray: Finalizado

Last Action

Displays the most recent action from the event ledger:

Action description (e.g., “Creado”, “Activado”)
Timestamp of the action

const lastAction = event.ledger[event.ledger.length - 1];
// { action: "Creado", date: "2024-03-12T10:30:00" }

Venue Name

Shows the name of the venue where the event takes place. Helps identify location at a glance.

Table Actions

Search

Search events by name, venue name, status, or date

Filter

Apply advanced filters to narrow down the event list

Export

Download event data as CSV for external analysis

Sort

Click column headers to sort by that field

View Details

Click the eye icon or anywhere on the row to open event details

Pagination

Navigate through events with 10, 15, or 20 per page

Event Detail View

Clicking on an event opens the detailed view with multiple sections:

Event Information Tab

Event Details: Name, description, dates, and status
Venue Information: Location, capacity, and contact details
Financial Setup: Pricing, fees, and payment distribution
Contracts: All associated contracts and legal documents

Tickets Tab

Manage ticket inventory and pricing:

Create Ticket Types

Define different ticket categories (VIP, General Admission, etc.)

Configure Zones

Set up venue sections with pricing and capacity

Set Colors

Assign colors to zones for visual identification

Generate Tickets

Create the actual ticket inventory for sale

Sales and Orders

Monitor ticket sales in real-time:

// Real-time sales data
{
  total_tickets: 1500,
  sold_tickets: 892,
  available_tickets: 608,
  revenue: 125600.00,
  orders: 324
}

Event Ledger

View a complete history of all actions taken on the event:

ledger: [
  { action: "Creado", date: "2024-01-15T10:00:00", user: "[email protected]" },
  { action: "Activado", date: "2024-01-20T14:30:00", user: "[email protected]" },
  { action: "Primera Venta", date: "2024-01-20T15:45:00", user: "[email protected]" }
]

Event Security

Each event has a security configuration for QR code validation:

// Generated secret key for ticket validation
const key = generateSecretKey(); // 32-byte random key
await Firestore.collection(`events/${eventId}/security`)
  .doc('qr-pin').set({ data: key });

The QR code secret is automatically generated when an event is created and is used to verify ticket authenticity at entry points.

Best Practices

Plan Ahead

Create events well in advance to allow time for marketing and ticket sales

Complete Information

Fill in all event details thoroughly to provide clear information to ticket buyers

High-Quality Images

Use professional banner images at the recommended resolution

Accurate Dates

Double-check event dates and times before activating

Contract Management

Ensure all contracts are finalized before creating the event

Venue Capacity

Verify venue maximum capacity matches ticket inventory

Troubleshooting

Cannot save event

Check that all required fields are filled
Verify the event end date is after the start date
Ensure you have selected at least one contract
Confirm the banner image is under 2MB
Check that the venue has available capacity

Event not appearing in list

Verify you are logged in with the correct client account
Check if filters are hiding the event
Confirm the event was successfully created (check for success message)
Try refreshing the page

Cannot activate event

Ensure ticket types and zones are configured
Verify all financial setup is complete
Check that the event date hasn’t passed
Confirm you have activation permissions

Ticket Sales

Configure ticket types and manage sales for your events

Office Operations

Set up box offices to sell tickets for your events

Payment Processing

Configure payment methods for ticket purchases

Getting Started

Core Features

User Guides

Administration

​Overview

​Accessing Events

​Creating a New Event

​Prerequisites

Event Venue

Contracts

Client Account

Financial Setup

​Event Creation Workflow

​Event Form Fields

​Basic Information

​Relationships

​Event Metadata Structure

​Event Status Lifecycle

​Events Table Interface

​Table Columns

​Table Actions

Search

Filter

Export

Sort

View Details

Pagination

​Event Detail View

​Event Information Tab

​Tickets Tab

​Sales and Orders

​Event Ledger

​Event Security

​Best Practices

Plan Ahead

Complete Information

High-Quality Images

Accurate Dates

Contract Management

Venue Capacity

​Troubleshooting

​Related Features

Ticket Sales

Office Operations

Payment Processing

Build docs developers (and LLMs) love

Overview

Accessing Events

Creating a New Event

Prerequisites

Event Creation Workflow

Event Form Fields

Basic Information

Relationships

Event Metadata Structure

Event Status Lifecycle

Events Table Interface

Table Columns

Table Actions

Event Detail View

Event Information Tab

Tickets Tab

Sales and Orders

Event Ledger

Event Security

Best Practices

Troubleshooting

Related Features