backend-systems 1.0.0__py3-none-any.whl

backend_systems-1.0.0.dist-info/METADATA

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: backend-systems
+Version: 1.0.0
+Summary: ERP-style backend with DDD and Clean Architecture
+Author-email: Engineering Team <team@example.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.109.0
+Requires-Dist: uvicorn[standard]>=0.27.0
+Requires-Dist: sqlalchemy>=2.0.25
+Requires-Dist: alembic>=1.13.1
+Requires-Dist: psycopg2-binary>=2.9.9
+Requires-Dist: pydantic>=2.5.3
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: python-jose[cryptography]>=3.3.0
+Requires-Dist: passlib[bcrypt]>=1.7.4
+Requires-Dist: python-multipart>=0.0.6
+Requires-Dist: httpx>=0.26.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.4; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.3; extra == "dev"
+Requires-Dist: httpx>=0.26.0; extra == "dev"
+Requires-Dist: black>=24.1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.14; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+
+# 01_backend_systems - ERP-Style Backend
+
+> Production-grade ERP backend demonstrating Domain-Driven Design, Clean Architecture, and enterprise patterns.
+
+## 🎯 Overview
+
+This module implements a comprehensive ERP-style backend with:
+
+- **Domain-Driven Design (DDD)** - Entities, Value Objects, Aggregates
+- **Clean Architecture** - Layered separation of concerns
+- **RBAC** - Role-based access control
+- **RESTful APIs** - OpenAPI 3.0 documented
+- **PostgreSQL** - With Alembic migrations
+
+## 📁 Structure
+
+```
+01_backend_systems/
+├── src/
+│   ├── domain/           # Business logic & entities
+│   │   ├── entities/     # Core domain models
+│   │   └── value_objects/# Immutable value types
+│   ├── application/      # Use cases & services
+│   │   └── services/     # Application services
+│   ├── infrastructure/   # External concerns
+│   │   ├── database/     # DB connection & session
+│   │   └── repositories/ # Data access layer
+│   └── presentation/     # API layer
+│       ├── routes/       # API endpoints
+│       └── schemas/      # Pydantic models
+├── alembic/              # Database migrations
+├── tests/                # Unit & integration tests
+└── example_data/         # Sample data for testing
+```
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- Python 3.11+
+- PostgreSQL 14+ (or use SQLite for development)
+
+### Installation
+
+```bash
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # or `venv\Scripts\activate` on Windows
+
+# Install dependencies
+pip install -e .
+
+# Set environment variables
+cp .env.example .env
+# Edit .env with your database credentials
+
+# Run migrations
+alembic upgrade head
+
+# Start the server
+uvicorn src.main:app --reload --port 8000
+```
+
+### API Documentation
+
+Once running, visit:
+
+- Swagger UI: <http://localhost:8000/docs>
+- ReDoc: <http://localhost:8000/redoc>
+
+## 🏗️ Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     PRESENTATION LAYER                      │
+│  (FastAPI Routes, Pydantic Schemas, Request/Response DTOs)  │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│                     APPLICATION LAYER                       │
+│     (Use Cases, Application Services, Business Logic)       │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│                       DOMAIN LAYER                          │
+│   (Entities, Value Objects, Domain Services, Aggregates)    │
+└─────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────┐
+│                   INFRASTRUCTURE LAYER                      │
+│    (Repositories, Database, External APIs, Messaging)       │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 📋 Domain Model
+
+The ERP system manages:
+
+- **Organizations** - Multi-tenant company management
+- **Users** - Authentication and authorization
+- **Inventory** - Product and stock management
+- **Orders** - Sales order processing
+- **Invoices** - Billing and payment tracking
+
+## 🔒 RBAC Roles
+
+| Role | Permissions |
+|------|-------------|
+| `admin` | Full system access |
+| `manager` | Read/write on assigned resources |
+| `operator` | Limited write access |
+| `viewer` | Read-only access |
+
+## 🧪 Testing
+
+```bash
+# Run all tests
+pytest tests/
+
+# Run with coverage
+pytest tests/ --cov=src --cov-report=html
+
+# Run specific test file
+pytest tests/unit/test_entities.py -v
+```
+
+## 📊 API Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| POST | `/api/v1/auth/login` | Authenticate user |
+| GET | `/api/v1/users` | List users |
+| POST | `/api/v1/orders` | Create order |
+| GET | `/api/v1/inventory` | List inventory |
+| GET | `/health` | Health check |
+
+## 🔧 Configuration
+
+Environment variables (`.env`):
+
+```env
+DATABASE_URL=postgresql://user:pass@localhost:5432/erp_db
+SECRET_KEY=your-secret-key-here
+DEBUG=true
+ALLOWED_HOSTS=localhost,127.0.0.1
+```
+
+## 📄 License
+
+MIT

