[[sigaa:graduacao:documentacao_tecnica:aba_ddp| << Voltar]]  

<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>

====== Cadastro de Componente Curricular ======

Este caso de uso tem a finalidade de permitir ao  Departamento Didático Pedagógico (DDP) cadastrar Componentes Curriculares. 


===== Descrição do Caso de Uso =====

Este caso de uso inicia-se quando o usuário acessa a opção SIGAA -> Graduação -> DDP -> Componentes Curriculares -> Cadastrar

=== Passo 1 ===

O usuário informa os seguintes dados:

  * **Tipo do Componente***: Tipo - TEXTO. 
  * **Tipo de Atividade***: Tipo - TEXTO.
  * **Forma de Participação***: Tipo - TEXTO.
  * **Modalidade de Educação**: Tipo - TEXTO. Informa para qual modalidade de educação o componente será utilizado (presencial, à distância, etc.).

Caso o //Tipo de Componente// selecionado não seja ATIVIDADE, não será necessário informar os campos //Tipo de Atividade// e //Forma de Participação//.

=== Passo 2 ===

O sistema exibe os seguintes dados:

  * **__Tipo do Componente__**: Tipo - TEXTO.
  * **__Tipo de Atividade__**: Tipo - TEXTO.
  * **__Forma de Participação__**: Tipo - TEXTO.


