Näin rakennat reseptisovelluksen: reseptit, annoskoon muuntaminen, ostoslistat ja haku

Reseptisovellus on kokoelma reseptejä hyvällä haulla, selkeillä ruoanlaittosivuilla ja pari keittiöapuria: annoskoon skaalaus, yksikkömuunnos ja reseptien muuttaminen ostoslistaksi. Olipa kyseessä perheen keittokirja, ruokablogi reseptikorteilla tai reseptituote muille, yksi päätös tekee kaikesta toimivaa: ainesosat tallennetaan rakenteisena datana, ei tekstikappaleena. Kun se on kunnossa, hyödylliset ominaisuudet ovat helppoja.

Päätä, minkä tyyppinen reseptisovellus on

Tietomalli on sama kaikissa neljässä. Muuttuu se, kuka voi kirjoittaa ja tarvitseeko sivujen löytyä hakukoneilla.

Mitä reseptisovellus tarvitsee

Sivut

• Reseptilista tai etusivu: kortit kuvalla, otsikolla, kokonaisajalla ja tageilla.
• Reseptisivu: ruoanlaittonäkymä, jossa on kuva, annoskoon säädin, ainesosalista, numeroidut vaiheet ja muistiinpanot.
• Haku ja suodattimet: nimen, ainesosan, tagin (kasvisruoka, nopea, jälkiruoka) tai ajan mukaan.
• Reseptin lisäys ja muokkaus: lomake, joka käsittelee ainesosat rivi riviltä.
• Kokoelmat: "Arkiruoka", "Joulu", "Äidin reseptit".
• Ostoslista: rakennettu yhdestä tai useammasta reseptistä.

Data

• Reseptit: otsikko, slug, kuvaus, annokset, valmistelun ja kypsennyksen aika, kuva, tagit, lähde, tekijä, näkyvyys.
• Ainesosat: resepti, järjestys, määrä, yksikkö, nimi, huomautus ("hienonnettu"), valinnainen ryhmä ("Kastikkeeseen").
• Vaiheet: resepti, järjestys, teksti, valinnainen ajastin.
• Kokoelmat ja kokoelman kohteet.
• Ostoslistan kohteet: käyttäjä, ainesosan nimi, määrä, yksikkö, merkitty tai ei.

Määrien pitäisi olla lukuja. "1 ½ kuppia" on määrä 1.5, yksikkö kuppi. Pidä lyhyt lista yksiköistä, jotka sovellus ymmärtää, ja salli vapaa teksti ("nokare", "maun mukaan") ilman määrää.

Käyttöoikeudet

Henkilökohtainen keittokirja tarvitsee yhden tilin ja yksityiset reseptit. Perheen keittokirja tarvitsee jaettuja kokoelmia, joita useat voivat muokata. Julkinen sivusto tarvitsee lukijoita (ei kirjautumista) ja muokkaajia. Yhteisö tarvitsee jäseniä, jotka omistavat omat reseptinsä, ja moderaattoreita, jotka voivat piilottaa mitä tahansa.

Ominaisuudet, jotka tekevät siitä kannattavan käyttää

Annoskoon skaalaus. Kerro jokainen määrä uusilla annoksilla jaettuna alkuperäisillä annoksilla. Näytä järkevät murtoluvut (¾ kuppia, ei 0,75 kuppia) ja pyöristä kankeat määrät. Jotkut asiat eivät skaalaudu lineaarisesti: mausteet, paistoajat, vuoan koot, joten lyhyt huomautus reseptissä auttaa.

Yksikkömuunnos. Metrinen/USA-vaihto. Muunna tilavuudet ja painot oman tyyppinsä sisällä; kuppien muuttaminen grammoiksi jauhoille vaatii ainesosakohtaisen tiheyden, mikä on myöhempi ominaisuus, ei ensimmäinen.

Ruoanlaittotila. Iso teksti, yksi vaihe kerrallaan tai vierittävä lista ruksilaatikoilla, ja näyttö pidetään hereillä ruoanlaiton ajan (selaimet tukevat näytön wake lock -toimintoa monilla laitteilla). Tästä ihmiset kiittävät sinua.

Ostoslista. Yhdistä ainesosat useista resepteistä, yhdistä sama ainesosa samalla yksiköllä, ryhmittele käytävän mukaan ja anna ihmisten ruksia kohteet kaupassa.

Haku ainesosan mukaan. "Mitä voin tehdä kanasta ja purjosta?" toimii vain siksi, että ainesosat ovat erillisiä tietueita. Katso näin lisäät haun sovellukseesi.

Hakukoneoptimointi julkisille reseptisivuille

Jos ihmisten pitäisi löytää reseptisi hakukoneilla, jokaisella reseptillä pitää olla oma URL-osoite, uniikki otsikko ja kuvaus sekä reseptisisältö, joka on HTML:ssä jo sivun latautuessa eikä JavaScriptin piirtämänä myöhemmin. Lisää schema.org Recipe -rakenteinen data (ainesosat, vaiheet, ajat, annokset, kuva), joka generoidaan tietokannasta, jotta se vastaa aina sivua. Sisällytä arvostelut vain, jos oikeat ihmiset ovat jättäneet ne sivulle. Oppaamme rakenteisesta datasta selittää merkinnän, ja Googlen oma dokumentaatio listaa käyttämänsä kentät.

Esimerkki ensimmäisestä kehotteesta

