Product Overview — Membership One
What is Membership One?
Membership One is a cloud-based SaaS platform for managing sports clubs, fitness studios, and similar membership-based organizations. It provides a single integrated solution for member administration, contract management, billing, resource booking, event planning, communication, and access control.
Software Packages
Membership One is organized into 11 software packages:
Package 1: MEMBER (v1.0)
Core member lifecycle management — profiles, family linking, age groups, custom attributes, search, GDPR compliance, audit trail.
Package 2: CONTRACT (v1.0)
Contract and membership lifecycle — templates, trial memberships, online registration, installment plans, cancellation with notice periods, credit notes, invoice cancellation (Storno).
Package 3: BILLING (v1.0)
Financial operations — fee structures, billing runs, SEPA export, VAT configuration, pro-rata billing, payment tracking. Integrated with My-Factura/Cash360 for payment processing.
Package 4: MOBILE (v1.0)
Cross-platform mobile app (Flutter) — member self-service, digital membership card, QR code check-in, push notifications, event registration.
Package 5: LANDING PAGE (v1.0)
Public-facing pages — landing page builder per membership plan, online registration forms, SEO optimization, custom branding, subdomain support.
Package 6: ACCESS CONTROL (v2.0)
Check-in and physical access — QR code, NFC, BLE, OSDP/Gantner terminal integration, zone-based access rules, real-time monitoring.
Package 7: RESOURCE (v2.0)
Resource and booking management — rooms, courts, equipment, personnel scheduling, capacity management, conflict detection, utilization analytics.
Package 8: COMMUNICATION (v3.0)
Multi-channel communication — email templates, push notifications, newsletter, bulk messaging, event-triggered automation, template management.
Package 9: EXECUTIVE DASHBOARDS (v2.0)
Management reporting — KPI dashboards, revenue analytics, member growth trends, churn analysis, franchise benchmarking.
Package 10: CRM / SALES (v2.0)
Sales pipeline management — lead tracking, deal stages, activity logging, conversion analytics, pipeline reports.
Package 11: SUPPORT / TICKETING (v2.0)
Customer support — ticket management, SLA tracking, knowledge base, CSAT surveys, agent assignment.
Architecture
Backend
- Java 25 / Spring Boot 4.0.2 modular monolith
- 17 Maven modules with clean domain boundaries
- PostgreSQL 18 with Flyway migrations
- Redis 7 for caching and rate limiting
- RabbitMQ 4 for async messaging
- REST API-first with OpenAPI/Swagger documentation
Frontend
- Flutter 3.41.2 cross-platform app (Android, iOS, Web)
- Riverpod state management, GoRouter navigation
- Freezed immutable models, Dio HTTP client
- Material Design 3 with custom design system
Infrastructure
- Hetzner Cloud (production)
- Kubernetes with Helm charts
- GitLab CI/CD pipeline
- Docker containerization
- Prometheus + Grafana monitoring
User Roles
| Role | Level | Access |
|---|---|---|
| Super Admin | Platform | Full platform access across all tenants |
| Entity Admin | Organization | Full access to own organization |
| Entity Manager | Organization | Operational management (no billing/settings) |
| Entity Staff | Organization | Day-to-day operations (members, check-in) |
| Trainer | Organization | Own schedule, attendance, member notes |
| Member | Self-service | Own profile, contracts, bookings, check-in |
| Franchise Admin | Franchise | Cross-organization management |
| Franchise Director | Franchise | Reports, benchmarking, template management |
| Vendor (various) | External | Limited access for cleaning, maintenance, etc. |
Integration Points
| Integration | Purpose | Method |
|---|---|---|
| My-Factura | Invoicing, billing cycles | REST API (API_KEY auth) |
| Cash360/CashControl | SEPA direct debit, debt collection | Via My-Factura |
| DATEV | Accounting export | CSV/XML export |
| Gantner Essecca | Access control terminals | OSDP protocol |
| iCal | Calendar sync | iCal feed export |
| Hetzner Cloud | Infrastructure | Kubernetes API |
Multilingual Support
32 languages from v1.0: - 24 EU official languages: Bulgarian, Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, German, Greek, Hungarian, Irish, Italian, Latvian, Lithuanian, Maltese, Polish, Portuguese, Romanian, Slovak, Slovenian, Spanish, Swedish - 8 non-EU priority languages: Turkish, Arabic (RTL), Russian, Ukrainian, Serbian, Albanian, Chinese Simplified, Hebrew (RTL)
Security & Compliance
- GDPR compliant (data portability, right to erasure, consent tracking, DPA)
- eIDAS compatible digital signatures
- RS256 JWT authentication (asymmetric keys)
- bcrypt password hashing (cost factor 12)
- CORS explicit origin whitelist
- Optimistic locking on all entities
- BigDecimal for all monetary values
- Audit trail on all business entities
Roadmap Summary
| Phase | Focus | Key Deliverables |
|---|---|---|
| 0 | Project Setup | Maven project, Flutter app, Docker, i18n, CI/CD |
| 1 | Core Backend | Auth, Organization, Member, Contract, Product entities + APIs |
| 2 | Payment & Billing | My-Factura integration, billing engine, SEPA |
| 3 | Consumer Mobile App | Flutter features, QR membership card, self-service |
| 4 | Admin Web App | Dashboard, member management, contract admin |
| 5 | Access Control | QR/NFC/BLE check-in, zone management, Gantner |
| 6 | Communication | Email/push templates, bulk messaging, automation |
| 7 | Document & Import | PDF generation, CSV import, mapping engine |
| 8 | CRM, Support, Accounting | Sales pipeline, ticketing, DATEV export |
| 9 | Trainer, Shop, Franchise | Trainer tools, simple shop, franchise config |
| 10 | Testing & Quality | E2E tests, performance baseline, security scan |
| 11 | Launch Preparation | Migration, Helm charts, staging, go-live checklist |
| 12 | Startup Operations | GmbH formation, infrastructure, marketing, team |
| 13 | Customer Onboarding | Provisioning, wizard, migration, health scoring |