Upload files to "/"

This commit is contained in:
2026-02-20 15:43:22 +00:00
parent ae7756c296
commit 4f82e8e06f
3 changed files with 392 additions and 0 deletions

145
ROADMAP.md Normal file
View 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
View 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
View 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.