docs: update sprint 1 docs after manual testing
- СПРИНТЫ.md: mark Sprint 1 as completed (✅), check all tasks, add 4 bugs found and fixed during testing - ШАГ_006.md: add bugs table with symptoms, causes and fixes Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -14,6 +14,7 @@
|
||||
## Ответ
|
||||
|
||||
Реализован Спринт 1 в полном объёме: инфраструктура + создание тестов без авторизации.
|
||||
Спринт протестирован вручную в браузере, найдены и исправлены 4 бага.
|
||||
|
||||
---
|
||||
|
||||
@@ -113,6 +114,20 @@ docker compose up --build
|
||||
- Перейти к созданному тесту и увидеть все вопросы и ответы
|
||||
- `http://localhost/api/health` → `{"status": "ok"}`
|
||||
- `http://localhost/api/docs` → Swagger UI FastAPI
|
||||
- `http://localhost/api/redoc` → ReDoc документация
|
||||
|
||||
---
|
||||
|
||||
## Баги, найденные и исправленные при ручном тестировании
|
||||
|
||||
| # | Симптом | Причина | Исправление |
|
||||
|---|---------|---------|-------------|
|
||||
| 1 | `permission denied` на `entrypoint.sh` | `docker-compose.yml` монтирует `./backend:/app` — volume перекрывает файлы образа, включая результат `chmod +x` из Dockerfile | `CMD ["bash", "entrypoint.sh"]` вместо `CMD ["./entrypoint.sh"]` |
|
||||
| 2 | `No module named 'app'` в Alembic | Python не добавляет WORKDIR в `sys.path` автоматически | `ENV PYTHONPATH=/app` в Dockerfile |
|
||||
| 3 | nginx: `host not found in upstream "backend"` | nginx резолвит upstream-хосты **при старте**, а backend ещё не поднялся | Docker DNS resolver `127.0.0.11` + `set $backend` — резолвинг откладывается до момента запроса |
|
||||
| 4 | `http://localhost/api/docs` → 404 | FastAPI по умолчанию отдаёт Swagger по `/docs`, а через nginx путь становится `/api/docs` → `backend:8000/api/docs` (не существует) | Явно указать `docs_url="/api/docs"`, `redoc_url="/api/redoc"`, `openapi_url="/api/openapi.json"` в FastAPI |
|
||||
|
||||
> **Для джуниора:** все четыре бага — типичные для первого запуска Docker + FastAPI + nginx. Запомни их, встретишь снова.
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user