constec 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

constec/db/models/organization.py

@@ -0,0 +1,62 @@
+from django.db import models
+from .base import UUIDModel
+
+
+class Organization(UUIDModel):
+    """Platform-level tenant (e.g., Constec itself)."""
+    name = models.CharField(max_length=255)
+    slug = models.SlugField(max_length=100, unique=True)
+    description = models.TextField(blank=True, null=True)
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'core"."organizations'
+
+    def __str__(self):
+        return self.name
+
+
+class OrganizationRole(UUIDModel):
+    """Roles within an organization."""
+    organization = models.ForeignKey(
+        Organization,
+        on_delete=models.CASCADE,
+        related_name="organization_roles",
+        null=True,
+        blank=True
+    )
+    name = models.CharField(max_length=100)
+    description = models.TextField(blank=True, null=True)
+    permissions = models.JSONField(default=dict)
+    is_system_role = models.BooleanField(default=False)
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'core"."organization_roles'
+        unique_together = [['organization', 'name']]
+
+    def __str__(self):
+        return self.name
+
+
+class OrganizationUser(UUIDModel):
+    """Administrator users at organization level."""
+    organization = models.ForeignKey(
+        Organization,
+        on_delete=models.CASCADE,
+        related_name="users",
+    )
+    name = models.CharField(max_length=255)
+    email = models.EmailField(unique=True)
+    password_hash = models.CharField(max_length=255)
+    role = models.ForeignKey(
+        OrganizationRole,
+        on_delete=models.PROTECT
+    )
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'core"."organization_users'
+
+    def __str__(self):
+        return f"{self.name} ({self.email})"

constec/db/models/person.py

@@ -0,0 +1,28 @@
+from django.db import models
+from .base import UUIDModel
+from .company import Company
+
+
+class Person(UUIDModel):
+    """Real person (customer, supplier, employee)."""
+    company = models.ForeignKey(
+        Company,
+        on_delete=models.CASCADE,
+        related_name="persons",
+    )
+    first_name = models.CharField(max_length=100)
+    last_name = models.CharField(max_length=100)
+    full_name = models.CharField(max_length=255)
+    metadata = models.JSONField(default=dict, blank=True)
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'core"."persons'
+
+    def __str__(self):
+        return f"{self.full_name}"
+
+    def save(self, *args, **kwargs):
+        """Auto-generate full_name from first_name and last_name."""
+        self.full_name = f"{self.first_name} {self.last_name}"
+        super().save(*args, **kwargs)

constec/db/models/session.py

@@ -0,0 +1,94 @@
+from django.db import models
+from .base import UUIDModel
+from .company import Company
+from .person import Person
+from .flow import Flow
+
+
+class Session(UUIDModel):
+    """Conversation session between a user and the AI agent.
+
+    Tracks the conversation context including company, user, and permissions.
+    All MCP tools receive the session_id to know who is making the request.
+    """
+
+    company = models.ForeignKey(
+        Company,
+        on_delete=models.CASCADE,
+        related_name="sessions",
+        help_text="The company this session belongs to"
+    )
+    user = models.ForeignKey(
+        Person,
+        on_delete=models.CASCADE,
+        related_name="sessions",
+        help_text="The person chatting (can be employee or client)"
+    )
+    flow = models.ForeignKey(
+        Flow,
+        on_delete=models.PROTECT,
+        related_name="sessions",
+        help_text="AI flow configuration to use"
+    )
+
+    metadata = models.JSONField(
+        default=dict,
+        help_text="Session context (connection, role, etc.)"
+    )
+
+    is_active = models.BooleanField(default=True)
+    ended_at = models.DateTimeField(null=True, blank=True)
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'constancia"."sessions'
+        indexes = [
+            models.Index(fields=['company', 'is_active']),
+            models.Index(fields=['user', 'is_active']),
+            models.Index(fields=['-created_at']),
+        ]
+
+    def __str__(self):
+        return f"Session {self.id} - {self.user} @ {self.company.name}"
+
+
+class Message(UUIDModel):
+    """Message in a conversation session.
+
+    Stores the conversation history between user and AI assistant.
+    """
+
+    ROLE_CHOICES = [
+        ('user', 'User'),
+        ('assistant', 'Assistant'),
+    ]
+
+    session = models.ForeignKey(
+        Session,
+        on_delete=models.CASCADE,
+        related_name="messages",
+    )
+    role = models.CharField(max_length=20, choices=ROLE_CHOICES)
+    content = models.TextField()
+
+    metadata = models.JSONField(
+        default=dict,
+        blank=True,
+        help_text="Additional message data: tool calls, errors, context, etc."
+    )
+
+    created_at = models.DateTimeField(auto_now_add=True)
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'constancia"."messages'
+        ordering = ['created_at']
+        indexes = [
+            models.Index(fields=['session', 'created_at']),
+        ]
+
+    def __str__(self):
+        preview = self.content[:50] + "..." if len(self.content) > 50 else self.content
+        return f"{self.role}: {preview}"

