Skip to main content

Welcome to Soft-Bee API

Soft-Bee is a comprehensive REST API designed for beekeeping management systems. Built with Clean Architecture and Domain-Driven Design principles, it provides a robust foundation for managing apiaries, hives, production tracking, inventory, and inspections.

Key Features

Clean Architecture

Built with DDD principles, ensuring maintainable and scalable code

JWT Authentication

Secure user authentication and authorization with JWT tokens

PostgreSQL Database

Reliable data storage with SQLAlchemy ORM

Modular Design

Feature-based architecture for easy extensibility

What You Can Build

Soft-Bee API enables you to build comprehensive beekeeping management applications:
  • User Management: Secure registration, authentication, and profile management
  • Apiary Monitoring: Track hive health, production, and environmental conditions
  • Production Tracking: Monitor honey production, harvest schedules, and yields
  • Inventory Management: Manage equipment, supplies, and product inventory
  • Inspection Records: Document hive inspections and maintenance activities

Architecture Highlights

The API follows Clean Architecture with three distinct layers:
1

Domain Layer

Core business logic with entities, value objects, and domain events
2

Application Layer

Use cases, DTOs, and interfaces that orchestrate business logic
3

Infrastructure Layer

Database models, repositories, and external service implementations

Get Started

Start building with Soft-Bee API in minutes

API Reference

Explore authentication endpoints

Architecture Guide

Learn about the system architecture

Development Setup

Set up your local development environment

Technology Stack

  • Framework: Flask 3.1.1
  • Database: PostgreSQL with SQLAlchemy 2.0
  • Authentication: JWT with python-jose
  • Password Hashing: bcrypt
  • Dependency Injection: dependency-injector
  • Validation: Pydantic 2.11
Soft-Bee API is designed to optimize beekeeping operations and improve sustainability and productivity in apiaries.

Build docs developers (and LLMs) love