Challenge 3dfilestore Web

In this challenge, you will design the REST API and implement the backend features of a 3D file repository web application. The frontend of the web application is provided.

The 3D file repository has the following features:

• Upload a 3D file, a single format is required, obj is suggested for this exercise.
• List 3D files uploaded on the server.

The app doesn't require to display a 3D viewer of the files. The server should support a single 3D file format. OBJ Wavefront is the suggested format but could be changed at your convenience.

Each file hosted on this server should expose the following features:

• Download file
• Rename file
• Delete file
• Download a transformed file (see below)

On the server-side, you can decide how you store the files (with the database of your choice or even using the file system).

In the end, you should provide:

• A fully implemented and standalone backend code written in Typescript.
• An OpenAPI specification file for your REST operations.
• If your backend requires external dependencies such as a database, it should be either standalone (e.g. sqlite) or containerized with Docker Compose.

The frontend code is provided and has a mock of each requested features.

The transform feature is displayed as a link with hardcoded arguments, but keep in mind that arguments are just placeholders, and could be set manually by a user.

⚠️ Keep in mind that your code should be efficient performance-wise.

The performance of the database you choose will not be taken into account for this evaluation. ⚠️

Interfacing your API with the existing Web App

Modify the arguments passed to each function in ./src/api/functions.ts.

Transform and Download feature

The Transform and Download is a special functionality that will transform each vertices in the file with a given scale and translation vector.

For example with an obj the vertices are described like this:

v 1  1  1
v 1  0  1
v 2 10 10

The transform feature will allow you to download the file with a dynamic scale and translation vectors. For example, if we specify [2, 2, 2] as a scale vector, the file will be downloaded and transformed like that:

v 2  2  2
v 2  0  2
v 4 20 20

With a [10, 0, 0] as a translation vector, the file will be downloaded and transformed like that:

v 11  1  1
v 11  0  1
v 20 10 10

⚠️ The transformed file should not alter the original file stored on the server! ⚠️

Example obj files

You can find some obj files ready to use from the following links:

• buggy.obj
• engine.obj
• starwarsjuggeren.obj
• teapot.obj
• whale.obj

Toolchain

• nodejs: >=18
• npm: >=9

How to use

npm install
npm run start:w

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.