monkeybrain-runtime 1.0.0__py3-none-any.whl

services/products/models/product_inventory.py

@@ -0,0 +1,118 @@
+from __future__ import annotations
+
+from datetime import date, datetime
+from typing import Any, Optional
+
+from pydantic import BaseModel, Field, model_validator
+
+from services.inventory.models.inventory_enums import (
+    InventoryStatus,
+    InventoryValuationMethod,
+)
+from services.products.models.product_common import ensure_utc, utc_now
+
+class ProductInventoryBase(BaseModel):
+    product_id:         str   = Field(..., min_length=1)
+    location_id:        str   = Field(..., min_length=1)
+    quantity_on_hand:   float = Field(default=0, ge=0)
+    quantity_reserved:  float = Field(default=0, ge=0)
+    quantity_incoming:  float = Field(default=0, ge=0)
+    quantity_committed: float = Field(default=0, ge=0)
+    reorder_point:      Optional[float] = Field(default=None, ge=0)
+    reorder_quantity:   Optional[float] = Field(default=None, ge=0)
+    max_stock_level:    Optional[float] = Field(default=None, ge=0)
+    safety_stock:       Optional[float] = Field(default=None, ge=0)
+    valuation_method:   InventoryValuationMethod = "Weighted-Average"
+    unit_cost:          Optional[float] = Field(default=None, ge=0)
+    currency:           str  = Field(default="USD", min_length=3, max_length=3)
+    batch_tracking:     bool = False
+    serial_tracking:    bool = False
+    expiry_tracking:    bool = False
+    last_counted_at:    Optional[date] = None
+    next_count_due:     Optional[date] = None
+    status:             InventoryStatus = "In-Stock"
+    notes:              Optional[str] = None
+    metadata:           Optional[dict[str, Any]] = None
+
+
+class ProductInventoryRecord(ProductInventoryBase):
+    inventory_id:       str   = Field(..., min_length=1)
+    sku:                str   = Field(..., min_length=1)
+    product_name:       str   = Field(..., min_length=1)
+    quantity_available: float = Field(default=0, ge=0)
+    total_value:        Optional[float] = Field(default=None, ge=0)
+    is_below_reorder:   bool  = False
+    is_overstocked:     bool  = False
+    is_expired:         bool  = False
+    alert_flags:        list[str] = Field(default_factory=list)
+    created_by:         Optional[str] = None
+    updated_by:         Optional[str] = None
+    created_at:         datetime = Field(default_factory=utc_now)
+    updated_at:         datetime = Field(default_factory=utc_now)
+
+    @model_validator(mode="after")
+    def compute_fields(self) -> "ProductInventoryRecord":
+        self.created_at = ensure_utc(self.created_at)
+        self.updated_at = ensure_utc(self.updated_at)
+        self.quantity_available = max(self.quantity_on_hand - self.quantity_reserved, 0)
+
+        if self.unit_cost is not None:
+            self.total_value = round(self.quantity_on_hand * self.unit_cost, 2)
+
+        self.is_below_reorder = (
+            self.reorder_point is not None
+            and self.quantity_available <= self.reorder_point
+        )
+
+        self.is_overstocked = (
+            self.max_stock_level is not None
+            and self.quantity_on_hand > self.max_stock_level
+        )
+
+        self.is_expired = self.status == "Expired"
+
+        flags: list[str] = []
+        if self.is_below_reorder:
+            flags.append("low-stock")
+        if self.quantity_available == 0:
+            flags.append("out-of-stock")
+        if self.is_overstocked:
+            flags.append("overstock")
+        if self.is_expired:
+            flags.append("expired")
+        self.alert_flags = flags
+        return self
+
+
+class ProductInventoryCreate(ProductInventoryBase):
+    pass
+
+
+class ProductInventoryUpdate(BaseModel):
+    quantity_on_hand:   Optional[float] = Field(default=None, ge=0)
+    quantity_reserved:  Optional[float] = Field(default=None, ge=0)
+    quantity_incoming:  Optional[float] = Field(default=None, ge=0)
+    quantity_committed: Optional[float] = Field(default=None, ge=0)
+    reorder_point:      Optional[float] = Field(default=None, ge=0)
+    reorder_quantity:   Optional[float] = Field(default=None, ge=0)
+    max_stock_level:    Optional[float] = Field(default=None, ge=0)
+    safety_stock:       Optional[float] = Field(default=None, ge=0)
+    valuation_method:   Optional[InventoryValuationMethod] = None
+    unit_cost:          Optional[float] = Field(default=None, ge=0)
+    currency:           Optional[str]  = Field(default=None, min_length=3, max_length=3)
+    batch_tracking:     Optional[bool] = None
+    serial_tracking:    Optional[bool] = None
+    expiry_tracking:    Optional[bool] = None
+    last_counted_at:    Optional[date] = None
+    next_count_due:     Optional[date] = None
+    status:             Optional[InventoryStatus] = None
+    notes:              Optional[str] = None
+    metadata:           Optional[dict[str, Any]] = None
+    updated_by:         Optional[str] = None
+
+
+class PaginatedProductInventoryResponse(BaseModel):
+    total:     int
+    page:      int
+    page_size: int
+    results:   list[ProductInventoryRecord]

