Criar usuário ou subordinado
---
  tags:
    - Users
  summary: Criação de usuário ou subordinado vinculado a um usuário responsável
  description: >
    Este endpoint permite criar um usuário ou subordinado vinculado a um usuário responsável.
  parameters:
    - in: body
      name: body
      required: true
      description: Dados do usuário  ou subordinado a serem criados.
      schema:
        type: object
        required:
          - username
          - email
          - password
          - responsible_id
        properties:
          username:
            type: string
            description: Nome de usuário ou subordinado.
            example: subordinate_user
          email:
            type: string
            description: E-mail.
            example: subordinate@example.com
          phone:
            type: integer
            description: Número de telefone  (opcional).
            example: 5511999999999
          password:
            type: string
            description: Senha.
            example: securepassword123
          profile_image:
            type: string
            description: URL da imagem de perfil (opcional).
            example: https://example.com/profile.jpg
          birth_date:
            type: string
            format: date
            description: Data de nascimento (opcional).
            example: 1990-01-01
          parent_id:
            type: integer
            description: ID do usuário responsável (opcional).
            example: 1
  responses:
    201:
      description: Usuário criado com sucesso.
      schema:
        type: object
        properties:
          message:
            type: string
            example: Usuário criado com sucesso.
          subordinate_id:
            type: integer
            example: 42
    400:
      description: Erro na criação do Usuário.
      schema:
        type: object
        properties:
          error:
            type: string
            example: Usuário já existe.
    401:
      description: Não autorizado.
      schema:
        type: object
        properties:
          error:
            type: string
            example: Token inválido ou expirado.