Managing Cities, Places, Events, and Categories in Tourify

Content Resources

Cities, Categories, Places, and Events are each managed through standard Laravel resource controllers registered under the /admin prefix. Every resource exposes the full CRUD cycle: list, create, edit, and delete — all scoped behind the auth + is_admin middleware.

Deleting a city cascades to all of its associated places and events. Make sure you intend to remove all child content before deleting a city.

Cities
Categories
Places
Events

URL: /admin/citiesCities are the top-level geographic containers for all places and events in Tourify. Each city can have one cover image stored under images/cities/ in the public disk.

Listing Cities

Navigate to /admin/cities to see all cities sorted alphabetically by name.

Creating a City

Go to /admin/cities/create and fill in the following fields:

Field	Required	Notes
`name`	✅ Yes	Max 255 characters
`country`	✅ Yes	Max 255 characters
`description`	No	Free-form text
`image`	No	Image file, max 4 MB — stored in `images/cities/`

POST /admin/cities
Content-Type: multipart/form-data

name=Buenos Aires
country=Argentina
description=Capital and largest city of Argentina.
image=<file>

Editing a City

Navigate to /admin/cities/{city}/edit. The form pre-populates all existing fields and displays the current image. Uploading a new image replaces the old one (the old file is deleted from storage).

Deleting a City

Click Delete on any city from the index page. The city record, its image file, and all associated places and events are permanently removed.

Deleting a city is irreversible and will cascade — all places and events linked to that city will also be deleted.

URL: /admin/categoriesCategories classify places in the mobile app (e.g. Museums, Parks, Beaches, Restaurants). They are lightweight records with a name and an optional description.

Listing Categories

Navigate to /admin/categories to see all categories sorted alphabetically.

Creating a Category

Go to /admin/categories/create and fill in the following fields:

Field	Required	Notes
`name`	✅ Yes	Max 255 characters
`description`	No	Free-form text

POST /admin/categories
Content-Type: application/x-www-form-urlencoded

name=Museums
description=Cultural and historical museums.

Editing a Category

Navigate to /admin/categories/{category}/edit to update the name or description.

Deleting a Category

Click Delete on any category from the index page to permanently remove it.

Before deleting a category, consider reassigning any places that use it — places whose category is removed may appear uncategorized in the app.

URL: /admin/placesPlaces are the core tourist entities of Tourify — landmarks, attractions, restaurants, and any other point of interest. Each place belongs to both a city and a category, and can carry geographic coordinates for map display.

Listing Places

Navigate to /admin/places to see all places sorted alphabetically, with their associated city and category shown inline.

Creating a Place

Go to /admin/places/create. The form populates city and category dropdowns from the database. Fill in the following fields:

Field	Required	Notes
`name`	✅ Yes	Max 255 characters
`city_id`	✅ Yes	Must reference an existing city
`category_id`	✅ Yes	Must reference an existing category
`description`	No	Free-form text
`address`	No	Max 255 characters
`latitude`	No	Decimal numeric value
`longitude`	No	Decimal numeric value
`image`	No	Image file, max 4 MB — stored in `images/places/`

POST /admin/places
Content-Type: multipart/form-data

name=Museo Nacional de Arte
city_id=1
category_id=3
description=National art museum with collections spanning five centuries.
address=Av. del Libertador 1473
latitude=-34.5871
longitude=-58.3748
image=<file>

Editing a Place

Navigate to /admin/places/{place}/edit. City and category dropdowns are pre-selected. Uploading a new image replaces the existing one and deletes the old file from storage.

Deleting a Place

Click Delete from the index page. The place and its stored image are permanently removed.

URL: /admin/eventsEvents are time-bound occurrences linked to a city and optionally to a specific place. The index shows all events with their associated city, place, and registration count, ordered by date descending.

Listing Events

Navigate to /admin/events to see all events. Each row includes the registration count (from withCount('registrations')), the associated city, and the linked place (if any).

Viewing Event Details

Navigate to /admin/events/{event} to see a full detail view including the list of registered users.

Creating an Event

Go to /admin/events/create. City and place dropdowns are populated from the database. Fill in the following fields:

Field	Required	Notes
`title`	✅ Yes	Max 255 characters
`city_id`	✅ Yes	Must reference an existing city
`date`	✅ Yes	Valid date value
`place_id`	No	Optional link to a specific place
`description`	No	Free-form text
`image`	No	Image file, max 4 MB — stored in `images/events/`

