LTI - Talent Tracking System | ENG

This project is a full-stack application with a React frontend and an Express backend using Prisma as an ORM. The frontend is set up with Create React App, and the backend is written in TypeScript.

Explanation of Directories and Files

backend/: It contains the server-side code written in Node.js.
- src/: It contains the source code for the backend.
  - index.ts: The entry point for the backend server.
  - application/: It contains the application logic.
  - domain/: It contains the business logic.
  - presentation/: It contains code related to the presentation layer (such as controllers).
  - routes/: It contains the route definitions for the API.
- prisma/: It contains the Prisma schema file for ORM.
- tsconfig.json: TypeScript configuration file.
frontend/: It contains the client-side code written in React.
- src/: It contains the source code for the frontend.
- public/: It contains static files such as the HTML file and images.
- build/: It contains the production-ready build of the frontend.
.env: It contains the environment variables.
docker-compose.yml: It contains the Docker Compose configuration to manage your application's services.
README.md: This file contains information about the project and instructions on how to run it.

Project Structure

The project is divided into two main directories: frontend and backend.

Frontend

The frontend is a React application, and its main files are located in the src folder. The public folder contains static assets, and the build directory contains the production build of the application.

Backend

The backend is an Express application written in TypeScript. The src directory contains the source code, divided into several subdirectories:

application: It contains the application logic.
domain: It contains the domain models.
infrastructure: It contains code related to the infrastructure.
presentation: It contains code related to the presentation layer.
routes: It contains the application routes.
tests: It contains the application tests.

The prisma folder contains the Prisma schema.

First Steps

To get started with this project, follow these steps:

Clone the repo.
Install the dependencies for front end and back end:

cd frontend
npm install

cd ../backend
npm install

Build the back end server:

cd backend
npm run build

Start the backend server:

cd backend
npm start

In a new terminal window, build the frontend server:

cd frontend
npm run build

Start the frontend server:

cd frontend
npm start

The backend server will be running at http://localhost:3010, and the frontend will be available at http://localhost:3000.

Docker y PostgreSQL

This project uses Docker to run a PostgreSQL database. Here’s how to get it up and running:

Install Docker on your machine if you haven't done so already. You can download it from here. Navigate to the root directory of the project in your terminal. Run the following command to start the Docker container:

docker-compose up -d

This will start a PostgreSQL database in a Docker container. The -d flag runs the container in detached mode, which means it runs in the background.

To access the PostgreSQL database, you can use any PostgreSQL client with the following connection details:

Host: localhost
Port: 5432
User: postgres
Password: password
Database: mydatabase

Please replace User, Password, and Database with the actual username, password, and database name specified in your .env file.

To stop the Docker container, run the following command:

docker-compose down

To generate the database using Prisma, follow these steps:

Make sure that the .env file in the root directory of the backend contains the DATABASE_URL variable with the correct connection string to your PostgreSQL database. If it doesn’t work, try replacing the full URL directly in schema.prisma, in the url variable.
Open a terminal and navigate to the backend directory where the schema.prisma file is located.
Run the following command to apply the migrations to your database:

npx prisma migrate dev

Once you have completed all the steps, you should be able to save new candidates, both via the web and via the API, and see them in the database.

POST http://localhost:3010/candidates
{
    "firstName": "Albert",
    "lastName": "Saelices",
    "email": "albert.saelices@gmail.com",
    "phone": "656874937",
    "address": "Calle Sant Dalmir 2, 5ºB. Barcelona",
    "educations": [
        {
            "institution": "UC3M",
            "title": "Computer Science",
            "startDate": "2006-12-31",
            "endDate": "2010-12-26"
        }
    ],
    "workExperiences": [
        {
            "company": "Coca Cola",
            "position": "SWE",
            "description": "",
            "startDate": "2011-01-13",
            "endDate": "2013-01-17"
        }
    ],
    "cv": {
        "filePath": "uploads/1715760936750-cv.pdf",
        "fileType": "application/pdf"
    }
}

LTI - Sistema de Seguimiento de Talento | ES

Este proyecto es una aplicación full-stack con un frontend en React y un backend en Express usando Prisma como un ORM. El frontend se inicia con Create React App y el backend está escrito en TypeScript.

Explicación de Directorios y Archivos

backend/: Contiene el código del lado del servidor escrito en Node.js.
- src/: Contiene el código fuente para el backend.
  - index.ts: El punto de entrada para el servidor backend.
  - application/: Contiene la lógica de aplicación.
  - domain/: Contiene la lógica de negocio.
  - presentation/: Contiene código relacionado con la capa de presentación (como controladores).
  - routes/: Contiene las definiciones de rutas para la API.
