Kevin Rosales
38d86531e8
✨ New Features: - Company module: Single company management with comprehensive business info - Client & Provider module: Manages clients/providers with address/program relationships - GParts module: Parts/components management for SCAII, SCAF, and WINSAAI systems - GClass module: Class classifications for SCAII and SCAF with tariff information 🔗 Database Relationships: - GPart ↔ GClass: Composite key relationship (client_key, part_class ↔ class_code) - GPart → Country: Foreign key to public.countries (country_of_origin) - GPart → CurrencyType: Foreign key to public.currency_types (currency_key) - GClass → MaterialType: Foreign key to public.material_types (material_key) 📊 API Endpoints Added: Company Module (/company): - POST / - Create company - GET / - Get single company Client & Provider Module (/clients-providers): - POST / - Create client/provider - GET / - List all with pagination - GET /clients - List only clients - GET /providers - List only providers - GET /search/rfc/{rfc} - Search by RFC - GET /{client_id} - Get by ID - PUT /{client_id} - Update client/provider - DELETE /{client_id} - Delete client/provider - PATCH /{client_id}/toggle-status - Toggle status - GET /{client_id}/address - Get address info - GET /{client_id}/programs - Get programs info - GET /{client_id}/basic - Get basic info GParts Module (/parts): - POST / - Create part - GET / - List all with pagination and filters - GET /client/{client_key} - Get parts by client - GET /search/fraction/{fraction} - Search by tariff fraction - GET /search/supplier/{supplier} - Search by supplier - GET /search/country/{country_code} - Search by country - GET /statistics - Get parts statistics - GET /{client_key}/{part_number} - Get specific part - PUT /{client_key}/{part_number} - Update part - DELETE /{client_key}/{part_number} - Delete part - PATCH /{client_key}/{part_number}/toggle-status - Toggle status - GET /{client_key}/{part_number}/basic - Get basic info - GET /{client_key}/{part_number}/regulatory - Get regulatory info GClass Module (/classes): - POST / - Create class - GET / - List all with pagination and filters - GET /client/{client_key} - Get classes by client - GET /search/fraction/{fraction} - Search by tariff fraction - GET /search/material/{material_key} - Search by material - GET /search/unit-measure/{unit_of_measure} - Search by unit of measure - GET /search/physical-review/{physical_review} - Search by physical review status - GET /statistics - Get class statistics - GET /{client_key}/{class_code} - Get specific class - PUT /{client_key}/{class_code} - Update class - DELETE /{client_key}/{class_code} - Delete class - GET /{client_key}/{class_code}/basic - Get basic info - GET /{client_key}/{class_code}/tariff - Get tariff information 🏗️ Architecture: - Modular design with models, DTOs, services, and routes for each entity - English field names with composite primary keys where applicable - Comprehensive CRUD operations with specialized search endpoints - SQLAlchemy relationships with proper foreign key constraints - Type-safe DTOs with Pydantic validation 📝 Documentation: - RELATIONSHIPS.md: Complete documentation of database relationships - Detailed type hints and comprehensive service methods - Consistent patterns across all modules for maintainability
183 lines
7.9 KiB
Python
183 lines
7.9 KiB
Python
"""
|
|
DTOs (Data Transfer Objects) para módulo de partes/componentes
|
|
Reemplaza schemas.py siguiendo enfoque DDD y estilo NestJS
|
|
"""
|
|
from pydantic import BaseModel, Field
|
|
from typing import Optional
|
|
from datetime import datetime
|
|
from decimal import Decimal
|
|
|
|
|
|
class PartCreateDTO(BaseModel):
|
|
"""DTO para crear una parte"""
|
|
client_key: int = Field(..., description="Client key")
|
|
part_number: str = Field(..., max_length=49, description="Part number")
|
|
fraction: Optional[str] = Field(None, max_length=10, description="Tariff fraction")
|
|
description_spanish: Optional[str] = Field(None, max_length=500, description="Description in Spanish")
|
|
description_english: Optional[str] = Field(None, max_length=500, description="Description in English")
|
|
part_class: Optional[str] = Field(None, max_length=8, description="Part class")
|
|
unit_of_measure: Optional[str] = Field(None, max_length=5, description="Unit of measure")
|
|
commercial_part_number: Optional[str] = Field(None, max_length=70, description="Commercial part number")
|
|
country_of_origin: Optional[str] = Field(None, max_length=3, description="Country of origin code")
|
|
|
|
# Pricing and currency
|
|
unit_cost: Optional[Decimal] = Field(None, description="Unit cost")
|
|
currency_type: Optional[str] = Field(None, max_length=2, description="Currency type")
|
|
currency_key: Optional[str] = Field(None, max_length=3, description="Currency key")
|
|
|
|
# Weight information
|
|
unit_weight: Optional[Decimal] = Field(None, description="Unit weight")
|
|
weight_type: Optional[str] = Field(None, max_length=6, description="Weight type")
|
|
|
|
# Classification and regulatory
|
|
us_fraction: Optional[str] = Field(None, max_length=16, description="US tariff fraction")
|
|
fda_key: Optional[str] = Field(None, max_length=20, description="FDA key")
|
|
fcc_key: Optional[str] = Field(None, max_length=30, description="FCC key")
|
|
license_code: Optional[str] = Field(None, max_length=3, description="License code")
|
|
eccn: Optional[str] = Field(None, max_length=20, description="Export Control Classification Number")
|
|
export_code: Optional[str] = Field(None, max_length=2, description="Export code")
|
|
exclusion_symbol: Optional[str] = Field(None, max_length=19, description="Exclusion symbol")
|
|
|
|
# Additional information
|
|
supplier: Optional[str] = Field(None, max_length=14, description="Supplier")
|
|
alternate_unit_measure: Optional[str] = Field(None, max_length=14, description="Alternate unit of measure")
|
|
added_value: Optional[Decimal] = Field(None, description="Added value")
|
|
|
|
# Status and media
|
|
enabled_disabled: Optional[int] = Field(None, description="Enabled/Disabled status")
|
|
creation_date: Optional[int] = Field(None, description="Creation date")
|
|
part_photo: Optional[str] = Field(None, max_length=255, description="Part photo URL")
|
|
|
|
class Config:
|
|
from_attributes = True
|
|
|
|
|
|
class PartUpdateDTO(BaseModel):
|
|
"""DTO para actualizar una parte"""
|
|
fraction: Optional[str] = Field(None, max_length=10, description="Tariff fraction")
|
|
description_spanish: Optional[str] = Field(None, max_length=500, description="Description in Spanish")
|
|
description_english: Optional[str] = Field(None, max_length=500, description="Description in English")
|
|
part_class: Optional[str] = Field(None, max_length=8, description="Part class")
|
|
unit_of_measure: Optional[str] = Field(None, max_length=5, description="Unit of measure")
|
|
commercial_part_number: Optional[str] = Field(None, max_length=70, description="Commercial part number")
|
|
country_of_origin: Optional[str] = Field(None, max_length=3, description="Country of origin code")
|
|
|
|
# Pricing and currency
|
|
unit_cost: Optional[Decimal] = Field(None, description="Unit cost")
|
|
currency_type: Optional[str] = Field(None, max_length=2, description="Currency type")
|
|
currency_key: Optional[str] = Field(None, max_length=3, description="Currency key")
|
|
|
|
# Weight information
|
|
unit_weight: Optional[Decimal] = Field(None, description="Unit weight")
|
|
weight_type: Optional[str] = Field(None, max_length=6, description="Weight type")
|
|
|
|
# Classification and regulatory
|
|
us_fraction: Optional[str] = Field(None, max_length=16, description="US tariff fraction")
|
|
fda_key: Optional[str] = Field(None, max_length=20, description="FDA key")
|
|
fcc_key: Optional[str] = Field(None, max_length=30, description="FCC key")
|
|
license_code: Optional[str] = Field(None, max_length=3, description="License code")
|
|
eccn: Optional[str] = Field(None, max_length=20, description="Export Control Classification Number")
|
|
export_code: Optional[str] = Field(None, max_length=2, description="Export code")
|
|
exclusion_symbol: Optional[str] = Field(None, max_length=19, description="Exclusion symbol")
|
|
|
|
# Additional information
|
|
supplier: Optional[str] = Field(None, max_length=14, description="Supplier")
|
|
alternate_unit_measure: Optional[str] = Field(None, max_length=14, description="Alternate unit of measure")
|
|
added_value: Optional[Decimal] = Field(None, description="Added value")
|
|
|
|
# Status and media
|
|
enabled_disabled: Optional[int] = Field(None, description="Enabled/Disabled status")
|
|
part_photo: Optional[str] = Field(None, max_length=255, description="Part photo URL")
|
|
|
|
class Config:
|
|
from_attributes = True
|
|
|
|
|
|
class PartResponseDTO(BaseModel):
|
|
"""DTO para respuesta de parte"""
|
|
client_key: int
|
|
part_number: str
|
|
fraction: Optional[str] = None
|
|
description_spanish: Optional[str] = None
|
|
description_english: Optional[str] = None
|
|
part_class: Optional[str] = None
|
|
unit_of_measure: Optional[str] = None
|
|
commercial_part_number: Optional[str] = None
|
|
country_of_origin: Optional[str] = None
|
|
|
|
# Pricing and currency
|
|
unit_cost: Optional[Decimal] = None
|
|
currency_type: Optional[str] = None
|
|
currency_key: Optional[str] = None
|
|
|
|
# Weight information
|
|
unit_weight: Optional[Decimal] = None
|
|
weight_type: Optional[str] = None
|
|
|
|
# Classification and regulatory
|
|
us_fraction: Optional[str] = None
|
|
fda_key: Optional[str] = None
|
|
fcc_key: Optional[str] = None
|
|
license_code: Optional[str] = None
|
|
eccn: Optional[str] = None
|
|
export_code: Optional[str] = None
|
|
exclusion_symbol: Optional[str] = None
|
|
|
|
# Additional information
|
|
supplier: Optional[str] = None
|
|
alternate_unit_measure: Optional[str] = None
|
|
added_value: Optional[Decimal] = None
|
|
|
|
# Status and dates
|
|
enabled_disabled: Optional[int] = None
|
|
creation_date: Optional[int] = None
|
|
modification_date: Optional[int] = None
|
|
modification_date_iso: Optional[datetime] = None
|
|
|
|
# Media
|
|
part_photo: Optional[str] = None
|
|
|
|
class Config:
|
|
from_attributes = True
|
|
|
|
|
|
class PartBasicDTO(BaseModel):
|
|
"""DTO para información básica de parte"""
|
|
client_key: int
|
|
part_number: str
|
|
description_spanish: Optional[str] = None
|
|
description_english: Optional[str] = None
|
|
part_class: Optional[str] = None
|
|
unit_cost: Optional[Decimal] = None
|
|
currency_key: Optional[str] = None
|
|
enabled_disabled: Optional[int] = None
|
|
|
|
class Config:
|
|
from_attributes = True
|
|
|
|
|
|
class PartListDTO(BaseModel):
|
|
"""DTO para lista de partes"""
|
|
parts: list[PartBasicDTO]
|
|
total: int
|
|
page: int
|
|
size: int
|
|
|
|
class Config:
|
|
from_attributes = True
|
|
|
|
|
|
class PartSearchDTO(BaseModel):
|
|
"""DTO para búsqueda de partes"""
|
|
client_key: Optional[int] = Field(None, description="Filter by client key")
|
|
part_number: Optional[str] = Field(None, description="Search by part number")
|
|
description: Optional[str] = Field(None, description="Search in descriptions")
|
|
fraction: Optional[str] = Field(None, description="Filter by tariff fraction")
|
|
supplier: Optional[str] = Field(None, description="Filter by supplier")
|
|
enabled_only: bool = Field(False, description="Show only enabled parts")
|
|
|
|
class Config:
|
|
from_attributes = True
|
|
|
|
|