services/products/models/product_pricing.py

@@ -0,0 +1,73 @@
+from __future__ import annotations
+
+from datetime import date, datetime
+from typing import Any, Optional
+
+from pydantic import BaseModel, ConfigDict, Field, model_validator
+
+from services.products.models.product_common import PricingType, SupportedCurrency, PricingTier, utc_now, ensure_utc
+
+
+class ProductPricingBase(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+
+    product_id: str = Field(..., min_length=1)
+    pricing_type: PricingType = "Standard"
+    currency: str = Field(default="USD", min_length=3, max_length=3)
+    price_per_unit: float = Field(default=0, ge=0)
+    min_order_quantity: Optional[int] = Field(default=None, gt=0)
+    effective_from: Optional[date] = None
+    effective_to: Optional[date] = None
+    tier_rules: Optional[list[PricingTier]] = None
+    is_active: bool = True
+    notes: Optional[str] = None
+    metadata: Optional[dict[str, Any]] = None
+
+    @model_validator(mode="after")
+    def effective_to_after_from(self) -> "ProductPricingBase":
+        if self.effective_from and self.effective_to and self.effective_to < self.effective_from:
+            raise ValueError("effective_to must be on or after effective_from")
+        return self
+
+
+class ProductPricingRecord(ProductPricingBase):
+    pricing_id: str = Field(..., min_length=1)
+    created_by: Optional[str] = None
+    updated_by: Optional[str] = None
+    created_at: datetime = Field(default_factory=utc_now)
+    updated_at: datetime = Field(default_factory=utc_now)
+
+    @model_validator(mode="after")
+    def normalize_datetimes(self) -> "ProductPricingRecord":
+        self.created_at = ensure_utc(self.created_at)
+        self.updated_at = ensure_utc(self.updated_at)
+        return self
+
+
+class ProductPricingCreate(ProductPricingBase):
+    pass
+
+
+class ProductPricingUpdate(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+
+    product_id: Optional[str] = None
+    pricing_type: Optional[PricingType] = None
+    currency: Optional[str] = Field(default=None, min_length=3, max_length=3)
+    price_per_unit: Optional[float] = Field(default=None, ge=0)
+    min_order_quantity: Optional[int] = Field(default=None, gt=0)
+    effective_from: Optional[date] = None
+    effective_to: Optional[date] = None
+    tier_rules: Optional[list[PricingTier]] = None
+    is_active: Optional[bool] = None
+    notes: Optional[str] = None
+    metadata: Optional[dict[str, Any]] = None
+    updated_by: Optional[str] = None
+    updated_at: datetime = Field(default_factory=utc_now)
+
+
+class PaginatedProductPricingResponse(BaseModel):
+    total: int
+    page: int
+    page_size: int
+    results: list[ProductPricingRecord]

services/products/models/products.py

@@ -0,0 +1,151 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any, Optional
+
+from pydantic import BaseModel, Field, model_validator
+
+from services.products.models.product_common import ProductStatus, ProductType, LifecycleStage, UnitOfMeasure, utc_now, ensure_utc
+
+
+class Product(BaseModel):
+    product_id: str = Field(..., min_length=1)
+    asset_tag: Optional[str] = None
+    sku: str = Field(..., min_length=1)
+    gtin: Optional[str] = None
+    upc: Optional[str] = None
+    ean: Optional[str] = None
+    cas_number: Optional[str] = None
+    barcode: Optional[str] = None
+    upc_ean: Optional[str] = None
+    mpn: Optional[str] = None
+    ndc:Optional[str] = None
+    internal_code: Optional[str] = None
+
+    name: str = Field(..., min_length=1)
+    description: Optional[str] = None
+    short_description: Optional[str] = None
+    brand: Optional[str] = None
+    category: Optional[str] = None
+    subcategory: Optional[str] = None
+    tags: list[str] = Field(default_factory=list)
+    product_type: ProductType = "Finished-Good"
+    lifecycle_stage: Optional[LifecycleStage] = None
+    status: ProductStatus = "Draft"
+
+    base_unit_of_measure: UnitOfMeasure = "Each"
+    packaging_type: Optional[str] = None
+    units_per_case: Optional[float] = Field(default=None, gt=0)
+    units_per_pallet: Optional[float] = Field(default=None, gt=0)
+    alternate_uoms: Optional[list[Any]] = None  # AlternateUom handled via dict in DB
+
+    weight_kg: Optional[float] = Field(default=None, ge=0)
+    volume_liters: Optional[float] = Field(default=None, ge=0)
+    length_cm: Optional[float] = Field(default=None, ge=0)
+    width_cm: Optional[float] = Field(default=None, ge=0)
+    height_cm: Optional[float] = Field(default=None, ge=0)
+
+    reorder_point: Optional[float] = Field(default=None, ge=0)
+    max_stock_level: Optional[float] = Field(default=None, ge=0)
+    min_order_quantity: Optional[int] = Field(default=None, gt=0)
+    lead_time_days: Optional[int] = Field(default=None, ge=0)
+    shelf_life_days: Optional[int] = Field(default=None, ge=0)
+    storage_requirements: Optional[str] = None
+
+    batch_tracking_required: bool = False
+    serial_tracking_required: bool = False
+    expiry_tracking_required: bool = False
+    hazmat: bool = False
+    temp_sensitive: bool = False
+    controlled_substance: bool = False
+    regulatory_certifications: Optional[list[str]] = None
+    msds_url: Optional[str] = None
+
+    cost_price: Optional[float] = Field(default=None, ge=0)
+    selling_price: Optional[float] = Field(default=None, ge=0)
+    currency: Optional[str] = Field(default="USD", min_length=3, max_length=3)
+    tax_category: Optional[str] = None
+
+    default_supplier_id: Optional[str] = None
+    default_supplier_name: Optional[str] = None
+    manufacturer_id: Optional[str] = None
+    manufacturer_name: Optional[str] = None
+    country_of_origin: Optional[str] = None
+
+    images: list[str] = Field(default_factory=list)
+    attachments: list[str] = Field(default_factory=list)
+
+class ProductCreate(Product):
+    pass
+
+class ProductUpdate(BaseModel):
+    product_id: Optional[str] = None
+    asset_tag: Optional[str] = None
+    sku: Optional[str] = None
+    gtin: Optional[str] = None
+    upc: Optional[str] = None
+    ean: Optional[str] = None
+    cas_number: Optional[str] = None
+    barcode: Optional[str] = None
+    upc_ean: Optional[str] = None
+    mpn: Optional[str] = None
+    internal_code: Optional[str] = None
+    name: Optional[str] = None
+    description: Optional[str] = None
+    short_description: Optional[str] = None
+    brand: Optional[str] = None
+    category: Optional[str] = None
+    subcategory: Optional[str] = None
+    tags: Optional[list[str]] = None
+    product_type: Optional[ProductType] = None
+    lifecycle_stage: Optional[LifecycleStage] = None
+    status: Optional[ProductStatus] = None
+    base_unit_of_measure: Optional[UnitOfMeasure] = None
+    packaging_type: Optional[str] = None
+    units_per_case: Optional[float] = Field(default=None, gt=0)
+    units_per_pallet: Optional[float] = Field(default=None, gt=0)
+    alternate_uoms: Optional[list[Any]] = None
+    weight_kg: Optional[float] = Field(default=None, ge=0)
+    volume_liters: Optional[float] = Field(default=None, ge=0)
+    length_cm: Optional[float] = Field(default=None, ge=0)
+    width_cm: Optional[float] = Field(default=None, ge=0)
+    height_cm: Optional[float] = Field(default=None, ge=0)
+    reorder_point: Optional[float] = Field(default=None, ge=0)
+    max_stock_level: Optional[float] = Field(default=None, ge=0)
+    min_order_quantity: Optional[int] = Field(default=None, gt=0)
+    lead_time_days: Optional[int] = Field(default=None, ge=0)
+    shelf_life_days: Optional[int] = Field(default=None, ge=0)
+    storage_requirements: Optional[str] = None
+    batch_tracking_required: Optional[bool] = None
+    serial_tracking_required: Optional[bool] = None
+    expiry_tracking_required: Optional[bool] = None
+    hazmat: Optional[bool] = None
+    temp_sensitive: Optional[bool] = None
+    controlled_substance: Optional[bool] = None
+    regulatory_certifications: Optional[list[str]] = None
+    msds_url: Optional[str] = None
+    cost_price: Optional[float] = Field(default=None, ge=0)
+    selling_price: Optional[float] = Field(default=None, ge=0)
+    currency: Optional[str] = Field(default=None, min_length=3, max_length=3)
+    tax_category: Optional[str] = None
+    default_supplier_id: Optional[str] = None
+    default_supplier_name: Optional[str] = None
+    manufacturer_id: Optional[str] = None
+    manufacturer_name: Optional[str] = None
+    country_of_origin: Optional[str] = None
+    images: Optional[list[str]] = None
+    attachments: Optional[list[str]] = None
+    updated_by: Optional[str] = None
+    updated_at: datetime = Field(default_factory=utc_now)
+
+
+class ProductResponse(Product):
+    class Config:
+        from_attributes = True
+
+
+class PaginatedProductResponse(BaseModel):
+    total: int
+    page: int
+    page_size: int
+    results: list[ProductResponse]

services/products/routers/__init__.py

@@ -0,0 +1,9 @@
+"""products service routers package."""
+
+__all__ = [
+    "boms",
+    "product_components",
+    "product_inventory",
+    "product_pricing",
+    "products",
+]

services/products/routers/boms.py

@@ -0,0 +1,116 @@
+from fastapi import APIRouter, Depends, HTTPException, Query, status
+from motor.motor_asyncio import AsyncIOMotorDatabase
+
+from services.common.db import get_database
+from services.common.auth import require_permission
+from services.products.helpers import boms as crud
+from services.products.models.product_component import BOMCreate, BOMRecord, BOMUpdate, PaginatedBOMResponse
+
+router = APIRouter()
+
+
+@router.get("/", response_model=PaginatedBOMResponse)
+async def list_boms(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-product-components")),
+):
+    boms, total = await crud.get_all(db, page=page, page_size=page_size)
+    return PaginatedBOMResponse(
+        total=total,
+        page=page,
+        page_size=page_size,
+        results=boms,
+    )
+
+
+@router.get("/by-code/{bom_code}", response_model=list[BOMRecord])
+async def list_boms_by_code(
+    bom_code: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-product-components")),
+):
+    return await crud.get_by_code(db, bom_code)
+
+
+@router.get("/by-parent-product/{parent_product_id}", response_model=list[BOMRecord])
+async def list_boms_by_parent_product(
+    parent_product_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-product-components")),
+):
+    return await crud.get_by_parent_product(db, parent_product_id)
+
+
+@router.get("/by-parent-product/{parent_product_id}/current", response_model=BOMRecord)
+async def get_current_bom_by_parent_product(
+    parent_product_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-product-components")),
+):
+    record = await crud.get_current_by_parent_product(db, parent_product_id)
+    if not record:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Current BOM for parent product '{parent_product_id}' not found",
+        )
+    return record
+
+
+@router.get("/{bom_id}", response_model=BOMRecord)
+async def get_bom(
+    bom_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-product-components")),
+):
+    record = await crud.get_by_id(db, bom_id)
+    if not record:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"BOM '{bom_id}' not found",
+        )
+    return record
+
+
+@router.post("/", response_model=BOMRecord, status_code=status.HTTP_201_CREATED)
+async def create_bom(
+    data: BOMCreate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-create-product-components")),
+):
+    if await crud.get_by_id(db, data.bom_id):
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT,
+            detail=f"BOM '{data.bom_id}' already exists",
+        )
+    return await crud.create(db, data)
+
+
+@router.patch("/{bom_id}", response_model=BOMRecord)
+async def update_bom(
+    bom_id: str,
+    data: BOMUpdate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-update-product-components")),
+):
+    updated = await crud.update(db, bom_id, data)
+    if not updated:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"BOM '{bom_id}' not found",
+        )
+    return updated
+
+
+@router.delete("/{bom_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_bom(
+    bom_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-delete-product-components")),
+):
+    if not await crud.delete(db, bom_id):
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"BOM '{bom_id}' not found",
+        )

