Projektvision - niklasgolf/unique-postcard GitHub Wiki
Unique Postcard
Namn | Niklas Herrloff |
Användarnamn | nh222zn |
Studieform | Distans (bor i Kalmar och är ofta på campus) |
Projektnamn | Unique Postcard |
Tekniker | Next.js, React 19, CSS Modules, Firebase Authentication, Firestore Database (planerade: PWA, videoinspelning, betalningstjänster, GPS/karttjänster, QR-koder, automatisk utskrift) |
Bakgrund och problembeskrivning
🌍 Visionen
Visionen är att erbjuda ett enkelt, modernt och personligt sätt för människor att skapa och skicka fysiska vykort med en unik och minnesvärd prägel – direkt från mobil eller dator.
Genom applikationen får användaren möjlighet att utforma sitt eget vykort med personliga bilder, hälsningar och detaljer som speglar ögonblickets känsla. Med hjälp av innovativa funktioner ges vykorten dessutom ett samlarvärde som lyfter upplevelsen bortom det vanliga – och förenar det digitala med det fysiska på ett helt nytt sätt.
🎯 Problembeskrivning och behov
I dagens digitala samhälle är det enkelt att skicka hälsningar via appar och sociala medier, men den personliga känslan och det emotionella värdet av ett fysiskt vykort har nästan försvunnit. Samtidigt saknas ett modernt, enkelt och inspirerande verktyg som låter människor skapa vykort som är både unika och personliga – och som dessutom kan levereras fysiskt till mottagaren.
Projektet Unique Postcard har initierats av en kund som tagit fram idén och det övergripande konceptet för appen. Funktionerna har specificerats av kunden, medan design och teknisk implementering har utvecklats i nära samarbete mellan kunden och mig som utvecklare. Jag har bidragit med teknisk expertis, arkitekturval och lösningsförslag för att förverkliga visionen på ett effektivt och hållbart sätt.
Målet med projektet är att erbjuda ett lättanvänt, webbaserat verktyg som gör vykortsskapande tillgängligt, kreativt och meningsfullt – utan krav på installation eller tekniska förkunskaper.
Användar/mål-grupper
👥 Målgrupp
Vår lösning riktar sig till resenärer, turister, familjer, vänner och alla som vill skicka en personlig hälsning med ett fysiskt vykort – men som samtidigt vill ha möjligheten att anpassa sitt vykort på ett sätt som inte tidigare varit möjligt.
Marknad
📌 Marknad och unika egenskaper
Unique Postcard erbjuder unika funktioner som ingen annan app på marknaden har:
- Selfie-frimärken och Lokala Post-stämplar – Använd din egen selfie som frimärke och få en personlig lokal stämpel på ditt vykort.
- Tidsstämplad och Lokal Post-stämpel – Skapa samlarvärde med tidsstämplade poststämplar som bevisar var och när vykortet skapades.
- GPS och QR-koder – Lägg till exakta GPS-koordinater och skapa QR-koder som ger mottagaren en interaktiv upplevelse.
- Personliga Videohälsningar och Ljudmeddelanden – Skicka videohälsningar eller ljudmeddelanden tillsammans med ditt vykort för en ännu mer personlig touch.
- Digitalt Album – Skapa ett digitalt album vid beställning av fler än fem vykort och spara minnen på ett smidigt sätt.
Konkurrenter:
- MyPostcard: Skapa och skicka vykort globalt med över 70,000 designmallar.
- Touchnote: Ladda upp bilder och designa vykort, med global leverans.
- Ink: Enkel och prisvärd design med vykort.
- Postagram: Fotopostkort som levereras i USA och internationellt.
Unique Postcard erbjuder en mer personlig och interaktiv upplevelse med funktioner som selfie-frimärken, tidsstämplar, GPS och QR-koder som skiljer oss från konkurrenterna och ger en minnesvärd upplevelse.
🧩 Baskrav / Funktionella egenskaper
⭐️ Version 1 (de första 10 veckorna)
-
Användaren ska kunna skapa ett vykort via mobil eller dator utan att behöva installera någon app.
✅ Genomfört – appen fungerar i webbläsare och kräver ingen installation. -
Användaren ska kunna välja en egen bild som framsida och frimärke.
✅ Genomfört – användaren kan lägga till och förhandsgranska bild-URL i realtid. -
Användaren ska kunna skriva en personlig hälsning, samt ange datum och plats.
✅ Genomfört – användaren kan redigera meddelande, plats och datum i ett redigeringsformulär. -
Användaren ska kunna redigera och spara sina vykort.
✅ Genomfört – vykort kan redigeras och uppdateras i realtid. -
Användaren ska kunna ta bort vykort från databasen.
✅ Genomfört – användaren kan radera sina vykort med bekräftelse. -
Vykorten sparas i en molndatabas (Firestore).
✅ Genomfört – integration med Firebase Firestore är färdig. -
Gästanvändare ska kunna läsa hemsidans innehåll och erbjudas inloggning.
✅ Genomfört – startsida med tydlig information och Google-inloggning. -
Inloggade användare ska kunna se sina sparade vykort.
✅ Genomfört – vykort hämtas dynamiskt från databasen. -
Designen ska vara ljus, estetisk och mobilanpassad.
✅ Genomfört – ljus och modern design med modulariserad CSS. -
Appen ska visa både fram- och baksidan av vykortet.
✅ Genomfört – layout med förhandsvisning av vykortets båda sidor. -
Kodbasen ska vara uppdelad i små komponenter för bättre läsbarhet och underhåll.
✅ Genomfört – koden är modulär och komponentbaserad. -
Automatiska tester ska köras i CI/CD innan kod går i produktion.
✅ Genomfört – CI/CD pipeline med tester är aktiv. -
Felaktiga funktionsanrop ska tas bort så att ingen kod blockerar vykortsfunktionalitet.
✅ Genomfört – identifierade och åtgärdade fel i logik för vykortssparning.
⭐️ Version 2 (Efter vecka 10)
-
Möjlighet att spela in video eller ljudklipp som kopplas till vykortet.
❌ Ej genomfört – funktionalitet för mediauppladdning saknas ännu. -
Vykortet skrivs ut i A5-storlek och skickas med fysisk post till korrekt adress.
❌ Ej genomfört – fysisk hantering och postintegration ej påbörjad. -
Möjlighet att skicka samma vykort till flera mottagare.
❌ Ej genomfört – systemet stödjer endast en mottagare per vykort. -
Beställning av fler än fem vykort ger tillgång till ett digitalt album.
❌ Ej genomfört – funktionalitet för albumhantering saknas. -
Användaren ska kunna lägga till väderinformation.
❌ Ej genomfört – ingen integration med vädertjänst ännu. -
QR-kod med exakta GPS-koordinater ska kunna läggas till.
❌ Ej genomfört – GPS och QR-kod saknas. -
Funktionalitet för videoinspelning och ljudupptagning direkt i webbläsaren.
❌ Ej genomfört – inspelningsfunktion via webbläsare ännu inte implementerad. -
Integration med tredjepartsbetalningstjänster som PayPal och Klarna.
❌ Ej genomfört – ingen betalningsintegration finns i nuläget. -
Integration med karttjänster för GPS-positionering.
❌ Ej genomfört – kartbaserad platsinformation saknas. -
QR-kodsgenerering för att skapa unika identifierare för vykorten.
❌ Ej genomfört – ingen QR-kodgenerering i nuvarande version. -
Automatisk hantering av utskrift och leverans via partnerskap med tryckerier och posttjänster.
❌ Ej genomfört – inget samarbete med tryckeri/post ännu etablerat.
Teknik
Version 1 (de första 10 veckorna)
Den första versionen av Unique Postcard är byggd med moderna webbutvecklingsverktyg och fokuserar på en snabb, responsiv och modulär upplevelse:
- Next.js (med React 19) för en komponentbaserad frontendstruktur.
- CSS Modules för modulär och isolerad styling av komponenter.
- Firebase Authentication för inloggning med Google och hantering av användarsessioner.
- Firebase Firestore som molndatabas för att spara vykort, användardata och realtidsuppdateringar.
Version 2 (Efter vecka 10)
Den andra versionen planeras att utöka funktionalitet och infrastruktur, men dessa delar är ännu inte implementerade:
- PWA (Progressive Web App)-stöd för installation och offline-användning.
- Videoinspelning och ljudupptagning direkt i webbläsaren.
- Integration med betalningstjänster som PayPal och Klarna.
- GPS-positionering och karttjänster för att koppla platsdata till vykort.
- QR-kodsgenerering för unika identifierare.
- Automatisk utskrift och leverans via partnerskap med tryckerier och posttjänster.
👉 URL till Readme Tillbaka till förstasidan