Upload files to "/"
This commit is contained in:
145
ROADMAP.md
Normal file
145
ROADMAP.md
Normal file
@@ -0,0 +1,145 @@
|
|||||||
|
# TuxiNet Terminal
|
||||||
|
|
||||||
|
## Udviklingsroadmap & Versionshistorik
|
||||||
|
|
||||||
|
Dato: 2026-02-20\
|
||||||
|
Aktuel version: v0.6.0 Beta
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# Introduktion
|
||||||
|
|
||||||
|
Dette dokument beskriver udviklingen af TuxiNet Terminal fra første
|
||||||
|
prototype (v0.0.1) til nuværende beta-version (v0.6.0 Beta).
|
||||||
|
|
||||||
|
Systemet er udviklet med fokus på stabil offline-drift, touch-optimering
|
||||||
|
og event-baseret brug.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# v0.0.1 -- Proof of Concept
|
||||||
|
|
||||||
|
- Simpelt salgsinterface
|
||||||
|
- Grundlæggende produktvalg
|
||||||
|
- Lokal database
|
||||||
|
- Manuel betaling uden print
|
||||||
|
|
||||||
|
Formål: Bevise at systemet kunne fungere offline.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# v0.1.x -- Basis Salgssystem
|
||||||
|
|
||||||
|
- Kurv-funktion
|
||||||
|
- Totalberegning
|
||||||
|
- Simpel betalingsregistrering
|
||||||
|
- Første print-integration
|
||||||
|
|
||||||
|
Stabil salgsflow etableret.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# v0.2.x -- Print & Hardware Integration
|
||||||
|
|
||||||
|
- ESC/POS printerstyring
|
||||||
|
- Automatisk åbning af pengeskuffe
|
||||||
|
- Stabil USB-håndtering
|
||||||
|
- Fejllogning
|
||||||
|
|
||||||
|
Hardware blev fuldt integreret.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# v0.3.x -- Drift & Autostart
|
||||||
|
|
||||||
|
- Startup PowerShell script
|
||||||
|
- Automatisk opstart af XAMPP
|
||||||
|
- Kiosk-mode i Chromium
|
||||||
|
- Print-agent som separat proces
|
||||||
|
- Log-system
|
||||||
|
|
||||||
|
Systemet blev selvkørende ved boot.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# v0.4.x -- KlubKort (RFID Betalingskort)
|
||||||
|
|
||||||
|
- RFID scanning ved betaling
|
||||||
|
- Konto-baseret saldo
|
||||||
|
- card = searchkey struktur
|
||||||
|
- Offline funktionalitet
|
||||||
|
|
||||||
|
KlubKort implementeret som betalingsmiddel. Ikke login-system.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# v0.5.x -- Drift Manager & Backup
|
||||||
|
|
||||||
|
- SUADMIN driftspanel
|
||||||
|
- Print-agent genstart
|
||||||
|
- Backup-script (hver time)
|
||||||
|
- Tunnel-baseret datasikring
|
||||||
|
- Transaktionsvisning mellem datoer
|
||||||
|
|
||||||
|
Systemet blev driftsmodent.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# v0.6.0 Beta -- Statistik & Stabilisering
|
||||||
|
|
||||||
|
- Webbaseret statistikpanel
|
||||||
|
- Salg pr. produkt
|
||||||
|
- Omsætningsoverblik
|
||||||
|
- Semi-live synkronisering (1 time)
|
||||||
|
- Forbedret betalingsflow
|
||||||
|
- UI-forbedringer
|
||||||
|
- Stabilitet under høj belastning
|
||||||
|
|
||||||
|
Systemet anvendes nu aktivt ved events.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# Arkitekturudvikling
|
||||||
|
|
||||||
|
Fra monolitisk PHP-løsning → Til modulopdelt struktur med:
|
||||||
|
|
||||||
|
- Separat Print Agent
|
||||||
|
- Backup-agent
|
||||||
|
- SUADMIN kontrolpanel
|
||||||
|
- Web-statistik backend
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# Hvorfor Beta?
|
||||||
|
|
||||||
|
v0.6.0 betegnes Beta fordi:
|
||||||
|
|
||||||
|
- Ingen real-time synkronisering endnu
|
||||||
|
- Ingen multi-terminal support
|
||||||
|
- Ingen lagerstyring
|
||||||
|
- UI kan stadig forbedres
|
||||||
|
|
||||||
|
Systemet er dog fuldt funktionsdygtigt og stabilt.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# Næste Milepæl -- v1.0
|
||||||
|
|
||||||
|
Planlagte mål:
|
||||||
|
|
||||||
|
- Realtids dashboard
|
||||||
|
- Lagerstyring
|
||||||
|
- Multi-terminal support
|
||||||
|
- Central administrationsserver
|
||||||
|
- Forbedret rapportering
|
||||||
|
- Versionssigneret release
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# Konklusion
|
||||||
|
|
||||||
|
TuxiNet Terminal er udviklet fra en simpel prototype til et stabilt,
|
||||||
|
event-klart POS-system.
|
||||||
|
|
||||||
|
v0.6.0 Beta repræsenterer en moden og driftsklar platform, klar til
|
||||||
|
videreudvikling mod v1.0.
|
||||||
170
funktioner.md
Normal file
170
funktioner.md
Normal file
@@ -0,0 +1,170 @@
|
|||||||
|
# TuxiNet Terminal
|
||||||
|
|
||||||
|
## Funktionsbeskrivelse & Systemarkitektur
|
||||||
|
|
||||||
|
Version: 2.0\
|
||||||
|
Dato: 2026-02-20\
|
||||||
|
Udviklet af: TuxiNet.dk
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 1. Systemoversigt
|
||||||
|
|
||||||
|
TuxiNet Terminal er et event-optimeret POS-system designet til:
|
||||||
|
|
||||||
|
- LAN parties
|
||||||
|
- Skolefester
|
||||||
|
- Foreninger
|
||||||
|
- Midlertidige events
|
||||||
|
- Offline miljøer
|
||||||
|
|
||||||
|
Systemet er bygget med fokus på:
|
||||||
|
|
||||||
|
- Offline-first drift
|
||||||
|
- Touch-optimeret brugerflade
|
||||||
|
- Stabilitet under høj belastning
|
||||||
|
- Automatisk backup
|
||||||
|
- Separat print-agent arkitektur
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 2. Overordnet Arkitektur
|
||||||
|
|
||||||
|
Touchskærm\
|
||||||
|
→ Chromium (Kiosk Mode)\
|
||||||
|
→ Apache / XAMPP\
|
||||||
|
→ LANPOS PHP Backend\
|
||||||
|
→ Database (SQLite/MySQL)\
|
||||||
|
→ Print Agent\
|
||||||
|
→ USB Kvitteringsprinter\
|
||||||
|
→ Pengeskuffe
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 3. Kernefunktioner
|
||||||
|
|
||||||
|
## Salgsmodul
|
||||||
|
|
||||||
|
- Produktkategorier
|
||||||
|
- Touch-betjening
|
||||||
|
- Flere varer i kurv
|
||||||
|
- Slet vare fra kurv
|
||||||
|
- Automatisk totalberegning
|
||||||
|
- Numerisk tastatur ved betaling
|
||||||
|
- Kvitteringsprint
|
||||||
|
- Automatisk åbning af pengeskuffe
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
## Betalingsmetoder
|
||||||
|
|
||||||
|
- Kontant
|
||||||
|
- MobilePay (registreres som Card internt)
|
||||||
|
- KlubKort (RFID betalingskort)
|
||||||
|
- Gratis
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
## RFID KlubKort Modul
|
||||||
|
|
||||||
|
KlubKort fungerer udelukkende som betalingskort.
|
||||||
|
|
||||||
|
Det er ikke et login-system og giver ingen rettigheder.
|
||||||
|
|
||||||
|
Funktion:
|
||||||
|
|
||||||
|
- Scan kort ved betaling
|
||||||
|
- Kundekonto identificeres
|
||||||
|
- Saldo vises
|
||||||
|
- Beløb trækkes
|
||||||
|
- Transaktion registreres
|
||||||
|
- Bon kan udskrives
|
||||||
|
|
||||||
|
Teknisk:
|
||||||
|
|
||||||
|
- card = searchkey
|
||||||
|
- Ingen session
|
||||||
|
- Ingen bruger-login
|
||||||
|
- Offline funktionalitet
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
## Print Agent
|
||||||
|
|
||||||
|
Separat Windows-agent som:
|
||||||
|
|
||||||
|
- Modtager printjobs
|
||||||
|
- Sender ESC/POS direkte til printer
|
||||||
|
- Åbner pengeskuffe
|
||||||
|
- Logger fejl
|
||||||
|
- Kan genstartes via SUADMIN
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
## Webbaseret Statistikpanel
|
||||||
|
|
||||||
|
Ekstern webvisning af salgsdata.
|
||||||
|
|
||||||
|
Funktioner:
|
||||||
|
|
||||||
|
- Total omsætning
|
||||||
|
- Salg pr. produkt
|
||||||
|
- Antal solgte enheder
|
||||||
|
- Betalingsfordeling
|
||||||
|
- Datofiltrering
|
||||||
|
|
||||||
|
Opdatering:
|
||||||
|
|
||||||
|
- Synkroniseres én gang i timen
|
||||||
|
- Semi-live visning
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
## Backup Modul
|
||||||
|
|
||||||
|
- Automatisk backup hver time
|
||||||
|
- Sendes via sikker tunnel
|
||||||
|
- Versionssikret
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
## SUADMIN Drift Manager
|
||||||
|
|
||||||
|
- Genstart af print agent
|
||||||
|
- Servicefunktioner
|
||||||
|
- Systemstatus
|
||||||
|
- Driftsoverblik
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 4. Driftstilstande
|
||||||
|
|
||||||
|
Normal drift\
|
||||||
|
Service mode\
|
||||||
|
Offline mode
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 5. Hardwarekrav
|
||||||
|
|
||||||
|
Minimum:
|
||||||
|
|
||||||
|
- 4 GB RAM (8 GB anbefales)
|
||||||
|
- SSD
|
||||||
|
- USB kvitteringsprinter (ESC/POS)
|
||||||
|
- Pengeskuffe via printer
|
||||||
|
- Touchskærm
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 6. Moduloversigt
|
||||||
|
|
||||||
|
Modul Funktion Kritisk Status
|
||||||
|
-------------------- -------------------- --------- --------
|
||||||
|
Salg Håndterer salg Ja Aktiv
|
||||||
|
Print Agent Udskriver bon Ja Aktiv
|
||||||
|
Backup Datasikring Ja Aktiv
|
||||||
|
RFID KlubKort Konto-betaling Ja Aktiv
|
||||||
|
Web Statistikpanel Omsætningsoversigt Nej Aktiv
|
||||||
|
SUADMIN Drift kontrol Nej Aktiv
|
||||||
|
Startup Script Autostart Ja Aktiv
|
||||||
77
manual.md
Normal file
77
manual.md
Normal file
@@ -0,0 +1,77 @@
|
|||||||
|
# TuxiNet Terminal
|
||||||
|
|
||||||
|
## Brugermanual
|
||||||
|
|
||||||
|
Version: 2.0\
|
||||||
|
Dato: 2026-02-20
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 1. Opstart
|
||||||
|
|
||||||
|
1. Tænd maskinen
|
||||||
|
2. Systemet starter automatisk
|
||||||
|
3. Når produktsiden vises er systemet klar
|
||||||
|
|
||||||
|
Hvis systemet ikke starter korrekt: Kontakt teknisk ansvarlig.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 2. Opret salg
|
||||||
|
|
||||||
|
1. Tryk på ønsket produkt
|
||||||
|
2. Produktet vises i kurven
|
||||||
|
3. Tilføj flere varer hvis nødvendigt
|
||||||
|
4. Tryk "Betal"
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 3. Kontant betaling
|
||||||
|
|
||||||
|
1. Tryk "Kontant"
|
||||||
|
2. Indtast modtaget beløb
|
||||||
|
3. Byttepenge vises automatisk
|
||||||
|
4. Bon printes
|
||||||
|
5. Pengeskuffen åbner
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 4. MobilePay
|
||||||
|
|
||||||
|
1. Tryk "MobilePay"
|
||||||
|
2. Kunden betaler
|
||||||
|
3. Bekræft betaling
|
||||||
|
4. Bon printes
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 5. Betaling med KlubKort
|
||||||
|
|
||||||
|
1. Tryk "Betal"
|
||||||
|
2. Scan KlubKort
|
||||||
|
3. Saldo vises
|
||||||
|
4. Beløb trækkes
|
||||||
|
5. Bon printes
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 6. Slet vare
|
||||||
|
|
||||||
|
Tryk på "X" ud for varen i kurven.
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 7. Hvis printer ikke virker
|
||||||
|
|
||||||
|
- Tjek papir
|
||||||
|
- Tjek at printer er tændt
|
||||||
|
- Kontakt teknisk ansvarlig
|
||||||
|
|
||||||
|
------------------------------------------------------------------------
|
||||||
|
|
||||||
|
# 8. Lukning
|
||||||
|
|
||||||
|
- Luk systemet normalt
|
||||||
|
- Sluk maskinen
|
||||||
|
|
||||||
|
Backup sker automatisk.
|
||||||
Reference in New Issue
Block a user