monkeybrain-runtime 1.0.0__py3-none-any.whl

services/floor_layout/routers/bays.py

@@ -0,0 +1,143 @@
+from fastapi import APIRouter, HTTPException, Depends, Query, status
+from motor.motor_asyncio import AsyncIOMotorDatabase
+
+from services.common.db import get_database
+from services.common.auth import require_permission
+from services.floor_layout.helpers import bays as crud
+
+from services.floor_layout.models.bays import (
+    BayCreate,
+    BayUpdate,
+    BayResponse,
+    PaginatedBayResponse,
+)
+
+router = APIRouter()
+
+
+# ── List ──────────────────────────────────────────────────────────────────────
+
+@router.get("/", response_model=PaginatedBayResponse)
+async def list_bays(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-bays")),
+):
+    bays, total = await crud.get_all(db, page=page, page_size=page_size)
+    return PaginatedBayResponse(
+        total=total,
+        page=page,
+        page_size=page_size,
+        results=bays,
+    )
+
+
+# ── Hierarchy Queries ─────────────────────────────────────────────────────────
+
+@router.get("/by-room/{room_id}", response_model=list[BayResponse])
+async def list_bays_by_room(
+    room_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-bays")),
+):
+    return await crud.get_by_room(db, room_id)
+
+
+@router.get("/by-floor/{floor_id}", response_model=list[BayResponse])
+async def list_bays_by_floor(
+    floor_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-bays")),
+):
+    return await crud.get_by_floor(db, floor_id)
+
+
+@router.get("/by-building/{building_id}", response_model=list[BayResponse])
+async def list_bays_by_building(
+    building_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-bays")),
+):
+    return await crud.get_by_building(db, building_id)
+
+
+@router.get("/by-facility/{facility_id}", response_model=list[BayResponse])
+async def list_bays_by_facility(
+    facility_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-bays")),
+):
+    return await crud.get_by_facility(db, facility_id)
+
+
+# ── Get One ───────────────────────────────────────────────────────────────────
+
+@router.get("/{bay_id}", response_model=BayResponse)
+async def get_bay(
+    bay_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-bays")),
+):
+    record = await crud.get_by_id(db, bay_id)
+    if not record:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Bay '{bay_id}' not found",
+        )
+    return record
+
+
+# ── Create ────────────────────────────────────────────────────────────────────
+
+@router.post("/", response_model=BayResponse, status_code=status.HTTP_201_CREATED)
+async def create_bay(
+    data: BayCreate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-create-bays")),
+):
+    if await crud.get_by_id(db, data.bay_id):
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT,
+            detail=f"Bay '{data.bay_id}' already exists",
+        )
+    return await crud.create(db, data)
+
+
+# ── Update ────────────────────────────────────────────────────────────────────
+
+@router.patch("/{bay_id}", response_model=BayResponse)
+async def update_bay(
+    bay_id: str,
+    data: BayUpdate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-update-bays")),
+):
+    updated = await crud.update(db, bay_id, data)
+    if not updated:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Bay '{bay_id}' not found",
+        )
+    return updated
+
+
+# ── Delete ────────────────────────────────────────────────────────────────────
+
+@router.delete("/{bay_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_bay(
+    bay_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-delete-bays")),
+):
+    if not await crud.delete(db, bay_id):
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Bay '{bay_id}' not found",
+        )
+
+
+# ── Future Extensions ─────────────────────────────────────────────────────────
+
+# TODO: GET /api/v1/bays/{bay_id}/machines
+# TODO: GET /api/v1/bays/{bay_id}/sensors

services/floor_layout/routers/buildings.py

