Maria Bookings Standard och Pro installation användarguide

Maria Bookings App - Programvara för tidsbokning online

Installera och hantera Maria Bookings Standard och Pro med setup, bokningsflöden, adminverktyg, e-post, platser, roller och support.

Maria Bookings är en webbaserad bokningsapplikation för tjänsteföretag. Den innehåller en publik bokningssida, en sida för hantering av bokningar, en adminpanel, hantering av tjänster och personal, e-postaviseringar, bokningsregler, flerspråkiga inställningar och hantering av kundbokningar.

Den här guiden täcker både Maria Bookings Standard och Maria Bookings Pro.

1. Översikt över utgåvor

Maria Bookings Standard

Maria Bookings Standard är utformad för ett enskilt företag eller en enskild filial. Den innehåller grundläggande bokningssystem och alla nödvändiga adminverktyg.

Publik bokningssida
Sida för hantering av kundbokningar
Adminpanel
Bokningshantering
Klienthantering
Tjänstehantering
Personal-/leverantörshantering
Personalscheman och ledighet
E-postaviseringar och mallar
Bokningsregler
Varumärke och färger
Språk- och valutainställningar
Aktivitetsloggar
Användarkonton och rollbaserad åtkomst
Stöd för botskydd
Stöd för kalenderflöden

Maria Bookings Pro

Maria Bookings Pro innehåller allt i Standard och lägger till funktioner för flera platser för växande företag med flera filialer eller platsansvariga.

Allt som ingår i Standard
Flera platser
Platsbaserat bokningsflöde
Platsspecifika tjänster
Platsspecifik personaltilldelning
Roll som platsansvarig (Manager)
Åtkomst för platsansvariga begränsad till tilldelad plats
Prestationsstatistik per plats
Upptäckt av bokningsproblem vid ofullständig konfiguration av plats/tjänst/personal
Platsmedveten publik bokning och adminhantering

2. Krav

Node.js 22 LTS eller senare
npm
En värdmiljö som kan köra en Node.js-applikation
En databas som stöds: SQLite, PostgreSQL, MySQL eller MariaDB
En domän eller subdomän för produktionsanvändning
Autentiseringsuppgifter för e-postleverantör om e-postaviseringar krävs

Databaser som stöds

SQLite: Lämplig endast för lokal utveckling eller VPS-hosting.
PostgreSQL: Rekommenderas för Vercel, Neon, Supabase, Railway och Render.
MySQL/MariaDB: Lämplig för Railway, PlanetScale, VPS och andra MySQL-kompatibla värdar.

Viktigt: SQLite bör inte användas på Vercel eftersom Vercel använder ett flyktigt filsystem. Använd PostgreSQL för Vercel-driftsättningar.

3. Paketfiler

Efter köp eller bygge innehåller applikationspaketet de körfiler som krävs för att köra Maria Bookings.

Standardpaket

maria-bookings/

Pro-paket

maria-bookings-pro/

Använd det paket som matchar din licens. Standard och Pro är separata byggen. Pro är inte en låst eller avaktiverad version av Standard, utan innehåller ytterligare funktioner för platser och platsansvariga.

4. Installation

Steg 1: Ladda upp applikationen

Ladda upp Maria Bookings-paketet till din server eller värdplattform.

För Standard, ladda upp:

maria-bookings

För Pro, ladda upp:

maria-bookings-pro

Steg 2: Installera beroenden

Öppna en terminal i applikationsmappen och kör:

npm install --omit=dev

Steg 3: Skapa miljövariabler

Skapa en .env-fil eller lägg till miljövariabler i din värdpanel.

Obligatoriska variabler

PORT=3000
NODE_ENV=production
JWT_SECRET=your-long-random-jwt-secret
SETUP_SECRET=your-long-random-setup-secret

JWT_SECRET används för admins inloggningssessioner. Använd ett starkt slumpmässigt värde på minst 32 tecken.

SETUP_SECRET skyddar installationsguiden. Du måste ange samma värde under installationen.

Exempel för SQLite

DB_TYPE=sqlite
DB_PATH=./data/appointments.db

Använd SQLite endast för lokal utveckling eller VPS-hosting.

Exempel för PostgreSQL

