Soft Jobs Fullstack

Aplicacion full-stack para conectar desarrolladores junior con oportunidades laborales. Este proyecto esta pensado como portafolio para demostrar React, TypeScript, Node.js, PostgreSQL, autenticacion JWT, Docker, CI/CD y buenas practicas basicas de seguridad.

Stack

• Frontend: React, TypeScript, Vite, React Router
• Backend: Node.js, Express, JWT, bcrypt, PostgreSQL
• Calidad: Vitest, Supertest, ESLint, GitHub Actions
• Infraestructura: Docker Compose

Funcionalidades

• Registro e inicio de sesion con JWT.
• Perfil privado protegido por token.
• Listado de oportunidades laborales.
• API REST documentada por endpoints.
• Validacion basica de datos y manejo centralizado de errores.

Ejecutar con Docker

docker compose up --build

• Frontend: http://localhost:5173
• Backend: http://localhost:3000
• PostgreSQL: localhost:5432

Ejecutar localmente

1. Backend

cd backend
cp .env.example .env
npm install
npm run db:setup
npm run db:schema
npm run dev

npm run db:setup asume que tienes PostgreSQL local con un usuario administrador llamado postgres. Si usas otro usuario administrador, ejecuta el SQL manualmente desde backend/src/config/local-setup.sql.

2. Frontend

cd frontend
npm install
npm run dev

Alternativa rapida

Si no quieres configurar PostgreSQL local, ejecuta todo con Docker desde la raiz:

docker compose up --build

Endpoints principales

Metodo	Ruta	Descripcion
GET	/health	Estado del backend
POST	/api/auth/register	Crear usuario
POST	/api/auth/login	Obtener token JWT
GET	/api/me	Ver perfil autenticado
GET	/api/jobs	Listar ofertas

Variables de entorno

Ver backend/.env.example.

Roadmap de portafolio

• Agregar Swagger/OpenAPI.
• Agregar refresh tokens.
• Agregar roles candidate y admin.
• Desplegar frontend en Vercel y backend en Render/Fly.io.
• Conectar este sistema con el repo QA Automation.