← Back to Projects

Project: TVT23KMO-R4-Mobiilisovellusprojekti/2024-Q4-Mobiili

Kierrätyssovellus


Tekijät


Tämä repositorio esittelee Oulun ammattikorkeakoulun tieto- ja viestintätekniikan opiskelijoiden tekemää sovellusta, joka kuuluu toteutukseen Mobiilikehitysprojekti (6 op + 3 op). Hankkeen tarkoituksena on oppia kokonaisvaltaista mobiilikehitystä ketteriä menetelmiä sekä versionhallintajärjestelmää käyttäen.


Sovelluksen kuvaus

Kierttis tarjoaa digitaalisen alustan kierrätykselle, jossa asiakkaat voivat jakaa ja vastaanottaa kierrätettäviä tavaroita helposti ja ekologisesti. Sovelluksena se perustuu sosiaalisen median roskalavaryhmiin.

Ominaisuuksia

  • Käyttäjä voi julkaista tavaroita annettavaksi sekä hallinnoida julkaisujaan.
  • Käyttäjä voi listautua jonoon / varaajaksi tuotteeseen sekä poistaa varauksiaan.
  • Julkaisija ja käyttäjä näkee jonottajien määrän tuotteessa sekä jonottaja saa jonotussijansa.
  • Jonotus etenee ja pinosta vanhentuneet varaukset poistuvat, varaus on voimassa edellisen sijan päättymisestä 6h.
  • Ilmoitus on voimassa kunnes julkaisija merkitsee tuotteen luovutetuksi / poistaa sen, ja silti - enintään viikon verran julkaisusta.
  • Julkaisijan ja 1. sijalla olevan varaajan välille avataan viestiketju, jossa he voivat sopia tuotteen luovutuksesta.
  • Viestiketjut lähtevät vanhentuneiden ja peruuntuneiden varausten mukana.

Teknologiat

  • Android-toteutus React nativella (Expo)
  • Autentikointi Firebase
  • Tietokanta Firestore
  • Ajoympäristö Node.js

Sovelluksen rakenne

Sovellus sisältää seuraavat kansiot:

./: Sisältää sovelluksen käynnistymisessä olennaiset tiedostot kuten App.js

./assets/: Sisältää sovelluksen käyttämät kuvat

./components/: Sisältää sovelluksen käyttämiä komponentteja kuten ylä- ja alapalkit sekä painikkeet

./context/: Sisältää autentikaatioon, sisällön lataamiseen ja viestijärjestelmään liittyviä kontekstitiedostoja

./screens/: Sisältää sovelluksen eri näkymiä kuten tilinäkymä, chatnäkymä sekä kotinäkymä

./services/: Sisältää erilaisiin sovelluksen käyttämiin palveluihin liittyviä yhteystiedostoja kuten Firebase sekä Firestore


Sovelluksen käyttö

Kun sovellus avataan niin se avautuu kirjautumisnäkymään. Kirjautumisnäkymästä pääsee myös rekisteröitymään.

Kirjautumisen/Rekisteröitymisen jälkeen sovellus siirtyy kotinäkymään, jonka alareunasta pääsee siirtymään kierrätystavaralistaukseen tai tilinhallintaan.

Kierrätystavaralistauksessa on listattuna tarjolla olevat ilmoitukset. Yläreunan valikon kautta voi luoda omia ilmoituksia sekä tarkastella jo tehtyjä ilmoituksia sekä varauksia.

Tilinhallintanäkymässä puolestaan voi tarkastella varausten myötä syntyneitä keskusteluja, omia ilmoituksia sekä varauksia, hallita tiliä sekä kirjautua ulos sovelluksesta.

KirjautumisnäkymäKotinäkymäKierrätystavaralistausTilinhallintanäkymä
Screenshot_20241211-172124Screenshot_20241211-172133Screenshot_20241211-172157Screenshot_20241211-172211

Asennus

Kloonaus

Voit kloonata repositorion käyttämällä valitsemassasi terminaalissa komentoa:

git clone https://github.com/TVT23KMO-R4-Mobiilisovellusprojekti/2024-Q4-Mobiili

Projektin käynnistäminen paikallisesti

Projektin voi käynnistää paikallisesti valitsemassasi terminaalissa komennoilla:

npm install
npm start

Tämän jälkeen sovelluksen voi avata ja sitä voi käyttää älypuhelimen (Android tai iOS) Expo Go -sovelluksella

Firebasen konfigurointi

Firebasen konfigurointiin löydät ohjeet Firebasen dokumentaatiosta.