A modern Telegram bot for booking sports courts and facilities. Built with TypeScript, Telegraf, and Prisma ORM.

• Interactive Court Booking: Users can browse available courts and book time slots
• Smart Time Management: Configurable booking windows and slot durations
• User Management: Automatic user registration and access control
• Booking History: Users can view their past and upcoming bookings
• Multi-language Support: Built-in internationalization support
• Real-time Availability: Check court availability in real-time
• Notifications:: Receive notifications about upcoming bookings

The bot follows a modular architecture with clear separation of concerns:

• Handlers: Telegram command and callback handlers
• Services: Business logic layer
• Middlewares: Request processing and validation
• Formatters: Message formatting utilities
• Exceptions: Custom error handling

• Telegram ID and username tracking
• Access control and restrictions
• Booking history
• Notification Preferences

• Court information and availability
• Configurable booking rules

• Time slot reservations
• User and court relationships
• Booking status tracking

1. Clone the repository

   git clone https://github.com/artemind/court-booking-tg-bot.git
   cd court-booking-tg-bot

2. Set up environment variables

   cp .env.example .env
   # Edit .env with your configuration

3. Install dependencies

   docker-compose run --rm node npm install

4. Set up the database

   npm run db:setup

5. Start the development server

   docker-compose run --rm node npm run dev

• Node.js 18+
• PostgreSQL database
• Telegram Bot Token (from @BotFather)

npm run dev          # Start development server with hot reload
npm run build        # Build the project
npm run start        # Start production server
npm run lint         # Run ESLint
npm run lint:fix     # Fix ESLint issues

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE.md file for details.

See CHANGELOG.md for a list of changes and version history.

Run the published image directly (the entrypoint assembles DATABASE_URL from parts):

docker run -d \
  --name courtbot \
  -e BOT_TOKEN="your_telegram_bot_token" \
  -e DATABASE_HOST="postgres" \
  -e DATABASE_PORT="5432" \
  -e DATABASE_NAME="courtbot" \
  -e DATABASE_USER="postgres" \
  -e DATABASE_PASSWORD="password" \
  -e APP_LOCALE="en" \
  -e APP_TIMEZONE="UTC" \
  artemind/court-booking-tg-bot:latest

Notes:

• The container applies Prisma migrations on startup; ensure the database is reachable.
• Override :latest with a specific tag (e.g., :v1.0.0) for reproducible deployments.

Artem Yeremenko

• Website: artemind.dev
• GitHub: @artemind