Torna Idioma — Platform Documentation

Section One

1. What is Torna Idioma

Torna Idioma (The Return of the Language) is a comprehensive digital platform for revitalizing the Spanish language in the Philippines. It serves as the operational backbone for a government-endorsed initiative to reintroduce Spanish as a functional language for economic opportunity, cultural reconnection, and international collaboration.

The platform is operated by Multi Travel Connection, Inc. (DBA Torna Idioma), a Florida-incorporated company (EIN 59-2938390), and powered by Digit2AI's technology infrastructure. The academic content is supplied through a signed Memorandum of Understanding (MOU) with the Universidad Virtual del Estado de Guanajuato (UVEG), a public Mexican university.

12

Modules

72

Lessons

360

Teaching Hours

3

Cities

11

Partner Schools

10+

Universities

The name embodies the philosophy: "Torna" means "to return" — reflecting the return of the Spanish language to a nation where it was spoken for 333 years. The tagline "Vida · Cultura · Legado" (Life · Culture · Legacy) captures the three dimensions of the initiative.

🎓

Education Platform

12-module UVEG-certified SFL (Spanish as a Foreign Language) curriculum with interactive lessons, exercises, progress tracking, and certifications.

💼

BPO Workforce Pipeline

Direct integration with BPO companies (Teleperformance, Concentrix, TTEC) offering Spanish-speaking jobs with 25-35% salary premiums.

🌎

International Collaboration

Partnerships with universities across Mexico, Colombia, Chile, Argentina, Spain, and the Philippines for academic exchange and research.

🤖

AI-Powered Learning

Profesora Isabel, an AI tutor using the Don Quijote Immersion Method, provides personalized conversation practice adapted to each student's level.

Section Two

2. Target Audience

The platform serves six distinct user roles, each with tailored experiences, dashboards, and access levels:

👨‍🎓

Students

Filipino learners — university students, young professionals, and self-learners in Makati, Zamboanga, and Cavite seeking to learn Spanish for career advancement or cultural reconnection.

Primary UsersA1→B1+

👩‍🏫

Teachers

UVEG-certified Spanish instructors and local Filipino educators trained to facilitate the SFL program. They manage classes, track student progress, and provide virtual instruction.

Content ManagersUVEG-trained

🏢

BPO Workers

Call center professionals and BPO aspirants looking to add Spanish to their skillset for higher-paying positions serving Latin American accounts.

Job Board Access+25-35% salary

🏛️

Government Officials

City officials from Makati, Zamboanga, and Cavite who oversee program implementation, monitor KPIs, review economic impact, and manage school partnerships.

Full AnalyticsPolicy Dashboard

🤝

University Partners

Academic institutions across 6+ countries participating in curriculum development, faculty exchange, research collaboration, and student mobility programs.

10+ UniversitiesMOU-based

📣

Advocates & Supporters

Individuals and corporations supporting the Spanish revitalization movement through donations, event participation, and community advocacy.

CommunityEvents

Geographic Focus: Three Pilot Cities

Makati City — Metro Manila's financial capital. Home to the BPO corridor and University of Makati. First city to pilot the program with the highest concentration of BPO demand for Spanish speakers.
Zamboanga City — Known as "Asia's Latin City." The only Philippine city with a living Spanish creole language (Chavacano), spoken by 600,000+ people.
Cavite — Historical province with deep Spanish colonial heritage. Home to Cavite State University and strong community ties to Spanish-era traditions.

Makati

Financial & BPO Hub

Zamboanga

Asia's Latin City

Cavite

Heritage Province

Section Three

3. Why We Built It

Torna Idioma exists at the intersection of three forces: economic opportunity, cultural heritage, and international diplomacy.

💰 The Economic Case

The Philippine BPO industry generates $32.5B annually. Spanish-speaking agents earn 25-35% more than English-only peers. With 650M+ Spanish speakers globally and growing US Hispanic population, demand far exceeds supply. Torna Idioma creates a direct pipeline from classroom to career.

🏰 The Heritage Case

