Skip to content

iiy9/SeansPro

BranchesTags

Repository files navigation

SeansPro Logo

SeansPro: Service Management Ecosystem

The open-core engine for appointment-based businesses, built for scale, isolation, and efficiency.

Go 1.23 React 19 PostgreSQL 16 Redis 7 License

Overview

SeansPro is a high-performance Service Management Ecosystem designed to handle the complex requirements of modern service businesses. Built with a focus on data isolation (RLS), real-time scheduling, and automated retention logic, it serves as the technical backbone for operations ranging from single-studio setups to multi-location enterprises.

Unlike generic CRM solutions, SeansPro integrates a powerful Logic Engine that proactively analyzes customer behavior, occupancy trends, and financial health to provide actionable recommendations.

Screenshots

A visual walkthrough of SeansPro's core modules.

Dashboard

Dashboard Overview Dashboard Widgets
Main Dashboard Dashboard Widgets

Appointments & Scheduling

Appointments Calendar Online Bookings
Appointments Calendar Online Bookings

Finance & POS

Finance Overview Quick Sale POS
Finance Overview Quick Sale POS

CRM & Loyalty

Customer Management Loyalty Program
Customer Management Loyalty Program
Loyalty Tiers Staff Management
Loyalty Tiers Staff Management

Analytics

Analytics Overview Analytics Deep Dive
Analytics Overview Revenue Analytics

Marketing & Reviews

Marketing Campaigns Reviews & Feedback
Marketing Campaigns Reviews & Feedback

Inventory & Rooms

Inventory Management Room Management
Inventory Management Room Management

Settings

Settings - General Settings - Advanced
Settings - General Settings - Advanced

QR Reservation & Review System

QR Reservation Step 1 QR Reservation Step 2
QR Reservation – Step 1 QR Reservation – Step 2
QR Reservation Step 3 QR Reservation Step 4
QR Reservation – Step 3 QR Reservation – Step 4
QR Review System
QR Review System

Exhaustive Feature Deep Dive

SeansPro is partitioned into several specialized modules that work in concert to automate business operations.

1. Finance & POS

A unified financial core that handles everything from rapid checkout to complex payroll.

  • Quick Sale POS: Unified interface for rapid checkout of services, products, and packages.
  • Multi-Method Payments: Support for Split payments (Cash, Card, Transfer) in one transaction.
  • Automated Daily Closings: System-generated cash-out reports with net income calculations.
  • Recurring Expense Tracking: Automated scheduling for fixed business costs (Rent, Utilities).
  • Flexible Discount Engine: Support for fixed/percentage discounts at both item and global levels.
  • Payroll & Commissions: Automatic calculation of staff earnings based on individual performance.

2. Operations & Scheduling

The engine behind smooth daily workflows and resource optimization.

  • Multi-Service Booking: Assigning multiple services to a single appointment time-slot.
  • Resource/Room Management: Capacity-aware room assignment to prevent resource conflicts.
  • Real-time Availability: Dynamic conflict checking for staff schedules and room occupancy.
  • Automatic Appointment Status: Lifecycle tracking from 'Booked' to 'No-show' or 'Paid'.

3. CRM & Loyalty

Moving beyond simple databases into proactive customer management.

  • Dynamic Loyalty Economy: Configurable point-earning rules based on customer spend.
  • Tiered VIP Management: Logic-engine powered detection of high-value customers.
  • Visit Frequency Analysis: Automatic churn risk detection for 60-day inactivity.
  • Custom Customer Profiles: Sector-ready note fields for technical/medical requirements.

4. Marketing & Retention

Automating the feedback loop and revenue growth.

  • ROI-Tracked Campaigns: Precise revenue attribution for SMS/Email marketing spends.
  • Dynamic SMS Templates: Variables-driven 1-to-1 messaging for higher engagement.
  • QR-Based Survey System: Seamless feedback collection with categorical sentiment tracking.
  • Unprocessed Feedback Loops: Routing negative reviews directly to admin for immediate action.

5. Inventory & Logistics

Scalable logistics for growing businesses.

  • State-Tracked Inventory: Quantity monitoring with low-stock threshold triggers.
  • Multi-Location Support: Distributed management of stock across unlimited branches.

Infrastructure & Security

SeansPro is engineered for enterprise-grade stability and security.

Data Security & Isolation

  • PostgreSQL RLS Isolation: Hard data separation at the database level for tenant privacy.
  • Granular RBAC: Role-based access control for Owners, Admins, and Staff.
  • Full Audit Logging: Traceability for all critical actions including price overrides.

High-Performance Stack

  • Backend: Go 1.23 + Fiber v2 for sub-millisecond API response times.
  • Frontend: React 19 + Mantine UI + Vite for a fluid, responsive administrative experience.
  • Caching: Redis 7 as a globally distributed cache and session store.
  • Rate-limiting: Global and per-instance request throttling.
  • Isolation: Docker-native deployment with optimized images.