@@ -0,0 +1,116 @@
+from fastapi import APIRouter, HTTPException, Depends, Query, status
+from motor.motor_asyncio import AsyncIOMotorDatabase
+
+from services.common.db import get_database
+from services.common.auth import require_permission
+from services.floor_layout.helpers import buildings as crud
+
+from services.floor_layout.models.buildings import (
+    BuildingCreate,
+    BuildingUpdate,
+    BuildingResponse,
+    PaginatedBuildingResponse,
+)
+
+router = APIRouter()
+
+
+# ── List ──────────────────────────────────────────────────────────────────────
+
+@router.get("/", response_model=PaginatedBuildingResponse)
+async def list_buildings(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-buildings")),
+):
+    buildings, total = await crud.get_all(db, page=page, page_size=page_size)
+    return PaginatedBuildingResponse(
+        total=total,
+        page=page,
+        page_size=page_size,
+        results=buildings,
+    )
+
+
+# ── Get by facility ───────────────────────────────────────────────────────────
+
+@router.get("/by-facility/{facility_id}", response_model=list[BuildingResponse])
+async def list_buildings_by_facility(
+    facility_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-buildings")),
+):
+    return await crud.get_by_facility(db, facility_id)
+
+
+# ── Get one ───────────────────────────────────────────────────────────────────
+
+@router.get("/{building_id}", response_model=BuildingResponse)
+async def get_building(
+    building_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-buildings")),
+):
+    record = await crud.get_by_id(db, building_id)
+    if not record:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Building '{building_id}' not found",
+        )
+    return record
+
+
+# ── Create ────────────────────────────────────────────────────────────────────
+
+@router.post("/", response_model=BuildingResponse, status_code=status.HTTP_201_CREATED)
+async def create_building(
+    data: BuildingCreate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-create-buildings")),
+):
+    if await crud.get_by_id(db, data.building_id):
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT,
+            detail=f"Building '{data.building_id}' already exists",
+        )
+    return await crud.create(db, data)
+
+
+# ── Update ────────────────────────────────────────────────────────────────────
+
+@router.patch("/{building_id}", response_model=BuildingResponse)
+async def update_building(
+    building_id: str,
+    data: BuildingUpdate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-update-buildings")),
+):
+    updated = await crud.update(db, building_id, data)
+    if not updated:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Building '{building_id}' not found",
+        )
+    return updated
+
+
+# ── Delete ────────────────────────────────────────────────────────────────────
+
+@router.delete("/{building_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_building(
+    building_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-delete-buildings")),
+):
+    if not await crud.delete(db, building_id):
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Building '{building_id}' not found",
+        )
+
+
+# ── Future Extensions ─────────────────────────────────────────────────────────
+
+# TODO: GET /api/v1/buildings/{building_id}/floors
+# TODO: GET /api/v1/buildings/{building_id}/rooms

services/floor_layout/routers/floors.py

@@ -0,0 +1,89 @@
+from fastapi import APIRouter, HTTPException, Depends, Query, status
+from motor.motor_asyncio import AsyncIOMotorDatabase
+from services.common.db import get_database
+from services.floor_layout.models.floors import (
+    FloorCreate,
+    FloorUpdate,
+    FloorResponse,
+    PaginatedFloorResponse,
+)
+from services.floor_layout.helpers import floors as crud
+from services.common.auth import require_permission
+
+router = APIRouter()
+
+
+@router.get("/", response_model=PaginatedFloorResponse)
+async def list_floors(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+     _: dict = Depends(require_permission("perm-view-floors")),
+):
+    floors, total = await crud.get_all(db, page=page, page_size=page_size)
+    return PaginatedFloorResponse(total=total, page=page, page_size=page_size, results=floors)
+
+
+@router.get("/by-building/{building_id}", response_model=list[FloorResponse])
+async def list_floors_by_building(
+    building_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+     _: dict = Depends(require_permission("perm-view-floors")),
+):
+    return await crud.get_by_building(db, building_id)
+
+
+@router.get("/by-facility/{facility_id}", response_model=list[FloorResponse])
+async def list_floors_by_facility(
+    facility_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+):
+    return await crud.get_by_facility(db, facility_id)
+
+
+@router.get("/{floor_id}", response_model=FloorResponse)
+async def get_floor(
+    floor_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+     _: dict = Depends(require_permission("perm-view-floors")),
+):
+    record = await crud.get_by_id(db, floor_id)
+    if not record:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Floor '{floor_id}' not found")
+    return record
+
+
+@router.post("/", response_model=FloorResponse, status_code=status.HTTP_201_CREATED)
+async def create_floor(
+    data: FloorCreate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+     _: dict = Depends(require_permission("perm-create-floors")),
+):
+    if await crud.get_by_id(db, data.floor_id):
+        raise HTTPException(status_code=status.HTTP_409_CONFLICT, detail=f"Floor '{data.floor_id}' already exists")
+    return await crud.create(db, data)
+
+
+@router.patch("/{floor_id}", response_model=FloorResponse)
+async def update_floor(
+    floor_id: str,
+    data: FloorUpdate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+     _: dict = Depends(require_permission("perm-update-floors")),
+):
+    updated = await crud.update(db, floor_id, data)
+    if not updated:
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Floor '{floor_id}' not found")
+    return updated
+
+
+@router.delete("/{floor_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_floor(
+    floor_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+     _: dict = Depends(require_permission("perm-delete-floors")),
+):
+    if not await crud.delete(db, floor_id):
+        raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=f"Floor '{floor_id}' not found")
+
+# TODO: GET /api/v1/floors/{floor_id}/rooms