constec/db/models/tag.py

@@ -0,0 +1,68 @@
+from django.db import models
+from .base import UUIDModel
+from .person import Person
+from .company import Company
+
+
+class TagCategory(UUIDModel):
+    """Tag categories per company."""
+    company = models.ForeignKey(
+        Company,
+        on_delete=models.CASCADE,
+        related_name="tag_categories",
+    )
+    name = models.CharField(max_length=50)
+    description = models.TextField(blank=True, null=True)
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'core"."tag_categories'
+
+    def __str__(self):
+        return f"{self.name}"
+
+
+class PersonTag(UUIDModel):
+    """Tags for persons."""
+    company = models.ForeignKey(
+        Company,
+        on_delete=models.CASCADE,
+        related_name="person_tags",
+    )
+    category = models.ForeignKey(
+        TagCategory,
+        on_delete=models.CASCADE,
+        related_name="person_tags",
+    )
+    name = models.CharField(max_length=50)
+    color = models.CharField(max_length=7, blank=True, null=True)
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'core"."person_tags'
+        unique_together = [['company', 'category', 'name']]
+
+    def __str__(self):
+        return f"{self.name}"
+
+
+class PersonTagged(UUIDModel):
+    """Person-tag relationship."""
+    person = models.ForeignKey(
+        Person,
+        on_delete=models.CASCADE,
+        related_name="tagged_items",
+    )
+    tag = models.ForeignKey(
+        PersonTag,
+        on_delete=models.CASCADE,
+        related_name="tagged_persons",
+    )
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'core"."person_tagged'
+        unique_together = [['person', 'tag']]
+
+    def __str__(self):
+        return f"{self.person.full_name} - {self.tag.name}"

constec/db/models/user.py

@@ -0,0 +1,72 @@
+from django.db import models
+from .base import UUIDModel
+from .company import Company
+
+
+class User(UUIDModel):
+    """User belonging to a company."""
+    company = models.ForeignKey(
+        Company,
+        on_delete=models.CASCADE,
+        related_name="users"
+    )
+    name = models.CharField(max_length=255)
+    email = models.EmailField(unique=True)
+    password_hash = models.CharField(max_length=255)
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'core"."users'
+
+    def __str__(self):
+        return f"{self.name} ({self.email})"
+
+
+class UserRole(UUIDModel):
+    """Role within a company."""
+    company = models.ForeignKey(
+        Company,
+        on_delete=models.CASCADE,
+        related_name="user_roles",
+        null=True,
+        blank=True
+    )
+    name = models.CharField(max_length=100)
+    description = models.TextField(blank=True, null=True)
+    permissions = models.JSONField(default=dict)
+    is_system_role = models.BooleanField(default=False)
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'core"."user_roles'
+        unique_together = [['company', 'name']]
+
+    def __str__(self):
+        return f"{self.name}"
+
+
+class UserCompanyAccess(UUIDModel):
+    """Cross-company access: one User can access multiple Companies."""
+    user = models.ForeignKey(
+        User,
+        on_delete=models.CASCADE,
+        related_name="company_accesses",
+    )
+    company = models.ForeignKey(
+        Company,
+        on_delete=models.CASCADE,
+        related_name="user_accesses",
+    )
+    role = models.ForeignKey(
+        UserRole,
+        on_delete=models.PROTECT,
+        related_name="user_accesses",
+    )
+
+    class Meta:
+        app_label = 'constec_db'
+        db_table = 'core"."user_company_access'
+        unique_together = [['user', 'company']]
+
+    def __str__(self):
+        return f"{self.user.email} @ {self.company.name} ({self.role.name})"

constec/services/__init__.py

@@ -0,0 +1,14 @@
+"""
+constec.services - Shared services for the Constec platform.
+
+Usage:
+    from constec.services import encrypt_password, decrypt_password
+"""
+
+from .encryption import encrypt_password, decrypt_password, EncryptionService
+
+__all__ = [
+    'encrypt_password',
+    'decrypt_password',
+    'EncryptionService',
+]

constec/services/encryption.py

