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:
Aleksey Razorvin
2026-03-21 12:46:30 +05:00
parent 3d21110dd9
commit 5551202d6f
2 changed files with 37 additions and 15 deletions
+15
View File
@@ -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. Запомни их, встретишь снова.
---