backend_systems-1.0.0.dist-info/RECORD

@@ -0,0 +1,38 @@
+src/__init__.py,sha256=oQrsYQeSZ9rrr0VQBJO2mgZQF1LoYwqDzJ3Y2eqQLUk,322
+src/config.py,sha256=VcygAomUdTpU00T6cNf-enIL5IK2y6460FmTJsOlvZo,2698
+src/main.py,sha256=2Bfb5tT2YfWcQgJgIBDN33uQ__SV7GPS-V7RgFqrgqk,3749
+src/application/__init__.py,sha256=ZElJDu9pRzpuDW0Do4_nYYawfgGx9iaw7eEfgSmPe1s,51
+src/application/services/__init__.py,sha256=aYwIt4J1V0C4ZOV7lThad-m-RfUq-P04DCC0Z09j7nE,65
+src/application/services/auth_service.py,sha256=pmv1oWocS5HOyOeZ3QoIXBrkjC2-ijqGftZFpAs9Shc,6005
+src/application/services/order_service.py,sha256=E7sdX6I0ZNpM5ME_9l6gFv_K173a0Rx7uie952A5ls0,8838
+src/domain/__init__.py,sha256=ypBUHIJZruIYfQBV1AcUh61nzXaD51pmvVQN3Yb4Xq4,60
+src/domain/entities/__init__.py,sha256=GtF8iOAgiGQLWlnWacT2oeVos0ZjqoGSPJLalSYiCW8,482
+src/domain/entities/inventory.py,sha256=BH37B19HR_kk49vBIS6pL4OUGGB9jomEYveKvQTjYwU,9017
+src/domain/entities/order.py,sha256=38F703Z9zSfn_TD3nfK610YFa2y2oYqK2OviwerM38c,9969
+src/domain/entities/organization.py,sha256=vUM1KeP9pZSVkxrpyOVP2wBzEBgoBRrggM1C9vlDoHU,4695
+src/domain/entities/user.py,sha256=waXVxbrD3ct2fHSCdlmjxXAbRHFOFPUS7Qi5ARnXr5A,5067
+src/domain/value_objects/__init__.py,sha256=0_paVmj4nrpMvsTl2UVH4uHYARUTPBdvqPw92FNjtHU,265
+src/domain/value_objects/address.py,sha256=Mv9Y_PVy8-MhEIRIebRZf7PYT70hnYPhh3HJgP6vX0E,3167
+src/domain/value_objects/email.py,sha256=NWUQmGaw-NPlDdURG-fSbcXFb9nUS1NHE-K30MJ0ueA,2695
+src/domain/value_objects/money.py,sha256=X6xPCcc-wgiQFSAkRqOWscdXl2qYcQG0bTaimlCLeB8,6865
+src/infrastructure/__init__.py,sha256=4LA_7dRyRn4yazu_gEsHqtwZRNN7TXjb2eMZvQFCEuc,72
+src/infrastructure/database/__init__.py,sha256=tPggXY8A-AMe-eaHKCp9GjJoaWcYod05e1kJgOkJB54,68
+src/infrastructure/database/models.py,sha256=DLyf8qy6uHNQZCw9ywRbyljH0z5vcIRXNxatN2I6Y6U,11511
+src/infrastructure/database/session.py,sha256=KYfSMLtYzeJu6v9KCVAziNk0otrPWYiF9BWmXbASKdA,2454
+src/infrastructure/repositories/__init__.py,sha256=QUeE09uMy99i-rw3M7jnNqc_xmnG-Hf_0RSuFtgbHlA,55
+src/infrastructure/repositories/base.py,sha256=hG0V9rDMj8jiBSpabg1W2feTBQ2MesXOZypbQ9SXmfA,4558
+src/infrastructure/repositories/inventory_repository.py,sha256=SC3dlndgvYJdVTce0TIHB5sBRM3U7jBIZM2BwQKoPHA,8682
+src/infrastructure/repositories/order_repository.py,sha256=iMzSQ816TRl0zBBIOSELI5Vlr_AvxY_3BMQ7kyVYgb0,8043
+src/infrastructure/repositories/user_repository.py,sha256=g8Rw2fytdRoGc4QajskvmAt4cy9siwQ_TiUBSU5e3U0,4146
+src/presentation/__init__.py,sha256=_JdpNelTs5YHmj2KokTDS_wRjbqVpwA-FHoNOsf9msM,52
+src/presentation/routes/__init__.py,sha256=m4rQ8jwQMOqgZDrGnTmvbpKI4SlIGvFid01yyq3P5eY,26
+src/presentation/routes/auth.py,sha256=CnpF0spaLWiXOCNOYsW5kzo9zDlu1UKuJhLUL-6bxGo,6079
+src/presentation/routes/health.py,sha256=BqcCK_S9KVkpK2RmkG4ADiOOLNruFNTTHOGk4GAm3b8,2521
+src/presentation/routes/inventory.py,sha256=COk5BloU0gPFnacq4PjeIkbKPWhcZOeYTeRDmD1RP1k,10346
+src/presentation/routes/orders.py,sha256=BpOzvyVeG09chzjGmw0gHZ2jEbKHPNSTt460KYVF_G0,9508
+src/presentation/routes/users.py,sha256=gEbhflqwP7sZdNztadSTQHRBPU3cj7fjVMQWxOOyJJw,7266
+src/presentation/schemas/__init__.py,sha256=LosHFlWnOB7DnjS1z07aPcbUuVNSfH_6aktob8u5y_k,53
+backend_systems-1.0.0.dist-info/METADATA,sha256=0KmS_pyWBGmm9ZbSJO6S8Zcxc0jy7M1KJX-tkF5pjOI,6898
+backend_systems-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+backend_systems-1.0.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+backend_systems-1.0.0.dist-info/RECORD,,