services/floor_layout/routers/locations.py

@@ -0,0 +1,80 @@
+from fastapi import APIRouter, HTTPException, Depends, Query, status
+from motor.motor_asyncio import AsyncIOMotorDatabase
+from pydantic import BaseModel
+
+from services.common.db import get_database
+from services.common.auth import require_permission
+
+from services.floor_layout.helpers import bays as bays_crud
+from services.floor_layout.helpers import rooms as room_crud
+from services.floor_layout.helpers import floors as floor_crud
+from services.floor_layout.helpers import buildings as building_crud
+from services.facilities.helpers import plants as plant_crud
+
+router = APIRouter()
+
+
+class LocationsResponse(BaseModel):
+    plant_name: str
+    building_name: str
+    floor_name: str
+    room_name: str
+    bay_name: str
+
+
+@router.get("/", response_model=LocationsResponse)
+async def get_location(
+    machine_id: str = Query(...),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    user: dict = Depends(require_permission("perm-view-locations")),
+):
+    # ── Step 1: Get Bay ─────────────────────────────────────────────
+    bays = await bays_crud.get_by_machine(db, machine_id)
+
+    if not bays:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"No bay found for machine '{machine_id}'",
+        )
+
+    bay = bays[0]
+    bay_name = bay.get("name")
+    room_id = bay.get("room_id")
+
+    # ── Step 2: Room ────────────────────────────────────────────────
+    room = await room_crud.get_by_id(db, room_id)
+    if not room:
+        raise HTTPException(404, f"Room '{room_id}' not found")
+
+    room_name = room.get("name")
+    floor_id = room.get("floor_id")
+
+    # ── Step 3: Floor ───────────────────────────────────────────────
+    floor = await floor_crud.get_by_id(db, floor_id)
+    if not floor:
+        raise HTTPException(404, f"Floor '{floor_id}' not found")
+
+    floor_name = floor.get("name")
+    building_id = floor.get("building_id")
+
+    # ── Step 4: Building ────────────────────────────────────────────
+    building = await building_crud.get_by_id(db, building_id)
+    if not building:
+        raise HTTPException(404, f"Building '{building_id}' not found")
+
+    building_name = building.get("name")
+    plant_id = building.get("plant_id")
+
+    # ── Step 5: Plant ───────────────────────────────────────────────
+    plant = await plant_crud.get_by_id(db, plant_id)
+    if not plant:
+        raise HTTPException(404, f"Plant '{plant_id}' not found")
+
+    # ── Final Response ──────────────────────────────────────────────
+    return LocationsResponse(
+        plant_name=plant.get("name"),
+        building_name=building_name,
+        floor_name=floor_name,
+        room_name=room_name,
+        bay_name=bay_name,
+    )

services/floor_layout/routers/rooms.py

