Overview
The ETI (Ética) module manages the complete ethics review process for research activities. It handles ethics committee operations, memory/report evaluation, meeting management, and multi-language report generation.Comités
Manage ethics committees and evaluators
Memorias
Process ethics review submissions
Evaluaciones
Conduct ethics evaluations and reviews
Key Features
Ethics Committee Management
- Committee Configuration: Set up multiple ethics committees (CEI, CEEA, etc.) with specific workflows
- Evaluator Management: Assign evaluators with expertise areas and conflict of interest tracking
- Meeting Scheduling: Plan committee meetings with agendas and documentation
- Minute Management: Generate and approve formal meeting minutes (
Acta) - Dynamic Forms: Configure custom evaluation forms per committee type
Ethics Review Process (Memorias)
A “Memoria” is an ethics review submission that must be evaluated by an ethics committee.
- Submission Types:
- NUEVA: New ethics review request
- MODIFICACION: Modification to existing approval
- RATIFICACION: Ratification of previous decision
- State Workflow: Track submission through evaluation states (
TipoEstadoMemoria) - Version Control: Maintain version history of submissions
- Retrospective Reviews: Handle retrospective ethics reviews when required
- Multi-language Support: Titles and content in multiple languages
Evaluation Workflow
- Researcher
- Evaluator
- Committee Secretary
- Create ethics review request (
PeticionEvaluacion) - Complete ethics memory form (
Memoria) - Submit required documentation
- Track evaluation status
- Respond to committee comments
- Receive ethics approval or recommendations
Dynamic Forms and Reports
- Form Configuration: Use Formly-based dynamic forms for flexible data collection
- Custom Checklists: Define evaluation criteria per committee type
- Multi-language Reports: Generate reports in different languages using configured templates
- Report Types: Ethics approval certificates, evaluation reports, committee minutes
Main Entities
Comité (Ethics Committee)
Located at:
sgi-eti-service/src/main/java/org/crue/hercules/sgi/eti/model/Comite.javacodigo: Committee code (e.g., “CEI”, “CEEA”)nombre: Committee name (multi-language)formularioMemoriaId: Main evaluation formformularioSeguimientoAnualId: Annual follow-up formformularioSeguimientoFinalId: Final follow-up formformularioRetrospectivaId: Retrospective review formrequiereRetrospectiva: Whether committee requires retrospective reviewsprefijoReferencia: Reference prefix for memory codespermitirRatificacion: Allow ratification submissions- Configuration flags for task and memory customization
Evaluador: Committee members and evaluatorsConvocatoriaReunion: Committee meetingsCargoComite: Committee positions/roles
Memoria (Ethics Memory/Submission)
Located at:
sgi-eti-service/src/main/java/org/crue/hercules/sgi/eti/model/Memoria.javanumReferencia: Unique reference numberpeticionEvaluacion: Associated evaluation requestcomite: Ethics committee handling the reviewformulario: Evaluation form usedtitulo: Memory title (multi-language)personaRef: Responsible researchertipo: Memory type (NUEVA, MODIFICACION, RATIFICACION)estadoActual: Current state in workflowfechaEnvioSecretaria: Submission dateversion: Version numberrequiereRetrospectiva: Retrospective review required flagretrospectiva: Linked retrospective reviewmemoriaOriginal: Original memory for modifications
Evaluacion: Evaluations performed on the memoryDocumentacionMemoria: Supporting documentsEstadoMemoria: State historyComentario: Comments and feedback
PeticionEvaluacion (Evaluation Request)
Key attributes:titulo: Request titleresumen: Research summaryobjetivos: Research objectivesdisMetodologico: Methodological designfuenteFinanciacion: Funding source- Team and researcher information
- Risk assessment data
Evaluacion (Evaluation)
Key attributes:memoria: Memory being evaluatedconvocatoriaReunion: Committee meetingtipoEvaluacion: Evaluation typedictamen: Final decision/verdictevaluador1,evaluador2: Assigned evaluatorsversion: Evaluation version- Comments and assessment data
Comentario: Evaluation commentsDictamen: Possible verdicts (approved, rejected, modifications required, etc.)
ConvocatoriaReunion (Committee Meeting)
Key attributes:comite: Committee holding the meetingfechaEvaluacion: Meeting date and timelugar: Meeting location (multi-language)ordenDia: Agenda (multi-language)tipoConvocatoriaReunion: Meeting typehoraInicio,horaInicio2: Session timesvideoconferencia: Video conference flag
Asistentes: Meeting attendeesDocumentacionConvocatoriaReunion: Meeting documentationActa: Generated meeting minutes
Acta (Meeting Minutes)
Key attributes:convocatoriaReunion: Associated meetingnumero: Minutes numberresumen: Summary (multi-language)estadoActual: Current stateinactiva: Inactive flag
ActaDocumento: Formal minutes documentsComentario: Comments and decisions recorded
User Workflows
Submitting an Ethics Review Request
- Create new evaluation request (
PeticionEvaluacion) - Complete research details: objectives, methodology, funding
- Define research team and responsibilities
- Assess ethical risks and considerations
- Create associated memory (
Memoria) - Select appropriate committee and form
- Complete ethics evaluation form
- Attach required documentation
- Submit to committee secretary
- Track evaluation status
Conducting Committee Review
- Secretary receives and validates submissions
- Assign evaluators (avoiding conflicts of interest)
- Evaluators review and complete checklists
- Schedule committee meeting
- Prepare meeting agenda with memories to review
- Distribute documentation to committee members
- Conduct meeting and discuss each case
- Record decisions in minutes (
Acta) - Generate formal approval/rejection documents
- Notify researchers of decisions
- Track follow-up requirements
Managing Follow-up Reports
- Approved projects receive follow-up requirements
- Researchers submit annual follow-up reports
- Committee reviews compliance
- Final follow-up report at project completion
- Close ethics approval record
Dynamic Form System
The ETI module uses a sophisticated dynamic form system based on Formly:
- Formulario: Form definition entity
- Bloque: Form sections/blocks
- Apartado: Form subsections
- FormlyDefinicion: Field definitions in JSON format
- Supports conditional logic and validation rules
- Ethics memory evaluation forms
- Annual follow-up forms
- Final follow-up forms
- Retrospective review forms
- Task and training forms
Report Generation
The module supports multi-language report generation:- FormularioReport: Links forms to report templates
- Informe: Generated report metadata
- InformeDocumento: Report documents in multiple languages
- Ethics approval certificates
- Evaluation reports
- Committee minutes
- Follow-up assessments
Conflict of Interest Management
- Track evaluator conflicts (
ConflictoInteres) - Prevent assignment of conflicted evaluators
- Automatic validation during assignment
- Transparency in committee decisions
Integration Points
- CSP Module: Link ethics approvals to research projects
- REP Module: Generate ethics committee reports and statistics
- COM Module: Notifications for deadlines, meetings, and decisions
API Endpoints
Key REST endpoints:/comites: Committee management/memorias: Memory submission and tracking/peticion-evaluaciones: Evaluation requests/evaluaciones: Evaluation management/convocatoria-reuniones: Meeting scheduling/actas: Minutes management/evaluadores: Evaluator assignment
Database Schema
Database migrations:comite- Ethics committeesmemoria- Ethics submissionsevaluacion- Evaluationsconvocatoria_reunion- Meetingsacta- Minutesformulario- Dynamic forms- Supporting tables for form definitions and relationships
Frontend Components
Web interface:- Memory submission wizard
- Committee dashboard
- Evaluation interface
- Meeting management
- Dynamic form rendering
- Report generation tools