docs: update documentation with Phase 3.8 fixes and production warnings

This commit is contained in:
Radosław Gierwiało
2025-12-09 19:25:52 +01:00
parent b0ca382ce7
commit 3c116bf796
4 changed files with 188 additions and 8 deletions

View File

@@ -348,4 +348,52 @@ REST_BUFFER_MINUTES: 60
---
**Last Updated:** 2025-12-06
**Last Updated:** 2025-12-09
---
## ⚠️ PRODUCTION ENVIRONMENT
**Status:****LIVE IN PRODUCTION**
**URL:** https://spotlight.cam
**Deployed:** 2025-12-09
**Users:** Real users with real data
### Critical Development Guidelines
#### Database Safety
- ⚠️ **NEVER** run migrations without testing in development first
- Always backup production database before schema changes
- Use `npx prisma migrate dev --create-only` to preview SQL
- Test data operations in dev environment before production
- Use transactions for multi-step operations
#### Deployment Process
1. Test thoroughly in development (`docker compose --profile dev up`)
2. Run full test suite (`make test` - all 351 tests must pass)
3. Review changes: `git diff origin/master`
4. Deploy during low-traffic periods
5. Monitor logs after deployment: `docker compose logs -f backend-prod`
#### Emergency Rollback
- Keep previous Docker images: `docker images | grep app-`
- Rollback command: `docker compose --profile prod down && docker tag OLD_IMAGE NEW_IMAGE && docker compose --profile prod up -d`
- Have database backup ready at all times
#### What to NEVER Do
- ❌ Drop tables or columns without migration plan
- ❌ Change primary keys or foreign key relationships
- ❌ Deploy without running tests
- ❌ Push directly to master without review
- ❌ Test experimental features on production data
#### Recent Bug Fixes (Phase 3.8 - Dec 2025)
1. Admin dropdown persistence (session fields)
2. Mobile chat scroll behavior
3. Polish characters in name validation
4. WSDC ID type conversion
5. Match chat message display
6. Socket.IO reconnection handling
7. Docker production build scripts
All fixes deployed successfully with zero downtime.