Fastcat Delivery

Fastcat Delivery on jakamiseen ja hallintaan suunniteltu alusta. Se tarjoaa turvallisen ja nopean tavan ladata, arkistoida ja jakaa suuria tiedostoja käyttäjien välillä. Järjestelmä hyödyntää reaaliaikaista WebSocket-viestintää ja automaattisia puhdistusprosesseja varmistaen saumattoman käyttökokemuksen.

Tekniset yksityiskohdat

Frontend

• React mahdollistaa dynaamisen ja responsiivisen käyttöliittymän rakentamisen.
• ReconnectingWebSocket varmistaa WebSocket-yhteyksien jatkuvan toimivuuden.
• FormData ja Multer käsittelevät tehokkaasti suurien tiedostojen lataamista.

Backend

• Express.js tarjoaa joustavan ja skaalautuvan palvelinpuolen rakenteen.
• Multer hoitaa tiedostojen lataamisen ja tallennuksen turvallisesti.
• WebSocket mahdollistaa reaaliaikaisen viestinnän asiakkaiden kanssa.
• Node-cron aikatauluttaa automaattiset puhdistusprosessit vanhojen tiedostojen poistamiseksi.

Build-prosessi

• Jokainen tiedoston latausprojekti käynnistää automaattisesti tarvittavat prosessit, kuten tiedostojen siirron, pakkaamisen ja lataamisen pilveen.
• Build-prosessin tuloksena syntyy optimoituja tiedostoja, jotka ovat helposti saatavilla käyttäjille.

Ominaisuudet

Tiedostojen hallinta

• Käyttäjä voi ladata, arkistoida ja jakaa suuria tiedostoja helposti.
• Tiedostojen latausprosessi on suojattu ja optimoitu nopeaan käsittelyyn.

Reaaliaikainen viestintä

• WebSocket-viestintä tarjoaa reaaliaikaisia päivityksiä tiedostojen latausprosessista.
• Käyttäjät saavat välittömän palautteen tiedostojen tilasta ja mahdollisista virheistä.

Automaattinen puhdistus

• Node-cron aikatauluttaa päivittäiset puhdistustehtävät poistamaan yli 30 päivää vanhat tiedostot Google Drivesta.
• Automaattiset puhdistusprosessit varmistavat järjestelmän optimoidun tilan ja resurssien tehokkaan käytön.

Sähköpostivastaukset

• Nodemailer lähettää käyttäjille sähköpostitiedotteet tiedostojen latauslinkkien kanssa.
• Sähköpostit sisältävät tiedostojen latauslinkit ja vanhenemisajat, mikä parantaa käyttäjäkokemusta ja turvallisuutta.

Teknologiat ja työkalut

• Express.js: Sovelluspalvelimen rakentamiseen ja API-reittien hallintaan.
• Multer: Tiedostojen lataamisen käsittelyyn ja hallintaan.
• WebSocket: Reaaliaikaisen viestinnän mahdollistamiseen asiakas- ja palvelinpuolen välillä.
• Node-cron: Ajastettujen tehtävien suorittamiseen, kuten vanhojen tiedostojen siivous.
• Google Drive API: Tiedostojen automaattiseen lataamiseen ja hallintaan pilvessä.
• Nodemailer: Sähköpostiviestien lähettämiseen käyttäjille tiedostojen latauslinkkien kanssa.
• dotenv: Ympäristömuuttujien hallintaan ja konfigurointiin.
• ReconnectingWebSocket: Varmistaa WebSocket-yhteyksien uudelleen yhdistämisen tarvittaessa.
• Archiver: Tiedostojen pakkaamiseen ZIP-arkistoiksi tehokkaasti.
• Cleanup Utilities: Automaattiseen vanhojen tiedostojen ja tilapäisten kansioiden puhdistamiseen.

Yleinen rakenne ja toiminnallisuudet

1. Koodi on jaettu moduuleihin ja hyödyntää RESTful-periaatteita sekä Express.js-reittien kautta tapahtuvaa toimintojen jakoa.
2. Frontend on rakennettu Reactillä ja hyödyntää ReconnectingWebSocketia reaaliaikaiseen viestintään.
3. Backend tukee tiedostojen lataamista, pakkaamista, siirtämistä pilveen ja sähköpostiviestien lähettämistä, samalla kun se suojaa järjestelmää CSRF-suojauksella.
4. Käyttäjätietoja hallinnoidaan kirjautumismekanismilla, jossa on bcrypt-salasanan salaus ja JWT-autentikointi.

Käyttäjän toiminta

1. Käyttäjä lataa tiedoston palvelimelle.
   • Pyyntö sisältää:
     • Tiedoston (JPEG, PNG, GIF tai ZIP).
     • Sähköpostitiedot (vastaanottaja ja lähettäjä).
     • Otsikko ja viesti.
2. Reitin käsittely (Esim. /upload)
   • Reititiedosto ohjaa pyynnön käyttämällä Multeria tiedoston tallentamiseen oikeaan hakemistoon.
   • Tiedoston MIME-tyyppi ja koko tarkistetaan ennen tallennusta.
   • Tiedosto tallennetaan tilapäiseen hakemistoon ja siirretään istunnon kansioon.
3. Tiedoston pakkaus ja lataus pilveen
   • Tiedostot pakataan ZIP-arkistoksi Archiverilla.
   • ZIP-arkisto ladataan Google Driveen Google Drive API:n avulla.
   • Arkistolle asetetaan julkiset oikeudet ja luodaan latauslinkki.
4. Sähköpostin lähetys
   • Nodemailer lähettää sähköpostin sekä vastaanottajalle että lähettäjälle, sisältäen latauslinkin ja vanhenemisajan.
5. Reaaliaikaiset päivitykset
   • WebSocket-viestit informoivat käyttäjää prosessin etenemisestä ja mahdollisista virheistä.
6. Automaattinen puhdistus
   • Node-cron suorittaa päivittäin puhdistustehtävät poistaen yli 30 päivää vanhat tiedostot Google Drivesta.
   • Tilapäiset kansiot ja tiedostot poistetaan heti prosessin jälkeen.

Yhteenveto

• Tiedostot tarkistetaan, tallennetaan ja pakataan turvallisesti.
• Tiedostot ladataan Google Driveen ja sähköpostit lähetetään automaattisesti käyttäjille.
• Reaaliaikainen viestintä ja automaattinen puhdistus varmistavat saumattoman käyttökokemuksen ja järjestelmän tehokkaan toiminnan.

Endpointit

1. Yleiset endpointit

2. Sivut

3. Artikkelit

4. Asetukset ja yleinen sisältö

5. Kuvien käsittely

6. Kirjautuminen ja käyttäjätoiminnot

7. Hallinta- ja asetustoiminnot