docs: update documentation with Phase 3.8 fixes and production warnings
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user