POST /admin/events
Content-Type: multipart/form-data

title=Buenos Aires Jazz Festival
city_id=1
place_id=4
description=Annual jazz festival in the heart of Buenos Aires.
date=2025-11-15
image=<file>

Editing an Event

Navigate to /admin/events/{event}/edit. All fields are pre-populated. Uploading a new image replaces and deletes the old one.

Deleting an Event

Click Delete from the index page. The event record and its stored image are permanently removed.

Moderating Reviews

URL: /admin/reviews The reviews section lets admins monitor and moderate all user-submitted reviews across the platform.

Viewing Reviews

Navigate to /admin/reviews to see all reviews in reverse chronological order. Each row includes:

The user who submitted the review (eager-loaded via Review::with(['user', 'reviewable']))
The reviewable entity — the place or event being reviewed
The review content and submission timestamp

Deleting a Review

To remove an inappropriate or spam review, click Delete next to the entry. This sends:

DELETE /admin/reviews/{review}

The review is permanently deleted and you are redirected back to the index with a success message.

Reviews can only be deleted, not edited, from the admin panel. If a review needs correction, delete it and ask the user to resubmit.

Push Notifications

URL: /admin/notifications The notifications section allows admins to broadcast push notifications to all registered app users simultaneously. Notifications are persisted in the database and also dispatched to devices via the Expo Push Service.

Viewing Sent Notifications

Navigate to /admin/notifications to see the most recent 100 notifications, each shown with the recipient user and timestamp.

Sending a Broadcast Notification

Open the create form

Navigate to /admin/notifications/create or click Send Notification from the index page.

Fill in the notification details

Provide the following fields:

Field	Required	Notes
`title`	✅ Yes	Max 255 characters — shown as the push notification headline
`message`	✅ Yes	The notification body text

Submit the form

Click Send. The controller:

Inserts one Notification database record per user (bulk insert via Notification::insert()).
Collects all non-null push_token values from the users table.
Posts a batch payload to https://exp.host/--/api/v2/push/send via Laravel’s HTTP client.

POST /admin/notifications
Content-Type: application/x-www-form-urlencoded

title=New Places Added!
message=Check out the latest attractions added to your city.

Confirm delivery

The panel redirects to the index page with a success message showing how many users received the notification, e.g. “Notificación enviada a 342 usuario(s).”

Push delivery is best-effort. If the Expo Push Service request fails (network error, invalid tokens, etc.), the in-app notification records are still persisted in the database and will appear in the user’s notification inbox inside the mobile app. Only the device push alert is affected.

Users without a registered push_token (i.e. they never granted push permission or the token has not been synced) will still receive the in-app notification record — they just won’t get a device banner.

Get Started

Core Features

Admin Panel

Architecture

Managing Cities, Places, Events, and Categories in Tourify

Content Resources

Listing Cities

Creating a City

Editing a City

Deleting a City

Listing Categories

Creating a Category

Editing a Category

Deleting a Category

Listing Places

Creating a Place

Editing a Place

Deleting a Place

Listing Events

Viewing Event Details

Creating an Event

Editing an Event

Deleting an Event

Moderating Reviews

Viewing Reviews

Deleting a Review

Push Notifications

Viewing Sent Notifications

Sending a Broadcast Notification

Build docs developers (and LLMs) love

Get Started

Core Features

Admin Panel

Architecture

Documentation Index

​Content Resources

​Listing Cities

​Creating a City

​Editing a City

​Deleting a City

​Listing Categories

​Creating a Category

​Editing a Category

​Deleting a Category

​Listing Places

​Creating a Place

​Editing a Place

​Deleting a Place

​Listing Events

​Viewing Event Details

​Creating an Event

​Editing an Event

​Deleting an Event

​Moderating Reviews

​Viewing Reviews

​Deleting a Review

​Push Notifications

​Viewing Sent Notifications

​Sending a Broadcast Notification

Build docs developers (and LLMs) love

Content Resources

Listing Cities

Creating a City

Editing a City

Deleting a City

Listing Categories

Creating a Category

Editing a Category

Deleting a Category

Listing Places

Creating a Place

Editing a Place

Deleting a Place

Listing Events

Viewing Event Details

Creating an Event

Editing an Event

Deleting an Event

Moderating Reviews

Viewing Reviews

Deleting a Review

Push Notifications

Viewing Sent Notifications

Sending a Broadcast Notification