DB_TYPE=postgres
DATABASE_URL=postgresql://user:password@host:5432/dbname?sslmode=require

PostgreSQL rekommenderas för Vercel, Neon, Supabase, Railway och Render.

Exempel för MySQL/MariaDB

DB_TYPE=mysql
DATABASE_URL=mysql://user:password@host:3306/dbname

Inställning för omvänd proxy

Om appen körs bakom Nginx, Cloudflare, Railway, Render, Vercel eller en annan proxy, ange:

TRUST_PROXY=1

Om appen inte körs bakom en proxy, ange:

TRUST_PROXY=0

Steg 4: Starta applikationen

Kör:

npm start

Som standard körs appen på:

http://localhost:3000

Steg 5: Öppna installationsguiden

Besök:

/setup.html

Exempel:

https://yourdomain.com/setup.html

Steg 6: Slutför installationen

Installationsguiden leder dig genom:

Val eller bekräftelse av databastyp
Ange installationshemligheten (setup secret)
Testa databasanslutningen
Skapa administratörskontot
Ange företagsnamnet
Välja administratörsspråk

Administratörslösenord måste vara starka och innehålla:

Minst 10 tecken
Minst en versal
Minst en gemen
Minst en siffra
Minst ett specialtecken

När installationen är slutförd låses installationssidan och appen omdirigerar användare till adminpanelen.

5. Huvudsakliga applikations-URL:er

Publik webbplats: /
Bokningssida: /booking.html
Sida för hantering av bokning: /manage.html
Adminpanel: /admin
Installationsguide: /setup.html

6. Översikt över adminpanelen

Adminpanelen är där företagsägare och behöriga användare hanterar bokningssystemet.

Instrumentpanel

Instrumentpanelen visar bokningsaktivitet, kommande bokningar, senaste bokningar, totalt antal bokningar, aktiv personal, aktiva tjänster och klienter.

Statistik

Statistikområdet tillhandahåller rapporter för bokningar, intäkter, bokningsstatus, avslutade bokningar, väntande bokningar och personalprestation.

I Pro kan statistiken även innehålla platsbaserad prestation.

Bokningar

Använd Bokningar för att visa, söka, filtrera, redigera, bekräfta, slutföra, avboka eller ta bort bokningar.

Bokningsstatusar inkluderar:

Väntande
Bekräftad
Avslutad
Avbokad
Uteblivet besök

Klienter

Använd Klienter för att visa kundregister, söka på namn, e-post eller telefon, och granska bokningshistorik.

Tjänster

Använd Tjänster för att skapa och hantera bokningsbara tjänster.

Varje tjänst kan innehålla:

Namn
Beskrivning
Varaktighet
Pris
Kategori
Sorteringsordning
Aktiv eller inaktiv status

Personal

Använd Personal för att hantera tjänsteleverantörer, teammedlemmar, scheman, tjänstetilldelningar, profilbilder och ledighet.

Varje personalmedlem kan innehålla:

Namn
Titel
Biografi
Foto
E-post
Telefon
Tilldelade tjänster
Veckoschema
Ledighet

E-postmallar

Använd E-postmallar för att anpassa ämnesrad och innehåll i aviseringsmejl.

Typer av mallar som stöds inkluderar:

E-post om ny bokning till kund
E-post om ny bokning till leverantör
E-post om ny bokning till administratör
E-post om bekräftad bokning till kund
E-post om avbokning till kund
E-post om avbokning till leverantör
E-post om avbokning till administratör
Påminnelsemejl till kund
Påminnelsemejl till leverantör

Inställningar

Använd Inställningar för att konfigurera företagsidentitet, publika bokningsregler, språk, valuta, varumärke, e-postleverans, botskydd, SEO och systembeteende.

Aktivitetsloggar

Aktivitetsloggar registrerar viktiga administratörsåtgärder. Loggar kan aktiveras eller inaktiveras, och lagringstid kan konfigureras.

Användare

Använd Användare för att hantera inloggningskonton för administratörer och personal.

Administratörer har full åtkomst. Personalanvändare kan begränsas till specifika områden och behörigheter.

7. Pro-funktioner

Platser

Maria Bookings Pro lägger till en sektion för Platser. Använd den för att skapa och hantera filialer eller verksamhetsplatser.