backend_systems-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

backend_systems-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+src

src/__init__.py

@@ -0,0 +1,10 @@
+"""
+Backend Systems - ERP-Style Backend with DDD and Clean Architecture.
+
+This package provides a production-grade backend implementation demonstrating
+enterprise patterns including Domain-Driven Design, CQRS-ready architecture,
+and comprehensive RBAC.
+"""
+
+__version__ = "1.0.0"
+__author__ = "Engineering Team"

src/application/__init__.py

@@ -0,0 +1 @@
+"""Application layer - Use cases and services."""

src/application/services/__init__.py

@@ -0,0 +1 @@
+"""Application services - Business use case implementations."""

src/application/services/auth_service.py

@@ -0,0 +1,216 @@
+"""
+Authentication Service - Handles user authentication and token management.
+"""
+
+from datetime import datetime, timedelta
+from typing import Optional
+from uuid import UUID
+
+from jose import JWTError, jwt
+from passlib.context import CryptContext
+
+from src.config import get_settings
+from src.domain.entities.user import User
+
+
+class AuthenticationService:
+    """
+    Service for handling authentication operations.
+    
+    Manages password hashing, verification, and JWT token generation.
+    """
+    
+    ALGORITHM = "HS256"
+    
+    def __init__(self):
+        """Initialize authentication service."""
+        self._settings = get_settings()
+        self._pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto")
+    
+    def hash_password(self, password: str) -> str:
+        """
+        Hash a plain text password.
+        
+        Args:
+            password: Plain text password
+            
+        Returns:
+            Hashed password string
+        """
+        return self._pwd_context.hash(password)
+    
+    def verify_password(self, plain_password: str, hashed_password: str) -> bool:
+        """
+        Verify a password against its hash.
+        
+        Args:
+            plain_password: Plain text password to verify
+            hashed_password: Stored password hash
+            
+        Returns:
+            True if password matches, False otherwise
+        """
+        return self._pwd_context.verify(plain_password, hashed_password)
+    
+    def create_access_token(
+        self,
+        user_id: UUID,
+        email: str,
+        role: str,
+        expires_delta: Optional[timedelta] = None,
+    ) -> str:
+        """
+        Create a JWT access token.
+        
+        Args:
+            user_id: User identifier
+            email: User email
+            role: User role
+            expires_delta: Optional custom expiration
+            
+        Returns:
+            Encoded JWT token
+        """
+        if expires_delta is None:
+            expires_delta = timedelta(minutes=self._settings.access_token_expire_minutes)
+        
+        expire = datetime.utcnow() + expires_delta
+        
+        to_encode = {
+            "sub": str(user_id),
+            "email": email,
+            "role": role,
+            "exp": expire,
+            "type": "access",
+        }
+        
+        return jwt.encode(
+            to_encode,
+            self._settings.secret_key,
+            algorithm=self.ALGORITHM,
+        )
+    
+    def create_refresh_token(
+        self,
+        user_id: UUID,
+        expires_delta: Optional[timedelta] = None,
+    ) -> str:
+        """
+        Create a JWT refresh token.
+        
+        Args:
+            user_id: User identifier
+            expires_delta: Optional custom expiration
+            
+        Returns:
+            Encoded JWT refresh token
+        """
+        if expires_delta is None:
+            expires_delta = timedelta(days=self._settings.refresh_token_expire_days)
+        
+        expire = datetime.utcnow() + expires_delta
+        
+        to_encode = {
+            "sub": str(user_id),
+            "exp": expire,
+            "type": "refresh",
+        }
+        
+        return jwt.encode(
+            to_encode,
+            self._settings.secret_key,
+            algorithm=self.ALGORITHM,
+        )
+    
+    def decode_token(self, token: str) -> Optional[dict]:
+        """
+        Decode and validate a JWT token.
+        
+        Args:
+            token: JWT token string
+            
+        Returns:
+            Token payload if valid, None otherwise
+        """
+        try:
+            payload = jwt.decode(
+                token,
+                self._settings.secret_key,
+                algorithms=[self.ALGORITHM],
+            )
+            return payload
+        except JWTError:
+            return None
+    
+    def validate_access_token(self, token: str) -> Optional[dict]:
+        """
+        Validate an access token.
+        
+        Args:
+            token: JWT access token
+            
+        Returns:
+            Token payload if valid access token, None otherwise
+        """
+        payload = self.decode_token(token)
+        if payload and payload.get("type") == "access":
+            return payload
+        return None
+    
+    def validate_refresh_token(self, token: str) -> Optional[str]:
+        """
+        Validate a refresh token.
+        
+        Args:
+            token: JWT refresh token
+            
+        Returns:
+            User ID if valid refresh token, None otherwise
+        """
+        payload = self.decode_token(token)
+        if payload and payload.get("type") == "refresh":
+            return payload.get("sub")
+        return None
+    
+    def authenticate_user(
+        self,
+        user: User,
+        password: str,
+    ) -> bool:
+        """
+        Authenticate a user with password.
+        
+        Args:
+            user: User entity
+            password: Plain text password
+            
+        Returns:
+            True if authentication successful
+            
+        Raises:
+            ValueError: If account is locked or inactive
+        """
+        if not user.is_active:
+            raise ValueError("Account is inactive")
+        
+        if user.is_locked():
+            raise ValueError("Account is temporarily locked")
+        
+        if not self.verify_password(password, user.hashed_password):
+            user.record_failed_login()
+            return False
+        
+        user.record_successful_login()
+        return True
+
+
+# Singleton instance
+_auth_service: Optional[AuthenticationService] = None
+
+
+def get_auth_service() -> AuthenticationService:
+    """Get authentication service singleton."""
+    global _auth_service
+    if _auth_service is None:
+        _auth_service = AuthenticationService()
+    return _auth_service