O usuário deve informar os seguintes dados:

  * **Dados Gerais do Componente Curricular**
    * **Unidade Responsável**: Tipo - TEXTO.
    * **Código**: Tipo - NUMÉRICO. ([[#Principais Regras de Negócio|RN01, RN02]])
    * **Nome**: Tipo - TEXTO.
    * **Ativo**: Formato - SIM/NÃO, Tipo - TEXTO.
    * **Excluir da Avaliação Institucional**: Tipo - TEXTO.

  * **Carga Horária do Componente**.
    
    * Se o Tipo do Componente for **DISCIPLINA** o usuário deve informar:
      * <del>Créditos Teóricos</del>** Carga Horária Teórica*** : Tipo - TEXTO. Este campo não aparece caso o componente seja à distância.
      * <del>Carga Horária de Ead</del>** Carga Horária de Ead***: Tipo - TEXTO.
      * <del>Créditos Práticos</del>** Carga Horária Prática***: Tipo - NUMÉRICO.
 
    * Se o Tipo do Componente for **ATIVIDADE** e:
     
     *  O Tipo da Atividade for //ATIVIDADE INTEGRADORA DE FORMAÇÃO// e a Forma de Participação for ATIVIDADE <del>ACADÊMICA INDIVIDUAL</del> AUTÔNOMA o usuário deve informar: 
      * **Carga Horária de Não Aula***: Tipo - NUMÉRICO.
      * **__Carga Horária Total do Componente__**: Tipo - NUMÉRICO. 
     
     *  O Tipo da Atividade for //ATIVIDADE INTEGRADORA DE FORMAÇÃO// e a Forma de Participação for ATIVIDADE DE ORIENTAÇÃO INDIVIDUAL o usuário deve informar: 
      * **Carga Horária de Não Aula***: Tipo - NUMÉRICO.
      * **__Carga Horária Total do Componente__**: Tipo - NUMÉRICO.
      * **Carga Horária do Docente***
        * **Valor da Ch:** Tipo - NUMÉRICO: Tipo - NUMÉRICO.  

     * O Tipo da Atividade for //ATIVIDADE INTEGRADORA DE FORMAÇÃO// e a Forma de Participação for ATIVIDADE COLETIVA o usuário deve informar: 
      * **<del>Créditos de Ead</del>***: Tipo - NUMÉRICO.
      * **Carga Horária Teórica***: Tipo - NUMÉRICO.
      * **Carga Horária Prática***: Tipo - NUMÉRICO.
      * **__Carga Horária Total Aula__***: Tipo - NUMÉRICO.
      * **Carga Horária de Não Aula**: Tipo - NUMÉRICO.
      * **__Carga Horária Total do Componente__**: Tipo - NUMÉRICO. 
      * **Carga Horária do Docente***
          * **Valor da Ch:** Tipo - NUMÉRICO: Tipo - NUMÉRICO. 

     * O Tipo da Atividade for //ATIVIDADE PROFISSIONAL// e a Forma de Participação for ATIVIDADE <del>ACADÊMICA INDIVIDUAL</del> AUTÔNOMA, o usuário deve informar: 
      * **Carga Horária de Não Aula**: Tipo - NUMÉRICO.
     
     * O Tipo da Atividade for //ATIVIDADE PROFISSIONAL// e a Forma de Participação for ATIVIDADE DE ORIENTAÇÃO INDIVIDUAL, o usuário deve informar: 
      * **Carga Horária de Não Aula**: Tipo - NUMÉRICO.
      * **__Carga Horária Total do Componente__**: Tipo - NUMÉRICO. 
      * **Carga Horária do Docente***
          * **Valor da Ch:** Tipo - NUMÉRICO: Tipo - NUMÉRICO.      
     
     * O Tipo da Atividade for //ATIVIDADE PROFISSIONAL// e a Forma de Participação for ATIVIDADE COLETIVA o usuário deve informar: 
      * **Carga Horária Teórica***: Tipo - NUMÉRICO.
      * **Carga Horária Prática***: Tipo - NUMÉRICO.
      * **__Carga Horária Total Aula__***: Tipo - NUMÉRICO.
      * **Carga Horária de Não Aula**: Tipo - NUMÉRICO.
      * **Carga Horária do Docente***
          * **Valor da Ch:** Tipo - NUMÉRICO: Tipo - NUMÉRICO.
     
     * O Tipo da Atividade for ESTÁGIO e a Forma de Participação for ATIVIDADE <del>ESPECIAL</del> COLETIVA o usuário deve informar: 
      * **Carga Horária Teórica***: Tipo - NUMÉRICO.
      * **Carga Horária Prática***: Tipo - NUMÉRICO.
      * **Carga Horária do Docente***: Tipo - NUMÉRICO.    
    
    * O Tipo da Atividade for ESTÁGIO e a Forma de Participação for ATIVIDADE DE ORIENTAÇÃO INDIVIDUAL o usuário deve informar: 
     * **Carga Horária de Não Aula**: Tipo - NUMÉRICO.
      * **Carga Horária do Docente***
          * **Valor da Ch:** Tipo - NUMÉRICO: Tipo - NUMÉRICO.

    * O Tipo da Atividade for TRABALHO DE CONCLUSÃO DE CURSO  e a Forma de Participação for ATIVIDADE DE ORIENTAÇÃO INDIVIDUAL o usuário deve informar: 
     * **Carga Horária de Não Aula**: Tipo - NUMÉRICO.
      * **Carga Horária do Docente***
          * **Valor da Ch:** Tipo - NUMÉRICO: Tipo - NUMÉRICO.
   
    * Se o Tipo do Componente for **MÓDULO** o usuário deve informar: 
      * **<del>Créditos de Ead</del>***: Tipo - NUMÉRICO.
      * **Carga Horária Teórica***: Tipo - NUMÉRICO.
      * **Carga Horária Prática***: Tipo - NUMÉRICO.
      * **Carga Horária de Ead***: Tipo - NUMÉRICO.
      * **Carga Horária do Docente***: Tipo - NUMÉRICO.


  * **Pré-requisitos, Co-Requisitos e Equivalências**  
    * **Pré-Requisitos**: Tipo - TEXTO. Pré-requisitos para cursar a disciplina. 
    * **Co-Requisitos**: Tipo - TEXTO. Co-Requisitos para cursar a disciplina.	
    * **Equivalências**: Tipo - TEXTO. Informar as disciplinas que são equivalentes a disciplina em questão.


  * **Outras informações**  
    * **Núm. Máximo de Docentes na Turma**: Tipo - NUMÉRICO. Indica o número máximo de docentes que uma turma para o componente curricular pode ter.
    * O usuário deve informar os seguintes dados exceto quando a forma de pariticipação for ATIVIDADE ESPECIAL COLETIVA ou quando o tipo de componente for MÓDULO: 
      * **Matriculável "On-Line"**: Tipo - TEXTO.
      * **Permite CH Compartilhada entre Docentes**: Tipo - TEXTO.
      * **Permite Turma com Flexibilidade de Horário**: Tipo - TEXTO.
      * **Horário Flexível do Docente**: Tipo - TEXTO.
      * **Pode criar turma sem solicitação**: Tipo - TEXTO.
      * **Permitir Criar subturmas desse componente curricular**: Tipo - TEXTO.
      * **Atividade de Integralização Contínua**: Tipo- LÓGICO.  Deve ser habilitado para os componentes curriculares do tipo ATIVIDADE, subtipo: ATIVIDADE AUTÔNOMA (antigo Atividade Individual).
      * **Exige Horário**: Tipo - TEXTO.
      * **Quantidade de Avaliações**: Tipo - TEXTO.
      * **Ementa***: Tipo - TEXTO.
    * Se a forma de participação for ATIVIDADE ESPECIAL COLETIVA o usuário deve informar: 
      * **Permite CH Compartilhada entre Docentes**:Tipo - TEXTO.
      * **Atividade Permite Criar Turma**: Tipo - TEXTO.
      * **Permite Turma com Flexibilidade de Horário**: Tipo - TEXTO.
      * **Horário Flexível do Docente**: Tipo - TEXTO.
      * **Obrigatoriedade de Nota Final**: Tipo - TEXTO.
      * **Necessita de Orientador**: Tipo - TEXTO.
      * **Permitir Criar subturmas desse componente curricular**: Tipo - TEXTO.
      * **Quantidade de Avaliações**: Tipo - TEXTO.
      * **Descrição***: Tipo - TEXTO.
    * Se o tipo do componente for MÓDULO o usuário de informar: 
      * **Matriculável "On-Line"**: Tipo - TEXTO.
      * **Permite CH Compartilhada entre Docentes**: Tipo - TEXTO.
      * **Permite Turma com Flexibilidade de Horário**: Tipo - TEXTO.
      * **Horário Flexível do Docente**: Tipo - TEXTO.
      * **Permitir Criar subturmas desse componente curricular**: Tipo - TEXTO.
      * **Exige Horário**: Tipo - TEXTO.
      * **Quantidade de Avaliações**: Tipo - TEXTO.
      * **Ementa***: Tipo - TEXTO.
    * Se o tipo do componente for BLOCO o usuário de informar: 
      * **Matriculável "On-Line"**: Tipo - TEXTO.
      * **Permite CH Compartilhada entre Docentes**: Tipo - TEXTO.
      * **Permite Turma com Flexibilidade de Horário**: Tipo - TEXTO.
      * **Horário Flexível do Docente**: Tipo - TEXTO.
      * **Pode criar turma sem solicitação**: Tipo - TEXTO.
      * **Permitir Criar subturmas desse componente curricular**: Tipo - TEXTO.
      * **Exige Horário**: Tipo - TEXTO.
      * **Quantidade de Avaliações**: Tipo - TEXTO.


=== Passo 3 ===

O usuário deve informar os seguintes dados quando o tipo do componente for BLOCO: ([[#Principais Regras de Negócio|RN13]])

  * **Nome***: Tipo - TEXTO. Nome do componente da subunidade
  * **Definir automaticamente os códigos das subunidades deste bloco**: Tipo - LÓGICO. Permite ao usuário informar o código da subunidade.
  * **Tipo da Subunidade***: Tipo - TEXTO. Tipo de componente da subunidade, podendo ser uma disciplina ou um módulo
  * **Quantidade de Avaliações**: Tipo - NUMÉRICO. Quantidade de avaliações da subunidade
  * **Ementa***: Tipo - TEXTO. Ementa da subunidade.

Logo abaixo são listadas as subunidades cadastradas com opção de alterar ou remover.

^ Subunidades Cadastradas para esse Bloco ^^^^|
^ Cr ^ Ch ^ Tipo ^ Código ^ Nome |
| Tipo - NUMÉRICO | Tipo - NUMÉRICO | Tipo - TEXTO | Tipo - TEXTO | Tipo - TEXTO |

=== Passo 4 ===

O sistema exibe um resumo das informações cadastradas nos passos anteriores. O usuário deve informar sua senha pessoal para garantir a segurança do cadastro.

O caso de uso é finalizado.

===== Principais Regras de Negócio =====


==== Regras Gerais ====

  * **RN01** - Não podem ser cadastrados dois componentes curriculares com o mesmo código.
  * **RN02** - O sistema sugere o código da disciplina baseado na unidade selecionada observando as regras de formação do código do componente e os códigos que estão disponíveis
  * **RN03** - Não é permitido criar componentes curriculares para atividades que não são acadêmicas
  * **RN04** - Se o tipo de componente for DISCIPLINA o sistema efetua o cálculo das CH da seguinte forma: CH Aula (Relação Créditos Aula * CR Aula); CH Laboratório (Relação Créditos Laboratório * CR Laboratório); CH Estágio (Relação Créditos Estágio * CR Estágio)
  * **RN05** - Se o tipo de componente for BLOCO o sistema efetua o cálculo das CH da seguinte forma: CH Aula (SOMATÓRIO DAS SUBUNIDADES(Relação Créditos Aula * CR Aula))
  * **RN07** - A CH Total é calculada da seguinte forma: = CH Aula + CH Laboratório + CH Estágio + CH Ead
  * **RN08** - Se o componente permitir CH Docente esta não pode ser superior a CH Total
  * **RN09** - As expressões de **Pré-requisitos, Co-Requisitos e Equivalências** devem segui formato de expressão lógica definido pelo sistema
  * **RN10** - Os componentes informados na expressões de **Pré-requisitos, Co-Requisitos e Equivalências** não necessitam estar cadastrados como ativo para serem considerados na expressão.
  * <del>**RN11** - Os componentes informados na expressões de **Equivalências** devem pertencer a mesma estrutura curricular do componente que está sendo cadastrado.</del>
  * **RN12** - Impossível cadastrar componente curricular que aceite subturma sem CH Laboratório
  * **RN14** - Todo componente curricular ESTÁGIO ou TRABALHO DE CONCLUSÃO DE CURSO devem possuir orientador 
  * **RN16** - Se o parâmetro VALIDAR_CODIGO_COMPONENTE_CURRICULAR for verdadeiro o código será validado obedecendo ao estabelecido nos parâmetros TAMANHO_CODIGO_COMPONENTE e QTD_LETRAS_CODIGO_COMPONENTE e na regra que o código deve começar com a **Sigla Acadêmica da Unidade** a qual o componente estiver sendo vinculado.
  * **RN17** - Se o parâmetro VALIDA_QTD_LETRAS_CODIGO for verdadeiro o sistema irá validar se a quantidade de letras do código corresponde ao definido no parâmtro QTD_LETRAS_CODIGO_COMPONENTE exceto para as unidades definidas no parâmtro CODIGO_UNIDADES_NAO_VERIFICAR_SIGLA_NO_CADASTRO_DE_COMPONENTES.
  * **RN18** - Impossível inativar um componente curricular que possua outros componentes com alguma dependência dele
  * **RN19** - Componentes Curriculares a distância não podem criar subturmas.

==== Regras da Graduação ====

  * **RN13** - Impossível adicionar subunidades repetidas 
  * **RN06** - Se o tipo de componente for DISCIPLINA ou MÓDULO a CH Ead do componente não pode ser maior que a definida para o seu tipo
  * **RN19** - Permitir a criação de turma apenas para atividades com forma de participação coletiva.
  * **RN20** - Um componente curricular não poderá ser equivalente a outro componente curricular de modalidade de ensino diferente.
  * **RN21** - Componentes Curriculares do tipo DISTANCIAL, devem ter sua CH 100% EAD (podendo ser dividido entre teórica e prática);
  * **RN22** - Componentes Curriculares do tipo PRESENCIAL, devem ter sua CH dividida entre 20% de CH EAD e mínimo de 80% CH presencial (podendo ser dividido entre teórica e prática);
  * **RN23** - Toda atividade coletiva possui carga horária e todas formam turma. É divida em carga horária de aulas (pode ser nula) e carga horária que não é aulas. Por sua vez, a carga horária com aulas é subdividida da mesma forma que a carga horária de um módulo (téorica, prática, distância, etc.).


**O valor da "Relação Créditos Aula" é definido pelo parâmetro HORAS_CREDITOS_AULA**


==== Resoluções/Legislações Associadas ====

  * [[desenvolvimento:especificacoes:sigaa:regulamento_da_graduacao#t%C3%ADtulo_vi_-_dos_componentes_curriculares|Regulamento da graduação - Componentes Curriculares]]


===== Parâmetros relacionados =====

  * HORAS_CREDITOS_AULA
  * VALIDAR_CODIGO_COMPONENTE_CURRICULAR
  * TAMANHO_CODIGO_COMPONENTE
  * QTD_LETRAS_CODIGO_COMPONENTE
  * VALIDA_QTD_LETRAS_CODIGO
  * CODIGO_UNIDADES_NAO_VERIFICAR_SIGLA_NO_CADASTRO_DE_COMPONENTES

Para maiores detalhes sobre os parâmetros acessar a página de [[desenvolvimento:especificacoes:sigaa:parametros|Parâmetros do SIGAA]]

===== Casos de uso relacionados =====

  * [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:ddp:curso:cadastrar|Cadastrar Curso]]

===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sigaa.ensino.dominio.ComponenteCurricular | sigaa.ensino.componente_curricular |
| br.ufrn.sigaa.ensino.dominio.TipoComponenteCurricular | sigaa.ensino.tipo_componente_curricular |





====== Plano de Teste ======

Sistema: SIGAA

Módulo: Graduação 

Link(s): DDP -> Componentes Curriculares -> Cadastrar 

Usuário: adelardo, amenezes, angelinasales, camilotaf (CDP), dressamp, vanessa, rhugo (ADMINISTRADOR_DAE)

Papel que usuário deve ter: SigaaPapeis.CDP, SigaaPapeis.ADMINISTRADOR_DAE

===== Cenários de Teste =====

Realizar o cadastro de um novo componente com um usuário com o papel CDP, verificando se o campo de preenchimento de curso e/ou novo curso se encontra habilitado para o usuário, assim como, verificar se este campo é exibido quando preenchido na tela de Resumo do cadastro de componente curricular.

Atualize o valor do parâmetro ParametrosStrictoSensu.PERMITE_COORDENACAO_CADASTRAR_ALTERAR_COMPONENETE_CURRICULAR como o valor 'C' e verifique se é possível o coordenador de pós graduação cadastrar um componente curricular. Neste caso não deverá ser possível a alteração de componentes.

Atualize o valor do parâmetro ParametrosStrictoSensu.PERMITE_COORDENACAO_CADASTRAR_ALTERAR_COMPONENETE_CURRICULAR como o valor 'A' e verifique se é possível o coordenador de pós graduação alterar um componente curricular. Neste caso não deverá ser possível o cadastro de componentes.

Atualize o valor do parâmetro ParametrosStrictoSensu.PERMITE_COORDENACAO_CADASTRAR_ALTERAR_COMPONENETE_CURRICULAR como o valor 'CA' e verifique se é possível o coordenador de pós graduação cadastrar/alterar um componente curricular.

===== Dados para o Teste =====

Pode-se utilizar o Departamento de Artes, código 1313, e tentar cadastrar um componente com o código DGN0010.

Para atualizar o valor do parâmetro ParametrosStrictoSensu.PERMITE_COORDENACAO_CADASTRAR_ALTERAR_COMPONENETE_CURRICULAR utilize como base o sql abaixo:

update comum.parametro  
set valor = 'CA' 
where codigo = '2_10700_37'