Varje plats kan innehålla:

Namn
Slug
Adress
Tidszon
Status

Platsbaserad bokning

I Pro innehåller det publika bokningsflödet ett platssteg. Kunder väljer en plats innan de väljer tjänst, personal, datum och tid.

Platstjänster

Tjänster kan vara organisationsövergripande eller platsspecifika.

Organisationstjänster: Delas mellan platser.
Platstjänster: Tillgängliga endast vid en specifik filial.

Platsansvariga (Managers)

Maria Bookings Pro innehåller rollen platsansvarig (Manager). Platsansvariga kan tilldelas en plats och kan endast hantera data som är tillåten för den platsen.

Beroende på administratörsinställningar kan platsansvariga tillåtas skapa, redigera eller ta bort tjänster för sin egen plats.

Bokningsproblem

Pro innehåller upptäckt av bokningsproblem för att hjälpa administratörer att hitta konfigurationsproblem som kan dölja tjänster från publik bokning.

Exempel på bokningsproblem inkluderar:

En plats saknar personal
En plats saknar tjänster
En tjänst saknar tilldelad personal
En organisationstjänst är inte bokningsbar på någon plats
En tjänst är endast bokningsbar på vissa platser

8. Publikt bokningsflöde

Standardbokningsflöde

Kunden öppnar /booking.html
Kunden väljer en tjänst
Kunden väljer en personalmedlem eller första tillgängliga leverantör
Kunden väljer ett datum och en tillgänglig tid
Kunden anger namn, e-post, telefon och anteckningar
Kunden granskar bokningen
Kunden bekräftar bokningen
Appen visar en referenskod

Pro-bokningsflöde

Kunden öppnar /booking.html
Kunden väljer en plats
Kunden väljer en tjänst som är tillgänglig på den platsen
Kunden väljer en personalmedlem eller första tillgängliga leverantör
Kunden väljer ett datum och en tillgänglig tid
Kunden anger namn, e-post, telefon och anteckningar
Kunden granskar bokningen
Kunden bekräftar bokningen
Appen visar en referenskod

Nya bokningar skapas som väntande som standard. Administratörer eller leverantörer kan bekräfta dem från adminpanelen eller via bekräftelselänkar i e-post om e-postaviseringar är aktiverade.

9. Hantera en bokning som kund

Kunder kan hantera sin egen bokning från:

/manage.html

För att hitta en bokning anger kunden referenskoden som visades efter bokningen.

För att avboka en bokning kan kunden behöva verifiera med hjälp av den fullständiga e-postadressen eller telefonnumret som användes vid bokningen.

Avslutade bokningar kan inte avbokas online.

10. Bokningsregler

Bokningsregler hanteras från Admin > Inställningar.

Tillgängliga bokningsinställningar inkluderar:

Företagets tidszon
Organisationens öppettider
Tidsintervall i minuter
Minsta varsel i timmar
Maximalt antal dagar framåt
Om telefonnummer krävs
Etikett för personal som visas i bokningsformuläret
Om kunder kan välja leverantör
Inställningar för e-postaviseringar
Inställningar för påminnelsemejl

Personalscheman kan åsidosätta organisationens allmänna öppettider. Ledighet kan läggas till för enskilda personalmedlemmar.

11. E-postkonfiguration

Maria Bookings stöder flera e-postleverantörer.

E-postleverantörer som stöds

SMTP
Resend
SendGrid
Amazon SES
Mailgun
Postmark
Webhook

SMTP-exempel

MAIL_PROVIDER=smtp
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=your-smtp-user
SMTP_PASS=your-smtp-password
SMTP_FROM=Appointments <noreply@yourdomain.com>

Resend-exempel

MAIL_PROVIDER=resend
RESEND_API_KEY=re_xxxxxxxx
MAIL_FROM=Appointments <noreply@yourdomain.com>

SendGrid-exempel

MAIL_PROVIDER=sendgrid
SENDGRID_API_KEY=SG.xxxxxxxx
MAIL_FROM=Appointments <noreply@yourdomain.com>

Amazon SES-exempel

MAIL_PROVIDER=ses
AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-key
AWS_REGION=eu-north-1
MAIL_FROM=noreply@yourdomain.com

