first test

docs/DEVELOPMENT.md

@@ -0,0 +1,60 @@
+# Development Setup
+
+## Environment Configuration
+
+This project uses separate environment configurations for local development and Docker deployment:
+
+### Local Development
+- **Backend**: Uses `.env` file with `DB_HOST=localhost`
+- **Frontend**: Uses `frontend/.env` with `VITE_API_URL=http://localhost:8080/api/v1`
+
+### Docker Deployment
+- **Backend**: Uses `.env.docker` file with `DB_HOST=postgres` (Docker network)
+- **Frontend**: Uses `frontend/.env.docker` with same API URLs
+
+## Port Configuration
+
+- **Backend Port**: Determined by `PORT` environment variable (default: 8080)
+- **Frontend Port**: Determined by `FRONTEND_PORT` environment variable (default: 5173)
+- **PostgreSQL**: Port 5432 (configured in docker-compose.yml)
+
+## Running the Application
+
+### Local Development
+```bash
+# Start PostgreSQL (if not running)
+docker run -d --name postgres -p 5432:5432 -e POSTGRES_DB=trackeep -e POSTGRES_USER=trackeep -e POSTGRES_PASSWORD=trackeep123 postgres:15-alpine
+
+# Start backend
+cd backend && go run main.go
+
+# Start frontend
+cd frontend && npm run dev
+```
+
+### Docker Deployment
+```bash
+docker-compose up --build
+```
+
+## Environment Variables
+
+Key environment variables that control the application:
+
+- `PORT`: Backend server port
+- `FRONTEND_PORT`: Frontend development server port
+- `DB_TYPE`: Database type (postgres)
+- `DB_HOST`: Database host (localhost for local, postgres for Docker)
+- `VITE_DEMO_MODE`: Enable/disable demo mode
+- `VITE_API_URL`: Frontend API base URL
+
+## Demo Mode
+
+When `VITE_DEMO_MODE=true`, the application:
+- Auto-populates login form with demo credentials
+- Restricts write operations to protect demo data
+- Seeds initial demo data on startup
+
+Demo credentials:
+- Email: demo@trackeep.com
+- Password: demo123