โšก SONAN TECH

Location Launchpad Docs

๐Ÿ”ง Admin Guide โ† Back to App

Admin Guide

This guide covers administrative functions: managing the task template, configuring system settings, controlling auto-generated reminders, and understanding how the system works under the hood.

Task Templates

Task Templates define the master checklist that is automatically applied to every new location. When a new location is created, the system creates one task per template entry for that location โ€” no manual setup required.

Navigate to Settings โ†’ Task Templates (or click the Templates tab inside the Settings page) to manage the master template.

Viewing Templates

Templates are displayed in a table grouped by Category with columns for Task Name, Category, Priority, Default Due Days, and the Assigned To field. You can sort the table by clicking any column header.

Adding a Template Task

1
Click + Add Template.
2
Enter the Task Name. This becomes the default title for the task on every new location.
3
Select the Category (one of the 13 defined categories).
4
Set the Priority: Critical, High, Normal, or Low.
5
Set Due Days โ€” the number of days after the location's Rent Commencement date when this task should be due. Enter a negative number if the task should be due before rent starts (e.g., -30 means 30 days before rent commencement).
6
Optionally enter a default Assigned To name or role.
7
Click Save Template.
Adding or editing a template does not retroactively update tasks that were already created for existing locations. New templates only apply when a new location is created.

Editing a Template Task

Click โœ๏ธ Edit on any template row to update the name, category, priority, due days, or assigned to field. Changes apply to future location creations only.

Deleting a Template Task

Click ๐Ÿ—‘ on any template row. A confirmation dialog will appear. Deleting a template does not delete tasks already created from it on existing locations.

Reordering Templates

Templates are displayed sorted by Category then Priority. There is no manual drag-to-reorder โ€” the display order within each category is determined by the Priority field (Critical first, then High, Normal, Low).

How Tasks Are Generated

When a user saves a new location, the API immediately queries all active task templates and creates one task per template for the new location:

  • The task title and category and priority are copied from the template.
  • The task due date is calculated as: rent_commencement_date + due_days. If the location has no Rent Commencement date set, the due date is left blank.
  • The task status is set to Not Started.
  • The task location_id is set to the new location.
If you create a location and then update its Rent Commencement date later, the task due dates are not automatically recalculated. You would need to update due dates manually per task, or delete and recreate the location.

Settings

Navigate to Settings in the sidebar. The Settings page has two tabs: General Settings and Task Templates.

General Settings controls how the system generates reminders and sends email digests. After making any changes, click Save Settings at the bottom.

Reminder Email Intervals

These settings control how many days in advance an email reminder is sent for each priority level. Each field accepts a comma-separated list of day values โ€” the system will send an email on each of those days before the reminder's due date.

SettingDefaultMeaning
Critical Reminder Days 30,14,7,3,1 Send emails 30, 14, 7, 3, and 1 day(s) before a Critical reminder is due
High Reminder Days 14,7,3 Send emails 14, 7, and 3 days before a High priority reminder
Normal Reminder Days 7,3 Send emails 7 and 3 days before a Normal priority reminder
Low Reminder Days 3 Send an email 3 days before a Low priority reminder

Example: If a Critical reminder is due on March 15, emails will be sent on Feb 13 (30 days before), March 1 (14 days), March 8 (7 days), March 12 (3 days), and March 14 (1 day before).

To disable email alerts for a specific priority, clear the field (leave it empty) and save. To add more alert points, simply add more days to the comma-separated list.

Auto-Generated Reminder Settings

When a user clicks Generate Reminders for a location, the system creates standard recurring reminders based on these settings:

Rent Months Ahead

Controls how many months of future Rent reminders to pre-create. Default is 24 โ€” the system will create 24 monthly Rent reminders starting from the location's Rent Commencement date.

Example: Rent Commencement = Jan 1, 2025, Months Ahead = 24 โ†’ creates rent reminders for Jan 2025 through Dec 2026.

HVAC Sessions Per Year

Controls how many HVAC service reminders to create per year. Default is 4 (quarterly). The system creates reminders spaced evenly through the year starting from Rent Commencement.

Example: 4 sessions/year โ†’ reminders every 3 months (Jan, Apr, Jul, Oct if rent starts in January).

Gross Sales Years

Controls how many years of annual Gross Sales report reminders to create. Default is 3. Each reminder is due on the anniversary of the Rent Commencement date.

Lease Renewal Reminder Buffers

A comma-separated list of day counts before lease expiry to send lease renewal warnings. Default: 1095,730,548,365 (3 years, 2 years, 18 months, 1 year before expiry).

Each value creates one reminder with Critical priority. These give the team early visibility to start lease renewal negotiations.

Example: Lease expires Dec 31, 2030 โ†’ reminders created for Dec 31, 2027 (3 years), Dec 31, 2028 (2 years), Jun 30, 2029 (18 months), Dec 31, 2029 (1 year).

