241 lines
6.7 KiB
Markdown
241 lines
6.7 KiB
Markdown
# FG Reports - Quick Start Guide
|
|
|
|
## 🚀 Access the Reports Page
|
|
|
|
### Step 1: Login
|
|
1. Go to `http://localhost:8080` (or your app URL)
|
|
2. Login with credentials:
|
|
- **Username**: `admin`
|
|
- **Password**: `admin123`
|
|
|
|
### Step 2: Navigate to Reports
|
|
Option A - Using Navigation Menu:
|
|
1. Click "Quality" in the top navigation bar
|
|
2. Click "Reports" (if visible in submenu)
|
|
|
|
Option B - Direct URL:
|
|
- Go to: `http://localhost:8080/quality/reports`
|
|
|
|
## 📊 Generate Your First Report
|
|
|
|
### Daily Report (Easiest)
|
|
1. Click the **"Today's Report"** card
|
|
2. Click **"Generate Report"** button
|
|
3. View results in the table below
|
|
4. Statistics display at top: Total, Approved, Rejected counts
|
|
|
|
### Select Specific Date Report
|
|
1. Click the **"Select Day"** card
|
|
2. A date picker appears
|
|
3. Select a date from the calendar
|
|
4. Click **"Generate Report"**
|
|
5. View the data
|
|
|
|
### Date Range Report
|
|
1. Click the **"Date Range"** card
|
|
2. Select **Start Date**
|
|
3. Select **End Date**
|
|
4. Click **"Generate Report"**
|
|
5. View all scans within that range
|
|
|
|
## 💾 Export Data
|
|
|
|
After generating a report:
|
|
|
|
### Export to Excel
|
|
1. Click the **"Export Excel"** button (green with file icon)
|
|
2. File downloads as: `fg_report_YYYY-MM-DD.xlsx`
|
|
3. Open in Microsoft Excel or Google Sheets
|
|
|
|
### Export to CSV
|
|
1. Click the **"Export CSV"** button
|
|
2. File downloads as: `fg_report_YYYY-MM-DD.csv`
|
|
3. Open in Excel, Google Sheets, or any text editor
|
|
|
|
## 📈 Available Report Types
|
|
|
|
| Report | Purpose | When to Use |
|
|
|--------|---------|------------|
|
|
| **Today's Report** | All scans from today | Daily production overview |
|
|
| **Select Day** | Choose any date | Look at past production |
|
|
| **Date Range** | Pick start & end dates | Analyze a period |
|
|
| **Last 5 Days** | Automatic 5-day window | Weekly summary |
|
|
| **Defects Today** | Only rejected items today | Quality issues monitoring |
|
|
| **Defects by Date** | Rejected items on specific date | Defect investigation |
|
|
| **Defects Range** | Rejected items in date range | Period defect analysis |
|
|
| **Defects 5 Days** | Last 5 days rejected items | Weekly defect trends |
|
|
| **All Data** | Everything in database | Complete export |
|
|
|
|
## 📊 Reading the Report
|
|
|
|
### Statistics (Top Right)
|
|
- **Total Scans**: Total records in report
|
|
- **Approved**: Scans with quality code '000' (green)
|
|
- **Rejected**: Scans with quality codes 001-999 (red)
|
|
|
|
### Status Badges in Table
|
|
- **Green Badge**: APPROVED (quality_code = '000')
|
|
- **Red Badge**: REJECTED (quality_code = '001' or higher)
|
|
|
|
### Table Columns
|
|
| Column | Meaning |
|
|
|--------|---------|
|
|
| ID | Record number |
|
|
| Operator Code | Who scanned (e.g., OP01) |
|
|
| CP Code | Product code (e.g., CP00000001-0001) |
|
|
| OC1 Code | Operation code 1 |
|
|
| OC2 Code | Operation code 2 |
|
|
| Status | APPROVED or REJECTED |
|
|
| Date | Scan date |
|
|
| Time | Scan time |
|
|
| Created | When record was created |
|
|
|
|
## 🎨 Dark Mode
|
|
|
|
The reports page fully supports dark mode:
|
|
1. Toggle theme using the moon icon (🌙) in top navigation
|
|
2. All colors automatically adjust
|
|
3. Text remains readable in both modes
|
|
|
|
## 🔧 Keyboard Shortcuts
|
|
|
|
- **Tab**: Navigate between fields
|
|
- **Enter**: Generate report / Confirm selection
|
|
- **Esc**: Clear filters (if supported)
|
|
|
|
## ❌ Troubleshooting
|
|
|
|
### Issue: "No data to display"
|
|
- **Cause**: Selected date range has no scans
|
|
- **Solution**:
|
|
- Try "All Data" report to verify data exists
|
|
- Use "Last 5 Days" for demo data
|
|
- Generate test data if needed
|
|
|
|
### Issue: Export button is greyed out
|
|
- **Cause**: No report has been generated yet
|
|
- **Solution**: Select a report type and click "Generate Report" first
|
|
|
|
### Issue: Page is loading forever
|
|
- **Cause**: Database query is taking long time
|
|
- **Solution**:
|
|
- Try a more specific date range
|
|
- Avoid "All Data" if database is very large
|
|
- Wait a few seconds for it to complete
|
|
|
|
### Issue: Date picker won't open
|
|
- **Cause**: Browser compatibility issue
|
|
- **Solution**:
|
|
- Use Chrome, Firefox, or Safari (latest versions)
|
|
- Try a different browser
|
|
- Clear browser cache and reload
|
|
|
|
## 💡 Tips & Tricks
|
|
|
|
1. **Quick Daily Check**: Click "Today's Report" → "Generate" → "Export Excel"
|
|
- Takes ~10 seconds
|
|
- Perfect for daily reports
|
|
|
|
2. **Weekly Summary**: Click "Last 5 Days" → "Generate"
|
|
- Automatic 5-day window
|
|
- No date selection needed
|
|
|
|
3. **Find Defects**: Click "Defects Today" or "Defects Range"
|
|
- Only shows rejected scans
|
|
- Easier to see quality issues
|
|
|
|
4. **Archive All Data**: Click "All Data" → "Export Excel"
|
|
- Complete database backup
|
|
- Useful for compliance/audits
|
|
|
|
5. **Batch Export**: Generate multiple reports, export each separately
|
|
- Naming includes date for organization
|
|
- Can easily import all into one Excel workbook
|
|
|
|
## 📱 Mobile Usage
|
|
|
|
The reports page is fully responsive:
|
|
- Works on phone, tablet, desktop
|
|
- Report cards stack vertically on small screens
|
|
- Table scrolls horizontally if needed
|
|
- All buttons easily clickable on touch devices
|
|
|
|
## 🔒 Permissions
|
|
|
|
You need an active login to access reports:
|
|
- Anonymous users cannot view reports
|
|
- Session expires after inactivity (default: 30 minutes)
|
|
- Re-login required if session expires
|
|
|
|
## 📞 Support
|
|
|
|
If you encounter issues:
|
|
|
|
1. **Check browser console** (F12 → Console tab)
|
|
2. **Check server logs**: `docker logs quality_app_v2`
|
|
3. **Verify login**: Make sure you're logged in as admin
|
|
4. **Clear cache**: Ctrl+Shift+Del (or Cmd+Shift+Del on Mac)
|
|
5. **Restart app**: `docker compose restart app`
|
|
|
|
## 🎯 Common Workflows
|
|
|
|
### Workflow 1: Daily Quality Report
|
|
```
|
|
1. Login
|
|
2. Navigate to Reports
|
|
3. Click "Today's Report"
|
|
4. Click "Generate Report"
|
|
5. Click "Export Excel"
|
|
6. Email the file to supervisor
|
|
```
|
|
**Time**: ~2 minutes
|
|
|
|
### Workflow 2: Investigation Specific Defect
|
|
```
|
|
1. Navigate to Reports
|
|
2. Click "Defects by Date"
|
|
3. Select the date you want to investigate
|
|
4. Click "Generate Report"
|
|
5. Review rejected scans
|
|
6. Click "Export Excel" for documentation
|
|
```
|
|
**Time**: ~5 minutes
|
|
|
|
### Workflow 3: Weekly Trend Analysis
|
|
```
|
|
1. Navigate to Reports
|
|
2. Click "Last 5 Days"
|
|
3. Click "Generate Report"
|
|
4. Check approval rate in statistics
|
|
5. Export Excel to track trends over weeks
|
|
```
|
|
**Time**: ~3 minutes
|
|
|
|
### Workflow 4: Complete Database Backup
|
|
```
|
|
1. Navigate to Reports
|
|
2. Click "All Data"
|
|
3. Click "Generate Report"
|
|
4. Click "Export Excel"
|
|
5. Archive the file
|
|
```
|
|
**Time**: ~1 minute (+ export time for large databases)
|
|
|
|
## 📚 Next Steps
|
|
|
|
- Read the full documentation: `FG_REPORTS_IMPLEMENTATION.md`
|
|
- See the implementation summary: `FG_REPORTS_SUMMARY.md`
|
|
- Check the checklist: `FG_REPORTS_CHECKLIST.md`
|
|
|
|
## ✅ You're Ready!
|
|
|
|
You now have a complete FG Scan Reports system with:
|
|
- ✅ 9 different report types
|
|
- ✅ Real-time filtering
|
|
- ✅ Excel and CSV export
|
|
- ✅ Dark mode support
|
|
- ✅ Mobile responsive design
|
|
- ✅ Production-ready code
|
|
|
|
**Happy reporting!** 📊
|