@@ -0,0 +1,134 @@
+from fastapi import APIRouter, HTTPException, Depends, Query, status
+from motor.motor_asyncio import AsyncIOMotorDatabase
+
+from services.common.db import get_database
+from services.common.auth import require_permission
+from services.floor_layout.helpers import rooms as crud
+
+from services.floor_layout.models.rooms import (
+    RoomCreate,
+    RoomUpdate,
+    RoomResponse,
+    PaginatedRoomResponse,
+)
+
+router = APIRouter()
+
+
+# ── List ──────────────────────────────────────────────────────────────────────
+
+@router.get("/", response_model=PaginatedRoomResponse)
+async def list_rooms(
+    page: int = Query(1, ge=1),
+    page_size: int = Query(20, ge=1),
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-rooms")),
+):
+    rooms, total = await crud.get_all(db, page=page, page_size=page_size)
+    return PaginatedRoomResponse(
+        total=total,
+        page=page,
+        page_size=page_size,
+        results=rooms,
+    )
+
+
+# ── Hierarchy Queries ─────────────────────────────────────────────────────────
+
+@router.get("/by-floor/{floor_id}", response_model=list[RoomResponse])
+async def list_rooms_by_floor(
+    floor_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-rooms")),
+):
+    return await crud.get_by_floor(db, floor_id)
+
+
+@router.get("/by-building/{building_id}", response_model=list[RoomResponse])
+async def list_rooms_by_building(
+    building_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-rooms")),
+):
+    return await crud.get_by_building(db, building_id)
+
+
+@router.get("/by-facility/{facility_id}", response_model=list[RoomResponse])
+async def list_rooms_by_facility(
+    facility_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-rooms")),
+):
+    return await crud.get_by_facility(db, facility_id)
+
+
+# ── Get One ───────────────────────────────────────────────────────────────────
+
+@router.get("/{room_id}", response_model=RoomResponse)
+async def get_room(
+    room_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-view-rooms")),
+):
+    record = await crud.get_by_id(db, room_id)
+    if not record:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Room '{room_id}' not found",
+        )
+    return record
+
+
+# ── Create ────────────────────────────────────────────────────────────────────
+
+@router.post("/", response_model=RoomResponse, status_code=status.HTTP_201_CREATED)
+async def create_room(
+    data: RoomCreate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-create-rooms")),
+):
+    if await crud.get_by_id(db, data.room_id):
+        raise HTTPException(
+            status_code=status.HTTP_409_CONFLICT,
+            detail=f"Room '{data.room_id}' already exists",
+        )
+    return await crud.create(db, data)
+
+
+# ── Update ────────────────────────────────────────────────────────────────────
+
+@router.patch("/{room_id}", response_model=RoomResponse)
+async def update_room(
+    room_id: str,
+    data: RoomUpdate,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-update-rooms")),
+):
+    updated = await crud.update(db, room_id, data)
+    if not updated:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Room '{room_id}' not found",
+        )
+    return updated
+
+
+# ── Delete ────────────────────────────────────────────────────────────────────
+
+@router.delete("/{room_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_room(
+    room_id: str,
+    db: AsyncIOMotorDatabase = Depends(get_database),
+    _: dict = Depends(require_permission("perm-delete-rooms")),
+):
+    if not await crud.delete(db, room_id):
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Room '{room_id}' not found",
+        )
+
+
+# ── Future Extensions ─────────────────────────────────────────────────────────
+
+# TODO: GET /api/v1/rooms/{room_id}/bays
+# TODO: GET /api/v1/rooms/{room_id}/devices

services/inventory/helpers/__init__.py

@@ -0,0 +1,13 @@
+"""inventory service helpers package."""
+
+__all__ = [
+    "inventory_allocations",
+    "inventory_item_counts",
+    "inventory_item_quantities",
+    "inventory_items",
+    "inventory_stage_outputs",
+    "inventory_transactions",
+    "stock_adjustment_requests",
+    "warehouse_cycle_counts",
+    "warehouse_locations",
+]