chore(models): add missing model stubs and fix INET import to restore profile API startup

docs/hflogs/runtimeerror.txt

@@ -1,4 +1,4 @@
-===== Application Startup at 2025-11-16 00:14:51 =====
+===== Application Startup at 2025-11-16 00:17:04 =====
 
 Traceback (most recent call last):
   File "/usr/local/bin/uvicorn", line 8, in <module>
@@ -35,6 +35,8 @@ Traceback (most recent call last):
   File "/usr/local/lib/python3.11/site-packages/uvicorn/config.py", line 467, in load
     self.loaded_app = import_from_string(self.app)
                       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/importer.py", line 24, in import_from_string
+    raise exc from None
   File "/usr/local/lib/python3.11/site-packages/uvicorn/importer.py", line 21, in import_from_string
     module = importlib.import_module(module_str)
              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -51,10 +53,62 @@ Traceback (most recent call last):
     from app.api.v1.router import api_router
   File "/app/src/app/api/v1/router.py", line 5, in <module>
     from app.api.v1 import auth, clients, contractors, invitations, profile
-  File "/app/src/app/api/v1/auth.py", line 14, in <module>
-    from app.services.audit_service import AuditService
-  File "/app/src/app/services/audit_service.py", line 9, in <module>
-    from app.models.audit_log import AuditLog
-  File "/app/src/app/models/audit_log.py", line 4, in <module>
-    from sqlalchemy import Column, String, Text, INET
-ImportError: cannot import name 'INET' from 'sqlalchemy' (/usr/local/lib/python3.11/site-packages/sqlalchemy/__init__.py)
+  File "/app/src/app/api/v1/profile.py", line 12, in <module>
+    from app.models.user_financial_account import UserFinancialAccount
+ModuleNotFoundError: No module named 'app.models.user_financial_account'
+Traceback (most recent call last):
+  File "/usr/local/bin/uvicorn", line 8, in <module>
+    sys.exit(main())
+             ^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1485, in __call__
+    return self.main(*args, **kwargs)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1406, in main
+    rv = self.invoke(ctx)
+         ^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 1269, in invoke
+    return ctx.invoke(self.callback, **ctx.params)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/click/core.py", line 824, in invoke
+    return callback(*args, **kwargs)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/main.py", line 416, in main
+    run(
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/main.py", line 587, in run
+    server.run()
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/server.py", line 61, in run
+    return asyncio.run(self.serve(sockets=sockets))
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/asyncio/runners.py", line 190, in run
+    return runner.run(main)
+           ^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/asyncio/runners.py", line 118, in run
+    return self._loop.run_until_complete(task)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "uvloop/loop.pyx", line 1518, in uvloop.loop.Loop.run_until_complete
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/server.py", line 68, in serve
+    config.load()
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/config.py", line 467, in load
+    self.loaded_app = import_from_string(self.app)
+                      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/importer.py", line 24, in import_from_string
+    raise exc from None
+  File "/usr/local/lib/python3.11/site-packages/uvicorn/importer.py", line 21, in import_from_string
+    module = importlib.import_module(module_str)
+             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "/usr/local/lib/python3.11/importlib/__init__.py", line 126, in import_module
+    return _bootstrap._gcd_import(name[level:], package, level)
+           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  File "<frozen importlib._bootstrap>", line 1204, in _gcd_import
+  File "<frozen importlib._bootstrap>", line 1176, in _find_and_load
+  File "<frozen importlib._bootstrap>", line 1147, in _find_and_load_unlocked
+  File "<frozen importlib._bootstrap>", line 690, in _load_unlocked
+  File "<frozen importlib._bootstrap_external>", line 940, in exec_module
+  File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed
+  File "/app/src/app/main.py", line 187, in <module>
+    from app.api.v1.router import api_router
+  File "/app/src/app/api/v1/router.py", line 5, in <module>
+    from app.api.v1 import auth, clients, contractors, invitations, profile
+  File "/app/src/app/api/v1/profile.py", line 12, in <module>
+    from app.models.user_financial_account import UserFinancialAccount
+ModuleNotFoundError: No module named 'app.models.user_financial_account'

src/app/models/project_team.py

@@ -0,0 +1,33 @@
+"""
+Project Team Model
+"""
+from sqlalchemy import Column, String, Boolean
+from sqlalchemy.dialects.postgresql import UUID
+from datetime import datetime
+from app.core.database import Base
+import uuid
+
+
+class ProjectTeam(Base):
+    """
+    Project Team model - Links users to projects with their roles
+    """
+    __tablename__ = "project_team"
+    
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    project_id = Column(UUID(as_uuid=True), nullable=False)
+    user_id = Column(UUID(as_uuid=True), nullable=False)
+    project_role_id = Column(UUID(as_uuid=True), nullable=True)
+    
+    # Status
+    is_assigned_slot = Column(Boolean, default=True)
+    
+    # Timestamps
+    assigned_at = Column(String(50), default=lambda: datetime.utcnow().isoformat())
+    removed_at = Column(String(50), nullable=True)
+    created_at = Column(String(50), default=lambda: datetime.utcnow().isoformat())
+    updated_at = Column(String(50), default=lambda: datetime.utcnow().isoformat())
+    deleted_at = Column(String(50), nullable=True)
+    
+    def __repr__(self):
+        return f"<ProjectTeam(project_id='{self.project_id}', user_id='{self.user_id}')>"

src/app/models/user_asset_assignment.py

@@ -0,0 +1,42 @@
+"""
+User Asset Assignment Model
+"""
+from sqlalchemy import Column, String, Boolean, DECIMAL, Text
+from sqlalchemy.dialects.postgresql import UUID
+from datetime import datetime
+from app.core.database import Base
+import uuid
+
+
+class UserAssetAssignment(Base):
+    """
+    User Asset Assignment model - Long-term equipment assigned to users
+    """
+    __tablename__ = "user_asset_assignments"
+    
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    user_id = Column(UUID(as_uuid=True), nullable=False)
+    
+    # Asset descriptors
+    asset_type = Column(Text, nullable=False)  # 'PPE', 'Laptop', 'Phone', 'Vehicle', 'Tools'
+    asset_name = Column(Text, nullable=False)
+    asset_description = Column(Text)
+    serial_number = Column(Text)
+    registration_number = Column(Text)
+    
+    # Valuation
+    asset_value = Column(DECIMAL(12, 2))
+    currency = Column(Text, default='KES')
+    
+    # Status
+    is_active = Column(Boolean, default=True)
+    
+    # Timestamps
+    assigned_at = Column(String(50), default=lambda: datetime.utcnow().isoformat())
+    returned_at = Column(String(50), nullable=True)
+    created_at = Column(String(50), default=lambda: datetime.utcnow().isoformat())
+    updated_at = Column(String(50), default=lambda: datetime.utcnow().isoformat())
+    deleted_at = Column(String(50), nullable=True)
+    
+    def __repr__(self):
+        return f"<UserAssetAssignment(user_id='{self.user_id}', asset='{self.asset_name}')>"

src/app/models/user_document_link.py

@@ -0,0 +1,37 @@
+"""
+User Document Link Model
+"""
+from sqlalchemy import Column, String, Text, Date
+from sqlalchemy.dialects.postgresql import UUID, JSONB
+from datetime import datetime
+from app.core.database import Base
+import uuid
+
+
+class UserDocumentLink(Base):
+    """
+    User Document Link model - Links users to their identity/compliance documents
+    """
+    __tablename__ = "user_document_links"
+    
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    user_id = Column(UUID(as_uuid=True), nullable=False)
+    document_id = Column(UUID(as_uuid=True), nullable=False)
+    
+    # Document type
+    document_link_type = Column(Text, nullable=False)  # 'national_id', 'driver_license', etc.
+    
+    # Expiry tracking
+    issued_at = Column(Date)
+    expires_at = Column(Date)
+    
+    # Metadata
+    notes = Column(Text)
+    additional_metadata = Column(JSONB, default=dict)
+    
+    # Timestamps
+    created_at = Column(String(50), default=lambda: datetime.utcnow().isoformat())
+    updated_at = Column(String(50), default=lambda: datetime.utcnow().isoformat())
+    
+    def __repr__(self):
+        return f"<UserDocumentLink(user_id='{self.user_id}', type='{self.document_link_type}')>"

src/app/models/user_financial_account.py

@@ -0,0 +1,47 @@
+"""
+User Financial Account Model
+"""
+from sqlalchemy import Column, String, Boolean, DECIMAL, Text
+from sqlalchemy.dialects.postgresql import UUID
+from datetime import datetime
+from app.core.database import Base
+import uuid
+
+
+class UserFinancialAccount(Base):
+    """
+    User Financial Account model - Payout details for users
+    """
+    __tablename__ = "user_financial_accounts"
+    
+    id = Column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
+    user_id = Column(UUID(as_uuid=True), nullable=False)
+    
+    # Account Details
+    account_name = Column(Text, nullable=False)
+    payout_method = Column(String(50), nullable=False)
+    
+    # Mobile money details
+    mobile_money_provider = Column(Text)
+    mobile_money_phone = Column(Text)
+    mobile_money_account_name = Column(Text)
+    
+    # Bank details
+    bank_name = Column(Text)
+    bank_account_name = Column(Text)
+    bank_account_number = Column(Text)
+    bank_branch = Column(Text)
+    bank_swift_code = Column(Text)
+    
+    # Status
+    is_primary = Column(Boolean, default=False)
+    is_active = Column(Boolean, default=True)
+    is_verified = Column(Boolean, default=False)
+    
+    # Timestamps
+    created_at = Column(String(50), default=lambda: datetime.utcnow().isoformat())
+    updated_at = Column(String(50), default=lambda: datetime.utcnow().isoformat())
+    deleted_at = Column(String(50), nullable=True)
+    
+    def __repr__(self):
+        return f"<UserFinancialAccount(user_id='{self.user_id}', method='{self.payout_method}')>"