@@ -0,0 +1,92 @@
+"""
+Fernet encryption for sensitive data like database passwords.
+
+Usage:
+    from constec.services import encrypt_password, decrypt_password
+
+    # Encrypt
+    encrypted = encrypt_password("my_password", fernet_key)
+
+    # Decrypt
+    password = decrypt_password(encrypted, fernet_key)
+
+The FERNET_KEY should be stored in environment variables and never committed.
+Generate a new key with:
+    from cryptography.fernet import Fernet
+    print(Fernet.generate_key().decode())
+"""
+
+from cryptography.fernet import Fernet, InvalidToken
+
+
+class EncryptionService:
+    """Service for encrypting and decrypting sensitive data."""
+
+    def __init__(self, key: str):
+        """
+        Initialize with Fernet key.
+
+        Args:
+            key: Fernet key as string (will be encoded to bytes)
+        """
+        self._fernet = Fernet(key.encode() if isinstance(key, str) else key)
+
+    def encrypt(self, plaintext: str) -> str:
+        """
+        Encrypt a string.
+
+        Args:
+            plaintext: String to encrypt
+
+        Returns:
+            Encrypted string (base64 encoded)
+        """
+        return self._fernet.encrypt(plaintext.encode()).decode()
+
+    def decrypt(self, ciphertext: str) -> str:
+        """
+        Decrypt a string.
+
+        Args:
+            ciphertext: Encrypted string (base64 encoded)
+
+        Returns:
+            Decrypted string
+
+        Raises:
+            InvalidToken: If decryption fails (wrong key or corrupted data)
+        """
+        return self._fernet.decrypt(ciphertext.encode()).decode()
+
+
+def encrypt_password(password: str, fernet_key: str) -> str:
+    """
+    Encrypt a password using Fernet symmetric encryption.
+
+    Args:
+        password: Plain text password
+        fernet_key: Fernet encryption key
+
+    Returns:
+        Encrypted password (base64 encoded string)
+    """
+    service = EncryptionService(fernet_key)
+    return service.encrypt(password)
+
+
+def decrypt_password(encrypted_password: str, fernet_key: str) -> str:
+    """
+    Decrypt a password using Fernet symmetric encryption.
+
+    Args:
+        encrypted_password: Encrypted password (base64 encoded string)
+        fernet_key: Fernet encryption key
+
+    Returns:
+        Decrypted password
+
+    Raises:
+        InvalidToken: If decryption fails
+    """
+    service = EncryptionService(fernet_key)
+    return service.decrypt(encrypted_password)

constec/utils/__init__.py

@@ -0,0 +1,20 @@
+"""
+constec.utils - Shared utilities for the Constec platform.
+
+Usage:
+    from constec.utils import normalize_cuit, validate_cuit
+    from constec.utils import hash_password, verify_password
+"""
+
+from .cuit import normalize_cuit, validate_cuit, format_cuit
+from .password import hash_password, verify_password
+
+__all__ = [
+    # CUIT
+    'normalize_cuit',
+    'validate_cuit',
+    'format_cuit',
+    # Password
+    'hash_password',
+    'verify_password',
+]

constec/utils/cuit.py

