Add trace files.

DOCKER-QUICKSTART.md

@@ -0,0 +1,190 @@
+# ColaFlow Docker Quick Start
+
+Quick guide to start ColaFlow backend for frontend development.
+
+## Prerequisites
+
+- Docker Desktop installed and running
+- Git (optional, for version control)
+
+## Quick Start (30 seconds)
+
+### Windows (PowerShell)
+
+```powershell
+# Clone repo (if not already)
+git clone <repo-url>
+cd product-master
+
+# Start all services
+.\scripts\dev-start.ps1
+```
+
+### Linux/Mac (Bash)
+
+```bash
+# Clone repo (if not already)
+git clone <repo-url>
+cd product-master
+
+# Start all services
+chmod +x scripts/dev-start.sh
+./scripts/dev-start.sh
+```
+
+### Using npm (from frontend directory)
+
+```bash
+cd colaflow-web
+npm run docker:dev
+```
+
+## Access Points
+
+After startup (30-60 seconds), access:
+
+| Service | URL | Credentials |
+|---------|-----|-------------|
+| Frontend | http://localhost:3000 | - |
+| Backend API | http://localhost:5000 | - |
+| Swagger Docs | http://localhost:5000/swagger | - |
+| Demo Login | - | owner@demo.com / Admin123! |
+
+## Common Commands
+
+```powershell
+# View logs
+docker-compose logs -f
+
+# Stop all services
+docker-compose down
+
+# Restart backend only
+docker-compose restart backend
+
+# Reset all data (WARNING: deletes everything)
+.\scripts\dev-start.ps1 -Reset
+
+# Start with dev tools (pgAdmin, Redis Commander)
+.\scripts\dev-start.ps1 -Tools
+```
+
+## Dev Tools (Optional)
+
+Start with `-Tools` flag to access:
+
+| Tool | URL | Credentials |
+|------|-----|-------------|
+| pgAdmin | http://localhost:5050 | admin@colaflow.com / admin |
+| Redis Commander | http://localhost:8081 | - |
+
+## Troubleshooting
+
+### Services won't start
+
+```powershell
+# Check Docker is running
+docker info
+
+# View detailed logs
+docker-compose logs backend
+docker-compose logs postgres
+```
+
+### Port conflicts
+
+Edit `.env` file to change ports:
+
+```env
+BACKEND_PORT=5001
+FRONTEND_PORT=3001
+POSTGRES_PORT=5433
+```
+
+### Fresh start
+
+```powershell
+# Remove all containers and data
+docker-compose down -v
+
+# Rebuild and restart
+.\scripts\dev-start.ps1 -Clean
+```
+
+## Frontend Development
+
+### Connect to containerized backend
+
+Create `colaflow-web/.env.local`:
+
+```env
+NEXT_PUBLIC_API_URL=http://localhost:5000
+NEXT_PUBLIC_WS_URL=ws://localhost:5000/hubs/project
+```
+
+### Run frontend locally (recommended)
+
+```bash
+cd colaflow-web
+npm install
+npm run dev
+```
+
+Frontend will run on http://localhost:3000 and connect to containerized backend.
+
+## What's Included?
+
+The Docker environment provides:
+
+- PostgreSQL 16 database
+- Redis 7 cache
+- .NET 9 backend API
+- Next.js 15 frontend
+- Demo tenant with sample data
+- SignalR real-time updates
+
+## Sample Data
+
+Default demo account:
+
+- Email: owner@demo.com
+- Password: Admin123!
+- Role: Tenant Owner (full access)
+
+Includes:
+- 1 demo project
+- 1 epic
+- 1 story
+- 3 tasks
+
+## Next Steps
+
+1. Start backend: `.\scripts\dev-start.ps1`
+2. Start frontend: `cd colaflow-web && npm run dev`
+3. Open browser: http://localhost:3000
+4. Login with demo account
+5. Start developing!
+
+## Need Help?
+
+- Full documentation: `docs/DOCKER-DEVELOPMENT-ENVIRONMENT.md`
+- Report issues: [GitHub Issues]
+- Ask in Slack: #colaflow-dev
+
+---
+
+**Quick Reference:**
+
+```powershell
+# Start
+.\scripts\dev-start.ps1
+
+# Stop
+docker-compose down
+
+# Logs
+docker-compose logs -f
+
+# Reset
+.\scripts\dev-start.ps1 -Reset
+```