Files
smoa/docs/user/SMOA-User-Manual.md
2025-12-26 10:48:33 -08:00

395 lines
9.0 KiB
Markdown

# SMOA User Manual
**Version:** 1.0
**Last Updated:** 2024-12-20
**Status:** Draft - In Progress
---
## Introduction
Welcome to the Secure Mobile Operations Application (SMOA) User Manual. This manual provides comprehensive guidance for using SMOA on your foldable Android device.
### About SMOA
SMOA is a hardened Android-based application designed for secure mobile operations. SMOA enables:
- Digital credential presentation
- Secure communications
- Orders management
- Evidence tracking
- Regulatory reporting
### System Requirements
- **Device:** Approved foldable Android device
- **Operating System:** Android 7.0 (API 24) or later
- **Hardware:** Biometric sensors (fingerprint, facial recognition)
- **Network:** Internet connectivity (with offline support)
### Getting Started
1. **Installation:** SMOA is pre-installed on approved devices
2. **Initial Setup:** Follow on-screen setup instructions
3. **First Login:** Use your assigned credentials
4. **Biometric Setup:** Enroll fingerprint and facial recognition
---
## Authentication
### Login Process
SMOA requires three-factor authentication:
1. **PIN Entry:** Enter your numeric PIN (6-12 digits)
2. **Fingerprint:** Place finger on fingerprint sensor
3. **Facial Recognition:** Look at front-facing camera
All three factors must be successfully verified to access SMOA.
### Session Management
- **Session Timeout:** Sessions automatically lock after inactivity
- **Re-authentication:** Required after:
- Period of inactivity
- Device fold state change
- Security events
- Sensitive operations
### PIN Management
- **Change PIN:** Settings → Security → Change PIN
- **PIN Requirements:** 6-12 numeric digits
- **PIN Lockout:** Account locks after 5 failed attempts
---
## Module Overview
### Issued Credentials
Display and manage your digital credentials:
- Government IDs
- Badges
- Licenses
- Permits
- Other authorized credentials
**Access:** Main screen → Credentials
### Internal Directory
Access internal routing and contact information:
- Phone numbers
- Extensions
- Secure routing identifiers
- Unit-scoped directory views
**Access:** Main screen → Directory
### Unit Communications
Secure voice communications:
- Multi-channel push-to-talk
- Radio-style communications
- Priority channels
- Encrypted voice transport
**Access:** Main screen → Communications
### Secure Meetings
Encrypted coordination for meetings:
- Audio and video conferencing
- Role-restricted access
- Identity-verified participants
- Screen sharing (policy-controlled)
**Access:** Main screen → Meetings
### Controlled Browser
Secure access to mission web resources:
- Allow-listed sites only
- Mandatory VPN connection
- Certificate trust hardening
- Restricted navigation
**Access:** Main screen → Browser
### Orders Management
View and manage digital orders:
- Authorization orders
- Assignment orders
- Search warrants
- Arrest warrants
- Court orders
- Administrative orders
**Access:** Main screen → Orders
### Evidence Chain of Custody
Track evidence chain of custody:
- Evidence registration
- Custody transfers
- Chain validation
- Evidence reports
**Access:** Main screen → Evidence
### Report Generation
Generate reports in multiple formats:
- PDF reports
- XML reports
- JSON reports
- CSV reports
**Access:** Main screen → Reports
---
## Module Guides
### Credentials Module
#### Viewing Credentials
1. Open SMOA
2. Navigate to Credentials
3. Select credential to view
4. Credential displays with PDF417 barcode
#### Credential Features
- **Barcode Display:** PDF417 barcode for scanning
- **Offline Access:** Credentials available offline
- **Validation Status:** Shows last validation timestamp
- **Anti-Spoofing:** Dynamic overlays and time markers
### Orders Module
#### Viewing Orders
1. Navigate to Orders
2. View order list (filtered by status/type)
3. Select order to view details
4. View order content and metadata
#### Order Features
- **Status Tracking:** View order status (draft, approved, issued, etc.)
- **Expiration Alerts:** Notifications for expiring orders
- **Copy Generation:** Generate authenticated copies
- **Search:** Search orders by keyword, type, status
### Evidence Module
#### Registering Evidence
1. Navigate to Evidence
2. Select "Register New Evidence"
3. Enter evidence details:
- Case number
- Description
- Type
- Collection location
- Collection method
4. Submit evidence registration
#### Transferring Custody
1. Select evidence item
2. Select "Transfer Custody"
3. Enter receiving party information
4. Enter transfer reason
5. Sign transfer (biometric authentication)
6. Submit transfer
#### Viewing Chain of Custody
1. Select evidence item
2. View "Chain of Custody" tab
3. Review custody history
4. Verify chain integrity
### Reports Module
#### Generating Reports
1. Navigate to Reports
2. Select "Generate Report"
3. Choose report template
4. Select output format (PDF, XML, JSON, CSV)
5. Configure report parameters
6. Generate report
7. View or export report
#### Report Templates
- Operational reports
- Compliance reports
- Audit reports
- Evidence reports
- Activity reports
- Regulatory reports
---
## Offline Operations
### Offline Mode
SMOA operates in offline mode when network connectivity is unavailable:
- **Available Features:**
- View credentials (cached)
- View orders (cached)
- View evidence (cached)
- Generate reports (limited templates)
- View directory (cached)
- **Limited Features:**
- No real-time synchronization
- No new data submission
- No external API access
- Limited report generation
### Data Synchronization
When connectivity is restored:
- Automatic synchronization
- Conflict resolution
- Sync status indicators
- Error notifications
### Offline Duration Limits
- **Credentials:** Available offline (time-bounded per policy)
- **Orders:** Available offline (time-bounded per policy)
- **Evidence:** Available offline (time-bounded per policy)
- **Directory:** Limited cache available offline
---
## Troubleshooting
### Common Issues
#### Cannot Login
- **Issue:** Authentication fails
- **Solutions:**
- Verify PIN is correct
- Ensure biometric sensors are clean
- Check biometric enrollment status
- Contact administrator if account is locked
#### Credentials Not Displaying
- **Issue:** Credentials not visible
- **Solutions:**
- Check credential status (active/expired/revoked)
- Verify network connectivity
- Refresh credential list
- Contact administrator
#### Orders Not Syncing
- **Issue:** Orders not updating
- **Solutions:**
- Check network connectivity
- Manually trigger sync
- Verify order permissions
- Contact administrator
#### App Crashes
- **Issue:** Application crashes
- **Solutions:**
- Restart application
- Clear app cache (Settings → Apps → SMOA → Clear Cache)
- Restart device
- Contact support if issue persists
### Error Messages
#### "Session Expired"
- **Meaning:** Session has timed out
- **Solution:** Re-authenticate
#### "Network Unavailable"
- **Meaning:** No network connectivity
- **Solution:** Check network connection, use offline mode
#### "Access Denied"
- **Meaning:** Insufficient permissions
- **Solution:** Contact administrator for access
#### "Data Sync Failed"
- **Meaning:** Synchronization error
- **Solution:** Retry sync, check network, contact support
---
## Security Best Practices
### Device Security
- Keep device locked when not in use
- Use strong PIN
- Enable all security features
- Report lost/stolen devices immediately
### Application Security
- Never share your PIN
- Log out when finished
- Report suspicious activity
- Keep application updated
### Data Security
- Do not screenshot sensitive information
- Do not share credentials
- Follow data handling procedures
- Report security incidents
---
## Support
### Getting Help
- **Documentation:** See this manual
- **Support Portal:** [URL]
- **Email Support:** support@smoa.example.com
- **Phone Support:** [Phone Number]
### Reporting Issues
- **Issue Tracker:** [URL]
- **Email:** issues@smoa.example.com
### Training
- **Training Materials:** See Training section
- **Training Schedule:** Contact training coordinator
---
## Appendices
### Appendix A: Glossary
See [Terminology Glossary](../standards/TERMINOLOGY_GLOSSARY.md)
### Appendix B: Keyboard Shortcuts
- **Lock Device:** Power button
- **Quick Lock:** Double-tap power button
- **Emergency Lock:** Triple-tap power button
### Appendix C: FAQ
**Q: Can I use SMOA on multiple devices?**
A: SMOA is device-bound. Contact administrator for multi-device access.
**Q: How long are credentials cached offline?**
A: Credentials are cached per policy (typically 30 days). Check with administrator.
**Q: Can I export my credentials?**
A: Credential export is restricted. Contact administrator for authorized exports.
**Q: What happens if my device is lost?**
A: Report immediately to administrator. Device can be remotely wiped.
---
**Document Owner:** Technical Writer
**Last Updated:** 2024-12-20
**Status:** Draft - In Progress
**Next Review:** 2024-12-27