@@ -0,0 +1,107 @@
+"""
+CUIT (Clave Única de Identificación Tributaria) utilities.
+
+Argentine tax identification number format: XX-XXXXXXXX-X
+- First 2 digits: Type (20=person, 23/24=company, 27=foreign, 30/33/34=company)
+- Middle 8 digits: ID number
+- Last digit: Verification digit
+
+Usage:
+    from constec.utils import normalize_cuit, validate_cuit, format_cuit
+
+    # Normalize (remove dashes)
+    normalized = normalize_cuit("20-12345678-9")  # "20123456789"
+
+    # Validate
+    is_valid = validate_cuit("20-12345678-9")  # True/False
+
+    # Format (add dashes)
+    formatted = format_cuit("20123456789")  # "20-12345678-9"
+"""
+
+import re
+
+
+def normalize_cuit(cuit: str) -> str:
+    """
+    Normalize CUIT by removing dashes and spaces.
+
+    Args:
+        cuit: CUIT string (with or without dashes)
+
+    Returns:
+        CUIT without dashes (11 digits)
+
+    Examples:
+        >>> normalize_cuit("20-12345678-9")
+        '20123456789'
+        >>> normalize_cuit("20 12345678 9")
+        '20123456789'
+    """
+    return re.sub(r'[\s\-]', '', cuit)
+
+
+def format_cuit(cuit: str) -> str:
+    """
+    Format CUIT with dashes (XX-XXXXXXXX-X).
+
+    Args:
+        cuit: CUIT string (11 digits, with or without dashes)
+
+    Returns:
+        Formatted CUIT with dashes
+
+    Examples:
+        >>> format_cuit("20123456789")
+        '20-12345678-9'
+    """
+    normalized = normalize_cuit(cuit)
+    if len(normalized) != 11:
+        return cuit  # Return as-is if invalid length
+    return f"{normalized[:2]}-{normalized[2:10]}-{normalized[10]}"
+
+
+def _calculate_verification_digit(cuit_base: str) -> int:
+    """Calculate the CUIT verification digit using mod 11 algorithm."""
+    weights = [5, 4, 3, 2, 7, 6, 5, 4, 3, 2]
+    total = sum(int(d) * w for d, w in zip(cuit_base, weights))
+    remainder = total % 11
+
+    if remainder == 0:
+        return 0
+    elif remainder == 1:
+        return 9  # Special case for type 23 (women)
+    else:
+        return 11 - remainder
+
+
+def validate_cuit(cuit: str) -> bool:
+    """
+    Validate a CUIT using the verification digit algorithm.
+
+    Args:
+        cuit: CUIT string (with or without dashes)
+
+    Returns:
+        True if valid, False otherwise
+
+    Examples:
+        >>> validate_cuit("20-12345678-9")
+        True  # (if verification digit is correct)
+    """
+    normalized = normalize_cuit(cuit)
+
+    # Must be exactly 11 digits
+    if not re.match(r'^\d{11}$', normalized):
+        return False
+
+    # Valid type prefixes
+    valid_types = ['20', '23', '24', '27', '30', '33', '34']
+    if normalized[:2] not in valid_types:
+        return False
+
+    # Verify check digit
+    expected_digit = _calculate_verification_digit(normalized[:10])
+    actual_digit = int(normalized[10])
+
+    return expected_digit == actual_digit

constec/utils/password.py

@@ -0,0 +1,62 @@
+"""
+Password hashing utilities using bcrypt.
+
+Usage:
+    from constec.utils import hash_password, verify_password
+
+    # Hash a password
+    hashed = hash_password("my_password")
+
+    # Verify a password
+    is_valid = verify_password("my_password", hashed)  # True
+"""
+
+import bcrypt
+
+
+def hash_password(password: str, rounds: int = 12) -> str:
+    """
+    Hash a password using bcrypt.
+
+    Args:
+        password: Plain text password
+        rounds: Cost factor (default 12, higher = slower but more secure)
+
+    Returns:
+        Bcrypt hash as string
+
+    Example:
+        >>> hashed = hash_password("secret123")
+        >>> hashed.startswith("$2b$")
+        True
+    """
+    salt = bcrypt.gensalt(rounds=rounds)
+    hashed = bcrypt.hashpw(password.encode('utf-8'), salt)
+    return hashed.decode('utf-8')
+
+
+def verify_password(password: str, hashed: str) -> bool:
+    """
+    Verify a password against a bcrypt hash.
+
+    Args:
+        password: Plain text password to verify
+        hashed: Bcrypt hash to verify against
+
+    Returns:
+        True if password matches, False otherwise
+
+    Example:
+        >>> hashed = hash_password("secret123")
+        >>> verify_password("secret123", hashed)
+        True
+        >>> verify_password("wrong", hashed)
+        False
+    """
+    try:
+        return bcrypt.checkpw(
+            password.encode('utf-8'),
+            hashed.encode('utf-8')
+        )
+    except (ValueError, TypeError):
+        return False

