docs: Clean up repository structure and organize documentation

[rcabral85]

🧹 Repository Cleanup

This PR organizes scattered documentation files into logical folders, making the repository much easier to navigate. This cleanup complements PR #31's comprehensive backend refactor.

🎯 What This PR Does

Creates New Documentation Structure

docs/
├── README.md (documentation index)
├── archive/ (historical guides)
├── fixes/ (documented bug fixes)
├── setup/ (deployment & config)
└── development/ (dev guides)

database/
├── archive/ (old schema files)
├── migrations/ (unchanged)
└── scripts/ (unchanged)

Before ❌

• 25+ markdown files cluttering root directory
• Unclear which docs were current vs historical
• Multiple schema files with no clear precedence
• Hard to find relevant documentation

After ✅

• Clean root with only essential files
• Organized documentation by purpose
• Clear archive for historical reference
• Easy navigation via docs/README.md

📄 Files Reorganized

Documentation Moved:

Setup & Deployment (docs/setup/):

• SETUP.md → docs/setup/local-development.md
• ENV_VARIABLES.md → docs/setup/environment-variables.md
• PRE_LAUNCH_CHECKLIST.md → docs/setup/pre-launch-checklist.md

Development (docs/development/):

• TESTING.md → docs/development/testing-guide.md
• CONTRIBUTING.md → docs/development/contributing.md

Bug Fixes (docs/fixes/):

• FIXES-LOGOUT-MAINTENANCE.md → docs/fixes/logout-maintenance-fix.md
• MAINTENANCE_ENDPOINTS_FIX.md → docs/fixes/maintenance-endpoints-fix.md
• RAILWAY_FIXES.md → docs/fixes/railway-deployment-fix.md
• HYDRANT_ADD_IMPROVEMENTS.md → docs/fixes/hydrant-add-improvements.md

Historical Archive (docs/archive/):

• IMPLEMENTATION_GUIDE.md → docs/archive/implementation-guide-legacy.md
• SUPERADMIN_IMPLEMENTATION.md → docs/archive/superadmin-implementation.md
• UPGRADE_IMPLEMENTATION.md → docs/archive/upgrade-implementation.md
• MAINTENANCE_MODULE.md → docs/archive/maintenance-module.md
• hydrant-hub-guide.md → docs/archive/hydrant-hub-guide.md

Database Files Archived:

Old schemas moved to database/archive/:

• schema.sql → schema-original.sql
• maintenance-schema.sql → maintenance-schema-legacy.sql
• create-maintenance-tables.sql → create-maintenance-tables-legacy.sql
• quick-fix-schema.sql → quick-fix-schema.sql

Note: PR #31 introduces database/master-schema.sql as the new unified schema.

Files Removed:

• mobile-nav-integration-example.html (example code, no longer needed)
• multi-tenancy-*.md (consolidated into archive)

🤝 Compatibility with PR #31

PR #31 (Backend Refactor)	This PR (Docs Cleanup)
Backend code refactor	Documentation organization
Database schema consolidation	Archive old schemas
Creates master-schema.sql	Points to new master schema
Complete implementation guide	Organizes historical guides
Fixes duplicate routes	Organizes fix documentation

No conflicts - These PRs improve different aspects of the repository and can be merged independently.

📚 New Documentation Index

Added docs/README.md with:

• Clear navigation structure
• Quick start guides
• Links to all documentation
• Documentation standards

See the new structure in the documentation index.

🗂️ Migration Guide

If you had bookmarked files:

Old Location	New Location
SETUP.md	docs/setup/local-development.md
ENV_VARIABLES.md	docs/setup/environment-variables.md
TESTING.md	docs/development/testing-guide.md
CONTRIBUTING.md	docs/development/contributing.md
database/schema.sql	database/archive/schema-original.sql

✅ Files Kept in Root (Essential)

• README.md (main entry point)
• LICENSE (required)
• .gitignore / .gitattributes (git config)
• docker-compose.yml (docker setup)
• netlify.toml (deployment)
• promote-superadmin.js (admin utility)

🏁 Benefits

1. Easier onboarding - New developers can find setup docs quickly
2. Clear history - Archive keeps old docs for reference
3. Better organization - Docs grouped by purpose
4. Cleaner root - Only essential files visible
5. Scalable structure - Easy to add new docs

📋 Checklist

• Created docs/ subdirectories
• Moved all scattered documentation
• Created docs/README.md index
• Archived old database schemas
• Created CLEANUP_SUMMARY.md
• Verified no broken links
• Compatible with PR Complete App Refactor - Fix Connections, Add Features, Clean Code #31

🚀 Next Steps After Merge

1. Update root README.md with links to docs/ sections
2. Merge PR Complete App Refactor - Fix Connections, Add Features, Clean Code #31 for backend refactor
3. Update any external documentation links
4. Consider creating GitHub wiki for user docs

📝 Testing

No code changes - documentation only. Test by:

• Checking all links in docs/README.md work
• Verifying files are in correct locations
• Ensuring no documentation is lost

---

Full details: See CLEANUP_SUMMARY.md

Questions? Comment on this PR or check the documentation index.

[netlify]

✅ Deploy Preview for stunning-cascaron-f49a60 canceled.

Name	Link
🔨 Latest commit	ed10f94
🔍 Latest deploy log	https://app.netlify.com/projects/stunning-cascaron-f49a60/deploys/691b7c9e7db98d00087680ae