Generating reminders is additive โ€” running it twice on the same location creates duplicates. Always check if reminders already exist before generating. You can delete individual reminders from the Reminders page if needed.

Email Configuration

The email digest is sent using Resend. The following are pre-configured in the system and do not need to be changed unless a new address is required:

FieldValue / Notes
From AddressConfigured in Resend โ€” must be a verified sending domain
To AddressSet in Settings โ€” the email address(es) that receive the daily digest
Send TimeDaily digest is sent by a scheduled cron job โ€” check deployment config for the cron schedule
API KeyRESEND_API_KEY environment variable in Cloudflare Workers โ€” already set, do not change

To change the recipient email address, update the Digest Email field in Settings and click Save.

Location Management

Understanding Location Statuses

Location status is informational โ€” it does not automatically change task due dates or lock any functionality. Update it manually to reflect actual progress:

StatusWhen to set itEffect
PlanningSite identified, lease not signedVisible on dashboard; tasks may exist or not yet
Lease SignedLease executedFull task list should be active; rent start date is known
BuildoutConstruction in progressPermits, buildout, utility tasks are active
Pre-OpeningConstruction done, preparing to openStaffing, inventory, marketing tasks are primary focus
OpenStore opened for businessProgress bar will show near 100%; moves to back of dashboard
ArchivedLocation cancelled or historicalHidden from dashboard and all active views

Archiving Locations

Archiving a location hides it from the main dashboard and all active filters. Archived locations are not deleted โ€” all data (tasks, reminders, budget, lease dates) remains in the database and is visible on the Locations page when you include Archived in the status filter.

When to Archive

  • A location opening was cancelled or the lease was not pursued
  • The store has been fully onboarded and the team no longer needs daily visibility
  • A historical location that predates the Launchpad system was manually entered for record-keeping

How to Archive

1
Open the location (click View on the dashboard or Locations page).
2
Click Edit Location.
3
Change Status to Archived.
4
Click Save Location.

The location disappears from the dashboard immediately. To view it again, go to Locations and set the status filter to Archived.

System Reference

All Task Categories

CategoryTypical tasks
Lease & DocumentsSign lease, collect landlord contact, file COI, execute TI amendment
Property DeliveryLandlord walkthrough, receive keys, document pre-existing conditions
InsuranceObtain general liability, property, workers comp, add landlord as additional insured
UtilitiesSet up electric, gas, water, waste โ€” account creation and transfer
BuildoutSelect GC, finalize drawings, permit submission, construction, punch list
PermitsBusiness license, certificate of occupancy, health permit, fire inspection
SignageDesign approval, permit, fabrication, installation
TechnologyPOS installation, internet, security cameras, alarm system
InventoryPlace opening order, verify delivery, count and shelf
StaffingPost jobs, interview, hire, onboard, schedule training
MarketingLocal social setup, Google Business profile, grand opening campaign
Grand OpeningSoft open, announce grand opening date, event planning
Post-Opening Follow-UpTI reimbursement claim, 30/60/90 day reviews, close-out documentation

All Reminder Types

TypeUse case
CustomOne-off reminders that don't fit other categories
TaskReminders tied to a specific task deadline
Lease DeadlineLease renewal windows, option exercise deadlines, TI claim cutoffs
HVACScheduled preventive maintenance โ€” quarterly or biannual
RentMonthly rent payment confirmations
InsuranceAnnual renewal / certificate expiry
TITenant improvement reimbursement claim deadlines
UtilityAnnual utility account reviews, rate renegotiation windows
SignagePermit renewals, lighting maintenance contracts
Gross SalesAnnual gross sales reporting due to landlord (percentage-rent leases)

Priority Definitions

PriorityDefinitionEmail cadence (default)
CriticalHard legal deadlines, rent starts, permit cutoffs โ€” missing these has financial or legal consequences30, 14, 7, 3, 1 days before
HighImportant operational milestones โ€” vendor sign-offs, staffing deadlines, opening checklist items14, 7, 3 days before
NormalStandard onboarding tasks that should be done on time but have flexibility7, 3 days before
LowNice-to-have or administrative items with low impact if delayed3 days before

Recurrence Options for Reminders

OptionInterval
NoneOne-time reminder, no recurrence
DailyEvery day
WeeklyEvery 7 days
BiweeklyEvery 14 days
MonthlyEvery calendar month (same day of month)
QuarterlyEvery 3 months
BiannualEvery 6 months
AnnualOnce per year

Environment Variables

These are pre-configured in Cloudflare Workers. Do not share or regenerate these unless there is a security incident.

VariablePurpose
RESEND_API_KEYEmail delivery via Resend API
CRON_SECRETProtects the cron endpoint from unauthorized invocation

Data is Tenant-Isolated

All data in the system is isolated by tenant_id โ€” if the system is ever shared across multiple SONAN entities, each organization's data is fully separated. All API routes enforce tenant isolation automatically via the requireAdminWithTenant() auth guard.