{constec-0.1.0.dist-info → constec-0.2.0.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: constec
-Version: 0.1.0
-Summary: Base library for the Constec ecosystem - shared utilities and namespace foundation
+Version: 0.2.0
+Summary: Base library for the Constec ecosystem - shared utilities, models, and namespace foundation
 License: MIT
 Project-URL: Homepage, https://github.com/TpmyCT/constec-python
 Project-URL: Repository, https://github.com/TpmyCT/constec-python
@@ -15,9 +15,19 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Typing :: Typed
+Classifier: Framework :: Django :: 4.2
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Provides-Extra: db
+Requires-Dist: Django>=4.2; extra == "db"
+Provides-Extra: services
+Requires-Dist: cryptography>=41.0; extra == "services"
+Requires-Dist: bcrypt>=4.0; extra == "services"
+Provides-Extra: utils
+Requires-Dist: bcrypt>=4.0; extra == "utils"
+Provides-Extra: all
+Requires-Dist: constec[db,services,utils]; extra == "all"
 Dynamic: license-file
 
 # Constec

constec-0.2.0.dist-info/RECORD

@@ -0,0 +1,33 @@
+constec/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+constec/db/__init__.py,sha256=wou_y3aqCg1xP8Gr13FKRy0kEI2avV-19G3P2g3bzjs,287
+constec/db/apps.py,sha256=zc-9lGNa049q9bvxV7957EwnZjuBozPLZq594cKAU24,221
+constec/db/migrations/0001_initial.py,sha256=OdNHJg1IgsjcpaFgolFG9e5HFEQZkuoFtJ81pi1UZ5U,28224
+constec/db/migrations/0002_alter_companysystem_table_alter_connection_table_and_more.py,sha256=e6ygltUq_ObFXykDn9I-aypqxtBvMQg-0NcuSMoqaOc,911
+constec/db/migrations/0003_add_is_active_to_company.py,sha256=kfMpnxkkOuJH2W81GYoKmT3qHvooyi22BGuFOSVqbJY,433
+constec/db/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+constec/db/models/__init__.py,sha256=xsER3dtbsj14mSb52v1Mf1bE0RzKbvrvwD6xti2RN5s,2132
+constec/db/models/base.py,sha256=1t_eYXYyggoL5fKLcitRPKr1qUE1Ql3_sOmSHQMD3QE,359
+constec/db/models/company.py,sha256=VZMt6gmsEWBL6VPUYzTPYOngBqL3mPYmZ6ZuCiz5Jeo,1055
+constec/db/models/contact.py,sha256=qzkekZBNBtusFMpZRANxwKjtDN9qCxc4BMz-H7RyWM0,1904
+constec/db/models/erp.py,sha256=sN0U0XCMNW-pc9CNLZG_kPZeWXznq_XU3ML2zJ3arjA,3518
+constec/db/models/erp_entity.py,sha256=lJG0sU7YfehuxoqrxmpvuCSG0_GsardU5DvwBgMKsW8,3412
+constec/db/models/flow.py,sha256=K_UA7E4zJ2-UPNp5H9e-lfPeGn0wDEiOl0cRal4Dmb8,4414
+constec/db/models/group.py,sha256=ueCOIfpmzR683ojWf5vLb6IG_jawfVRM7IJcGK05I3Y,897
+constec/db/models/module.py,sha256=na_7pJw8Q2D2UkF86ZwK5VdJnV87yqUOMBvaBLw4KgI,1218
+constec/db/models/organization.py,sha256=9dbsh5UBShtDRAeyMqqQEPEaflhzS3aiZpRWUiEluBU,1731
+constec/db/models/person.py,sha256=B4BNdy2AgqmxrZrkWWvqnFxFHs4uO1n61Y_5sP6MsUo,848
+constec/db/models/session.py,sha256=HeIk5rK25IaxKBRX-XNuJ75ndjJZ08rAdSGTLvTwlLE,2695
+constec/db/models/tag.py,sha256=wgJYoffXCO_-G7zhS1FLiQHFtJVbJKPV-wyRG3mwb74,1730
+constec/db/models/user.py,sha256=UzCgb47ZVg1cBN_Y5CIpZJeHSC8JOAYT_0xZE3d294Y,1921
+constec/services/__init__.py,sha256=LXGKIzaRf1gVG2y7oUc18EulUsJXHVs8-oz0nY2h7WA,312
+constec/services/encryption.py,sha256=rwfAGUC7kDy1bhezHPoZG1hTjajpEB6l3AgcfGtmdvg,2368
+constec/shared/__init__.py,sha256=Qe99OxBfwg3_4i4zyCQR20vCcyyaIULpLzUa0XfwBPg,435
+constec/shared/exceptions.py,sha256=8Bih40RWoH0gVhto09mH2ppSQV_drHPnGWITcoD-0J0,1335
+constec/utils/__init__.py,sha256=brf-G4UvU-3CK_rKNPTaHwsVsxnoJSbml_QTZJSM7d0,458
+constec/utils/cuit.py,sha256=dQKGlA4pRQ5DyR-N4BiV8ZsvAle2Vgjif7PU72zHx_A,2753
+constec/utils/password.py,sha256=XNpTJ9xZQSoZNjXEAnexAEZuYkwW1dFgX4AY-B5Q0gA,1462
+constec-0.2.0.dist-info/licenses/LICENSE,sha256=a1R51ONDGq0UQfV-n3ybsNL7EGhcC2sQ1sXvRANaFVI,1064
+constec-0.2.0.dist-info/METADATA,sha256=Qa43yajTCNkSvEodrX0OmBs6iy27qVrvR_LxE-e7CVU,2954
+constec-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+constec-0.2.0.dist-info/top_level.txt,sha256=bQ9AydOLlthShsr7tA7t7ivbLvlLPdhHOo0BdWgnh_Y,8
+constec-0.2.0.dist-info/RECORD,,