♻️📝 API-server files collection cleanup and doc

[pcrespov]

What do these changes do?

Minor cleanup and doc of files collections in the api-server:

• ♻️ cleanup API's files collection
• ♻️ updates openapi specs
• 📝 doc
  • controller-service-repository (CSR) pattern
  • @bisgaard-itis I added some doc about files collection to 4641 so you can follow up on those.
• ♻️ renames some utils modules as services to follow CSR pattern

Related issue/s

• preamble to Public API files resources #4641

How to test

in-place

DevOps

None

[codecov]

Codecov Report

Merging #4645 (38959d5) into master (08e7c25) will decrease coverage by 18.5%.
The diff coverage is 89.7%.

@@            Coverage Diff            @@
##           master   #4645      +/-   ##
=========================================
- Coverage    85.2%   66.7%   -18.5%     
=========================================
  Files        1054     513     -541     
  Lines       44715   25602   -19113     
  Branches     1018     190     -828     
=========================================
- Hits        38107   17090   -21017     
- Misses       6379    8465    +2086     
+ Partials      229      47     -182     

Flag	Coverage Δ
integrationtests	65.4% <ø> (-0.1%)	⬇️
unittests	81.7% <89.7%> (-2.6%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files Changed	Coverage Δ
..._service_api_server/services/solver_job_outputs.py	56.0% <ø> (ø)
...src/simcore_service_api_server/api/routes/files.py	61.6% <86.6%> (-1.4%)	⬇️
...core_service_api_server/api/routes/solvers_jobs.py	76.1% <100.0%> (ø)
...simcore_service_api_server/models/schemas/files.py	92.7% <100.0%> (ø)
...pi_server/services/solver_job_models_converters.py	97.1% <100.0%> (ø)
...src/simcore_service_api_server/services/storage.py	60.0% <100.0%> (ø)

... and 790 files with indirect coverage changes

[codeclimate]

Code Climate has analyzed commit 38959d5 and detected 0 issues on this pull request.

View more on Code Climate.

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
5 Code Smells

No Coverage information
1.4% Duplication

[mrnicegyu11]

thanks, good links in the updated docs :--)

[bisgaard-itis]

Looks good to me. Thanks for the clean up