feat: openapi angular client

[b0ink]

this would move away from the ngx-entity-service

1. Ensure container has java dependancies

sudo apt install default-jdk

2. Generate the Angular interfaces anytime the backend has scheme changes or a new endpoint is exposed

npx openapi-generator-cli generate \
-i http://localhost:3000/api/swagger_doc.json \
-g typescript-angular \
-o ./src/app/api/generated

as long as the backend correctly exposes entities via swagger:

  desc 'Download the tasks that should be listed under the task inbox',
       success: Entities::InboxTaskEntity,
       is_array: true
  params do
    optional :my_students_only, type: Boolean, desc: 'Show tasks from all tutorials or just the ones you teach'
  end
  get '/units/:id/tasks/inbox' do
...
  present unit.tasks_as_hash(tasks), with: Entities::InboxTaskEntity

then openapi will generate the interfaces

would still need to find a way to link relationships like a task->project->unit

4. Inject services and call auto-generated methods

 tasks = signal < InboxTaskEntity[] > ([]);
 #unitService = inject(UnitsService);

 ngOnInit(): void {
     this.authService.afterAuthCall(() => {
         const user = this.userService.currentUser;
         this.#unitService
             .getApiUnitsIdTasksInbox(1, user.username, user.authenticationToken)
             .subscribe((tasks) => this.tasks.set(tasks));
     });
 }

but this will force the backend's schema (entities) to be more consistent.

doubtfire-lms/doubtfire-api#643