backend-systems 1.0.0__tar.gz

backend_systems-1.0.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,153 @@
+# 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/backend_systems.egg-info/PKG-INFO

@@ -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/backend_systems.egg-info/SOURCES.txt

@@ -0,0 +1,41 @@
+README.md
+pyproject.toml
+backend_systems.egg-info/PKG-INFO
+backend_systems.egg-info/SOURCES.txt
+backend_systems.egg-info/dependency_links.txt
+backend_systems.egg-info/requires.txt
+backend_systems.egg-info/top_level.txt
+src/__init__.py
+src/config.py
+src/main.py
+src/application/__init__.py
+src/application/services/__init__.py
+src/application/services/auth_service.py
+src/application/services/order_service.py
+src/domain/__init__.py
+src/domain/entities/__init__.py
+src/domain/entities/inventory.py
+src/domain/entities/order.py
+src/domain/entities/organization.py
+src/domain/entities/user.py
+src/domain/value_objects/__init__.py
+src/domain/value_objects/address.py
+src/domain/value_objects/email.py
+src/domain/value_objects/money.py
+src/infrastructure/__init__.py
+src/infrastructure/database/__init__.py
+src/infrastructure/database/models.py
+src/infrastructure/database/session.py
+src/infrastructure/repositories/__init__.py
+src/infrastructure/repositories/base.py
+src/infrastructure/repositories/inventory_repository.py
+src/infrastructure/repositories/order_repository.py
+src/infrastructure/repositories/user_repository.py
+src/presentation/__init__.py
+src/presentation/routes/__init__.py
+src/presentation/routes/auth.py
+src/presentation/routes/health.py
+src/presentation/routes/inventory.py
+src/presentation/routes/orders.py
+src/presentation/routes/users.py
+src/presentation/schemas/__init__.py

backend_systems-1.0.0/backend_systems.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

backend_systems-1.0.0/backend_systems.egg-info/requires.txt

@@ -0,0 +1,20 @@
+fastapi>=0.109.0
+uvicorn[standard]>=0.27.0
+sqlalchemy>=2.0.25
+alembic>=1.13.1
+psycopg2-binary>=2.9.9
+pydantic>=2.5.3
+pydantic-settings>=2.1.0
+python-jose[cryptography]>=3.3.0
+passlib[bcrypt]>=1.7.4
+python-multipart>=0.0.6
+httpx>=0.26.0
+
+[dev]
+pytest>=7.4.4
+pytest-cov>=4.1.0
+pytest-asyncio>=0.23.3
+httpx>=0.26.0
+black>=24.1.0
+ruff>=0.1.14
+mypy>=1.8.0

backend_systems-1.0.0/backend_systems.egg-info/top_level.txt

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

backend_systems-1.0.0/pyproject.toml

@@ -0,0 +1,70 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "backend-systems"
+version = "1.0.0"
+description = "ERP-style backend with DDD and Clean Architecture"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "MIT"}
+authors = [
+    {name = "Engineering Team", email = "team@example.com"}
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+dependencies = [
+    "fastapi>=0.109.0",
+    "uvicorn[standard]>=0.27.0",
+    "sqlalchemy>=2.0.25",
+    "alembic>=1.13.1",
+    "psycopg2-binary>=2.9.9",
+    "pydantic>=2.5.3",
+    "pydantic-settings>=2.1.0",
+    "python-jose[cryptography]>=3.3.0",
+    "passlib[bcrypt]>=1.7.4",
+    "python-multipart>=0.0.6",
+    "httpx>=0.26.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.4",
+    "pytest-cov>=4.1.0",
+    "pytest-asyncio>=0.23.3",
+    "httpx>=0.26.0",
+    "black>=24.1.0",
+    "ruff>=0.1.14",
+    "mypy>=1.8.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["src*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+asyncio_mode = "auto"
+
+[tool.black]
+line-length = 88
+target-version = ["py311"]
+
+[tool.ruff]
+line-length = 88
+select = ["E", "F", "I", "N", "W"]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.11"
+warn_return_any = true
+warn_unused_ignores = true
+disallow_untyped_defs = true

backend_systems-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

backend_systems-1.0.0/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"

backend_systems-1.0.0/src/application/__init__.py

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

backend_systems-1.0.0/src/application/services/__init__.py

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