For 333 years (1565-1898), Spanish was the language of government, education, and culture in the Philippines. Today, 20-33% of Filipino vocabulary is Spanish-derived. Over 4,000 Filipino words come from Spanish. "Kumusta," "salamat," family words (tito, tita, lolo, lola), and most Filipino surnames are Spanish. This isn't a foreign language — it's a returning heritage.

🌐 The Diplomatic Case

Spanish proficiency opens doors to 20 Spanish-speaking nations. The Philippines' unique position — culturally Hispanic yet geographically Asian — makes it a natural bridge between ASEAN and Latin America. The initiative is endorsed by local governments and supported by international academic partnerships.

The Three Pillars: Dignidad · Orgullo · Premio

Dignidad (Dignity)

Every Filipino deserves access to their linguistic heritage. Spanish is not a colonial imposition — it's a shared cultural inheritance that empowers identity and self-worth.

Orgullo (Pride)

Speaking Spanish connects Filipinos to a global community of 580M speakers and to the literary works of Rizal, written in Spanish. It's a source of cultural pride.

Premio (Prize)

Tangible economic rewards: higher salaries, better career opportunities, international mobility, and access to the $7.7T GDP of the Spanish-speaking world.

Section Four

4. How We Built It

Torna Idioma is built as a vertical module within the RinglyPro CRM ecosystem — a multi-tenant platform that powers multiple AI-driven business verticals. This architecture allows rapid development while sharing core infrastructure.

Technology Stack

Layer	Technology	Purpose
Backend	Node.js + Express.js	RESTful API server, route handling, middleware
Frontend (SPA)	React 18 + Vite	Interactive dashboard, classroom, progress tracking
Frontend (Landing)	Static HTML + CSS	Public-facing landing page, no build step
Database	PostgreSQL	Relational data store (Render managed)
Authentication	JWT + bcrypt	Stateless auth with role-based access control
AI Tutor	OpenAI GPT-4o-mini	Conversational Spanish teacher ("Profesora Isabel")
HTTP Client	Axios	API communication with auto-auth interceptors
Deployment	Render	Auto-deploy on git push to main (~90 seconds)
Languages	EN / ES / FIL	Trilingual UI (English, Spanish, Filipino)

Key Partnerships

🇲🇽 UVEG — Academic Supplier

Universidad Virtual del Estado de Guanajuato, a public university supported by the Government of Guanajuato, Mexico. Provides the 12-module SFL curriculum, certified teachers, and digital platform methodology.

MOU Status: Signed (Indefinite term, 60-day termination notice)

Pricing: $530 MXN/module (~$0.78 USD/hr/student)

🇵🇭 Philippine Partners

University of Makati — Primary pilot institution
Colegio de San Juan de Letrán — Heritage university
PUP — Polytechnic University of the Philippines
Universidad de Medellín — Colombia (exchange)
Instituto Cervantes Manila — Cultural partner

Section Five

5. Functional Architecture

The platform is organized into six functional modules, each serving a specific operational domain:

🌐 Public LayerLanding page, program information, supporter registration, event calendar
🔒 Education Module12 UVEG SFL modules, 72 lessons, exercises, progress tracking, certifications
💼 BPO Workforce ModuleCompany partnerships, job board, applications, placement tracking, salary analytics
🤖 AI Tutoring ModuleProfesora Isabel (GPT-4o-mini), Don Quijote Immersion Method, level-adaptive conversations
📊 Analytics & Impact ModuleKPI dashboards, economic impact reports, school enrollment, partner metrics

Module Details

Education Module — Learning Flow

Student
enrolls

→

Course Catalog
12 UVEG modules

→

Classroom
lesson content

→

Exercises
MC + Fill Blank

→

Progress
score & time

→

Certification
≥ 80% pass

BPO Pipeline — Student to Employment

Student
completes B1

→

Job Board
browse openings

→

Application
submit + track

→

Interview
BPO company

→

Placement
salary tracked

User Role Matrix

