2024-04-19: Projekts - Degvielas čeki

[Rozkalns]

Plāns:

• Iepazīties ar degvielas čeku uzskaiti un iespējām
• SQL piemēri reālā projektā
• Individuālais darbs
• datu validācija (diskusija),
• attack-surface samazināšana
• Laika joslas, datumi, UTC, Europe/Riga

Projekts: Degvielas čeki

Problēmas apraksts

Man kļuva grūti uzturēt degvielas čeku vēsturi, tāpēc bija nepieciešams izveidot kādu programmu, lai to varētu darīt ērtāk. Ikreiz, kad es iegādājos degvielu, man bija jāpieraksta informācija par veikto uzpildi - cik daudz degvielas esmu iepildījis, kur es to darīju, kāds bija degvielas veids un cik daudz es maksāju un kāds ir šīs automašīnas pašreizējais noskrējiens. Turklāt, es vēlējos saglabāt šo informāciju tā, lai to būtu viegli atrast un analizēt nākotnē. Tāpēc es nolēmu izveidot programmu, kas ļauj man saglabāt un pārvaldīt savu degvielas čeku vēsturi tieši no datora vai mobilā ierīce.

Attēli:

Uzpilde	Odometrs	Čeks

Funkcionālās prasības:

• Datuma un laika ievade: Lietotājam ir jābūt iespējai ievadīt degvielas uzpildes datumu un laiku.
• Degvielas uzpildes informācijas ievade: Lietotājam ir jābūt iespējai ievadīt informāciju par degvielas uzpildi, tostarp izvēlēties degvielas veidu, norādīt uzpildes vietu, ievadīt uzpildīto daudzumu un kopējo summu, automašīnas noskrējienu, kas atrodams auto panelī.
• Informācijas saglabāšana: Sistēmai ir jāsaglabā ievadītā degvielas uzpildes informācija datubāzē.
• Informācijas iegūšana un pārvaldība: Lietotājam ir jābūt iespējai skatīt un pārvaldīt savu degvielas uzpildes vēsturi, tostarp meklēt pēc datuma, filiāles, vai degvielas veida.

Nefunkcionālās prasības:

• Drošība: Datubāzē saglabātā informācija ir jāaizsargā no neautorizētas piekļuves un jānodrošina, lai dati būtu konfidenciāli.
• Izstrādes valoda un tehnoloģijas: Sistēma ir jāizstrādā, izmantojot PHP programmēšanas valodu un MySQL datubāzi.
• Lietotāja pieredze (UX): Lietotājam ir jābūt iespējai viegli saprast un lietot sistēmu, pat ja viņam nav programmēšanas vai datubāzu pieredzes.
• Datu precizitāte: Sistēmai ir jānodrošina, lai ievadītā degvielas uzpildes informācija būtu precīza un nepārprotama.
• Veiktspēja: Sistēma ir jāizstrādā, lai būtu efektīva un ātri atbildētu uz lietotāju pieprasījumiem, pat pie liela datu apjoma.

Template

https://jsfiddle.net/akeqwpb1/

Vērtēšanas kritēriji

Criteria	Excellent (4)	Good (3)	Fair (2)	Needs Improvement (1)	Score (out of 4)
Task Completion	All tasks are completed accurately and thoroughly.	Most tasks are completed accurately.	Some tasks are completed accurately.	Few tasks are completed accurately.
Data Validation	Data validation rules are correctly applied.	Most data validation rules are applied.	Some data validation rules are applied.	Data validation rules are not applied or incorrect.
Sanitization	Proper sanitization techniques are applied.	Sanitization techniques are mostly applied.	Some sanitization techniques are applied.	Sanitization techniques are not applied or incorrectly applied.
XSS Prevention	XSS attack vectors are properly sanitized.	Most XSS attack vectors are sanitized.	Some XSS attack vectors are sanitized.	XSS attack vectors are not sanitized.
Timezone Handling	Datetime values are accurately converted to the correct timezone.	Most datetime values are accurately converted.	Some datetime values are accurately converted.	Datetime values are not accurately converted.
Problem Solving	Demonstrates strong problem-solving skills in resolving issues.	Successfully resolves most issues encountered.	Partially resolves issues encountered.	Struggles to resolve issues encountered.
Attention to Detail	Pays meticulous attention to detail in completing tasks.	Generally pays attention to detail.	Some attention to detail is evident.	Lacks attention to detail in completing tasks.
Understanding of Concepts	Demonstrates a deep understanding of concepts discussed.	Shows a good understanding of concepts.	Partial understanding of concepts.	Limited understanding of concepts.
Documentation and Communication	Provides clear documentation of the process and communicates effectively.	Documentation and communication are mostly clear.	Some documentation and communication are provided.	Documentation and communication are unclear or lacking.
Overall Performance	Exceeds expectations in completing tasks and applying concepts.	Meets expectations in completing tasks and applying concepts.	Partially meets expectations in completing tasks and applying concepts.	Falls below expectations in completing tasks and applying concepts.

[Rozkalns]

Start up

1. Izveidot repositoriju
   • nokopēt ssh saiti
   • git clone <ssh saite> <nosaukums>
2. Izveidot jaunu projektu
   • touch .gitignore, pievienojam .idea un vendor (gan jau noderēs, lai ignorētu composer packages instalētās)
3. Public mapītē izveidot index.php failu
   • mkdir public
   • touch public/index.php
   • git add . && git commit -m "public index fails" && git push
4. uzstādīt pamata docker projektu
   • touch compose.yaml
   • touch Dockerfile (jo būs nepieciešams mysql)
   • docker compose up -d
   • git add . && git commit -m "Docker setup" && git push
5. tajā failā renderēt html formu datu ievadei
   • Pievienot papildu lauku - odometrs
   • Aizvietot currency <input> lauku ar <select> kur renderē top 20 valūtas
6. Varam pieņemt POST requestu
   • if ($_SERVER["REQUEST_METHOD"] == "POST") {
7. Pievienojam src mapīti, kurā glabāsim degvielas čeka DTO un konekciju ar datubāzi
   • klaseFuelReceiptDTO - Data Transfer Object
   • vismaz iekš index php if request method == post - veidot sql pieprasījumu lai saglabātu informāciju tabulā
   • Izmantot Atsevišķu klasi, piemēram FuelDAO (DataAccessObject) caur kuru veikt saglabāšanu
8. Izveidot datubāzē fuel tabulu fuel_receipts, kur saglabās attiecīgos ierakstus

[Rozkalns]

Repositoriju Saites