5a8c26cf5d
- Backend: ShallowEtagHeaderFilter for /api/v1/*, API-VERSIONING.md, README (tenant, CORS, Flyway, ETag) - k8s: backend-deployment.yaml (Deployment, Service, Secret/ConfigMap) - Web: scaffold with directory pull, 304 handling, touch-friendly UI - Android 16: ANDROID-16-TARGET.md; BuildConfig STUN/signaling, SMOAApplication configures InfrastructureManager - Domain: CertificateManager revocation stub, ReportService signReports, ZeroTrust/ThreatDetection minimal docs - TODO.md and IMPLEMENTATION_STATUS.md updated; communications README for endpoint config Co-authored-by: Cursor <cursoragent@cursor.com>
213 lines
9.8 KiB
Markdown
213 lines
9.8 KiB
Markdown
# SMOA Documentation Index
|
||
|
||
**Last Updated:** 2024
|
||
**Status:** Active
|
||
|
||
---
|
||
|
||
## Welcome
|
||
|
||
This is the central index for all SMOA (Secure Mobile Operations Application) documentation. Use this index to navigate to the documentation you need.
|
||
|
||
---
|
||
|
||
## Quick Links
|
||
|
||
### Getting Started
|
||
- [Project README](../README.md) - Project overview and quick start
|
||
- [TODO – Remaining and optional tasks](../TODO.md) - Single checklist for remaining and optional work (backend, Android, iOS, Web, infra, compliance, testing)
|
||
- [Specification](reference/SPECIFICATION.md) - Application specification
|
||
- [Documentation Recommendations](DOCUMENTATION_RECOMMENDATIONS.md) - Documentation organization recommendations
|
||
- [Documentation Plan](standards/DOCUMENTATION_PLAN.md) - Comprehensive documentation plan
|
||
- [Documentation Implementation Steps](standards/DOCUMENTATION_IMPLEMENTATION_STEPS.md) - Step-by-step implementation guide
|
||
- [Documentation Checklist](standards/DOCUMENTATION_CHECKLIST.md) - Quick reference checklist
|
||
- [Executive Summary](standards/DOCUMENTATION_EXECUTIVE_SUMMARY.md) - Executive overview
|
||
|
||
### Compliance
|
||
- [Compliance Matrix](reference/COMPLIANCE_MATRIX.md) - Compliance status matrix
|
||
- [Compliance Evaluation](reference/COMPLIANCE_EVALUATION.md) - Detailed compliance assessment
|
||
- [Compliance Evidence](compliance/evidence/) - Compliance evidence documentation
|
||
|
||
### Implementation
|
||
- [Implementation Requirements](reference/IMPLEMENTATION_REQUIREMENTS.md) - Technical requirements
|
||
- [Implementation Status](status/IMPLEMENTATION_STATUS.md) - Current implementation status (consolidated)
|
||
|
||
---
|
||
|
||
## Documentation by Category
|
||
|
||
### Project Status and Progress Reports
|
||
- [Completion Reports](reports/completion/) - All completion and progress reports
|
||
- [Project Review](reports/completion/PROJECT_REVIEW.md) - Comprehensive project review
|
||
- [Project Review Summary](reports/completion/PROJECT_REVIEW_SUMMARY.md) - Executive summary
|
||
- [Final Completion Report](reports/completion/FINAL_COMPLETION_REPORT.md) - Final completion
|
||
- [Complete Implementation Report](reports/completion/COMPLETE_IMPLEMENTATION_REPORT.md) - Implementation report
|
||
- [Phase Completion Reports](reports/completion/) - Phase 1 and Phase 2 completion summaries
|
||
- [Progress Reports](reports/completion/) - Implementation progress and status reports
|
||
- [Weekly Status Reports](reports/weekly/) - Weekly project status updates
|
||
- [Monthly Progress Reports](reports/monthly/) - Monthly progress summaries
|
||
- [Quarterly Reports](reports/quarterly/) - Quarterly compliance status
|
||
- [Sprint Reports](reports/sprints/) - Sprint/iteration reports
|
||
|
||
### Implementation Documentation
|
||
- [Implementation Status](status/IMPLEMENTATION_STATUS.md) - Current implementation status (consolidated)
|
||
- [Module Completion Reports](completion/modules/) - Individual module completion reports
|
||
- [Phase Completion Reports](completion/phases/) - Phase completion reports
|
||
- [Final Implementation Report](completion/final-implementation-report.md) - Final project implementation report
|
||
|
||
### Compliance Documentation
|
||
- [Compliance Matrix](reference/COMPLIANCE_MATRIX.md) - Living compliance status matrix
|
||
- [Compliance Evaluation](reference/COMPLIANCE_EVALUATION.md) - Detailed compliance assessment
|
||
- [Compliance Evidence](compliance/evidence/) - Evidence for each compliance requirement
|
||
- [Certification Packages](compliance/certification/) - Certification submission packages
|
||
|
||
### Technical Documentation
|
||
- [Architecture Documentation](architecture/) - System and security architecture
|
||
- [API Documentation](api/) - API specifications and reference
|
||
- [Database Schema](database/) - Database schema and data models
|
||
- [Integration Documentation](integrations/) - External system integrations
|
||
- [Smart Routing and QoS](reference/SMART-ROUTING-AND-QOS.md) - QoS, lag reduction, infra management, system stability
|
||
- [Media Codecs and Point-to-Multipoint](reference/MEDIA-CODECS-AND-P2M.md) - Connection-speed-aware audio/video codecs
|
||
- [Platform Requirements](reference/PLATFORM-REQUIREMENTS.md) - Android, iOS (last 3 generations), Web Dapp (Desktop/Laptop + touch)
|
||
- [Requirements Alignment](reference/REQUIREMENTS-ALIGNMENT.md) - Frontend–backend contract and gaps
|
||
- [Device Compatibility](reference/DEVICE-COMPATIBILITY.md) - Primary device (Z Fold5) and app compatibility
|
||
|
||
### User Documentation
|
||
- [User Manual](user/SMOA-User-Manual.md) - Complete user guide
|
||
- [Quick Reference Guide](user/SMOA-Quick-Reference.md) - Quick reference card
|
||
- [Online User Manual](user/manual/) - Online version of user manual
|
||
- [Training Materials](training/) - Training slides, exercises, and videos
|
||
|
||
### Administrator Documentation
|
||
- [Administrator Guide](admin/SMOA-Administrator-Guide.md) - Complete administrator guide
|
||
- [Deployment Guide](admin/SMOA-Deployment-Guide.md) - Deployment procedures
|
||
- [Configuration Guide](admin/SMOA-Configuration-Guide.md) - Configuration reference
|
||
- [Online Administrator Guide](admin/guide/) - Online version of administrator guide
|
||
|
||
### Security Documentation
|
||
- [Security Architecture](security/SMOA-Security-Architecture.md) - Security architecture document
|
||
- [Threat Model](security/SMOA-Threat-Model.md) - Threat modeling documentation
|
||
- [Security Configuration Guide](security/SMOA-Security-Configuration-Guide.md) - Security configuration
|
||
- [Incident Response Plan](security/SMOA-Incident-Response-Plan.md) - Security incident procedures
|
||
|
||
### Testing Documentation
|
||
- [Test Plan](testing/SMOA-Test-Plan.md) - Comprehensive test plan
|
||
- [Test Cases](testing/test-cases/) - Test case documentation
|
||
- [Test Results](testing/reports/) - Test execution results
|
||
- [Performance Test Reports](testing/performance/) - Performance testing results
|
||
|
||
### Operations Documentation
|
||
- [Operations Runbook](operations/SMOA-Runbook.md) - Day-to-day operations procedures
|
||
- [Monitoring Guide](operations/SMOA-Monitoring-Guide.md) - Monitoring and alerting
|
||
- [Backup and Recovery](operations/SMOA-Backup-Recovery-Procedures.md) - Backup and DR procedures
|
||
|
||
### Change Management
|
||
- [Change Requests](changes/) - Change request documentation
|
||
- [Release Notes](releases/) - Release notes for each version
|
||
|
||
### Documentation Standards
|
||
- [Documentation Style Guide](standards/DOCUMENTATION_STYLE_GUIDE.md) - Writing and formatting standards
|
||
- [Terminology Glossary](standards/TERMINOLOGY_GLOSSARY.md) - Standard terms and definitions
|
||
- [Diagram Standards](standards/DIAGRAM_STANDARDS.md) - Diagram creation standards
|
||
- [Review Checklist](standards/DOCUMENTATION_REVIEW_CHECKLIST.md) - Documentation review checklist
|
||
- [RACI Matrix](standards/DOCUMENTATION_RACI_MATRIX.md) - Documentation responsibilities
|
||
|
||
### Documentation Templates
|
||
- [Weekly Status Report Template](templates/weekly-status-report-template.md)
|
||
- [Monthly Progress Report Template](templates/monthly-progress-report-template.md)
|
||
- [Module Completion Report Template](templates/module-completion-report-template.md)
|
||
- [Phase Completion Report Template](templates/phase-completion-report-template.md)
|
||
- [Release Notes Template](templates/release-notes-template.md)
|
||
|
||
---
|
||
|
||
## Documentation Status
|
||
|
||
### Completed Documentation
|
||
- ✅ Documentation infrastructure and templates
|
||
- ✅ Documentation standards and guidelines
|
||
- ✅ Documentation plan and implementation guides
|
||
- ✅ Compliance matrix and evaluation
|
||
- ✅ Implementation status documentation
|
||
|
||
### In Progress
|
||
- 🔄 Architecture documentation
|
||
- 🔄 API documentation
|
||
- 🔄 User documentation
|
||
- 🔄 Administrator documentation
|
||
|
||
### Planned
|
||
- ⏳ Module completion reports
|
||
- ⏳ Phase completion reports
|
||
- ⏳ Security documentation
|
||
- ⏳ Operations documentation
|
||
- ⏳ Training materials
|
||
|
||
---
|
||
|
||
## Finding Documentation
|
||
|
||
### By Role
|
||
- **End Users:** See [User Documentation](#user-documentation)
|
||
- **Administrators:** See [Administrator Documentation](#administrator-documentation)
|
||
- **Developers:** See [Technical Documentation](#technical-documentation)
|
||
- **QA Team:** See [Testing Documentation](#testing-documentation)
|
||
- **Security Team:** See [Security Documentation](#security-documentation)
|
||
- **Operations Team:** See [Operations Documentation](#operations-documentation)
|
||
- **Project Managers:** See [Project Status Reports](#project-status-and-progress-reports)
|
||
- **Compliance Officers:** See [Compliance Documentation](#compliance-documentation)
|
||
|
||
### By Topic
|
||
- **Getting Started:** See [Quick Links](#quick-links)
|
||
- **Architecture:** See [Architecture Documentation](architecture/)
|
||
- **APIs:** See [API Documentation](api/)
|
||
- **Security:** See [Security Documentation](security/)
|
||
- **Compliance:** See [Compliance Documentation](#compliance-documentation)
|
||
- **Deployment:** See [Deployment Guide](admin/SMOA-Deployment-Guide.md)
|
||
- **Configuration:** See [Configuration Guide](admin/SMOA-Configuration-Guide.md)
|
||
|
||
---
|
||
|
||
## Documentation Maintenance
|
||
|
||
### Update Frequency
|
||
- **Status Reports:** Weekly/Monthly/Quarterly (as scheduled)
|
||
- **Technical Documentation:** Updated with code changes
|
||
- **User Documentation:** Updated with each release
|
||
- **Standards:** Reviewed quarterly
|
||
|
||
### Contributing to Documentation
|
||
1. Follow [Documentation Style Guide](standards/DOCUMENTATION_STYLE_GUIDE.md)
|
||
2. Use appropriate [templates](templates/)
|
||
3. Review using [Review Checklist](standards/DOCUMENTATION_REVIEW_CHECKLIST.md)
|
||
4. Get approval per [RACI Matrix](standards/DOCUMENTATION_RACI_MATRIX.md)
|
||
|
||
### Reporting Issues
|
||
- **Documentation Issues:** Create issue in project tracker
|
||
- **Documentation Requests:** Contact Documentation Lead
|
||
- **Documentation Questions:** See [Documentation Standards](standards/)
|
||
|
||
---
|
||
|
||
## Documentation Versions
|
||
|
||
All documentation is version controlled. Check document headers for:
|
||
- Version number
|
||
- Last updated date
|
||
- Status (Draft, In Review, Approved, Published)
|
||
|
||
---
|
||
|
||
## Contact
|
||
|
||
For documentation questions or issues:
|
||
- **Documentation Lead:** [Contact Information]
|
||
- **Project Manager:** [Contact Information]
|
||
- **Technical Lead:** [Contact Information]
|
||
|
||
---
|
||
|
||
**Last Updated:** 2024
|
||
**Maintained by:** Documentation Lead
|
||
|