bedelightful/delightful-service

delightful service

v0.1 2026-01-14 16:57 UTC

Requires

• php: >=8.4
• ext-bcmath: *
• ext-curl: *
• ext-fileinfo: *
• ext-openssl: *
• ext-pdo: *
• ext-redis: *
• ext-xlswriter: *
• ext-zend-opcache: *
• ext-zlib: *
• 96qbhy/hyperf-auth: ^3.1
• bedelightful/api-response: ~0.1
• bedelightful/async-event: ~0.1
• bedelightful/be-delightful-module: ^v0.0
• bedelightful/cloudfile: ~0.1
• bedelightful/easy-dingtalk: ~0.1
• bedelightful/flow-expr-engine: ~0.1
• bedelightful/php-mcp: 0.1.*
• bedelightful/rule-engine-core: ~0.1
• bedelightful/sdk-base: ~0.1
• bedelightful/task-scheduler: ~0.1
• bedelightful/tiptap: ~0.1
• doctrine/dbal: ^3.9
• dragonmantank/cron-expression: ^3.3
• facile-it/php-openid-client: ^0.3.5
• firebase/php-jwt: ^6.10
• giggsey/libphonenumber-for-php: 8.13.29
• google/protobuf: ^4.28
• hyperf/amqp: ^3.1
• hyperf/cache: ^3.1
• hyperf/constants: ~3.1
• hyperf/crontab: ~3.1.0
• hyperf/database: ~3.1.0
• hyperf/db-connection: ~3.1.0
• hyperf/engine-swow: ^2.12
• hyperf/guzzle: ~3.1.0
• hyperf/http-message: ~3.1.0
• hyperf/laminas-mime: ^3.0
• hyperf/logger: ~3.1.0
• hyperf/migration-generator: ~3.1.0
• hyperf/odin: ~0.1.0
• hyperf/phar: ~3.1.0
• hyperf/process: ~3.1.0
• hyperf/qdrant-client: ~0.0.0
• hyperf/rate-limit: ^3.1
• hyperf/redis: ~3.1.0
• hyperf/retry: ^3.1
• hyperf/snowflake: ~3.1.0
• hyperf/socketio-server: ^3.1
• hyperf/translation: ~3.1.0
• hyperf/validation: ^3.1
• hyperf/websocket-client: ^3.1
• hyperf/websocket-server: ~3.1.0
• james-heinrich/getid3: ^1.9
• jetbrains/phpstorm-attributes: ~1.2
• limingxinleo/feishu: ^4.2
• monolog/monolog: ^3.0
• overtrue/chinese-calendar: ^1.0
• phpoffice/phpspreadsheet: ^2.0
• phpoffice/phpword: ^1.0
• spomky-labs/aes-key-wrap: ^7.0
• swow/swow: ^1.5
• symfony/css-selector: ^7.1
• symfony/dom-crawler: ^7.1
• symfony/mime: ^7.1
• volcengine/volc-sdk-php: ^1.0
• w7corp/easywechat: ^6.17
• wyndow/fuzzywuzzy: ^0.6.0

Requires (Dev)

• friendsofphp/php-cs-fixer: v3.86.0
• hyperf/devtool: ~3.1.0
• hyperf/testing: ~3.1.0
• hyperf/watcher: ^3.1
• mockery/mockery: ^1.0
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^10.5
• roave/security-advisories: dev-latest
• viest/php-ext-xlswriter-ide-helper: ^1.3

Suggests

• ext-json: Required to use JSON.
• ext-pdo_mysql: Required to use MySQL Client.

MIT

• framework
• php
• middleware
• Microservice
• hyperf
• swow

README

Project Overview

Delightful Service is a high-performance PHP microservice built on the Hyperf framework and powered by the Swow coroutine engine for high concurrency. It integrates AI search, chat, file handling, access control, and other modules to provide a comprehensive service solution.

Features

• AI search: Integrates Google and other search-engine APIs for intelligent search capabilities.
• Chat system: Supports real-time communication and session management.
• File handling: Upload, download, and manage files.
• Workflow management: Configure and run workflows.
• Assistant features: Extensible assistant functionality.

Requirements

• PHP >= 8.3
• Swow extension
• Redis extension
• PDO extension
• Other extensions: bcmath, curl, fileinfo, openssl, xlswriter, zlib, etc.
• Composer

Installation & Setup

1. Clone the project

git clone https://github.com/saashqdev/delightful/delightful.git
cd delightful-service

2. Install dependencies

composer install

3. Environment configuration

Copy the sample env file and adjust as needed:

cp .env.example .env

Database migrations

php bin/hyperf.php migrate

Running the Application

Start the frontend

cd static/web && npm install && npm run dev

Start the backend

php bin/hyperf.php start

Or use the helper script:

sh start.sh

Development Guide

Project structure

• app/ application code
  • Application/ application layer
  • Domain/ domain layer
  • Infrastructure/ infrastructure layer
  • Interfaces/ interface layer
  • ErrorCode/ error code definitions
  • Listener/ event listeners
• config/ configuration files
• migrations/ database migrations
• test/ tests
• bin/ executable scripts
• static/ static assets

Code quality

Code style (PHP-CS-Fixer):

composer fix

Static analysis (PHPStan):

composer analyse

Unit tests

vendor/bin/phpunit
# or
composer test

Docker

Build the image with the provided Dockerfile:

docker build -t delightful-service .

Contributing

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

License

This project is licensed under the MIT License. See the LICENSE file for details.