secure-t

secure T

Universidad digital de ciberseguridad e inteligencia artificial

secure T es una plataforma educativa open source orientada a ciberseguridad, IA y formación técnica avanzada. Combina campus digital, laboratorios aislados, tutoría IA gobernada, evaluación por evidencia y credenciales verificables.

Descargo legal: Esta aplicación NO afirma acreditación universitaria ni validez oficial de títulos. Las capacidades no implementadas están documentadas como pendientes en IMPLEMENTATION_STATUS.md.

---

💝 ¿Por qué secure T?

Nace de la convicción de que la educación es el acto más generoso de compartir.

Cuando alguien que amamos nos enseña algo, esa sabiduría merece ser transmitida. Lee ABOUT.md para entender la visión detrás de este proyecto.

¿Es una plataforma real de cursos? Sí. VERIFICATION.md detalla cada componente funcional.

---

🚀 Inicio rápido

Requisitos

• Node.js 22+
• pnpm 10.4+
• Docker & Docker Compose (para servicios locales)
• PostgreSQL (via Docker recomendado)

Setup

# Instalar dependencias
pnpm install

# Validar tipos y tests
pnpm check
pnpm test

# Levantar servicios locales (PostgreSQL, Redis, etc.)
docker compose -f infrastructure/docker-compose.yml up -d

# Configurar variables de entorno
cp .env.example .env

# Generar esquema BD con Drizzle
pnpm db:generate

# Desarrollo
pnpm dev

# Build para producción
pnpm build
pnpm start

La aplicación estará disponible en http://localhost:3000.

---

📚 Documentación

Documento	Contenido
ACADEMIC_MODEL.md	Modelo educativo, competencias y evaluación por evidencia
ARCHITECTURE.md	Diseño modular, fronteras, y decisiones técnicas
AI_GOVERNANCE.md	Governance de IA, permisos y auditoría
LAB_ARCHITECTURE.md	Cyber range aislado y entornos de laboratorio
DEPLOYMENT.md	Despliegue en Vercel, Docker, y configuración de producción
SECURITY.md	Seguridad, privacidad y mitigación de riesgos
DECISIONS.md	Architecture Decision Records (ADRs)
ROADMAP.md	Mapa de ruta y próximas fases
IMPLEMENTATION_STATUS.md	Estado de cada módulo y features pendientes
CURRICULUM.md	Currículo propuesto y contenidos académicos

---

📁 Estructura del Proyecto

secure-t/
├── client/              React 19 + Vite campus web
├── server/              Express API + AI Gateway
├── drizzle/             Esquema PostgreSQL y migraciones
├── ai/                  Routing, permisos, proveedores de modelos
├── academic/            Motor académico: cursos, competencias, evaluación
├── labs/                Cyber range: entornos aislados y desafíos
├── voice/               Síntesis de voz y consentimiento
├── rag/                 Recuperación de fuentes aprobadas
├── audit/               Eventos de auditoría sin secretos
├── notifications/       Contrato de tareas y estados terminales
├── tests/               Suites de testing (vitest)
├── infrastructure/      Docker Compose y configuración
├── docs/                Documentación completa
└── package.json         Workspaces y definición de proyecto

---

🏛️ Principios Fundamentales

• Open source first: Código abierto, evaluación continua de dependencias
• Seguridad y privacidad por diseño: Auditoría, RBAC, cero confianza
• Estándares abiertos: LTI, xAPI, verificación de credenciales
• Separación de autoridades: Academia desacoplada de tutoría IA
• Mínimo privilegio: Permisos granulares, validación en cada capa
• Evidencia antes de mastery: Evaluación observable, sin arbitra­riedad
• Código de estudiantes aislado: Sandboxing, sin ejecución en servidor principal

---

🔧 Tech Stack

Capa	Tecnologías
Frontend	React 19, Vite, TailwindCSS 4, Shadcn/ui, Recharts, Framer Motion
Backend	Express.js, Node.js 22, TypeScript 5.6
Database	PostgreSQL, Drizzle ORM
AI	Groq API, Supabase Auth, voz (Kokoro/Chatterbox)
DevOps	Docker, Vercel, GitHub Actions
Testing	Vitest, TypeScript strict mode

---

🔄 CI/CD

• GitHub Actions: Typecheck, tests y build en:
  • Push a main
  • Pull requests
  • Nightly schedule (3 AM UTC)
  • Manual dispatch
• Vercel: Despliegue automático configurado mediante vercel.json
  • Requiere conectar repositorio al equipo Vercel
  • Usa variables de entorno aseguradas en Vercel dashboard

---

🤝 Contribuciones

1. Fork el repositorio
2. Crea rama: git checkout -b feature/tu-feature
3. Commit: git commit -am 'feat: descripción clara'
4. Push: git push origin feature/tu-feature
5. Abre Pull Request con descripción de cambios

Política de commits: Sigue Conventional Commits

• feat: nuevas features
• fix: correcciones
• docs: documentación
• test: tests
• refactor: refactoring
• chore: dependencias, CI/CD

---

📋 Estado del Proyecto

• ✅ Campus React/Vite + API Express
• ✅ Progreso de aprendizaje + tutoría básica
• ✅ CI/CD con GitHub Actions
• 🚧 PostgreSQL/Drizzle + autenticación RBAC
• 🚧 Laboratorios aislados (cyber range)
• 🚧 Evaluación por evidencia persistente
• 🚧 Credenciales verificables
• 🗓️ Voz sintética (Kokoro/Chatterbox)
• 🗓️ Interoperabilidad LTI

Ver IMPLEMENTATION_STATUS.md para detalles completos.

---

📄 Licencia

Licenciado bajo AGPL-3.0-only.

Consulta NOTICE-ATRIBUCIONES.md para créditos de componentes y librerías.

---

🆘 Soporte

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentación: Ver carpeta docs/
• Contacto: belentani7pedro@gmail.com

---

🎯 Visión a Futuro

secure T busca convertirse en una alternativa real de universidad digital con:

• Currículo de 4 años acreditado
• Laboratorios en infraestructura aislada
• Comunidad de estudiantes y faculty
• Credenciales verificables en blockchain
• Integración con plataformas LMS estándar (LTI)
• Tutoría IA transparente y gobernada

Seguir roadmap completo en ROADMAP.md.

This site is open source. Improve this page.