Platform Administration

[UNDER ACTIVE DEVELOPMENT] The SaaS management layer is currently being enhanced. Features include platform-wide health monitoring, tenant quota management, and centralized tenant health oversight.

Internationalization (i18n)

SeansPro is built for the global market with architectural support for RTL and LTR languages.

  • Turkish: Full Support (Native)
  • English: Full Support (Standard)
  • Roadmap: Spanish, German, and Arabic translations are in development.

Getting Started

SeansPro supports two deployment methods: Docker Compose (recommended for quick setup) and Manual Deployment (for custom infrastructure).

Prerequisites

Component Version Purpose
Docker 24.0+ Container orchestration
Docker Compose 2.20+ Multi-service deployment
Go 1.23+ Manual backend build
Node.js 20+ Manual frontend build
PostgreSQL 16 Primary database
Redis 7 Caching & queue
MinIO Latest Object storage (images, exports)

Docker Deployment (Recommended)

The fastest way to get SeansPro running with all dependencies.

1. Clone and Configure

git clone https://github.com/seanspro/seanspro.git
cd seanspro
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env

2. Environment Variables

Edit backend/.env with your settings:

# Database
DB_HOST=postgres
DB_PORT=5432
DB_USER=seanspro
DB_PASSWORD=your-secure-password
DB_NAME=seanspro

# Redis
REDIS_HOST=redis
REDIS_PORT=6379

# MinIO (S3-compatible)
MINIO_ENDPOINT=minio:9000
MINIO_ACCESS_KEY=minioadmin
MINIO_SECRET_KEY=minioadmin
MINIO_BUCKET=seanspro
MINIO_USE_SSL=false

# Security
JWT_SECRET=your-jwt-secret-min-32-chars
APP_ADMIN_SECRET=your-admin-secret

3. Launch Stack

docker-compose up -d

4. Verify Services

Service URL Health Check
Backend API http://localhost:8080/health Returns {"status":"ok"}
Frontend http://localhost:3000 Login page loads
PostgreSQL localhost:5432 pg_isready
Redis localhost:6379 redis-cli ping
MinIO Console http://localhost:9001 Web UI login

5. Troubleshooting

# View logs
docker-compose logs -f api
docker-compose logs -f frontend

# Restart services
docker-compose restart api

# Rebuild after code changes
docker-compose build --no-cache api frontend

Manual Deployment

For custom infrastructure or development environments without Docker.

1. Backend (Go)

cd backend

# Install dependencies
go mod download

# Build binary
go build -o seanspro-api cmd/api/main.go
go build -o seanspro-worker cmd/worker/main.go

# Run migrations (ensure PostgreSQL is running)
go run cmd/migrations/main.go

# Start services
./seanspro-api
./seanspro-worker

Backend Environment Variables:

export SERVER_PORT=8080
export DB_HOST=localhost
export DB_PORT=5432
export DB_USER=seanspro
export DB_PASSWORD=your-password
export DB_NAME=seanspro
export REDIS_HOST=localhost
export REDIS_PORT=6379
export MINIO_ENDPOINT=localhost:9000
export MINIO_ACCESS_KEY=minioadmin
export MINIO_SECRET_KEY=minioadmin
export JWT_SECRET=your-32-char-secret
export APP_ADMIN_SECRET=your-admin-secret

2. Frontend (React + Vite)

cd frontend

# Install dependencies
npm install

# Start development server
npm run dev

For production build:

npm run build
# Output: dist/

Frontend Environment:

VITE_API_URL=http://localhost:8080/api/v1
VITE_APP_PLATFORM_SECRET=your-admin-secret

3. External Services Setup

Service Setup Required
PostgreSQL Create database seanspro, enable RLS extensions
Redis Enable persistence (appendonly yes)
MinIO Create bucket seanspro, set access policy

Default Ports Reference

Service Port Config Variable
Backend API 8080 SERVER_PORT
Frontend (dev) 3000 → 5173 Vite binding
PostgreSQL 5432 DB_PORT
Redis 6379 REDIS_PORT
MinIO API 9000 MINIO_ENDPOINT
MinIO Console 9001 Console port

Support & Contribution

Support the development of SeansPro!

Bitcoin (BTC) Address: bc1q6wwfq6tlv0meklhmnc9d0xkmq30gj6hrfd039z

We welcome contributions from the community. Please refer to our AUTHORS file for maintainer details and open core model specifics.

Built with passion by SeansPro Contributors. © 2026

About

A modern, scalable, platform for appointment and customer management, built for small and medium-sized businesses.

Topics

reservation crm appointment business-analytics reservation-management

Resources

Readme

License

Apache-2.0 license
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

1 tags

Sponsor this project

Packages

 
 
 

Contributors

Languages