Mailgun-exempel

MAIL_PROVIDER=mailgun
MAILGUN_API_KEY=key-xxxxxxxx
MAILGUN_DOMAIN=mg.yourdomain.com
MAILGUN_API_BASE=https://api.mailgun.net
MAIL_FROM=Appointments <noreply@yourdomain.com>

Postmark-exempel

MAIL_PROVIDER=postmark
POSTMARK_SERVER_TOKEN=xxxxxxxx
POSTMARK_MESSAGE_STREAM=outbound
MAIL_FROM=Appointments <noreply@yourdomain.com>

Webhook-exempel

MAIL_PROVIDER=webhook
MAIL_WEBHOOK_URL=https://your-endpoint.example/hooks/mail
MAIL_WEBHOOK_SECRET=optional-bearer-token
MAIL_FROM=Appointments <noreply@yourdomain.com>

Efter att ha ändrat miljövariabler för e-post, starta om applikationen. Gå sedan till Admin > Inställningar > E-postleverans och skicka ett testmejl.

12. Påminnelsemejl

Maria Bookings kan skicka påminnelsemejl innan bokade tider.

Påminnelser som stöds inkluderar:

24-timmars påminnelsemejl
1-timmes påminnelsemejl
Valfria påminnelsemejl till leverantör

På en VPS körs påminnelser automatiskt medan appen är igång.

På Vercel eller serverlös hosting, konfigurera en cron-begäran till:

/api/internal/reminders

Ange en cron-hemlighet i miljön:

CRON_SECRET=your-long-random-cron-secret

13. Botskydd

Maria Bookings stöder botskydd för publika bokningsformulär och kontaktformulär.

Leverantörer som stöds

Cloudflare Turnstile
hCaptcha
Google reCAPTCHA v2

Miljövariabler

TURNSTILE_SECRET_KEY=your-secret-key
HCAPTCHA_SECRET_KEY=your-secret-key
RECAPTCHA_SECRET_KEY=your-secret-key

Webbplatsnycklar kan anges i Admin > Inställningar > Botskydd. Hemliga nycklar ska förbli i servermiljön och inte exponeras offentligt.

14. Språk och valuta

Maria Bookings innehåller flerspråkigt stöd för adminpanelen, den publika bokningssidan, sidan för hantering av bokningar, den publika portalen och e-postmallar.

Språkinställningar finns i Admin > Inställningar > Språk & valuta.

Administratörsspråk: Används för adminpanelen och e-post till administratörer/personal.
Publikt webbplatsspråk: Används för publik bokning, hantering av bokning, publik portal och kunde-post.
Valutasymbol: Används för tjänstepriser och sammanfattningar vid publik bokning.

15. Varumärke och SEO

Inställningar för varumärke finns i Admin > Inställningar.

Du kan konfigurera:

Företagsnamn
Slogan eller beskrivning
Adress
Logotyp-URL
Primärfärg
Accentfärg
Synlighet för "levereras av"-attribution
Kanonisk webbplats-URL
SEO-titel
SEO-beskrivning
SEO-nyckelord

Appen tillhandahåller även publika upptäcktsfiler såsom robots- och sitemap-slutpunkter.

16. Användarroller och behörigheter

Administratör

Administratörer har full åtkomst till alla inställningar, användare, loggar, tjänster, personal, klienter och bokningar.

Personal

Personalkonton kan kopplas till personal-/leverantörsprofiler. Personalanvändare kan begränsas till sina egna bokningar och begränsade adminmenyer.

Platsansvarig (Manager)

Rollen platsansvarig finns tillgänglig i Pro. Platsansvariga kan tilldelas en plats och begränsas till platsspecifika åtgärder.

17. Kalenderflöden

Personalmedlemmar kan ha privata URL:er för kalenderprenumeration. Dessa gör det möjligt att visa bokningar i kompatibla kalenderapplikationer.

Administratörer kan generera om en kalender-URL om en gammal länk inte längre bör användas.

18. Rekommenderad checklista för förstagångsinstallation

