Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ariellukezz/admision-web/llms.txt

Use this file to discover all available pages before exploring further.

Segundas Especialidades is a fully independent admission track within the Sistema de Admisión Web designed for professional graduates who wish to enroll in a second-specialty postgraduate program. Unlike the main undergraduate admission process, this track targets applicants who already hold a university degree and are seeking an additional specialization. It carries its own pre-registration flow, its own vacancy tables, its own result publication pipeline, and a dedicated administrative panel — none of which overlap with the main admission module.
The cultural identity service (IdentidadSegundaController) connects to an external microservice at https://test-admision.unap.edu.pe/service_identidad/api/v1/ to retrieve condiciones de lengua, pertenencia cultural, lenguas indígenas, pueblos indígenas, and stored identidad cultural records per applicant, in compliance with SUNEDU reporting requirements.

Role and Access

The Segundas role (id_rol = 3) is required to access the administrative panel. After login, users are redirected to /segundas. All routes under the /segundas/* prefix require both auth and segundas middleware. The index route (GET /segundas) renders Segundas/Admin/Preinscripciones/index directly and acts as the default landing page after authentication.
Middleware file: app/Http/Middleware/Segundas.php
Route prefix:    /segundas
Auth redirect:   /segundas  (after login with id_rol = 3)

Comparison with the Main Admission Process

AspectMain AdmissionSegundas Especialidades
Target applicantsSecondary school graduatesUniversity graduates / professionals
Academic levelUndergraduate (nivel_academico general)Segunda Especialidad
Vacancy tablevacantes (main process)vacantes filtered by nivel_academico = 'Segunda Especialidad'
Results tableresultadosresultados_segundas
Pre-registrationpre_inscripcion (main)pre_inscripcion filtered by id_proceso scoped to segundas admin
Identity dataNot collected separatelyExternal service_identidad microservice
Score rangeMulti-area (INGENIERÍAS, BIOMÉDICAS, SOCIALES)Per-program score 0–20 with apto flag
Route namespace/admin/*/segundas/*
Both tracks share the postulante, pre_inscripcion, programa, and modalidad tables, but every query in the Segundas module is scoped to the administrator’s id_proceso, preventing data from mixing between tracks.

Module Capabilities

Preinscripciones

Administrators manage the incoming pre-registration queue at GET /segundas/preinscripciones (Segundas/Admin/Preinscripciones/index). Operations available:
  • POST /segundas/get-preinscripciones-segundas — paginated list with applicant name, DNI, program, modality, process, date, sex, inscription status, and observations (PreinscripcionSegundasController@getPreinscripciones)
  • POST /segundas/actualizar-preinscripciones-segundas — update a pre-registration’s program or modality, appending change notes to the observacion log (PreinscripcionSegundasController@Actualizar)
  • POST /segundas/guardar-inscripcion-segundas — promote a pre-registration to a confirmed inscripciones record (PreinscripcionSegundasController@Inscribir)
  • DELETE /segundas/delete-preinscripcion-segundas/{id} — remove an incorrect or duplicate pre-registration (PreinscripcionSegundasController@eliminar)

Postulante Management

Applicant profiles for the segundas track are managed at GET /segundas/postulantes (Segundas/Admin/Postulantes/index):
  • POST /segundas/get-postulantes-segundas — retrieve applicants (PostulanteSegundaController@getPostulantes)
  • GET /segundas/postulante-perfil/{dni} — full applicant profile Inertia view (PostulanteSegundaController@showPostulante)
  • GET /segundas/get-postulante-datos/{dni} — raw applicant JSON for AJAX consumption (PostulanteSegundaController@getDatosPostulante)
  • POST /segundas/save-postulante-admin — create or update an applicant record from the admin panel (PostulanteSegundaController@savePostulanteAdmin)
  • POST /save-postulante-adicional — save SUNEDU-required additional data (disability, linguistic identity, cultural belonging) via PostulanteSegundaController@saveDataAdicional

Vacancy Management

Second-specialty vacancies are managed per program at GET /segundas/vacantes (Segundas/Admin/Vacantes/index). The vacancy table is filtered to nivel_academico = 'Segunda Especialidad' and joined with the programa and vacantes tables. Available operations:
  • POST /segundas/get-vacantes-segundas-admin — list programs with their current vacancy counts and SUNEDU codes (VacantesSegundaController@getVacantes)
  • POST /segundas/save-numero-vacantes-segundas — create a new vacancy record for a program (VacantesSegundaController@saveNumeroVacantes)
  • POST /segundas/actualizar-vacantes-segundas — update vacancy count or status (VacantesSegundaController@actualizar)
  • POST /segundas/delete-vacante-segundas — remove a vacancy record (VacantesSegundaController@eliminar)

Modality Management

Active modalities for segundas programs are retrieved with:
GET /segundas/get-modalidades-segundas-activas
→ ModalidadSegundaController@getModalidadesActivas
This endpoint is consumed by the pre-registration and admin forms to populate modality selectors.

Observados (Flagged Applicants)

Applicants who fail document checks or have administrative flags are managed at GET /segundas/observados (Segundas/Admin/Observados/index):
  • POST /segundas/get-observados-segundas — paginated list of flagged applicants (ObservadosSegundaController@getObservados)
  • POST /segundas/save-observado-segundas — create or update an observado record (ObservadosSegundaController@save)

Identity Verification (Identidad Cultural)

The IdentidadSegundaController connects to the external identity microservice at https://test-admision.unap.edu.pe/service_identidad/api/v1/ to provide five data endpoints (all public, outside the segundas middleware group):
EndpointMethodReturns
GET /get-condiciones-lengua-segundasgetCondicionesLenguaLanguage condition options
GET /get-pertenencia-cultural-segundasgetPertenenciaCulturalCultural belonging options
GET /get-lengua-segundasgetLenguaIndigenaIndigenous language options
GET /get-pueblos-indigenes-segundasgetPueblosIndigenasIndigenous peoples options
GET /get-identidad-cultural/{id_postulante}/{id_proceso}getIdentidadCulturalByPostulanteProcesoStored identity data for one applicant

Summaries and Results

Summary reports are available through ResumenesSegundaController:
  • POST /segundas/get-resumen-preinscripcion-segundas — aggregated pre-registration summary (getResumenPreinscripcion)
  • POST /segundas/get-detalle-preinscripcion-segundas — detailed pre-registration list (getPreinscripciones)
Results management is handled by ResultadosSegundaController at GET /segundas/puntajes (Segundas/Admin/Puntajes/index):
  • POST /segundas/get-resultados-segundas — list applicants with their scores, positions, and apto status (getResultados)
  • POST /segundas/guardar-puntaje — enter or update a score (0–20 range, validated; blocked if the program’s vacantes record has publicado = 1) (guardarPuntaje)
  • GET /segundas/get-select-programas-asignados — programs with nivel = 2 and estado = 1 (getSelectProgramasAsignados)
  • POST /segundas/get-vacante-programa-segundas — vacancy/program detail for a specific program (getVacantePrograma)
  • POST /segundas/publicar-resultados-segundas — publish results (dispatches PublicarResultadosJob queue job) (publicar)
  • POST /segundas/pdf-resultados-segundas — generate PDF of results (getResultadosPDF)
A PDF pre-registration voucher is generated on demand for applicants (public route, outside the segundas middleware group):
GET /pdf-preinscripcion/{id_proceso}/{dni}
→ PreinscripcionSegundasController@pdfPreinscripcion

Queue Job: Publishing Results

Result publication is handled asynchronously via a queued job (PublicarResultadosJob). If a job fails, administrators can inspect and retry failed jobs using maintenance endpoints (accessible to Segundas role):
GET /segundas/queue/retry-publicar  — retry all failed PublicarResultadosJob entries
GET /segundas/queue/failed-publicar — list failed jobs with error summaries
GET /segundas/queue/failed/{id}     — full exception detail for a specific failed job

Further Reading

Pre-Registration Process

Multi-step public registration wizard for second-specialty applicants — identity validation, personal data, SUNEDU fields, program selection, and document upload.

Build docs developers (and LLMs) love