Initial commit - Church Music Database

legacy-site/documentation/md-files/QUICK_REFERENCE.md

@@ -0,0 +1,79 @@
+# 🚀 Quick Reference - Church HOP Music Data
+
+## Service URLs
+
+### Local Access
+
+- **Frontend**: <http://localhost:3000>
+- **Backend API**: <http://localhost:5100/api/songs>
+
+### Network Access  
+
+- **Frontend**: <http://192.168.10.130:3000>
+- **Backend API**: <http://192.168.10.130:5100/api/songs>
+
+### DNS Access (External)
+
+- **Frontend**: <http://houseofprayer.ddns.net:3000>
+- **Backend API**: <http://houseofprayer.ddns.net:5100/api/songs>
+
+## Database
+
+- **Type**: PostgreSQL
+- **Database**: church_songlyric
+- **User**: songlyric_user
+- **Host**: 192.168.10.130:5432
+
+## Technology Stack
+
+✅ **Backend**: Python Flask + SQLAlchemy + PostgreSQL  
+✅ **Frontend**: React 18 + Bootstrap 5.3.8  
+✅ **Database**: PostgreSQL 16  
+✅ **Port**: 5100 (Backend), 3000 (Frontend)  
+✅ **Mobile**: Bootstrap responsive design  
+✅ **DNS**: houseofprayer.ddns.net
+
+## Quick Commands
+
+### Start Backend
+
+```bash
+cd /media/pts/Website/Church_HOP_MusicData/backend
+source venv/bin/activate
+python app.py
+```
+
+### Start Frontend
+
+```bash
+cd /media/pts/Website/Church_HOP_MusicData/frontend
+npm start
+```
+
+### Test API
+
+```bash
+curl http://localhost:5100/api/songs
+```
+
+### Database Access
+
+```bash
+sudo -u postgres psql -d church_songlyric
+```
+
+## Status Check
+
+```bash
+# Check running processes
+ps aux | grep "python app.py"
+ps aux | grep "react-scripts"
+
+# Check ports
+lsof -i :5100
+lsof -i :3000
+```
+
+---
+**Last Updated**: December 14, 2025  
+**Status**: ✅ All systems operational with PostgreSQL