Feature	Student	Teacher	BPO Worker	Official	Partner	Admin
Dashboard	✅	✅	✅	✅	✅	✅
Course Catalog	✅	✅	✅	✅	✅	✅
Classroom & Exercises	✅	✅	✅	✅	✅	✅
Progress Tracking	✅	✅	✅	✅	✅	✅
AI Tutor	✅	✅	✅	✅	✅	✅
Job Board	—	—	✅	—	—	✅
Create Courses	—	✅	—	—	—	✅
Program Metrics	—	—	—	✅	—	✅
Economic Impact	—	—	—	✅	—	✅
School Management	—	—	—	✅	—	✅
Partner Network	—	—	—	✅	✅	✅
Supporter Management	—	—	—	✅	—	✅

Section Six

6. System Architecture

High-Level System Architecture

Browser
User

→

Static HTML
/Torna_Idioma/

Browser
Auth'd User

→

React SPA
/Torna_Idioma/*

→

Express API
/Torna_Idioma/api/*

→

PostgreSQL
Render

Express API

→

OpenAI API
GPT-4o-mini

Dual-Layer Frontend Architecture

The platform uses a unique dual-layer frontend that serves both a static HTML landing page and a React SPA from the same URL path:

Layer 1: Static Landing Page

public/Torna_Idioma/index.html

Served directly by Express static middleware
No build step required
Trilingual via CSS class toggling
Handles root URL /Torna_Idioma/
Contains mission, partners, roadmap, heritage

Layer 2: React SPA

verticals/torna_idioma/frontend/dist/

Built with Vite, served by Express
Handles all sub-routes (/login, /dashboard, etc.)
React Router v6 with base /Torna_Idioma
JWT-authenticated, role-based routing
Catch-all fallback to index.html

Request Flow

      Request Routing
// 1. Static middleware (runs first in Express)
GET /Torna_Idioma/         → public/Torna_Idioma/index.html (landing page)
GET /Torna_Idioma/docs     → public/Torna_Idioma/documentation.html

// 2. API routes (Express router)
POST /Torna_Idioma/api/auth/login  → auth.js route handler
GET  /Torna_Idioma/api/courses     → courses.js route handler

// 3. React SPA catch-all (fallback)
GET /Torna_Idioma/dashboard  → dist/index.html (React Router handles it)
GET /Torna_Idioma/courses    → dist/index.html (React Router handles it)
    

Backend Module Structure

      File Tree
verticals/torna_idioma/
├── backend/
│   ├── index.js              # Express router + seeding logic
│   ├── services/
│   │   └── db.ti.js          # PostgreSQL connection (Sequelize)
│   ├── middleware/
│   │   └── auth.ti.js        # JWT verification + role-based access
│   ├── routes/
│   │   ├── auth.js           # Login, register, profile
│   │   ├── courses.js        # CRUD, enrollments, lessons, progress
│   │   ├── analytics.js      # KPIs, economic impact, schools
│   │   ├── bpo.js            # Companies, jobs, applications
│   │   ├── advocacy.js       # Supporters, events, registrations
│   │   └── tutor.js          # AI chat (OpenAI GPT-4o-mini)
│   ├── migrations/           # 6 SQL schema files (001-006)
│   └── seeds/
│       ├── uveg-courses.js   # 12 UVEG SFL module definitions
│       ├── uveg-lessons.js   # 72 lessons with content & exercises
│       └── lessons.js        # Legacy demo lessons (deprecated)
├── frontend/
│   ├── src/
│   │   ├── App.jsx           # React Router, layout, sidebar
│   │   ├── pages/            # 17 page components
│   │   └── services/
│   │       ├── api.js        # Axios + auth interceptors
│   │       └── auth.js       # JWT + session management
│   ├── vite.config.js        # Base: /Torna_Idioma/
│   └── dist/                 # Production build output
    

Section Seven

7. Database Schema

The database uses 15 tables across 6 migration files. All tables use the ti_ prefix to namespace within the shared RinglyPro CRM database.

Table	Migration	Purpose	Key Fields
`ti_users`	001	User accounts	email, password_hash, role, tenant_id, language_pref
`ti_courses`	002	UVEG SFL modules	title_en/es/fil, level, category, duration_hours, total_lessons
`ti_lessons`	002	Lesson content	course_id, content_en/es/fil, lesson_type, exercises (JSONB)
`ti_enrollments`	002	Student-course enrollment	user_id, course_id, status, progress_pct
`ti_lesson_progress`	002	Lesson completion	user_id, lesson_id, score, time_spent_sec, status
`ti_certifications`	002	Issued certificates	user_id, course_id, cert_level, score, issued_at
`ti_schools`	003	Partner schools	name, school_type, enrolled_students, program_status
`ti_bpo_companies`	003	BPO employers	name, industry, spanish_positions, avg_salary_increase
`ti_bpo_placements`	003	Job placements	user_id, company_id, salary_before, salary_after
`ti_partners`	003	Academic partners	name, country, partner_type, partnership_status
`ti_events`	003	Cultural events	title_en/es/fil, event_type, location, capacity
`ti_event_registrations`	003	Event sign-ups	event_id, user_id, status
`ti_supporters`	003	Advocates/donors	full_name, email, supporter_type, organization
`ti_donations`	003	Financial contributions	supporter_id, amount, donation_type, purpose
`ti_bpo_jobs`	005	Job listings	company_id, title, salary_range, spanish_level_required, slots
`ti_bpo_applications`	005	Job applications	user_id, job_id, cover_note, status
`ti_kpi_snapshots`	004	KPI tracking	snapshot_date, period, metrics (JSONB)
`ti_economic_impact`	004	Impact reports	total_bpo_placed, avg_salary_increase, tax_revenue
`ti_tutor_sessions`	006	AI tutor sessions	user_id, message_count, level, last_active

Section Eight

8. API Reference

All API endpoints are prefixed with /Torna_Idioma/api. JWT authentication is required where indicated.

Authentication

Method	Endpoint	Auth	Description
POST	`/api/auth/login`	—	Email/password login, returns JWT token (24h)
POST	`/api/auth/register`	—	New user registration (student, bpo_worker, teacher, partner)
GET	`/api/auth/me`	JWT	Current authenticated user profile

Courses & Learning

Method	Endpoint	Auth	Description
GET	`/api/courses`	—	List all published courses (12 UVEG modules)
GET	`/api/courses/:id`	—	Course detail with lesson list
POST	`/api/courses/:id/enroll`	JWT	Enroll current user in a course
GET	`/api/courses/my/enrollments`	JWT	User's enrolled courses with progress
GET	`/api/courses/lessons/:id`	JWT	Full lesson content + user progress
POST	`/api/courses/lessons/:id/progress`	JWT	Submit lesson score (status, score, time_spent_sec)
GET	`/api/courses/my/progress`	JWT	Full progress summary (all enrollments, lessons, certs)

BPO Program

Method	Endpoint	Auth	Description
GET	`/api/bpo/companies`	—	List active BPO partner companies
GET	`/api/bpo/jobs`	—	List open Spanish-speaking job postings
POST	`/api/bpo/jobs/:id/apply`	JWT	Apply for a job (cover note)
GET	`/api/bpo/my/applications`	JWT	User's job applications + status
GET	`/api/bpo/stats`	—	BPO program stats (companies, positions, placements)

Analytics & Advocacy

Method	Endpoint	Auth	Description
GET	`/api/analytics/overview`	Official	Program-wide KPIs
GET	`/api/analytics/economic-impact`	Official	Monthly economic impact data
GET	`/api/analytics/schools`	Official	Participating schools list
GET	`/api/analytics/partners`	—	Active university partners
GET	`/api/advocacy/events`	—	Upcoming cultural events
POST	`/api/advocacy/supporters`	—	Register as a supporter
POST	`/api/tutor/chat`	JWT	Chat with AI Profesora Isabel

Section Nine

9. UVEG SFL Curriculum

The curriculum is provided by the Universidad Virtual del Estado de Guanajuato (UVEG) under signed MOU. It follows the Common European Framework of Reference (CEFR) and progresses from absolute beginner (A1) to intermediate (B1+).

12

Modules

6

Lessons / Module

72

Total Lessons

30h

Per Module

360h

Total Program

≥80

Pass Mark

#	Module	CEFR	Topics
1	Introducción al Español	A1	Greetings, alphabet, nationalities, family, descriptions, courtesy
2	Un Día en la Vida	A1	Routines, schedules, days/months, actions, frequency, future plans
3	Somos lo que Consumimos	A1-A2	Home, shopping, clothing, food, quantities, questions
4	Lugares y Transporte	A2	Directions, transport, airport, city, locations, travel
5	Tus Hábitos Hablan por Ti	A2	Free time, cinema/music, sports, events, opinions, invitations
6	Tu Cuerpo es tu Templo	A2-B1	Health, doctor, habits, exercise, symptoms, recommendations
7	A Qué te Dedicas	B1	Professions, skills, interviews, work environment, preterite tense
8	Cultura y Tradiciones	B1	Festivities, art, literature, gastronomy, customs, folklore
9	Medios de Comunicación y Tecnología	B1	Media, social media, tech, influence, advertising, digital
10	Viajes y Turismo	B1	Planning, accommodation, activities, culture, emergencies
11	Ambiente y Sustentabilidad	B1+	Environment, problems, recycling, energy, ecotourism
12	Cultura y Sociedad Contemporánea	B1+	Contemporary art, music, film, fashion, gastronomy, celebrations

Lesson Structure

Each of the 72 lessons follows a consistent structure designed for self-paced MOOC-style learning:

Content — 200-400 words of markdown with headers, vocabulary lists, grammar tables, and example dialogues
Filipino Connection — Heritage bridge showing Spanish-origin Filipino words (e.g., "kumusta" from "¿Cómo está?")
Cultural Capsule — Every 6th lesson includes a deep dive into Mexican/Latin American culture
Exercises — 2-3 interactive exercises per lesson (multiple choice + fill-in-the-blank), stored as JSONB
Duration — 30 minutes per lesson, 5 hours per module
Assessment — Pass mark ≥ 80% to receive module certificate

Section Ten

10. Security & Authentication

Authentication Flow

User submits email + password to POST /api/auth/login
Backend verifies against bcrypt-hashed password (12 salt rounds)
JWT token issued with 24-hour expiration
Token stored in sessionStorage (cleared on tab close)
Every API request includes Authorization: Bearer {token}
401 responses auto-clear session and redirect to login

Role-Based Access Control

admin — Full access to all features and data
official — Analytics, schools, economic impact, partners
teacher — Course creation, student progress
student — Courses, classroom, progress, AI tutor
bpo_worker — Job board, applications, courses
partner — Partner network, collaboration tools

Security Measures

Password hashing: bcrypt with 12 salt rounds (industry standard)
JWT tokens: Signed with server-side secret, 24-hour expiration
SSL/TLS: All database connections require SSL
Input validation: Parameterized queries prevent SQL injection
CORS: Managed at the Express application level
Session isolation: sessionStorage clears on browser/tab close
Tenant isolation: All data scoped to tenant_id = 'torna_idioma'

Section Eleven

11. Deployment & Infrastructure

CI/CD Pipeline

Developer
git push main

→

GitHub
main branch

→

Render
auto-build

→

Deploy
~90 seconds

→

Live
aiagent.ringlypro.com

Infrastructure

Hosting: Render (Web Service)
Database: Render PostgreSQL (managed)
Domain: aiagent.ringlypro.com
Port: 10000 (production)
SSL: Automatic via Render
Auto-deploy: On push to main branch

Build Process

Backend: No build step (Node.js runs directly)
React SPA: vite build → dist/
Landing Page: No build (static HTML)
Migrations: Run automatically on startup
Seeding: Idempotent (checks before insert)
Health check: GET /Torna_Idioma/health

Section Twelve

12. Future Roadmap

Phase 2: Live Instruction

Integration with UVEG virtual instructors — 2 hours/week of live conversation practice per group of 35 students, as specified in the MOU.

Q3 2026

Phase 3: DELE Preparation

Partnership with Instituto Cervantes Manila for official DELE exam preparation tracks (A2, B1, B2) with practice tests and certification.

Q4 2026

Phase 4: City Expansion

Expand from 3 pilot cities to 10+ municipalities across the Philippines, including Iloilo, Cebu, and Manila.

2027

Phase 5: Mobile App

Native mobile application (iOS/Android) with offline lesson access, push notifications, and speech recognition for pronunciation practice.