- prisma/: Contiene el archivo de esquema de Prisma para ORM.
- tsconfig.json: Archivo de configuración de TypeScript.
frontend/: Contiene el código del lado del cliente escrito en React.
- src/: Contiene el código fuente para el frontend.
- public/: Contiene archivos estáticos como el archivo HTML e imágenes.
- build/: Contiene la construcción lista para producción del frontend.
.env: Contiene las variables de entorno.
docker-compose.yml: Contiene la configuración de Docker Compose para gestionar los servicios de tu aplicación.
README.md: Este archivo, contiene información sobre el proyecto e instrucciones sobre cómo ejecutarlo.

Estructura del Proyecto

El proyecto está dividido en dos directorios principales: frontend y backend.

Frontend

El frontend es una aplicación React y sus archivos principales están ubicados en el directorio src. El directorio public contiene activos estáticos y el directorio build contiene la construcción de producción de la aplicación.

Backend

El backend es una aplicación Express escrita en TypeScript. El directorio src contiene el código fuente, dividido en varios subdirectorios:

application: Contiene la lógica de aplicación.
domain: Contiene los modelos de dominio.
infrastructure: Contiene código relacionado con la infraestructura.
presentation: Contiene código relacionado con la capa de presentación.
routes: Contiene las rutas de la aplicación.
tests: Contiene las pruebas de la aplicación.

El directorio prisma contiene el esquema de Prisma.

Primeros Pasos

Para comenzar con este proyecto, sigue estos pasos:

Clona el repositorio.
Instala las dependencias para el frontend y el backend:

cd frontend
npm install

cd ../backend
npm install

Construye el servidor backend:

cd backend
npm run build

Inicia el servidor backend:

cd backend
npm start

En una nueva ventana de terminal, construye el servidor frontend:

cd frontend
npm run build

Inicia el servidor frontend:

cd frontend
npm start

El servidor backend estará corriendo en http://localhost:3010 y el frontend estará disponible en http://localhost:3000.

Docker y PostgreSQL

Este proyecto usa Docker para ejecutar una base de datos PostgreSQL. Así es cómo ponerlo en marcha:

Instala Docker en tu máquina si aún no lo has hecho. Puedes descargarlo desde aquí. Navega al directorio raíz del proyecto en tu terminal. Ejecuta el siguiente comando para iniciar el contenedor Docker:

docker-compose up -d

Esto iniciará una base de datos PostgreSQL en un contenedor Docker. La bandera -d corre el contenedor en modo separado, lo que significa que se ejecuta en segundo plano.

Para acceder a la base de datos PostgreSQL, puedes usar cualquier cliente PostgreSQL con los siguientes detalles de conexión:

Host: localhost
Port: 5432
User: postgres
Password: password
Database: mydatabase

Por favor, reemplaza User, Password y Database con el usuario, la contraseña y el nombre de la base de datos reales especificados en tu archivo .env.

Para detener el contenedor Docker, ejecuta el siguiente comando:

docker-compose down

Para generar la base de datos utilizando Prisma, sigue estos pasos:

Asegúrate de que el archivo .env en el directorio raíz del backend contenga la variable DATABASE_URL con la cadena de conexión correcta a tu base de datos PostgreSQL. Si no te funciona, prueba a reemplazar la URL completa directamente en schema.prisma, en la variable url.
Abre una terminal y navega al directorio del backend donde se encuentra el archivo schema.prisma.
Ejecuta el siguiente comando para aplicar las migraciones a tu base de datos:

npx prisma migrate dev

Una vez has dado todos los pasos, deberías poder guardar nuevos candidatos, tanto via web, como via API, y verlos en la base de datos.

POST http://localhost:3010/candidates
{
    "firstName": "Albert",
    "lastName": "Saelices",
    "email": "albert.saelices@gmail.com",
    "phone": "656874937",
    "address": "Calle Sant Dalmir 2, 5ºB. Barcelona",
    "educations": [
        {
            "institution": "UC3M",
            "title": "Computer Science",
            "startDate": "2006-12-31",
            "endDate": "2010-12-26"
        }
    ],
    "workExperiences": [
        {
            "company": "Coca Cola",
            "position": "SWE",
            "description": "",
            "startDate": "2011-01-13",
            "endDate": "2013-01-17"
        }
    ],
    "cv": {
        "filePath": "uploads/1715760936750-cv.pdf",
        "fileType": "application/pdf"
    }
}

SirJalias/AI4Devs-tdd

LTI - Talent Tracking System | ENG

Explanation of Directories and Files

Project Structure

Frontend

Backend

First Steps

Docker y PostgreSQL

LTI - Sistema de Seguimiento de Talento | ES

Explicación de Directorios y Archivos

Estructura del Proyecto

Frontend

Backend

Primeros Pasos

Docker y PostgreSQL