diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..0fa31e1 --- /dev/null +++ b/.gitignore @@ -0,0 +1,13 @@ +# OS +.DS_Store +Thumbs.db + +# IDE +.vscode/ +.idea/ + +# Logs +*.log + +# Build/exports +*.zip diff --git a/LICENSE b/LICENSE index e7170d1..6675ebf 100644 --- a/LICENSE +++ b/LICENSE @@ -1,18 +1,3 @@ MIT License -Copyright (c) 2026 thomas - -Permission is hereby granted, free of charge, to any person obtaining a copy of this software and -associated documentation files (the "Software"), to deal in the Software without restriction, including -without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the -following conditions: - -The above copyright notice and this permission notice shall be included in all copies or substantial -portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT -LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO -EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER -IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE -USE OR OTHER DEALINGS IN THE SOFTWARE. +Copyright (c) TuxiNet diff --git a/README.md b/README.md index dc86a78..a76913b 100644 --- a/README.md +++ b/README.md @@ -71,7 +71,6 @@ betegnes Beta da følgende endnu ikke er implementeret: - Lagerstyring ------------------------------------------------------------------------ -![Roadmap](TuxiNet_Roadmap.png) ## License diff --git a/branding/TuxiNet_Branding_Guide.md b/branding/TuxiNet_Branding_Guide.md new file mode 100644 index 0000000..82ed526 --- /dev/null +++ b/branding/TuxiNet_Branding_Guide.md @@ -0,0 +1,33 @@ +# TuxiNet Terminal -- Branding Guide + +Version: v0.6.0 Beta\ +Date: 2026-02-20 + +## Brand Identity + +- **Keywords:** Reliable, Event-grade, Offline-first, Control +- **Tone:** Professional, technical, calm, confident + +## Color Palette (Suggested) + +- Primary: #0F172A (Deep Blue) +- Accent: #00FFFF (Neon Cyan) +- Secondary: #94A3B8 (Soft Grey) +- Highlight: #FF2E88 (Event Pink) + +## Typography (Suggested) + +- Headings: Bold sans-serif +- Body: Clean modern sans-serif + +## Messaging Rules + +- Emphasize offline reliability and stability +- Highlight modular architecture (Print Agent, Backup, SUADMIN) +- Avoid overstating "real-time" where sync is hourly + +## Logo Usage + +- Keep clear space around logo +- Do not stretch +- Prefer dark backgrounds for neon accents diff --git a/branding/TuxiNet_Roadmap.png b/branding/TuxiNet_Roadmap.png new file mode 100644 index 0000000..5738a88 Binary files /dev/null and b/branding/TuxiNet_Roadmap.png differ diff --git a/business/Business_Model.md b/business/Business_Model.md new file mode 100644 index 0000000..adefa8a --- /dev/null +++ b/business/Business_Model.md @@ -0,0 +1,36 @@ +# Business Model -- TuxiNet Terminal + +Version: v0.6.0 Beta\ +Date: 2026-02-20 + +## Primary Revenue Options + +1. **Event Rental** + - Fixed fee per event (incl. hardware + setup) + - Optional on-site support add-on +2. **Subscription** + - Monthly fee (updates + support) + - Optional modules as tiers (Stats, KlubKort, Enterprise) +3. **Licensing** + - Per-terminal licensing + - Annual maintenance and support contract + +## Target Segments + +- LAN organizers +- Schools / youth events +- Associations and clubs +- Pop-up sales / small venues + +## Value Proposition + +- Works offline (reliable revenue capture) +- Touch-first UX (fast checkout) +- KlubKort RFID payment (reduced cash handling) +- Proven at events (operational readiness) + +## Upsell & Expansion + +- Enterprise multi-terminal sync +- Inventory management module +- Central admin + monitoring diff --git a/business/PITCH.md b/business/PITCH.md new file mode 100644 index 0000000..0b2cd35 --- /dev/null +++ b/business/PITCH.md @@ -0,0 +1,34 @@ +# TuxiNet Terminal + +## Event-Ready POS Platform + +TuxiNet Terminal is a purpose-built Point Of Sale system designed for +events, LAN parties and association-based environments. + +------------------------------------------------------------------------ + +## Why Choose TuxiNet Terminal? + +- Works fully offline +- Fast touch-based interface +- RFID payment support (KlubKort) +- Reliable receipt printing +- Automatic hourly backups +- Web-based revenue overview + +------------------------------------------------------------------------ + +## Ideal For + +- LAN events +- Schools +- Clubs & associations +- Pop-up sales environments + +------------------------------------------------------------------------ + +## Status + +Currently running as v0.6.0 Beta and actively used at events. + +For inquiries: TuxiNet.dk diff --git a/business/TuxiNet_Enterprise_Roadmap.md b/business/TuxiNet_Enterprise_Roadmap.md new file mode 100644 index 0000000..93e2be9 --- /dev/null +++ b/business/TuxiNet_Enterprise_Roadmap.md @@ -0,0 +1,28 @@ +# TuxiNet Terminal -- Enterprise Edition Roadmap + +Date: 2026-02-20 + +## Phase 1 -- v1.0 Foundation + +- Real-time dashboard +- Inventory management +- Multi-terminal synchronization +- Enhanced reporting and exports + +## Phase 2 -- Enterprise Infrastructure + +- Central administration server +- Role-based access control (RBAC) +- API integration layer +- Health checks + monitoring + +## Phase 3 -- Hybrid / Optional Cloud + +- Optional cloud analytics +- Remote monitoring +- Automated update pipeline + +## Long-term Vision + +Enterprise Edition supports large multi-day events with synchronized +terminals and centralized control. diff --git a/business/TuxiNet_Risk_Analysis.md b/business/TuxiNet_Risk_Analysis.md new file mode 100644 index 0000000..a823091 --- /dev/null +++ b/business/TuxiNet_Risk_Analysis.md @@ -0,0 +1,23 @@ +# Risk Analysis & Mitigation Plan + +Date: 2026-02-20 + +## Technical Risks + +- Hardware failure → Mitigation: Redundant equipment +- Data corruption → Mitigation: Hourly backups + +## Market Risks + +- Low adoption → Mitigation: Focused niche strategy +- Competition → Mitigation: Offline differentiation + +## Financial Risks + +- Cash flow constraints → Mitigation: Event rental model +- Scaling costs → Mitigation: Phased enterprise rollout + +## Operational Risks + +- Event downtime → Mitigation: Pre-event checklist +- Human error → Mitigation: Simplified touch UI diff --git a/business/TuxiNet_Valuation_Estimate.md b/business/TuxiNet_Valuation_Estimate.md new file mode 100644 index 0000000..390db8a --- /dev/null +++ b/business/TuxiNet_Valuation_Estimate.md @@ -0,0 +1,25 @@ +# Valuation Estimate -- TuxiNet Terminal + +Date: 2026-02-20 + +## Methodology + +Early-stage SaaS/Event-Tech valuation based on: + +- Revenue multiple (3x--6x projected annual revenue) +- Risk-adjusted startup multiplier +- Market opportunity + +## Example Scenario + +Projected Year 3 Revenue: 2,000,000 DKK\ +Conservative Multiple: 3x\ +Estimated Valuation: 6,000,000 DKK + +Aggressive Multiple: 6x\ +Estimated Valuation: 12,000,000 DKK + +## Notes + +Valuation depends heavily on: - Traction - Growth rate - Market +expansion - Strategic partnerships diff --git a/business/V1_0_PLANNING.md b/business/V1_0_PLANNING.md new file mode 100644 index 0000000..9e05b96 --- /dev/null +++ b/business/V1_0_PLANNING.md @@ -0,0 +1,50 @@ +# TuxiNet Terminal -- v1.0 Planning Document + +Date: 2026-02-20 + +## Objective + +Transition from Beta (v0.6.0 Beta) to stable v1.0 production release. + +------------------------------------------------------------------------ + +## Required Features for v1.0 + +- Real-time statistics dashboard +- Multi-terminal synchronization +- Inventory management +- Enhanced reporting system +- Improved UI consistency +- Central administration support + +------------------------------------------------------------------------ + +## Architecture Improvements + +- Event-based sync engine +- Structured API layer +- Modular inventory service + +------------------------------------------------------------------------ + +## Stability Goals + +- Stress-tested under high load +- Improved logging granularity +- Automated health checks + +------------------------------------------------------------------------ + +## Release Criteria + +- All core modules stable +- Backup verified +- Print agent validated +- Event deployment checklist completed + +------------------------------------------------------------------------ + +## Target Status + +TuxiNet Terminal v1.0 will represent a fully production-certified event +POS platform with enterprise-grade stability. diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md new file mode 100644 index 0000000..640021f --- /dev/null +++ b/docs/CHANGELOG.md @@ -0,0 +1,35 @@ +# Changelog + +## v0.6.0 Beta + +- Webbaseret statistikpanel +- UI forbedringer +- Stabilisering +- Forbedret betalingsflow + +## v0.5.x + +- SUADMIN driftspanel +- Backup automation +- Transaktionsvisning + +## v0.4.x + +- KlubKort (RFID betalingskort) + +## v0.3.x + +- Startup script +- Print agent separation + +## v0.2.x + +- ESC/POS integration + +## v0.1.x + +- Basal salgsfunktion + +## v0.0.1 + +- Proof of concept diff --git a/docs/GDPR_Data_Compliance.md b/docs/GDPR_Data_Compliance.md new file mode 100644 index 0000000..6d32186 --- /dev/null +++ b/docs/GDPR_Data_Compliance.md @@ -0,0 +1,37 @@ +# GDPR & Data Compliance + +Version: v0.6.0 Beta\ +Date: 2026-02-20 + +## Data Types (Typical) + +- Transaction data (items, totals, payment method) +- KlubKort account identifiers (card/searchkey) and balance +- Operational logs (system / print agent) + +## Processing Purpose + +- Completing sales and producing receipts +- Maintaining customer account balance (KlubKort) +- Basic operational auditing and troubleshooting + +## Storage & Retention + +- Primary storage is local on the terminal +- Hourly backups are created for recovery and reporting +- Retention should be defined per event (recommended: minimum needed + for accounting + troubleshooting) + +## Security Controls + +- Offline-first design (no public POS exposure required) +- Restricted access to SUADMIN and system accounts +- Physical access control to the terminal is required +- Secure tunnel recommended for backup transfer + +## Recommendations for Operators + +- Restrict access to the terminal and admin panels +- Keep Windows user accounts protected +- Verify backups before/after events +- Document retention period and deletion procedure diff --git a/docs/RELEASE_STRUCTURE.md b/docs/RELEASE_STRUCTURE.md new file mode 100644 index 0000000..00857cf --- /dev/null +++ b/docs/RELEASE_STRUCTURE.md @@ -0,0 +1,20 @@ +# Release Package Structure + +Version: v0.6.0 Beta + +------------------------------------------------------------------------ + +## Recommended ZIP Layout + +/TuxiNet-Terminal/ │ ├── lanpos/ ├── scripts/ ├── assets/ ├── database/ +├── backup/ ├── README.md ├── ROADMAP.md ├── CHANGELOG.md ├── +SECURITY.md ├── RELEASE_NOTES_v0.6.0.md └── Wiki/ + +------------------------------------------------------------------------ + +## Deployment Notes + +- Extract to target machine +- Verify XAMPP installation +- Confirm printer driver installed +- Run startup script diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md new file mode 100644 index 0000000..02de67b --- /dev/null +++ b/docs/ROADMAP.md @@ -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. diff --git a/docs/SECURITY.md b/docs/SECURITY.md new file mode 100644 index 0000000..c983c9c --- /dev/null +++ b/docs/SECURITY.md @@ -0,0 +1,43 @@ +# Security & Data Handling + +Version: v0.6.0 Beta + +------------------------------------------------------------------------ + +## Design Principles + +- Offline-first architecture +- No external API dependency required +- Local database storage +- Segmented Print Agent process + +------------------------------------------------------------------------ + +## Data Storage + +- Transaction data stored locally +- Backup performed hourly +- No public exposure of POS interface + +------------------------------------------------------------------------ + +## Network + +- Optional secure tunnel for backup transfer +- No inbound public access required + +------------------------------------------------------------------------ + +## Access Control + +- SUADMIN restricted access +- No public login system +- KlubKort used for payments only + +------------------------------------------------------------------------ + +## Recommendations + +- Restrict physical access to terminal +- Secure Windows account +- Regularly verify backups diff --git a/docs/funktioner.md b/docs/funktioner.md new file mode 100644 index 0000000..7a04c90 --- /dev/null +++ b/docs/funktioner.md @@ -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 diff --git a/docs/manual.md b/docs/manual.md new file mode 100644 index 0000000..8694a06 --- /dev/null +++ b/docs/manual.md @@ -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. diff --git a/finance/TuxiNet_3Year_Financial_Model.xlsx b/finance/TuxiNet_3Year_Financial_Model.xlsx new file mode 100644 index 0000000..b119d3d Binary files /dev/null and b/finance/TuxiNet_3Year_Financial_Model.xlsx differ diff --git a/finance/TuxiNet_Financial_Projection.xlsx b/finance/TuxiNet_Financial_Projection.xlsx new file mode 100644 index 0000000..ea2ba1e Binary files /dev/null and b/finance/TuxiNet_Financial_Projection.xlsx differ diff --git a/finance/TuxiNet_TAM_SAM_SOM.xlsx b/finance/TuxiNet_TAM_SAM_SOM.xlsx new file mode 100644 index 0000000..81a4755 Binary files /dev/null and b/finance/TuxiNet_TAM_SAM_SOM.xlsx differ diff --git a/pitch/TuxiNet_Investor_Pitch_Deck.pptx b/pitch/TuxiNet_Investor_Pitch_Deck.pptx new file mode 100644 index 0000000..e4dcd78 Binary files /dev/null and b/pitch/TuxiNet_Investor_Pitch_Deck.pptx differ diff --git a/pitch/TuxiNet_Pitch_Deck_v2.pptx b/pitch/TuxiNet_Pitch_Deck_v2.pptx new file mode 100644 index 0000000..766140b Binary files /dev/null and b/pitch/TuxiNet_Pitch_Deck_v2.pptx differ diff --git a/pitch/TuxiNet_Sponsor_Pitch_Deck.pptx b/pitch/TuxiNet_Sponsor_Pitch_Deck.pptx new file mode 100644 index 0000000..dcb4fb0 Binary files /dev/null and b/pitch/TuxiNet_Sponsor_Pitch_Deck.pptx differ diff --git a/releases/GIT_RELEASE_v0.6.0.md b/releases/GIT_RELEASE_v0.6.0.md new file mode 100644 index 0000000..07b6dfb --- /dev/null +++ b/releases/GIT_RELEASE_v0.6.0.md @@ -0,0 +1,46 @@ +# 🚀 TuxiNet Terminal v0.6.0 Beta + +Release Date: 2026-02-20 + +## Summary + +This release marks a stable and event-tested milestone of TuxiNet +Terminal. The system is now production-proven at live events and +includes: + +### ✨ Highlights + +- Web-based statistics panel +- Semi-live hourly sync +- KlubKort (RFID payment support) +- Stable ESC/POS printing +- Automatic hourly backup +- SUADMIN Drift Manager + +------------------------------------------------------------------------ + +## 🔧 Improvements + +- Improved payment flow +- Enhanced print stability +- Backup reliability improvements +- UI optimizations + +------------------------------------------------------------------------ + +## âš  Known Limitations + +- No real-time dashboard +- No multi-terminal sync +- No inventory management + +------------------------------------------------------------------------ + +## Status + +Production-tested at live events. Marked as Beta pending advanced +feature completion. + +------------------------------------------------------------------------ + +Maintained by TuxiNet.dk diff --git a/releases/RELEASE_NOTES_v0.6.0.md b/releases/RELEASE_NOTES_v0.6.0.md new file mode 100644 index 0000000..2dec9ca --- /dev/null +++ b/releases/RELEASE_NOTES_v0.6.0.md @@ -0,0 +1,47 @@ +# TuxiNet Terminal -- Release Notes + +## v0.6.0 Beta + +Release Date: 2026-02-20 + +------------------------------------------------------------------------ + +## Overview + +v0.6.0 Beta represents a stable and event-ready milestone in the +development of TuxiNet Terminal. + +This version introduces the web-based statistics panel and includes +significant stability and usability improvements. + +------------------------------------------------------------------------ + +## New Features + +- Web-based statistics panel +- Semi-live hourly synchronization +- Improved payment flow +- Enhanced UI stability + +------------------------------------------------------------------------ + +## Improvements + +- Optimized print handling +- Improved backup stability +- Refined KlubKort processing + +------------------------------------------------------------------------ + +## Known Limitations + +- No real-time sync +- No multi-terminal support +- No inventory management + +------------------------------------------------------------------------ + +## Status + +System is production-tested at live events. Marked as Beta due to +pending advanced features. diff --git a/releases/TuxiNet_Terminal_Branded_Whitepaper.pdf b/releases/TuxiNet_Terminal_Branded_Whitepaper.pdf new file mode 100644 index 0000000..f3f31a2 --- /dev/null +++ b/releases/TuxiNet_Terminal_Branded_Whitepaper.pdf @@ -0,0 +1,80 @@ +%PDF-1.4 +%“Œ‹ž ReportLab Generated PDF document http://www.reportlab.com +1 0 obj +<< +/F1 2 0 R /F2 3 0 R /F3 4 0 R +>> +endobj +2 0 obj +<< +/BaseFont /Helvetica /Encoding /WinAnsiEncoding /Name /F1 /Subtype /Type1 /Type /Font +>> +endobj +3 0 obj +<< +/BaseFont /Helvetica-Bold /Encoding /WinAnsiEncoding /Name /F2 /Subtype /Type1 /Type /Font +>> +endobj +4 0 obj +<< +/BaseFont /Helvetica-BoldOblique /Encoding /WinAnsiEncoding /Name /F3 /Subtype /Type1 /Type /Font +>> +endobj +5 0 obj +<< +/Contents 9 0 R /MediaBox [ 0 0 595.2756 841.8898 ] /Parent 8 0 R /Resources << +/Font 1 0 R /ProcSet [ /PDF /Text /ImageB /ImageC /ImageI ] +>> /Rotate 0 /Trans << + +>> + /Type /Page +>> +endobj +6 0 obj +<< +/PageMode /UseNone /Pages 8 0 R /Type /Catalog +>> +endobj +7 0 obj +<< +/Author (\(anonymous\)) /CreationDate (D:20260220182739+00'00') /Creator (\(unspecified\)) /Keywords () /ModDate (D:20260220182739+00'00') /Producer (ReportLab PDF Library - www.reportlab.com) + /Subject (\(unspecified\)) /Title (\(anonymous\)) /Trapped /False +>> +endobj +8 0 obj +<< +/Count 1 /Kids [ 5 0 R ] /Type /Pages +>> +endobj +9 0 obj +<< +/Filter [ /ASCII85Decode /FlateDecode ] /Length 570 +>> +stream +Gat$u?#Q2d'Re<2\<$%,;!d]IfW;,QF`"^EW\8X;_M*:l+#AY2J%l@Z9LCDVA-lZdmQ&=CCGW2/Yl8ph!7h`ehCr=WU'-in3=pUm0@AeBJfVVu"7R=C"[Nu%"T`cWk]B+uCo!iCN2S_?TVLMZ,I(]K+P2W44S$$l\h/b0`gG^5PY92VF<*TnJ#[cLXMXO2ha:S-lThE.<0p'A@pM%?1YA%oXS9nU$>phNotnPe-*n(Bl$&G[YEPg"-886m+K#'0m-Rk9jsR&&(H`)t,$g5IM`3KJ%p=T%Q*>b@)(s+U'Tcj9A7>Uumf`EhY+Kh4O66.E,K^(5FfhVT(%^sgQqos"(e,mAIWG-U]JCN9,HQc&^oquWm)'doD.HJiHV#m&6jR-f%s0iW=X%rauN`TFAF3TK[qhendstream +endobj +xref +0 10 +0000000000 65535 f +0000000073 00000 n +0000000124 00000 n +0000000231 00000 n +0000000343 00000 n +0000000462 00000 n +0000000665 00000 n +0000000733 00000 n +0000001016 00000 n +0000001075 00000 n +trailer +<< +/ID +[<818fd8c87b724a699fb8b2c8a2cad09b><818fd8c87b724a699fb8b2c8a2cad09b>] +% ReportLab generated PDF document -- digest (http://www.reportlab.com) + +/Info 7 0 R +/Root 6 0 R +/Size 10 +>> +startxref +1735 +%%EOF diff --git a/releases/TuxiNet_Terminal_Event_Agreement.pdf b/releases/TuxiNet_Terminal_Event_Agreement.pdf new file mode 100644 index 0000000..e72c88d --- /dev/null +++ b/releases/TuxiNet_Terminal_Event_Agreement.pdf @@ -0,0 +1,74 @@ +%PDF-1.4 +%“Œ‹ž ReportLab Generated PDF document http://www.reportlab.com +1 0 obj +<< +/F1 2 0 R /F2 3 0 R +>> +endobj +2 0 obj +<< +/BaseFont /Helvetica /Encoding /WinAnsiEncoding /Name /F1 /Subtype /Type1 /Type /Font +>> +endobj +3 0 obj +<< +/BaseFont /Helvetica-Bold /Encoding /WinAnsiEncoding /Name /F2 /Subtype /Type1 /Type /Font +>> +endobj +4 0 obj +<< +/Contents 8 0 R /MediaBox [ 0 0 595.2756 841.8898 ] /Parent 7 0 R /Resources << +/Font 1 0 R /ProcSet [ /PDF /Text /ImageB /ImageC /ImageI ] +>> /Rotate 0 /Trans << + +>> + /Type /Page +>> +endobj +5 0 obj +<< +/PageMode /UseNone /Pages 7 0 R /Type /Catalog +>> +endobj +6 0 obj +<< +/Author (\(anonymous\)) /CreationDate (D:20260220155639+00'00') /Creator (\(unspecified\)) /Keywords () /ModDate (D:20260220155639+00'00') /Producer (ReportLab PDF Library - www.reportlab.com) + /Subject (\(unspecified\)) /Title (\(anonymous\)) /Trapped /False +>> +endobj +7 0 obj +<< +/Count 1 /Kids [ 4 0 R ] /Type /Pages +>> +endobj +8 0 obj +<< +/Filter [ /ASCII85Decode /FlateDecode ] /Length 645 +>> +stream +GasJO_/>`-&;KY&MZ;o45[!A3:2dD+St[WMkq,f?L;@[.]4?,jbM.4VLlG]N23K8uI/eRMK*>_u7/rh.^cKHTY6#n6>!OX5"k!Y2VmEk#(n\HDiFX7-e`q=s"+%#L9I%:VK=Y^>S*F4TuE:e=R,]7rXdAunF`^0"J+/.CN/X:s9Q[iduV)14-P)pQP/$FnT.#c-b=DRV&D]s65du]idms=LIl`Y3h]/Wt`1"PFIo+e'6'GT8^%TndL#UrhsSb#gUDB5eAWl'S26BkuX,eRit&k[MVL!8bJ1/EXX%4aKF6\I?],\30[bic);ntW_B'DPLZVm:@n@qh?BjEL[%T0Y'8Op'kmj;j;YM'O\X&"qKGn>f$`^?Y=56O#:%7HSNs1:\koAsdu@795],1VQr)j:+C5NAWe#9er"HehVSh)q[&FXZ&*bYRF;^lt\YD>WK?o:0P.f=b*>P.ZWIC4>#I,'H":ujf`=/)d_\\gsp&M>lG^Y%D[T6>.b+]Ja_Yendstream +endobj +xref +0 9 +0000000000 65535 f +0000000073 00000 n +0000000114 00000 n +0000000221 00000 n +0000000333 00000 n +0000000536 00000 n +0000000604 00000 n +0000000887 00000 n +0000000946 00000 n +trailer +<< +/ID +[] +% ReportLab generated PDF document -- digest (http://www.reportlab.com) + +/Info 6 0 R +/Root 5 0 R +/Size 9 +>> +startxref +1681 +%%EOF diff --git a/releases/TuxiNet_Terminal_Whitepaper_v0.6.0.pdf b/releases/TuxiNet_Terminal_Whitepaper_v0.6.0.pdf new file mode 100644 index 0000000..34372ab --- /dev/null +++ b/releases/TuxiNet_Terminal_Whitepaper_v0.6.0.pdf @@ -0,0 +1,99 @@ +%PDF-1.4 +%“Œ‹ž ReportLab Generated PDF document http://www.reportlab.com +1 0 obj +<< +/F1 2 0 R /F2 3 0 R /F3 4 0 R +>> +endobj +2 0 obj +<< +/BaseFont /Helvetica /Encoding /WinAnsiEncoding /Name /F1 /Subtype /Type1 /Type /Font +>> +endobj +3 0 obj +<< +/BaseFont /Helvetica-Bold /Encoding /WinAnsiEncoding /Name /F2 /Subtype /Type1 /Type /Font +>> +endobj +4 0 obj +<< +/BaseFont /Symbol /Name /F3 /Subtype /Type1 /Type /Font +>> +endobj +5 0 obj +<< +/Contents 10 0 R /MediaBox [ 0 0 595.2756 841.8898 ] /Parent 9 0 R /Resources << +/Font 1 0 R /ProcSet [ /PDF /Text /ImageB /ImageC /ImageI ] +>> /Rotate 0 /Trans << + +>> + /Type /Page +>> +endobj +6 0 obj +<< +/Contents 11 0 R /MediaBox [ 0 0 595.2756 841.8898 ] /Parent 9 0 R /Resources << +/Font 1 0 R /ProcSet [ /PDF /Text /ImageB /ImageC /ImageI ] +>> /Rotate 0 /Trans << + +>> + /Type /Page +>> +endobj +7 0 obj +<< +/PageMode /UseNone /Pages 9 0 R /Type /Catalog +>> +endobj +8 0 obj +<< +/Author (\(anonymous\)) /CreationDate (D:20260220155753+00'00') /Creator (\(unspecified\)) /Keywords () /ModDate (D:20260220155753+00'00') /Producer (ReportLab PDF Library - www.reportlab.com) + /Subject (\(unspecified\)) /Title (\(anonymous\)) /Trapped /False +>> +endobj +9 0 obj +<< +/Count 2 /Kids [ 5 0 R 6 0 R ] /Type /Pages +>> +endobj +10 0 obj +<< +/Filter [ /ASCII85Decode /FlateDecode ] /Length 1206 +>> +stream +Gat=*9lo;R&A@7.oJ*rm*)$:l84$4Das=k7Cs=$`,&A.(O_mRRRoHeG7cnWR;'M*%,;/-/<0'ZO.bV^r]b!j/-+0bMN(4Vb]J)f^%(/.Nu=\_Y!r,*DWi7kTV(;T[Pd!W_h>epqC6eJtFkdYTL2=&-mqQpook71sp4"SIRCU*6I+:d2?ntaiGb@+`?3E&X*#WHqDFq=Ze&e9F7IOg<)P(9K]'u7;kd%d[9lADJnq`9LlA3)5@%OnU"WkbP-&'?GeU>V]S'Po4od*3j&WSc#9cpEZ9b6hS/SkmnNUQ:!p0n[eH?U^a!dUaUAW^HIE+:QOJ.:HmD'$ZA(:)0%kUB"%'L;_44rn4TLu/:@/<.A\EIBQ%j5O%o\k#h3?3S9(VuU^!d>T+4'tT9V3At@B)_miJA:c`RXJdJ!IF)NU<-[dh;C:?]IfUUbLCoMb8o'65Tmp>o[/^G3Pgc&*mbQOaIDrW7;7Jbn)a_J9K'K*KLHeWEgB2/irj3(W#)I>^kMnmO/aKdX+Q/i40!iMG7o/Hnp%&g5cYZ,2K^mT/BdTT;I`*H\Z##Ad?D6&6?`Fendstream +endobj +11 0 obj +<< +/Filter [ /ASCII85Decode /FlateDecode ] /Length 85 +>> +stream +GapQh0E=F,0U\H3T\pNYT^QKk?tc>IP,;W#U1^23ihPEM_H"Zg#ZYSVTjVbIUh=4HB`Z`"(!*5e"T[<4%>O~>endstream +endobj +xref +0 12 +0000000000 65535 f +0000000073 00000 n +0000000124 00000 n +0000000231 00000 n +0000000343 00000 n +0000000420 00000 n +0000000624 00000 n +0000000828 00000 n +0000000896 00000 n +0000001179 00000 n +0000001244 00000 n +0000002542 00000 n +trailer +<< +/ID +[<3f69c5d8bee9f59be746c2ecad21bcaf><3f69c5d8bee9f59be746c2ecad21bcaf>] +% ReportLab generated PDF document -- digest (http://www.reportlab.com) + +/Info 8 0 R +/Root 7 0 R +/Size 12 +>> +startxref +2717 +%%EOF diff --git a/src/assets/.gitkeep b/src/assets/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/backup/.gitkeep b/src/backup/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/database/.gitkeep b/src/database/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/lanpos/.gitkeep b/src/lanpos/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/scripts/.gitkeep b/src/scripts/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/wiki/INDEX.md b/wiki/INDEX.md new file mode 100644 index 0000000..dbb8252 --- /dev/null +++ b/wiki/INDEX.md @@ -0,0 +1,14 @@ +# Wiki Index – TuxiNet Terminal (v0.6.0 Beta) + +- Home: WIKI_Home.md +- Frontpage: WIKI_Frontpage_Styled.md +- Installation: WIKI_Installation.md +- Hardware & Arkitektur: WIKI_Hardware_Arkitektur.md +- KlubKort: WIKI_KlubKort.md +- Print Agent: WIKI_PrintAgent.md +- SUADMIN: WIKI_SUADMIN.md +- Backup: WIKI_Backup.md +- Statistikpanel: WIKI_Statistikpanel.md +- Event Deployment: WIKI_Event_Deployment.md +- Service Manual: WIKI_Service_Manual.md +- Fejlsøgning: WIKI_Fejlsoegning.md diff --git a/wiki/WIKI_Backup.md b/wiki/WIKI_Backup.md new file mode 100644 index 0000000..9d30bfd --- /dev/null +++ b/wiki/WIKI_Backup.md @@ -0,0 +1,13 @@ +# Backup System + +Version: v0.6.0 Beta + +## Funktion + +- Automatisk backup hver time +- Overførsel via sikker tunnel +- Versionssikring + +## Script + +lanpos_backup.ps1 diff --git a/wiki/WIKI_Event_Deployment.md b/wiki/WIKI_Event_Deployment.md new file mode 100644 index 0000000..7392e2b --- /dev/null +++ b/wiki/WIKI_Event_Deployment.md @@ -0,0 +1,26 @@ +# Event Deployment Guide + +Version: v0.6.0 Beta + +## Før Event + +- Test printer +- Test KlubKort scanning +- Verificér backup kører +- Tjek statistikpanel + +------------------------------------------------------------------------ + +## Under Event + +- Brug kun touch +- Luk ikke browser +- Kontakt tekniker ved fejl + +------------------------------------------------------------------------ + +## Efter Event + +- Kontrollér backup +- Eksportér data hvis nødvendigt +- Sluk system korrekt diff --git a/wiki/WIKI_Fejlsoegning.md b/wiki/WIKI_Fejlsoegning.md new file mode 100644 index 0000000..1a15f79 --- /dev/null +++ b/wiki/WIKI_Fejlsoegning.md @@ -0,0 +1,20 @@ +# Fejlsøgning + +Version: v0.6.0 Beta + +## Printer virker ikke + +- Tjek papir +- Tjek USB-forbindelse +- Genstart Print Agent + +## System starter ikke + +- Tjek XAMPP +- Kør lanpos_startup.ps1 manuelt +- Kontroller logs + +## KlubKort registreres ikke + +- Tjek USB RFID-læser +- Kontroller databaseforbindelse diff --git a/wiki/WIKI_Frontpage_Styled.md b/wiki/WIKI_Frontpage_Styled.md new file mode 100644 index 0000000..b39a293 --- /dev/null +++ b/wiki/WIKI_Frontpage_Styled.md @@ -0,0 +1,34 @@ +# TuxiNet Terminal Wiki + +**Version:** v0.6.0 Beta\ +**Status:** Beta + +------------------------------------------------------------------------ + +## System Features + +✔ Offline First\ +✔ Touch Optimized\ +✔ KlubKort (RFID Betaling)\ +✔ ESC/POS Print\ +✔ Automatisk Backup\ +✔ Web Statistikpanel + +------------------------------------------------------------------------ + +## Navigation + +- Installation +- Hardware & Arkitektur +- KlubKort +- Print Agent +- SUADMIN +- Backup +- Statistikpanel +- Event Deployment +- Service Manual +- Fejlsøgning + +------------------------------------------------------------------------ + +Professionel event-klar POS platform udviklet af TuxiNet. diff --git a/wiki/WIKI_Hardware_Arkitektur.md b/wiki/WIKI_Hardware_Arkitektur.md new file mode 100644 index 0000000..14e1670 --- /dev/null +++ b/wiki/WIKI_Hardware_Arkitektur.md @@ -0,0 +1,28 @@ +# Hardware & Arkitektur + +Version: v0.6.0 Beta + +## Hardware Krav + +- Windows PC (min 4GB RAM, 8GB anbefalet) +- SSD +- USB ESC/POS Kvitteringsprinter +- Pengeskuffe via printer +- USB RFID-læser +- Touchskærm + +------------------------------------------------------------------------ + +## Arkitektur + +Touch → Chromium (Kiosk) → XAMPP → LANPOS Backend → Database\ +→ Print Agent → Printer → Pengeskuffe + +------------------------------------------------------------------------ + +## Designprincipper + +- Offline-first +- Modulopdelt arkitektur +- Separat Print Agent +- Timebaseret backup diff --git a/wiki/WIKI_Home.md b/wiki/WIKI_Home.md new file mode 100644 index 0000000..360a7f9 --- /dev/null +++ b/wiki/WIKI_Home.md @@ -0,0 +1,21 @@ +# TuxiNet Terminal Wiki + +Velkommen til den tekniske dokumentation for TuxiNet Terminal v0.6.0 +Beta. + +------------------------------------------------------------------------ + +## Wiki Indhold + +- Systemoversigt +- Installation & Setup +- Drift & Service +- KlubKort (RFID) +- Print Agent +- Backup System +- Statistikpanel +- Fejlsøgning + +------------------------------------------------------------------------ + +For fuld versionshistorik se ROADMAP.md i repository. diff --git a/wiki/WIKI_Installation.md b/wiki/WIKI_Installation.md new file mode 100644 index 0000000..4cc3ea5 --- /dev/null +++ b/wiki/WIKI_Installation.md @@ -0,0 +1,24 @@ +# Installation & Setup + +## Krav + +- Windows system +- XAMPP installeret +- Chromium +- USB ESC/POS printer +- Touchskærm + +------------------------------------------------------------------------ + +## Første Opstart + +1. Installer afhængigheder +2. Placér projektfiler i korrekt mappe +3. Kør lanpos_startup.ps1 +4. Systemet starter automatisk + +------------------------------------------------------------------------ + +## Service Mode + +Startup script kan deaktiveres for debug. Print agent kan køres manuelt. diff --git a/wiki/WIKI_KlubKort.md b/wiki/WIKI_KlubKort.md new file mode 100644 index 0000000..1f7202f --- /dev/null +++ b/wiki/WIKI_KlubKort.md @@ -0,0 +1,22 @@ +# KlubKort (RFID Betalingskort) + +Version: v0.6.0 Beta + +## FormÃ¥l + +KlubKort anvendes som betalingskort med saldo. Det er ikke et login- +eller adgangssystem. + +## Funktion + +- Scan kort ved betaling +- Konto identificeres +- Saldo vises +- Beløb trækkes +- Transaktion logges + +## Teknisk Struktur + +- card = searchkey +- Offline funktionalitet +- Ingen session diff --git a/wiki/WIKI_PrintAgent.md b/wiki/WIKI_PrintAgent.md new file mode 100644 index 0000000..7e1e428 --- /dev/null +++ b/wiki/WIKI_PrintAgent.md @@ -0,0 +1,14 @@ +# Print Agent + +Version: v0.6.0 Beta + +## Funktion + +- Modtager printjobs +- Sender ESC/POS kommandoer +- Ã…bner pengeskuffe +- Logger fejl + +## Drift + +Kan genstartes via SUADMIN eller restart_agent.ps1 diff --git a/wiki/WIKI_SUADMIN.md b/wiki/WIKI_SUADMIN.md new file mode 100644 index 0000000..23900ce --- /dev/null +++ b/wiki/WIKI_SUADMIN.md @@ -0,0 +1,14 @@ +# SUADMIN Drift Manager + +Version: v0.6.0 Beta + +## FormÃ¥l + +Internt driftspanel til service og fejlhÃ¥ndtering. + +## Funktioner + +- Genstart print agent +- Systemstatus +- Serviceværktøjer +- Overblik over drift diff --git a/wiki/WIKI_Service_Manual.md b/wiki/WIKI_Service_Manual.md new file mode 100644 index 0000000..411953d --- /dev/null +++ b/wiki/WIKI_Service_Manual.md @@ -0,0 +1,24 @@ +# Service Manual (Intern) + +Version: v0.6.0 Beta + +## Debug Mode + +- Deaktivér startup script +- Kør print agent manuelt +- Kontrollér logs + +------------------------------------------------------------------------ + +## Print Problemer + +- Genstart agent +- Test ESC/POS direkte +- Tjek USB device manager + +------------------------------------------------------------------------ + +## Database + +- Kontrollér database fil +- Verificér write permissions diff --git a/wiki/WIKI_Statistikpanel.md b/wiki/WIKI_Statistikpanel.md new file mode 100644 index 0000000..4039997 --- /dev/null +++ b/wiki/WIKI_Statistikpanel.md @@ -0,0 +1,14 @@ +# Webbaseret Statistikpanel + +Version: v0.6.0 Beta + +## Funktioner + +- Total omsætning +- Salg pr. produkt +- Betalingsfordeling +- Datofiltrering + +## Opdatering + +Synkroniseres én gang i timen (semi-live).