Rakenna perheen reseptisovellus, joka on suunniteltu ensin puhelimille. Jokaisella reseptillä on otsikko, kuva, annokset, valmistelun ja kypsennyksen aika, tagit, ainesosat ja numeroidut vaiheet. Tallenna jokainen ainesosa omana tietueenaan, jossa on määrä, yksikkö, nimi ja huomautus, ryhmiteltynä valinnaisiin osioihin kuten "Kastikkeeseen". Reseptisivulla on annoskoon säädin, joka skaalaa jokaisen määrän ja näyttää kauniit murtoluvut, metrinen/USA-yksikkövaihto ja ruoanlaittotila, jossa on iso teksti, vaiheruudut ja näyttö, joka pysyy hereillä. Haku reseptin nimen tai ainesosan mukaan, suodatus tagin ja kokonaisajan mukaan. Käyttäjät voivat tallentaa reseptejä kokoelmiin ja lisätä yhden tai useampia reseptejä ostoslistaan, joka yhdistää samat ainesosat ja antaa minun ruksata kohteita. Perheenjäsenet kirjautuvat sähköpostilla ja salasanalla ja jakavat yhden keittokirjan, jota kaikki voivat muokata. Tallenna kaikki tietokantaan ja kuvat tiedostotallennukseen. Lisää kuusi esimerkkireseptiä.

Rakenna askel askeleelta

1. Reseptisivu esimerkkidatalla. Tee ruoanlaittonäkymästä erinomainen puhelimella ennen mitään muuta.
2. Rakenteinen ainesosien syöttö. Lomake, jossa jokainen rivi on määrä, yksikkö, ainesosa ja huomautus. Tarjoa myös "liitä lista" -laatikko, joka jakaa tekstin riveiksi, ja anna kokkaajan korjata väärin jaetut kohdat.
3. Skaalaus ja yksiköt. Testaa hankalilla tapauksilla: ⅓ kuppia kaksinkertaistettuna, 1 muna puolitettuna, "suolaa maun mukaan".
4. Haku ja suodattimet.
5. Ostoslista. Yhdistä "2 sipulia" ja "1 sipuli" kohdaksi "3 sipulia"; pidä eri yksiköt erillään sen sijaan, että arvaisit.
6. Kirjautuminen ja jakaminen. Katso näin lisäät kirjautumisen sovellukseesi.
7. Kuvat. Pienennä latauksen yhteydessä, jotta sivut pysyvät nopeina.
8. Julkiset sivut ja merkintä (jos julkiset). Julkaise sitten ja tarkista reseptisivun lähdekoodi.

Yleisiä virheitä

• Ainesosat yhtenä tekstikenttänä. Menetät skaalauksen, ostoslistat ja haun ainesosan mukaan.
• Desimaalit näytöllä. "0,333 kuppia" on käyttökelvoton. Näytä murtoluvut.
• Elämäntarina ennen reseptiä. Omassa sovelluksessasi laita ainesosat lähelle ylälaitaa, ja jos tarinaa on, lisää linkki "siirry reseptiin".
• Täysikokoiset kuvat. Puhelimen kuvat ovat suuria; pienennä ja pakkaa ne.
• Muiden sivujen reseptien kopioiminen julkisesti. Tuonti henkilökohtaiseen käyttöön on eri asia kuin toisen tekstin ja kuvien julkaiseminen.
• Väärennetyt arvostelut rakenteisessa datassa. Hakukoneet voivat rangaista harhaanjohtavasta merkinnästä.
• Ravintoarvot esitettynä tarkkoina. Jos lasket ravintoarvot, kerro että ne ovat arvioita ja mainitse datalähde.

Kun valmis reseptisovellus on parempi

Jos haluat tallentaa ja kokata omia reseptejäsi, vakiintuneet reseptinhallintasovellukset tuovat jo reseptejä verkkosivuilta, synkronoivat laitteiden välillä ja toimivat offline. Ruokablogille blogialustojen reseptikortti-lisäosat hoitavat merkinnän ja tulostusnäkymät valmiiksi.

Rakenna oma, kun haluat jotain, mitä nuo työkalut eivät tee: reseptijärjestelmä yritykselle, jossa on kustannuslaskenta tai allergeenien seuranta, keittokirja, jota laaja perhe jakaa omalla rakenteella, reseptit yhdistettynä ateriasuunnitelmaan tai kauppaan, tai ulkoasu, joka on kokonaan sinun. Jos ateriasuunnittelu on todellinen tavoite, lue seuraavaksi näin rakennat ateriasuunnittelusovelluksen.

Rakentaminen Mythexillä

Mythexissä kuvaat reseptisovelluksen chatissa, tarkistat ruoanlaittonäkymän elävän esikatselun puhelinkehyksessä ja julkaiset sen julkiseen osoitteeseen, jonka perhe tai lukijat voivat avata puhelimellaan ja lisätä aloitusnäytölle. Mythex lisää oman Postgres-tietokannan resepteille ja ainesosille sekä tiedostotallennuksen kuville, kun sovellus sitä tarvitsee. Kirjautuminen on omalla ratkaisulla: valitset lähestymistavan ja agentti kytkee sen. Pro-tasolla Mythex voi myös paketoida sovelluksen Android- ja iPhone-sovellukseksi, joka lähetetään Google Playn sisäiseen testaukseen ja TestFlightiin. Julkiselle reseptisivustolle katso ruokablogin pohja ja opas mobiiliystävällisen verkkosovelluksen rakentamisesta.

Kysymykset