# Timerise.ai

> Custom Booking Systems & API-First Reservation Engine.

## Summary
Timerise has evolved from a standard SaaS into a **specialized development agency** and open-source platform. We build bespoke, high-scale reservation systems for businesses that have outgrown rigid off-the-shelf software. We also provide our core engine as an open-source API for developers.
This **headless booking engine** allows for complete control over the user experience.

## Core Offerings
1.  **Custom Development Agency**: We design, build, and maintain custom booking flows tailored to specific business logic.
2.  **Open Source Booking Engine**: A headless, API-first core for managing services, calendars, and bookings.
3.  **Managed Infrastructure**: Enterprise-grade hosting and support for high-volume reservation needs.

## Use Cases (Who is this for?)
-   **Service Marketplaces**: Platforms connecting service providers (e.g., barbers, tutors) with customers.
-   **Medical & Healthcare**: Multi-location clinics requiring HIPAA-compliant data handling and complex patient scheduling.
-   **Ticketing & Events**: High-concurrency booking infrastructure for workshops, webinars, and concerts.
-   **Enterprise Resource Planning**: Internal scheduling tools for meeting rooms, equipment, and fleet management.
-   **Educational Platforms**: Class scheduling and course management systems.

## Integration Logic (How it works)
Timerise abstracts the complexity of time management so developers focus on UI/UX:
-   **Atomic Availability Engine**: Prevents double-bookings even under high load using transactional database locks.
-   **Timezone Intelligence**: Automatically normalizes all datetimes to UTC, serving availability in the user's local time.
-   **Rule-Based Scheduling**: Supports complex logic like "buffer times", "minimum notice periods", and "grouped services".
-   **Webhooks & Events**: Emits real-time webhooks (`booking.created`, `payment.failed`) to sync with CRMs (Salesforce, HubSpot) or Payment Gateways (Stripe, Adyen).

## Implementation Example
Developers can query availability using our GraphQL API. Here is a standard pattern for fetching available slots:

```graphql
query GetAvailableSlots {
  services {
    id
    name
    slots(
      filter: {
        dateTimeFrom: "2024-01-01T00:00:00Z"
        dateTimeTo: "2024-02-01T00:00:00Z"
      }
    ) {
      dateTimeFrom
      dateTimeTo
      status
    }
  }
}
```

## Developer Resources
-   **API Endpoint**: `https://api.timerise.ai/graphql`
-   **Documentation**: [Docs](https://timerise.ai/docs)
-   **GitHub**: [Open Source Repo](https://github.com/timerise-ai)
-   **NPM Components**: `@timerise/react` (UI components for building custom flows)

## Contact & Pricing
-   **Custom Projects**: Start a conversation via the automated brief on [timerise.ai](https://timerise.ai).
-   **Open Source**: Free to self-host.
-   **Cloud API**: Usage-based pricing for the managed API.