services/products/routers/drug_research.py

@@ -0,0 +1,115 @@
+from __future__ import annotations
+
+from fastapi import APIRouter, Depends, HTTPException, Query, status
+from motor.motor_asyncio import AsyncIOMotorDatabase
+
+from services.common.auth import require_permission
+from services.common.db import get_database
+from services.products.helpers import drug_research as crud
+from services.products.models.drug_research import (
+    DrugFormulationResearchCreate,
+    DrugFormulationResearchRecord,
+    DrugFormulationResearchUpdate,
+    ProductSimilarityCanvasResponse,
+    DrugResearchSearchResponse,
+    PaginatedDrugResearchResponse,
+)
+
+router = APIRouter()
+
+
+@router.get("/", response_model=PaginatedDrugResearchResponse)
+async def list_drug_research_records(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1, le=1000),
+    generic_name: str | None = None,
+    dosage_form: str | None = None,
+    therapeutic_class: str | None = None,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    query = {
+        key: value
+        for key, value in {
+            "generic_name": generic_name,
+            "dosage_form": dosage_form,
+            "therapeutic_class": therapeutic_class,
+        }.items()
+        if value
+    }
+    records, total = await crud.get_all(db, page=page, page_size=page_size, query=query)
+    return PaginatedDrugResearchResponse(total=total, page=page, page_size=page_size, results=records)
+
+
+@router.get("/search", response_model=DrugResearchSearchResponse)
+async def search_drug_research_records(
+    q: str = Query(..., min_length=1),
+    limit: int = Query(8, ge=1, le=25),
+    include_documents: bool = True,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    return await crud.search(db, q, limit=limit, include_documents=include_documents)
+
+
+@router.post("/sync-elasticsearch")
+async def sync_drug_research_elasticsearch(
+    limit: int | None = Query(None, ge=1),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-update-products")),
+):
+    return await crud.sync_elasticsearch(db, limit=limit)
+
+
+@router.get("/canvas", response_model=ProductSimilarityCanvasResponse)
+async def product_similarity_canvas(
+    q: str | None = Query(None, min_length=1),
+    limit: int = Query(8, ge=1, le=25),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    return await crud.product_similarity_canvas(db, q, limit=limit)
+
+
+@router.post("/", response_model=DrugFormulationResearchRecord, status_code=status.HTTP_201_CREATED)
+async def upsert_drug_research_record(
+    data: DrugFormulationResearchCreate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-create-products")),
+):
+    return await crud.upsert(db, data)
+
+
+@router.get("/{research_product_id}", response_model=DrugFormulationResearchRecord)
+async def get_drug_research_record(
+    research_product_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-products")),
+):
+    record = await crud.get_by_id(db, research_product_id)
+    if not record:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Drug research record '{research_product_id}' not found")
+    return record
+
+
+@router.patch("/{research_product_id}", response_model=DrugFormulationResearchRecord)
+async def update_drug_research_record(
+    research_product_id: str,
+    data: DrugFormulationResearchUpdate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-update-products")),
+):
+    updated = await crud.update(db, research_product_id, data)
+    if not updated:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Drug research record '{research_product_id}' not found")
+    return updated
+
+
+@router.delete("/{research_product_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_drug_research_record(
+    research_product_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-delete-products")),
+):
+    if not await crud.delete(db, research_product_id):
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Drug research record '{research_product_id}' not found")