================================================================================
  Factory Efficiency Management System
  Deployment Package
  工厂工时效率管理系统 - 部署包
================================================================================

QUICK START (快速开始)
======================

Windows:
  1. Double-click: deploy.bat
  2. After deployment: double-click start.bat
  
macOS / Linux:
  1. Open terminal, run: chmod +x deployment/*.sh
  2. Run: ./deployment/deploy.sh
  3. After deployment: ./deployment/start.sh


SYSTEM REQUIREMENTS (系统要求)
===============================

- Windows 10/11, macOS 10.14+, or Linux
- Python 3.8 or higher
- 100MB free disk space
- Modern web browser (Chrome, Edge, Firefox, Safari)


DEPLOYMENT STEPS (详细部署步骤)
================================

Step 1: Copy Files
-------------------
Copy the entire project folder to the target computer.

Step 2: Run Deployment Script
------------------------------
Windows:   Double-click deploy.bat
macOS:     chmod +x deployment/deploy.sh && ./deployment/deploy.sh
Linux:     chmod +x deployment/deploy.sh && ./deployment/deploy.sh

Step 3: Start Server
--------------------
Windows:   Double-click start.bat
macOS:     ./deployment/start.sh
Linux:     ./deployment/start.sh

Step 4: Access System
---------------------
Open browser: http://localhost:5001

Default login:
  Username: admin
  Password: admin123


FILE STRUCTURE (文件结构)
=========================

efficiency/
|- app.py                 # Main application
|- config.py              # Configuration
|- requirements.txt       # Python dependencies
|- database/              # Database models
|- routes/                # Application routes
|- templates/             # HTML templates
|- static/                # CSS, JS, images
|- data/                  # Database file (auto-created)
|- venv/                  # Virtual environment (auto-created)
|- deployment/            # Deployment scripts
   |- deploy.bat          # Windows deployment
   |- deploy.sh           # macOS/Linux deployment
   |- start.bat           # Windows start
   |- start.sh            # macOS/Linux start
   |- stop.bat            # Windows stop
   |- stop.sh             # macOS/Linux stop
   |- README.txt          # This file


DAILY OPERATIONS (日常操作)
============================

Start Server:
  Windows: start.bat
  macOS/Linux: start.sh

Stop Server:
  Windows: stop.bat
  macOS/Linux: stop.sh

Or press Ctrl+C in the server terminal.


TROUBLESHOOTING (故障排除)
==========================

Issue: "Python not found"
Solution: Install Python 3.8+ from python.org

Issue: "Port already in use"
Solution: Change PORT in config.py (default: 5001)

Issue: "Database error"
Solution: Delete data/efficiency.db and restart

Issue: "Permission denied" (macOS/Linux)
Solution: Run: chmod +x deployment/*.sh


PORT CONFIGURATION (端口配置)
==============================

Default port: 5001

To change:
1. Open config.py
2. Modify PORT = 5001
3. Save and restart


BACKUP (备份)
=============

Backup these folders regularly:
- data/           # Database
- static/uploads/ # Uploaded files (if any)


SUPPORT (支持)
==============

For issues or questions, contact your system administrator.
================================================================================