Installera beroenden.
Konfigurera miljövariabler.
Starta appen.
Öppna /setup.html.
Testa databasanslutningen.
Skapa administratörskontot.
Öppna adminpanelen.
Uppdatera företagsidentitet och varumärke.
Ange tidszon, språk och valuta.
Lägg till tjänster.
Lägg till personalmedlemmar.
Tilldela tjänster till personal.
Ange personalscheman.
Konfigurera e-postleverans.
Skicka ett testmejl.
Testa en publik bokning.
Bekräfta, slutför och avboka en testbokning.

Ytterligare checklista för Pro

Lägg till platser.
Tilldela personal till platser.
Skapa organisationsövergripande eller platsspecifika tjänster.
Tilldela tjänster till personal på varje plats.
Granska bokningsproblem.
Testa det publika bokningsflödet för varje plats.
Skapa platsansvarigkonton vid behov.
Verifiera åtkomstbegränsningar för platsansvariga.

19. Uppdatera Maria Bookings

Säkerhetskopiera applikationsfilerna.
Säkerhetskopiera databasen.
Ladda upp det nya Standard- eller Pro-paketet.
Behåll dina befintliga .env-värden.
Kör npm install --omit=dev om beroenden har ändrats.
Starta om applikationen.
Öppna adminpanelen och bekräfta att instrumentpanelen laddas.
Testa en bokning från den publika bokningssidan.

Ersätt inte en Pro-installation med Standard-paketet om du inte medvetet vill ta bort Pro-funktionaliteten.

20. Felsökning

Appen startar inte

Bekräfta att Node.js 22 LTS eller senare är installerat.
Bekräfta att npm install --omit=dev slutfördes utan fel.
Bekräfta att nödvändiga miljövariabler är inställda.
Kontrollera serverloggarna för saknade databas- eller e-postinställningar.

Installationen meddelar att databasanslutningen misslyckades

Kontrollera DB_TYPE.
Kontrollera DATABASE_URL eller DB_PATH.
Bekräfta att databasservern är nåbar från din värdplattform.
För PostgreSQL, bekräfta SSL-inställningar som krävs av din leverantör.

Installationshemligheten avvisas

Bekräfta att värdet som angetts i installationsguiden exakt matchar SETUP_SECRET.
Starta om applikationen efter att ha ändrat miljövariabler.

E-post skickas inte

Bekräfta att MAIL_PROVIDER är korrekt inställd.
Bekräfta att alla nödvändiga leverantörsuppgifter finns.
Starta om applikationen efter att ha ändrat e-postvariabler.
Använd Admin > Inställningar > E-postleverans för att skicka ett testmejl.

Inga tider visas

Bekräfta att tjänsten är aktiv.
Bekräfta att personalmedlemmen är aktiv.
Bekräfta att personalmedlemmen är tilldelad den valda tjänsten.
Bekräfta att personalschemat inkluderar den valda dagen.
Bekräfta att datumet ligger inom bokningsfönstret för maximalt antal dagar framåt.
Bekräfta att reglerna för minsta varsel inte blockerar tiden.
I Pro, bekräfta att platsen har personal och bokningsbara tjänster.

Kunder kan inte avboka bokningar

Bekräfta att bokningens referenskod är korrekt.
Bekräfta att kunden använder den fullständiga bokningse-posten eller telefonnumret för verifiering.
Bekräfta att bokningen inte redan är avslutad.

Pro-platstjänster döljs från bokning

Öppna Bokningsproblem i adminpanelen.
Bekräfta att platsen är aktiv.
Bekräfta att tjänsten är aktiv.
Bekräfta att personal är tilldelad den platsen.
Bekräfta att personal är kopplad till tjänsten.

21. Säkerhetsrekommendationer

Använd starka slumpmässiga värden för JWT_SECRET, SETUP_SECRET och CRON_SECRET.
Använd HTTPS i produktion.
Håll databasuppgifter privata.
Exponera inte .env-filen offentligt.
Använd betrodda e-postleverantörsuppgifter.
Aktivera botskydd för publika formulär om spam blir ett problem.
Ge personal och platsansvariga endast de behörigheter de behöver.
Generera om kalenderflödes-URL:er om en privat länk delas av misstag.
Säkerhetskopiera databasen innan uppdateringar.

22. Support

För support, kontakta Maria Stella Tech:

contact@mariastellatech.com