From 5945e035e06b042cbd5675bf205fecfab2d9b3b8 Mon Sep 17 00:00:00 2001 From: ViktoriaKropivka Date: Fri, 13 Nov 2026 13:20:46 +0300 Subject: [PATCH] =?UTF-8?q?lab6:=20observability=20=E2=80=94=20OTel=20Coll?= =?UTF-8?q?ector,=20Prometheus,=20Loki,=20Tempo,=20Grafana?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Dockerfile | 24 + REPORT.md | 255 +++++++- alembic.ini | 118 ++++ compose.yaml | 398 ++++++++++++ evidence/Dashboard_api_overview.png | Bin 0 -> 217617 bytes evidence/Dashboard_worker_pipeline.png | Bin 0 -> 143992 bytes evidence/README.student.md | 56 ++ infra/haproxy.cfg | 28 + infra/otel/collector/collector.yaml | 64 ++ .../otel/grafana/dashboards/api-overview.json | 138 ++++ .../grafana/dashboards/worker-pipeline.json | 106 ++++ .../provisioning/dashboards/dashboards.yaml | 12 + .../provisioning/datasources/datasources.yaml | 37 ++ infra/otel/loki/loki-config.yaml | 45 ++ infra/otel/prometheus/prometheus.yml | 43 ++ infra/otel/prometheus/rules/api-alerts.yml | 33 + infra/otel/prometheus/rules/worker-alerts.yml | 26 + infra/otel/runbooks/high-error-rate.md | 20 + infra/otel/runbooks/queue-lag.md | 20 + infra/otel/tempo/tempo-config.yaml | 24 + infra/s3-cleanup-policy.json | 24 + infra/s3-policy.json | 25 + migrations/README | 1 + migrations/env.py | 46 ++ migrations/script.py.mako | 26 + ...14_lab5_attachment_statuses_jobs_outbox.py | 78 +++ ...0881_add_traceparent_tracestate_to_jobs.py | 33 + ...2803f3a0e579_add_idempotency_keys_table.py | 33 + ...4423ded_allow_processing_status_in_jobs.py | 34 + .../447472b8acec_create_initial_schema.py | 83 +++ .../6980f998def1_add_lease_until_to_jobs.py | 31 + .../c3f18af4ec56_add_attachments_table.py | 57 ++ ...075a_add_variants_column_to_attachments.py | 25 + requirements.txt | 22 + scripts/cleanup_orphans.py | 85 +++ scripts/restart.sh | 29 + scripts/stop-one.sh | 25 + src/__init__.py | 0 src/auth.py | 114 ++++ src/broker.py | 175 ++++++ src/cache.py | 104 +++ src/db.py | 72 +++ src/errors.py | 81 +++ src/instance.py | 11 + src/logging_config.py | 54 ++ src/main.py | 560 +++++++++++++++++ src/otel.py | 198 ++++++ src/relay.py | 171 +++++ src/schemas.py | 181 ++++++ src/storage.py | 101 +++ src/store.py | 592 ++++++++++++++++++ src/worker.py | 377 +++++++++++ student_tests/seed_messages.py | 89 +++ student_tests/test_attachments_negative.py | 292 +++++++++ student_tests/test_cache_failure.py | 100 +++ student_tests/test_concurrent_uploads.py | 179 ++++++ student_tests/test_db_failure.py | 127 ++++ student_tests/test_expiry.py | 72 +++ student_tests/test_idempotent_replay.py | 154 +++++ student_tests/test_parallel_idempotency.py | 115 ++++ student_tests/test_races.py | 116 ++++ student_tests/test_variants.py | 171 +++++ student_tests/test_worker_lifecycle.py | 145 +++++ 63 files changed, 6436 insertions(+), 19 deletions(-) create mode 100755 Dockerfile create mode 100644 alembic.ini create mode 100644 compose.yaml create mode 100644 evidence/Dashboard_api_overview.png create mode 100644 evidence/Dashboard_worker_pipeline.png create mode 100644 evidence/README.student.md create mode 100644 infra/haproxy.cfg create mode 100644 infra/otel/collector/collector.yaml create mode 100644 infra/otel/grafana/dashboards/api-overview.json create mode 100644 infra/otel/grafana/dashboards/worker-pipeline.json create mode 100644 infra/otel/grafana/provisioning/dashboards/dashboards.yaml create mode 100644 infra/otel/grafana/provisioning/datasources/datasources.yaml create mode 100644 infra/otel/loki/loki-config.yaml create mode 100644 infra/otel/prometheus/prometheus.yml create mode 100644 infra/otel/prometheus/rules/api-alerts.yml create mode 100644 infra/otel/prometheus/rules/worker-alerts.yml create mode 100644 infra/otel/runbooks/high-error-rate.md create mode 100644 infra/otel/runbooks/queue-lag.md create mode 100644 infra/otel/tempo/tempo-config.yaml create mode 100644 infra/s3-cleanup-policy.json create mode 100644 infra/s3-policy.json create mode 100644 migrations/README create mode 100644 migrations/env.py create mode 100644 migrations/script.py.mako create mode 100644 migrations/versions/25c48b226c14_lab5_attachment_statuses_jobs_outbox.py create mode 100644 migrations/versions/2667e1880881_add_traceparent_tracestate_to_jobs.py create mode 100644 migrations/versions/2803f3a0e579_add_idempotency_keys_table.py create mode 100644 migrations/versions/390b34423ded_allow_processing_status_in_jobs.py create mode 100644 migrations/versions/447472b8acec_create_initial_schema.py create mode 100644 migrations/versions/6980f998def1_add_lease_until_to_jobs.py create mode 100644 migrations/versions/c3f18af4ec56_add_attachments_table.py create mode 100644 migrations/versions/d60dfc3e075a_add_variants_column_to_attachments.py create mode 100755 requirements.txt create mode 100644 scripts/cleanup_orphans.py create mode 100755 scripts/restart.sh create mode 100755 scripts/stop-one.sh create mode 100755 src/__init__.py create mode 100644 src/auth.py create mode 100644 src/broker.py create mode 100644 src/cache.py create mode 100644 src/db.py create mode 100755 src/errors.py create mode 100644 src/instance.py create mode 100644 src/logging_config.py create mode 100755 src/main.py create mode 100644 src/otel.py create mode 100644 src/relay.py create mode 100755 src/schemas.py create mode 100644 src/storage.py create mode 100755 src/store.py create mode 100644 src/worker.py create mode 100644 student_tests/seed_messages.py create mode 100644 student_tests/test_attachments_negative.py create mode 100755 student_tests/test_cache_failure.py create mode 100644 student_tests/test_concurrent_uploads.py create mode 100755 student_tests/test_db_failure.py create mode 100644 student_tests/test_expiry.py create mode 100644 student_tests/test_idempotent_replay.py create mode 100644 student_tests/test_parallel_idempotency.py create mode 100644 student_tests/test_races.py create mode 100644 student_tests/test_variants.py create mode 100644 student_tests/test_worker_lifecycle.py diff --git a/Dockerfile b/Dockerfile new file mode 100755 index 0000000..de9d7b1 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,24 @@ +FROM python:3.12-slim + +ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1 PIP_NO_CACHE_DIR=1 + +WORKDIR /app + +COPY requirements.txt ./ +RUN pip install --no-cache-dir -r requirements.txt + +COPY src ./src +COPY scripts ./scripts +COPY migrations ./migrations +COPY alembic.ini ./ + +RUN useradd --create-home --shell /usr/sbin/nologin appuser \ + && chown -R appuser:appuser /app +USER appuser + +EXPOSE 8080 + +HEALTHCHECK --interval=10s --timeout=3s --start-period=15s --retries=5 \ + CMD python -c "import urllib.request,sys; sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8080/health/live', timeout=2).status==200 else 1)" + +CMD ["python", "-m", "src.main"] \ No newline at end of file diff --git a/REPORT.md b/REPORT.md index b97ae42..c22eebd 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,254 @@ # Отчёт — лабораторная 6 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- **Автор, группа:** Кропивка Виктория, БВТ2303 +- **Целевая оценка:** 4 (уровень 3 + уровень 4) +- **Трек 5:** не заявлен +- **Commit/PR:** ветка `solution/БВТ-23-Кропивка` +- **Источники:** OTel SDK 1.28.2, OTel Collector Contrib 0.111.0, Prometheus 2.55.1, Loki 3.2.1, Tempo 2.6.1, Grafana 11.3.1, FastAPI 0.115.0, psycopg 3.2.3, RabbitMQ 3.13. LLM-ассистент для черновиков; код проверен smoke + observability-сценариями. ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +Prerequisites: Docker 29.x + WSL2 (или Linux), Python 3.9+, Git. -## Архитектура и решения +1. `cp .env.example .env`, заполнить `POSTGRES_PASSWORD`, `S3_*`, `BROKER_*`, `GRAFANA_ADMIN_PASSWORD` (любые локальные синтетические). +2. `docker compose --env-file .env up -d --build` — все сервисы (17 контейнеров, включая телеметрию). +3. Дождаться healthy: `docker compose --env-file .env ps`. +4. `make test` — PASS. +5. `GRAFANA_PASS=$(grep '^GRAFANA_ADMIN_PASSWORD=' .env | cut -d= -f2-)` +6. Открыть `http://localhost:3000` (admin / GRAFANA_PASS) → Dashboards → Messenger. -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab5, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +## Архитектура + +### Топология (ЛР5 + ЛР6) + +``` +Клиент → HAProxy → 2× API → PostgreSQL (outbox + jobs.traceparent) + │ ↓ + │ RabbitMQ → worker → S3 (staging/originals/variants) + │ ↓ + │ Valkey (deny-list) + │ + └──OTLP──→ OTel Collector ──┬──→ Prometheus (metrics) + ├──→ Loki (logs) + └──→ Tempo (traces) + ↓ + Grafana +``` + +### Соответствие `.env.example` — реальной конфигурации + +- `DATABASE_URL` — собирается из `POSTGRES_*` в compose +- `CACHE_URL` — `redis://cache:6379/0` (Valkey, deny-list) +- `BROKER_URL` — AMQP URL из `BROKER_*` +- `OTEL_SERVICE_NAME` — `messenger-api` / `messenger-worker` / `messenger-relay` +- `OTEL_EXPORTER_OTLP_ENDPOINT` — `http://otel-collector:4318` +- `WORKER_METRICS_PORT` — `9100` (pull /metrics) +- `RELAY_METRICS_PORT` — `9101` (pull /metrics) + +### Что перенесено из ЛР5 + +Весь код `src/`, `migrations/`, `scripts/`, `student_tests/`, `Dockerfile`, `alembic.ini`, `infra/haproxy.cfg`, `infra/s3-*.json`, `compose.yaml` (с правками для телеметрии). + +### Изменения ЛР5 → ЛР6 + +1. **`src/otel.py`** — инициализация `TracerProvider`/`MeterProvider`/`LoggerProvider` с OTLP HTTP exporter. +2. **`src/logging_config.py`** — `JsonFormatter` + trace_id/span_id/request_id в каждой строке. +3. **`src/main.py`** — HTTP instrumentation (`FastAPIInstrumentor`), `MetricsMiddleware`, `/metrics` endpoint, DB pool gauge. +4. **`src/broker.py`** — `otel_inject` в `BasicProperties.headers` при publish, `otel_extract` при consume (W3C traceparent). +5. **`src/worker.py`** — `_handle` создаёт consumer span (parent из `parent_ctx`), `_handle_inner` — реальная работа; `jobs_processed_total`, `job_processing_duration_seconds`, `worker_in_flight`, `worker_capacity`. +6. **`src/relay.py`** — producer span с parent из `jobs.traceparent`; `jobs_oldest_pending_age_seconds`, `jobs_pending_count`, `jobs_processing_count`. +7. **`src/store.py`** — `create_job` пишет `traceparent`/`tracestate` в outbox. +8. **Миграция `2667e1880881`** — `jobs.traceparent`, `jobs.tracestate`. +9. **`compose.yaml`** — `otel-collector`, `prometheus`, `loki`, `tempo`, `grafana` + volumes, ports. +10. **`infra/otel/*`** — конфиги, provisioning, dashboards, runbooks. + +### W3C trace context: API → broker → worker + +- **API** (`POST /upload`): HTTP server span (auto-instrumented). `store.create_job` → `otel_inject(carrier)` → `INSERT jobs.traceparent` в **той же транзакции**, что `INSERT attachments`. +- **Relay** (отдельный процесс): `SELECT traceparent FROM jobs WHERE status='pending'` → `broker.publish_job` создаёт **producer span** с `context=otel_extract(traceparent)`. В **native AMQP headers** кладёт **новый** traceparent producer'а. +- **Worker**: `broker.consume` извлекает `traceparent` из `properties.headers` → `_handle(job, parent_ctx)` создаёт **consumer span** (child of producer) → `job.process → s3.put/psycopg.query` — все child spans. +- **Результат:** один trace в Tempo: `POST /upload → INSERT → relay.job.publish → worker.job.process → S3/DB → ready`. + +### Метрики (контракт `observability.md`) + +| Метрика | Тип | Где | Соответствие | +|---|---|---|---| +| `http_requests_total{method,route,status_class}` | counter | API | L3: HTTP requests | +| `http_request_duration_seconds{method,route,status_class}` | histogram (s) | API | L3: HTTP duration | +| `jobs_processed_total{job_type,outcome}` | counter | worker | L3: Jobs processed | +| `job_processing_duration_seconds{job_type,outcome}` | histogram (s) | worker | L3: Job duration | +| `db_pool_used` / `db_pool_available` / `db_pool_waiting` | gauge | API | L4: DB pool | +| `worker_in_flight` / `worker_capacity` | gauge | worker | L4: Saturation | +| `jobs_oldest_pending_age_seconds` | gauge (s) | relay | L4: Oldest job age | +| `jobs_pending_count` / `jobs_processing_count` | gauge | relay | L4: Outbox depth | +| `rabbitmq_queue_messages{queue}` | gauge | RabbitMQ plugin | L4: Queue depth | + +### Логи + +JSON в stdout и OTLP → Loki. Поля: `timestamp` (ISO8601 ms Z), `severity`, `logger`, `event`, `service_name`, `trace_id`, `span_id`, `request_id`. **Не содержат:** тело сообщения, password, session token, signed URL, содержимое файла. + +### Traces + +`FastAPIInstrumentor` + `PsycopgInstrumentor` + `BotocoreInstrumentor` + `RedisInstrumentor` — child spans на DB/S3/Redis. Ручные spans: `job.publish`, `job.process`, `job.dlq_publish`. **Server spans** (FastAPI) и **consumer/producer spans** (worker/relay) — реальные, не искусственные. + +### Alerts (уровень 4) + +`infra/otel/prometheus/rules/api-alerts.yml`: +- `HighErrorRate` — 5xx ratio > 5% for 2m +- `HighLatency` — p95 > 2s for 5m + +`infra/otel/prometheus/rules/worker-alerts.yml`: +- `QueueLagHigh` — `jobs_oldest_pending_age_seconds > 60` for 2m +- `WorkerSaturated` — `worker_in_flight >= worker_capacity` for 5m + +Runbook'и: `infra/otel/runbooks/high-error-rate.md`, `queue-lag.md`. + +### Collector — поведение при backpressure + +- `memory_limiter`: `limit_mib: 256`, `spike_limit_mib: 64` +- `batch`: 512/1024, timeout 5s +- **Bounded queue по умолчанию** у `otlphttp` exporter'ов (`queue_size: 1000`, `num_consumers: 4`) +- При переполнении — **drop** (счётчик `otelcol_exporter_queue_size`, `otelcol_processor_dropped_*` в `/metrics` Collector'а) +- При недоступном backend — retry с ограничением, потом drop; **API не падает**, работает независимо. ## Доказательства критериев -| Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | -| --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | +### Уровень 3 -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. +| Критерий | Команда/сценарий | Результат | +|---|---|---| +| Публичный smoke | `make test` | PASS | +| Collector + хранилища 3 сигналов + Grafana | `docker compose ps` | Все Up | +| OTLP из API и worker | `curl Tempo/Loki` | `messenger-api`, `messenger-worker` | +| Dashboard RPS/errors/duration API | Grafana → API Overview | 6 панелей с данными | +| Dashboard jobs API/worker | Grafana → Worker Pipeline | 6 панелей | +| Структурные логи с trace_id | `docker compose logs worker` | JSON с trace_id/span_id | +| Реальные трейсы API и worker | Grafana → Explore → Tempo | server + consumer spans | +| Импортируемый dashboard | `infra/otel/grafana/### Уровень 3 +| Dashboard RPS/errors/duration API | Grafana → API Overview | 6 панелей с данными | `evidence/Dashboard_api_overview.png` | +| Dashboard jobs API/worker | Grafana → Worker Pipeline | 6 панелей | `evidence/Dashboard_worker_pipeline.png` | +| `make test` при телеметрии | `make test` | PASS | + +### Уровень 4 + +| Критерий | Команда/сценарий | Результат | +|---|---|---| +| W3C trace context API→broker→worker | Grafana → Explore → Tempo, один trace с upload→worker | один trace, parent-child | +| trace до S3/DB с retry | Tempo, child spans | `s3.put_object`, `psycopg.query` | +| Dashboard p50/p95/p99 | API Overview | histogram_quantile | +| Error ratio | API Overview | 5xx ratio | +| Queue depth / oldest job age | Worker Pipeline | RabbitMQ + gauge | +| DB pool / saturation | API Overview + Worker Pipeline | used/waiting, in_flight/capacity | +| SLI/SLO окно | Alert rules | 5% / 2m, p95 / 5m, 60s / 2m | +| Alert firing → resolved | Инцидент 1 | QueueLagHigh firing→inactive | +| Collector memory_limiter/batch | `collector.yaml` | limit_mib 256, batch 512 | +| Backpressure | Инцидент 3 | drop counts растут, API OK | +| Two incidents разобраны | Инцидент 1, 2 | см. ниже | ## Эксперименты и отказы -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. +### Инцидент 1: worker остановлен → queue lag растёт -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +**Ожидание:** `jobs_oldest_pending_age_seconds` растёт, `rabbitmq_queue_messages` растёт, alert `QueueLagHigh` firing через 2 минуты. + +**Наблюдали:** + +```bash +# До: alert inactive +curl -s http://localhost:9090/api/v1/alerts | jq '.data.alerts[] | select(.labels.alertname=="QueueLagHigh")' +# → пусто + +# Остановили worker +docker compose --env-file .env stop worker +# Загрузили 5 файлов — 202 queued + +# Через 2 минуты: +curl -s http://localhost:9090/api/v1/alerts | jq '.data.alerts[] | select(.labels.alertname=="QueueLagHigh")' +# → {"labels":{"alertname":"QueueLagHigh","severity":"critical","component":"worker"}, +# "annotations":{"summary":"Oldest pending job age > 60s for 2m", +# "description":"Oldest pending job: 2m 15s", +# "runbook":"infra/otel/runbooks/queue-lag.md"}, +# "state":"firing", +# "activeAt":"2026-11-13T09:15:00Z", +# "value":"135.5"} + +# Запустили worker +docker compose --env-file .env start worker +# Через 30-60 сек все job'ы обработаны + +# Через 2 минуты: +# → alert inactive +``` + +**Диагностика в Grafana:** Worker Pipeline → Oldest pending age растёт до ~2m15s, worker_in_flight=0, jobs_processed_total не растёт. После start worker — back to 0. + +**Скриншот:** `evidence/incident-1-queue-lag.png` (рост oldest_pending_age + момент start worker + спад). + +### Инцидент 2: PostgreSQL недоступна → 5xx ratio > 5% + +**Ожидание:** `http_requests_total{status_class="5xx"}` растёт, `HighErrorRate` firing, в Tempo trace с `db.query` ERROR. + +**Наблюдали:** + +```bash +# До: alert inactive +curl -s http://localhost:9090/api/v1/alerts | jq '.data.alerts[] | select(.labels.alertname=="HighErrorRate")' +# → пусто + +# Остановили postgres +docker compose --env-file .env stop postgres + +# Сделали 5 запросов: +for i in 1 2 3 4 5; do curl -s -o /dev/null -w "%{http_code}\n" http://localhost:8080/api/v1/users/me; done +# → 500 500 500 500 500 + +# Через 2 минуты: +# → {"labels":{"alertname":"HighErrorRate","severity":"warning","component":"api"}, +# "annotations":{"summary":"API 5xx ratio > 5% for 2m", +# "description":"Current 5xx ratio: 100%"}, +# "state":"firing", +# "value":"1.0"} + +# Восстановили postgres +docker compose --env-file .env start postgres +# API переподключился, 5xx ratio упал + +# Через 2 минуты: +# → alert inactive +``` + +**Диагностика в Grafana:** API Overview → `HTTP 5xx ratio` растёт до 100%, `DB pool` — used высокий, waiting высокий. Explore → Tempo → trace с `status=ERROR` на span `db.query` (`connection refused`), что **отличает** проблему БД от медленного handler. + +**Скриншот:** `evidence/incident-2-db-down.png` (5xx ratio spike + trace с db.query ERROR). + +### Инцидент 3 (дополнительно): telemetry backend недоступен + +**Ожидание:** остановить Tempo — API продолжает работать, Collector дропает spans с ограниченным счётчиком, RAM Collector'а не растёт бесконечно. + +**Наблюдали:** +- `docker compose stop tempo` → API продолжает отвечать 200 (make test PASS) +- `otelcol_processor_dropped_spans` в `/metrics` Collector'а растёт +- `otelcol_exporter_queue_size` ограничен 1000 (default) +- RAM Collector'а стабилизируется +- `docker compose start tempo` → spans снова текут + +**Скриншот:** `evidence/incident-3-tempo-down.png` (RAM Collector'а + счётчик dropped + API RPS не падает). ## Ограничения и следующие шаги -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +**Что работает / что не работает:** +- **Работает:** W3C trace context от API до worker, все 4 уровня сигналов, alerts, дашборды. +- **Не работает:** 5-й трек (не заявлен). +- **Учебное упрощение:** + - Имена контейнеров `mtusi2026lab6-api-1`/`-2` **захардкожены** в `prometheus.yml` — в production используется Kubernetes service discovery или Consul. + - Tempo `metrics_generator` **не используется** — service graph недоступен (для уровня 4 не требуется). + - Loki — single-binary, filesystem storage, retention 168h; для production — S3 + TSDB с несколькими компонентами. + - Grafana admin password — plaintext в `.env`; в production — OpenBao/Secrets Manager. + - Argon2id — не ЛР6 (обязательно в lab7). + +**Следующие шаги (гипотезы для ЛР7):** +- OpenBao для секретов (вместо `.env`) +- TLS/mTLS на всех внутренних связях +- Argon2id (уже есть, но требует проверки параметров) +- Burn-rate alerts с multi-window (трек 5, если понадобится) +- Kubernetes + ServiceMonitor для автомасштабирования scrape'а \ No newline at end of file diff --git a/alembic.ini b/alembic.ini new file mode 100644 index 0000000..16feb6c --- /dev/null +++ b/alembic.ini @@ -0,0 +1,118 @@ +# A generic, single database configuration. + +[alembic] +# path to migration scripts +# Use forward slashes (/) also on windows to provide an os agnostic path +script_location = migrations + +# template used to generate migration file names; The default value is %%(rev)s_%%(slug)s +# Uncomment the line below if you want the files to be prepended with date and time +# see https://alembic.sqlalchemy.org/en/latest/tutorial.html#editing-the-ini-file +# for all available tokens +# file_template = %%(year)d_%%(month).2d_%%(day).2d_%%(hour).2d%%(minute).2d-%%(rev)s_%%(slug)s + +# sys.path path, will be prepended to sys.path if present. +# defaults to the current working directory. +prepend_sys_path = . + +# timezone to use when rendering the date within the migration file +# as well as the filename. +# If specified, requires the python>=3.9 or backports.zoneinfo library. +# Any required deps can installed by adding `alembic[tz]` to the pip requirements +# string value is passed to ZoneInfo() +# leave blank for localtime +# timezone = + +# max length of characters to apply to the "slug" field +# truncate_slug_length = 40 + +# set to 'true' to run the environment during +# the 'revision' command, regardless of autogenerate +# revision_environment = false + +# set to 'true' to allow .pyc and .pyo files without +# a source .py file to be detected as revisions in the +# versions/ directory +# sourceless = false + +# version location specification; This defaults +# to migrations/versions. When using multiple version +# directories, initial revisions must be specified with --version-path. +# The path separator used here should be the separator specified by "version_path_separator" below. +# version_locations = %(here)s/bar:%(here)s/bat:migrations/versions + +# version path separator; As mentioned above, this is the character used to split +# version_locations. The default within new alembic.ini files is "os", which uses os.pathsep. +# If this key is omitted entirely, it falls back to the legacy behavior of splitting on spaces and/or commas. +# Valid values for version_path_separator are: +# +# version_path_separator = : +# version_path_separator = ; +# version_path_separator = space +# version_path_separator = newline +version_path_separator = os # Use os.pathsep. Default configuration used for new projects. + +# set to 'true' to search source files recursively +# in each "version_locations" directory +# new in Alembic version 1.10 +# recursive_version_locations = false + +# the output encoding used when revision files +# are written from script.py.mako +# output_encoding = utf-8 + +# URL подставится из переменной окружения DATABASE_URL (см. migrations/env.py). +sqlalchemy.url = + + +[post_write_hooks] +# post_write_hooks defines scripts or Python functions that are run +# on newly generated revision scripts. See the documentation for further +# detail and examples + +# format using "black" - use the console_scripts runner, against the "black" entrypoint +# hooks = black +# black.type = console_scripts +# black.entrypoint = black +# black.options = -l 79 REVISION_SCRIPT_FILENAME + +# lint with attempts to fix using "ruff" - use the exec runner, execute a binary +# hooks = ruff +# ruff.type = exec +# ruff.executable = %(here)s/.venv/bin/ruff +# ruff.options = --fix REVISION_SCRIPT_FILENAME + +# Logging configuration +[loggers] +keys = root,sqlalchemy,alembic + +[handlers] +keys = console + +[formatters] +keys = generic + +[logger_root] +level = WARN +handlers = console +qualname = + +[logger_sqlalchemy] +level = WARN +handlers = +qualname = sqlalchemy.engine + +[logger_alembic] +level = INFO +handlers = +qualname = alembic + +[handler_console] +class = StreamHandler +args = (sys.stderr,) +level = NOTSET +formatter = generic + +[formatter_generic] +format = %(levelname)-5.5s [%(name)s] %(message)s +datefmt = %H:%M:%S diff --git a/compose.yaml b/compose.yaml new file mode 100644 index 0000000..ce9ed35 --- /dev/null +++ b/compose.yaml @@ -0,0 +1,398 @@ +name: mtusi2026lab6 +services: + postgres: + image: postgres:16.4-alpine + environment: + POSTGRES_USER: ${POSTGRES_USER:-messenger} + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-changeme} + POSTGRES_DB: ${POSTGRES_DB:-messenger} + volumes: + - postgres_data:/var/lib/postgresql/data + ports: + - "127.0.0.1:5433:5432" + healthcheck: + test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-messenger} -d ${POSTGRES_DB:-messenger}"] + interval: 5s + timeout: 3s + retries: 10 + start_period: 5s + deploy: + resources: + limits: + cpus: "1.0" + memory: 512M + restart: unless-stopped + + cache: + image: valkey/valkey:8.0.1-alpine + command: ["valkey-server", "--save", "", "--appendonly", "no"] + volumes: + - cache_data:/data + healthcheck: + test: ["CMD", "valkey-cli", "ping"] + interval: 5s + timeout: 3s + retries: 10 + start_period: 3s + deploy: + resources: + limits: + cpus: "0.5" + memory: 256M + restart: unless-stopped + + s3: + image: pgsty/silo:RELEASE.2026-09-16T00-00-00Z + command: server /data + environment: + MINIO_ROOT_USER: ${S3_ACCESS_KEY_ID:-minioadmin} + MINIO_ROOT_PASSWORD: ${S3_SECRET_ACCESS_KEY:-minioadmin} + volumes: + - minio_data:/data + healthcheck: + test: ["CMD", "silo", "healthcheck", "ready"] + interval: 5s + timeout: 3s + retries: 10 + start_period: 5s + deploy: + resources: + limits: + cpus: "0.5" + memory: 512M + restart: unless-stopped + + s3-init: + image: pgsty/mc:RELEASE.2026-09-16T00-00-00Z + depends_on: + s3: + condition: service_healthy + entrypoint: > + /bin/sh -c " + mc alias set local http://s3:9000 $${MINIO_ROOT_USER} $${MINIO_ROOT_PASSWORD} && + mc mb --ignore-existing local/$${S3_BUCKET} && + mc anonymous set none local/$${S3_BUCKET} && + mc admin user add local $${S3_API_USER} $${S3_API_PASSWORD} 2>/dev/null || true && + mc admin policy remove local messenger-api-policy 2>/dev/null || true && + mc admin policy create local messenger-api-policy /tmp/api-policy.json && + mc admin policy attach local messenger-api-policy --user $${S3_API_USER} 2>/dev/null || true && + mc admin user add local $${S3_CLEANUP_USER} $${S3_CLEANUP_PASSWORD} 2>/dev/null || true && + mc admin policy remove local messenger-cleanup-policy 2>/dev/null || true && + mc admin policy create local messenger-cleanup-policy /tmp/cleanup-policy.json && + mc admin policy attach local messenger-cleanup-policy --user $${S3_CLEANUP_USER} 2>/dev/null || true && + echo 'Bucket and users ready: '$${S3_BUCKET} + " + volumes: + - ./infra/s3-policy.json:/tmp/api-policy.json:ro + - ./infra/s3-cleanup-policy.json:/tmp/cleanup-policy.json:ro + environment: + MINIO_ROOT_USER: ${S3_ACCESS_KEY_ID:-minioadmin} + MINIO_ROOT_PASSWORD: ${S3_SECRET_ACCESS_KEY:-minioadmin} + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_API_USER: ${S3_API_USER:-messenger-api} + S3_API_PASSWORD: ${S3_API_PASSWORD:-messenger-api-secret} + S3_CLEANUP_USER: ${S3_CLEANUP_USER:-messenger-cleanup} + S3_CLEANUP_PASSWORD: ${S3_CLEANUP_PASSWORD:-messenger-cleanup-secret} + restart: "no" + + broker: + image: rabbitmq:3.13-management-alpine + environment: + RABBITMQ_DEFAULT_USER: ${BROKER_USER:-messenger} + RABBITMQ_DEFAULT_PASS: ${BROKER_PASSWORD:-messenger-secret} + RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS: "-rabbitmq_prometheus tcp_listen_options" + volumes: + - broker_data:/var/lib/rabbitmq + healthcheck: + test: ["CMD-SHELL", "bash -c 'exec 3<>/dev/tcp/127.0.0.1/5672'"] + interval: 10s + timeout: 5s + retries: 10 + start_period: 30s + deploy: + resources: + limits: + cpus: "0.5" + memory: 512M + restart: unless-stopped + + migrate: + build: + context: . + dockerfile: Dockerfile + command: ["alembic", "upgrade", "head"] + depends_on: + postgres: + condition: service_healthy + environment: + DATABASE_URL: postgresql://${POSTGRES_USER:-messenger}:${POSTGRES_PASSWORD:-changeme}@postgres:5432/${POSTGRES_DB:-messenger} + deploy: + resources: + limits: + cpus: "0.5" + memory: 256M + restart: "no" + + api: + build: + context: . + dockerfile: Dockerfile + command: ["python", "-m", "src.main"] + depends_on: + migrate: + condition: service_completed_successfully + cache: + condition: service_healthy + s3-init: + condition: service_completed_successfully + broker: + condition: service_healthy + environment: + APP_HOST: 0.0.0.0 + APP_PORT: 8080 + APP_ENV: ${APP_ENV:-lab} + SESSION_TTL_SECONDS: ${SESSION_TTL_SECONDS:-3600} + DATABASE_URL: postgresql://${POSTGRES_USER:-messenger}:${POSTGRES_PASSWORD:-changeme}@postgres:5432/${POSTGRES_DB:-messenger} + CACHE_URL: redis://cache:6379/0 + S3_ENDPOINT: ${S3_ENDPOINT:-http://s3:9000} + S3_REGION: ${S3_REGION:-us-east-1} + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ACCESS_KEY_ID: ${S3_API_USER:-messenger-api} + S3_SECRET_ACCESS_KEY: ${S3_API_PASSWORD:-messenger-api-secret} + MAX_UPLOAD_BYTES: ${MAX_UPLOAD_BYTES:-10485760} + MAX_IMAGE_PIXELS: ${MAX_IMAGE_PIXELS:-40000000} + BROKER_URL: amqp://${BROKER_USER:-messenger}:${BROKER_PASSWORD:-messenger-secret}@broker:5672/ + JOB_MAX_ATTEMPTS: ${JOB_MAX_ATTEMPTS:-5} + OTEL_SERVICE_NAME: messenger-api + OTEL_EXPORTER_OTLP_ENDPOINT: http://otel-collector:4318 + deploy: + replicas: 2 + resources: + limits: + cpus: "0.5" + memory: 256M + healthcheck: + test: ["CMD", "python", "-c", "import urllib.request,sys; sys.exit(0 if urllib.request.urlopen('http://127.0.0.1:8080/health/live', timeout=2).status==200 else 1)"] + interval: 5s + timeout: 3s + retries: 5 + start_period: 15s + restart: unless-stopped + + worker: + build: + context: . + dockerfile: Dockerfile + command: ["python", "-m", "src.worker"] + depends_on: + migrate: + condition: service_completed_successfully + s3-init: + condition: service_completed_successfully + broker: + condition: service_healthy + ports: + - "127.0.0.1:9100:9100" + environment: + DATABASE_URL: postgresql://${POSTGRES_USER:-messenger}:${POSTGRES_PASSWORD:-changeme}@postgres:5432/${POSTGRES_DB:-messenger} + S3_ENDPOINT: ${S3_ENDPOINT:-http://s3:9000} + S3_REGION: ${S3_REGION:-us-east-1} + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ACCESS_KEY_ID: ${S3_API_USER:-messenger-api} + S3_SECRET_ACCESS_KEY: ${S3_API_PASSWORD:-messenger-api-secret} + BROKER_URL: amqp://${BROKER_USER:-messenger}:${BROKER_PASSWORD:-messenger-secret}@broker:5672/ + JOB_MAX_ATTEMPTS: ${JOB_MAX_ATTEMPTS:-5} + JOB_TIMEOUT_SECONDS: ${JOB_TIMEOUT_SECONDS:-60} + WORKER_CONCURRENCY: ${WORKER_CONCURRENCY:-2} + OTEL_SERVICE_NAME: messenger-worker + OTEL_EXPORTER_OTLP_ENDPOINT: http://otel-collector:4318 + WORKER_METRICS_PORT: "9100" + deploy: + replicas: 1 + resources: + limits: + cpus: "1.0" + memory: 512M + healthcheck: + disable: true + restart: unless-stopped + + relay: + build: + context: . + dockerfile: Dockerfile + command: ["python", "-m", "src.relay"] + depends_on: + migrate: + condition: service_completed_successfully + broker: + condition: service_healthy + ports: + - "127.0.0.1:9101:9101" + environment: + DATABASE_URL: postgresql://${POSTGRES_USER:-messenger}:${POSTGRES_PASSWORD:-changeme}@postgres:5432/${POSTGRES_DB:-messenger} + BROKER_URL: amqp://${BROKER_USER:-messenger}:${BROKER_PASSWORD:-messenger-secret}@broker:5672/ + OTEL_SERVICE_NAME: messenger-relay + OTEL_EXPORTER_OTLP_ENDPOINT: http://otel-collector:4318 + RELAY_METRICS_PORT: "9101" + deploy: + replicas: 1 + resources: + limits: + cpus: "0.25" + memory: 128M + healthcheck: + disable: true + restart: unless-stopped + + cleanup: + build: + context: . + dockerfile: Dockerfile + command: ["python", "-m", "scripts.cleanup_orphans"] + depends_on: + postgres: + condition: service_healthy + s3: + condition: service_healthy + environment: + DATABASE_URL: postgresql://${POSTGRES_USER:-messenger}:${POSTGRES_PASSWORD:-changeme}@postgres:5432/${POSTGRES_DB:-messenger} + S3_ENDPOINT: ${S3_ENDPOINT:-http://s3:9000} + S3_REGION: ${S3_REGION:-us-east-1} + S3_BUCKET: ${S3_BUCKET:-messenger-attachments} + S3_ACCESS_KEY_ID: ${S3_CLEANUP_USER:-messenger-cleanup} + S3_SECRET_ACCESS_KEY: ${S3_CLEANUP_PASSWORD:-messenger-cleanup-secret} + CLEANUP_GRACE_HOURS: ${CLEANUP_GRACE_HOURS:-1} + deploy: + resources: + limits: + cpus: "0.25" + memory: 128M + restart: "no" + + lb: + image: haproxy:3.0-alpine + command: ["haproxy", "-W", "-db", "-f", "/usr/local/etc/haproxy/haproxy.cfg"] + volumes: + - ./infra/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro + ports: + - "127.0.0.1:8080:8080" + depends_on: + api: + condition: service_healthy + deploy: + resources: + limits: + cpus: "0.25" + memory: 128M + restart: unless-stopped + + otel-collector: + image: otel/opentelemetry-collector-contrib:0.111.0 + command: ["--config=/etc/otelcol/collector.yaml"] + volumes: + - ./infra/otel/collector/collector.yaml:/etc/otelcol/collector.yaml:ro + depends_on: + tempo: + condition: service_started + prometheus: + condition: service_started + loki: + condition: service_started + ports: + - "127.0.0.1:4318:4318" # для отладки OTLP HTTP с хоста (опционально) + deploy: + resources: + limits: + cpus: "0.5" + memory: 384M + restart: unless-stopped + + prometheus: + image: prom/prometheus:v2.55.1 + command: + - "--config.file=/etc/prometheus/prometheus.yml" + - "--storage.tsdb.path=/prometheus" + - "--storage.tsdb.retention.time=7d" + - "--web.enable-remote-write-receiver" + - "--web.enable-lifecycle" + volumes: + - ./infra/otel/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro + - ./infra/otel/prometheus/rules:/etc/prometheus/rules:ro + - prometheus_data:/prometheus + ports: + - "127.0.0.1:9090:9090" + deploy: + resources: + limits: + cpus: "0.5" + memory: 384M + restart: unless-stopped + + loki: + image: grafana/loki:3.2.1 + command: ["-config.file=/etc/loki/local-config.yaml"] + volumes: + - ./infra/otel/loki/loki-config.yaml:/etc/loki/local-config.yaml:ro + - loki_data:/loki + ports: + - "127.0.0.1:3100:3100" + deploy: + resources: + limits: + cpus: "0.5" + memory: 384M + restart: unless-stopped + + tempo: + image: grafana/tempo:2.6.1 + command: ["-config.file=/etc/tempo.yaml"] + volumes: + - ./infra/otel/tempo/tempo-config.yaml:/etc/tempo.yaml:ro + - tempo_data:/var/tempo + ports: + - "127.0.0.1:3200:3200" + - "127.0.0.1:4317:4317" + deploy: + resources: + limits: + cpus: "0.5" + memory: 384M + restart: unless-stopped + + grafana: + image: grafana/grafana:11.3.1 + environment: + GF_SECURITY_ADMIN_USER: ${GRAFANA_ADMIN_USER:-admin} + GF_SECURITY_ADMIN_PASSWORD: ${GRAFANA_ADMIN_PASSWORD:-admin} + GF_USERS_ALLOW_SIGN_UP: "false" + GF_AUTH_ANONYMOUS_ENABLED: "false" + volumes: + - ./infra/otel/grafana/provisioning:/etc/grafana/provisioning:ro + - ./infra/otel/grafana/dashboards:/var/lib/grafana/dashboards:ro + - grafana_data:/var/lib/grafana + ports: + - "127.0.0.1:3000:3000" + depends_on: + prometheus: + condition: service_started + loki: + condition: service_started + tempo: + condition: service_started + deploy: + resources: + limits: + cpus: "0.5" + memory: 256M + restart: unless-stopped + +volumes: + postgres_data: + cache_data: + minio_data: + broker_data: + prometheus_data: + loki_data: + tempo_data: + grafana_data: \ No newline at end of file diff --git a/evidence/Dashboard_api_overview.png b/evidence/Dashboard_api_overview.png new file mode 100644 index 0000000000000000000000000000000000000000..740d06ec05f7e0e0edf32bc0eab4b84eb1b9ca5d GIT binary patch literal 217617 zcmbrlXH*ki7dDKdqSB;DFCqw{6cOnqDkvaLL;>j#ibyB)E+D8h5u`&Dq)P7)I+6gP zNH0kU7$87^0HKHSj?eS1`?=Tm?_J-lm6dg7&dlty&p!L?eeG*LKG#vBy~=Twf`Wop zLtXU+1;r&93JS``%a?#NuM~am0e|NpFVr4WlnrvN0F4XwkF+0AP*lcKA6s1n+E?7v zUqdJ;=(_&?&LLb2Z73+t@-$Q*z4SF-!}tZh96veRGTeLkSTNu*3*+M{6-MvNVK=I- z^yP$BHOz<2jTpQ&asIhiP**$EB!2J;b>}7e+D|X>+ZSJYU$D7S6(M>>laaAUxea93 z+n<$YbN-ldBT)%!jbwK|8|AZbGKp>*NeY^1(RWrY{GRg(=?l)2$ zWbo1)?~I6y94UTvH;!BBnV(opARo8(R*xtGa&eQI8_86+LXum&jS;ppAtS_v&Q|oH#y+}2(QBh8Z6Q;C@d@U zzT#x*+^A<}HUP9`-H#jc@R>8lK+iYajMgGzte5{i&V`(7cJ~<=89Rq_)r5tGw~7OV zb7y9ZpFMjf>%ViGkB=`RO$&b0CFEE!ZjZ>ZeQd5hCs64d1F+4oXynt6wq687+;44P+E5v6b~aVZVATwUlaP0P*; z<=~uld{AyU(>h+S@?c_q)6ROw3ftfw8huqQtZ|o!CkqEP4_3{=J09 zuf-pEUY5uS(HdRt#YA1uD>s#YmS?c>e|1oWweu32tQ01EziE^Hg{ArLN4%pe@ zO=$K!Zljv#Ihtk4sLhHJ6@1W<8l>~}>(@#!UTmgTQ&8$wcPhr_`1qJj##_Y7%J~3K zD6jV4eVf8^_tvdj&E#3e*3%bdCzDTdq7a;t#>vr( zM~Wt_oA}*`D6Hjhr;O1KnyUmWruyqCbYK@2N^}-Y->rt|L4t!<_v1hG_$>ksPhI_T zUS1wtB-*NN>2ynj>tNHTe~WpFLiR{%2)(P2%=OIr&q>?T3$QZa&z}LkTU+f( z-acKwDR1$l>^oE;An>+aiu~#%`YhwA*5v+8bi?PT@;|G87wEc*aZ1MwWVG2&S1o3f z?<+)IrKX;)ga`=>ucwQ)50{$AFfz_;uM|M_o zIYr_ga@Ln;g4LHEPO8||Y_Q#S%PjN%{XK>(zBUbkI$O$3LN!VmcJw2DV{c1xy82VJ5M zw(M_nliCl`QT;J}@z;p`j;Bi_n9gTbB1%EX3lZ@#Mq{EacC=K+?G@4JI2O6}7}#Di zm4nh}jD3RSZ%G7fKRn-N(Q{JnLUBUZ-W@s0n;r@OeE?KuwGzJzsO))k$;jz5Q5XYt5xq)ds z_L;uldc57nCGW{%U(9YZ6f`jq|7FRq@SfERx)S3)a^%ihBmZ(LS#Bt++&~{6%ZiY@ zn{b|xvgt5tzj<(n%@aC*uKyK%)tk38cX{iRO`4D1`&6uM8W^7!j$$SjQu8%tr$4GXlP9hvz@E(uam zD35!AZN!?ivd@nigTLT5GJociHjY)Se%1Wgju! z^GqP}=GFB2$yK{ir+qnw1iQ)Pc^NJINYZ`ppnXwnAnHlP6LDd64^UEy(;>K7OH9av9un zzVNoV(Cynjsev7zkd4W5GIV^yW&-Up37W2%12vhlV4d7oSz1|B z77JmXucW!7>ndN+JN|f&IzV^n&~sxg>X8!Un+XGGl!xVbV7^l8r>1NV+A7A6R;-*( z(C!R_%G#bSh*7#GMrG)*#4{kQN+U)(U+Q}jTPHVhh1bc3RYIWY(0pgqN^Z#ui;}7G zFkzT)y0Ji$2anXRasH~rc6{1ob}h?y>*DB;kt7zcs+w+sDyyNtizCxx@jtx?Mlcs{ zM;{)9%0b7+A{9f%n2)rVFJJyP(skocZ_wxm+2*Wx^o1swvvs^_2x%zIHPGhD!il}Y z;jjaZC&{azs_IK+p*nzSmFc7P3K*i#5i@o?w*jSP1aXYzw3JrbiXIpy;kmki5k!GKm2&K4tvIvp~f z^T?i=8T{%MzQ<+u*J}8AUXhQI09829vi9Ku;!<*8y{@K+ef8KXI09x$hp>(NCUkQ~9Sg|%fU{z`K7qKhyUlY4GdAxeodcRE;lbZcTM_udw{_5!DsSmOB#58+e+K$70GLYn2VB7d3 zKw&p^&xCXgd)o9vL3eA(Tr$`(cp)XRU&%UWAVK2w(#N*IU&ko+mVrt!TTTVrv~n^g zkd(z=5>n4;-MTw}xO7ObRb6uT&I}j(S8E;3XlWrDSl6)-sxkPueu+>OgM5n~E1Y|3 zXOMiDpvL1~>S?Y;S{jfP5)f<@sjk#NJEiPT6w-Cs@f?tvOjYn&U8`z_>)3OkQ}0>j z9NL4(jdHEdVVdS(L1H*3oy9EU>fyVU?M3u~%B|rQ%|sllJ(9Jp$qT(zMM%LMwI<00 zIq0~Z@Hw32tRB2aH@TKs%yHv6fg#zVyn)s4CK-a+V{26p@LP)^yMUg;#o;=jDwc+| zj8S*@X=!}#;z84)yS0{2NF4WQEJ(m9F=}TzGBgRc?%_kDG~jyI@xTgq%-=Oi?;->8 zT_drPXuUeY*#tj`+?h-8g~rp{H6>lO*&Kw3`C~RhD00iew+Uw}vpZsywa4oOUw1>R zr8o|g7VeiLcjwE*8etnWlNF=hsMYt5Y5pmW%}+Uu;*p1&o@KFkaDQ$jRaY6xWFI$^ zx^#5!d+U*Xe>tpt%%a?^4yA8KTAIb%$;HYIZp7)TB$7@>2fU{SzaqUGlyAE?mN#aY zE|r=@t*16}>8Cuv$+=@(P`k@plD%f>TL&CxE+hWy{&CHR$0SdpM=7a}>O~yEUCCv3 z0Phw8kzwbdnGvEVuVlKKMQ*XNgGSM&xx2j7J}BbSR1;bToyV>WS)Yu6^fH-Zr}|HC#|Z&zi&_l}1Sm9_t(+$4sFV zX9*srC})Y;#H>-%`tHRhA2}g=k2nITpbW|zx3W7f2R7Snj!$mGB!Lo%13ZJ#xFD3D zg$QbKn|<}gU_($Dw6@Hvo8&E31A+$@5QVapEodhb_Mxw6vG`RCk9PV42YKwM9G%P9 zeshgn7^gEW!Rd4kevQN(f7Tm_FZ7i0o4q8HvwkiPq~sQL7)NzFrur`SjfxvTMsX{J zG(h5Q99R6!GgYCz0xX;2>xmFDZ$%sTs;gE`+_H&8l3fvsnAsI?q^rP34XwzF>;9g^i7LpKa6e@)3W zu;RpQhPWRga$YHJOo5K_@vke2KWw_lO$Z|ETvE8m8<-vl{Y)KLm|lLM?NjNKYl)_3 z?uGkPwgXl+{tS0{eQtvZeZtM0;Z+qf{9+!<=<%uXC~BFLLIpZIxhl(6!j@8j2*z^# zXv~V!31R(CWhNh=Ry}1VBj~b3)$V>8tGK@+w(qbqz1LbM3a)Kl_bizW8Ja(U?UWLp z3#|@Rk0G1Hn$Vdc_ne@m$ciS%4g()n*)d}55T@6paSud*zq!W+8}j%LcEz7Yn#HHt z6G6+S;)X7FJ)HlzHk65&eP!Pt=G-U);aWOooZp|MU##+2<}sgqm1V2N6SXmp&V*28 z!toBijZbMy?Qv&yddxg3#ifD7IOfF-k7ttJ-ybT0ugZC|+ZXX~jI6F|ckPyElb;3c zHc5C5WCU1HP6ntTrpp*`qU=N{u^e@g4&UABX5oF7B&q%*2t&O9}a-#YA_`bc0j7hSXijQ2uEkvlk zOb*V^cV1D`$11)&=Y!iN%+kGV_-n7BWq%!Xo?Lc8_>?mcG940S98he8qB)%G%YLo2l zmH&hIr*y@&nmQ9vTj`S0V)Br)OF7`=H6hsw#({?Vw?<8mpK-o>8e|~l2_@MDsH%!F zw$jpjI!kA4ZEZ;iQf}ftzPKDKFq%62IZ5D8n5Numt^{RZV4xzM;cvyTEz+)#*Dp~m z0+UO>Q^ec7;Ny_yS|P5{?E2T6Tgt_;PX>({?zW*-^(^h5>aInO8m<3GV8bQN3Aq1q z+JH)afybN<13Q|wHZ5<+_7zm!NqhS_N_8!*g@Y}ex%OWyqB|=Az+CU#xzn6}{`~o6 zbfct@4)a#m-ul?s7#r*48zBHFEo?}Q*}y27KX}S8KmQAXs17*`1{+AeJ$f|C)h7FT zE%)2Ihwln_PiJFbb4L~3ohy%GD?v{6BH@b0VHZejV{=O1-hu7cqNd?R;x0(~lFdv% z5o04PMba*iOl0ke*HAaSe}acpJo5qFSLCMlK@Sl1_^1f4?cO@c{?M(X3I-sV@F)9= zmY~{Ml#qu zd}w9YXuvfgF)o{)LQpC^UF7hq%+{t7t~sL^5R_>8P)ZcFbxaT)z#Kf<7*V|2|Fgg} z{QoY&Bazi~rt&f$@wn=*TY>&1_69n;vjf{`vlLF!Rm_D)PFx_)SpYGzFU8TYlfRbZ z#&{ccQztKmi0sRn{BG?aC&kYDH{V;WUF56TV)iScbV20Y>nCmn4~I%-5uI!Y<`0V` zN&?Z_bHm$y$I|cjs5Cd?GK6M%sJm1U{$l~+a+G3|x%}ewK45bzOxI+Is`aP3%7qqZ z=IId{`ZmrZ5l3dnZ&Hf(fnC_fPgkcMwIH73;pi0o9+L@Ho!OAz+s`HJigy)K>#_D6 zUM&wIGaN_X6%cO>z8ef;mQ@VZiKVrlY>Jw;Y%5@=l%4Jma=9<@vqXHx$fC!O@P=;x zHE}$T{t^f_6p;aGF8_QJ*B}ljLd+)`TQ1Ud zqycFmL}q)g$!zaI0oGwRsBP09YX*V}DJsT4Qp46=G7+WU;qddOpkZz|V@FDl~)_C9!M=I#`S{I5=2)J9AnulvQ_y zw9hS2Bz&F=+S(tco55dUrPo3PXInI67w`ORSbU41P?Nh(cbB%e`O6mO&*k_Jx#X|a zjo)=;UncA88UA==&LwSMM}dgrR$!O=<00?0Y9r$D=rS$sEy-%CTiv&`S*9oo%ZjW> zOGJ%l&u+G;P=V{Hd3kw{=$Gl+_tsId)2uS_rIIDC46x>o(H#*`rcjqP%0xW-Qohrr ziF!d%i!rP$K|HGt$aGy38_5abyV?o_`p3HTdoRFUr64**r7;~oY4qXz$AbFN7Oy%I z=k?Nb;!)k`PE$Qv#P!L5y=~1dReTqH)zS8C<8GW7((B9sGmYvtahVwZ%?XctBwn!n z8sZx~)<959Rfnf|Sl6HDRZNu86ot9Y++%C_w(w~&l0tHR$6YquP+{jCg4+)9oz zbOJ95B2hiu0r5V5_o(V*E-5MbDpS&qxA||}-JKvvmN?oMpW@cuA^h#GJVsACn_w#4 zQSv2~G_I=hXi)QRYeCc_16oW0TH$PW#>43}{%f3uXeiin()PY`l4B_O+sF%^noF`Q zqM7KL$zXlSOVnBU)nw&A!&IE>uD9(iMri9wt#SFU_8z8h&DSG_sz^?cfjyMHt=tK~ zye253@}zV}gP@fc=wk4NE*{RYBg|YTA7cybn{F9_|6|{gbEN}hdSgm1YEjoYPEv-+ z$-Z**6?)zL+{*V)^&OY1$v|Ojh|7dWXBjiR%}(lg>S&4Cg%r#ZS!p+53dwU7TlI5r z{6WT2ky@G6_)$H58q2l~09)<)6;hx1Qn9sub?zaQai`O^u-?qy{ z6dqh){KKUFVGsZN)BEF~X)9c3CQ#sDU}JluRd=vKYry>h{Ck&)ru1?sQ5oN|53(yd1;5^ihkH1)HRWvf`TFO>Lc%M}dGDdVB88$_ah*`RAn-E_}W z9KNPNes!KS^fkjjl@Zs?SqJ1XL595M_k*RwS~NNEVi1mAoYaaxQ4tKc{60GN@Y`?? zVZF9?foF)oWV^h^D$RSRqj$rX6{b37K>s7=Q)v8Y;b6 z+3Q&}-c@Wv2DS2K4^}5ugAmE2$#$ZUF3P$DvX{)|^-k2pQc3#Od!u@&f=jD~uQAln zG^8t(T(-Z8D{6%%JY9>&6Rl_!GKTKx?l)FX|26Ki;?P>C$ikVqZ?-)~3n+|4j+8dr zYX%(h23C}P>tMMAl&LRVR8TbX@d#zbnrqv}uP93YjD{FYzn%5Bm$KFQXx4BzykcWe zX17I6mFeLW78YJq_(qEycC>!t%V5DBmvbg1BVoVigm-9$L>WJE%%bG7^&`t}<0eIp z8#;Jx29|G7ZU6j8@VV8J%hkl7uqhSI5;X9L0;~EIoS3? zOq8BoUZ>VeD9o0deuxjH{WAhUx*HtsVAS`PrsG`UM)6T9h6>5fo4*F!>sq~B72r%f z(#?KAHA>6fpTZgC6Xh|%>%J$0cS5cH7V_9bn`FWtRdVB-f`5sU{~Q?PAnHd;Pkzhq zHaaP(#VHPkM2diVvdGF&TZ&FU?*cx3YShGScky+|n%sIk3^GiiY0)-_!W-|Gxauop zgKh+DgwuI7x|^0c$l%Y51Vt&d-jbc4@AdRVEvl=a%|a#?*~#xtErsu{z<+6AOlN(A zLNH<~AxpHGLTbArlRZCo11l2D=H;|{E0t2Km8YnOte)vKkW|!k!B?}2E)gu0_OIiD zWgT*wmKJw6#@$_LQf`#yMKc%zG2PVHuRuZ_Ky0i3bhFFL`gQh}_Gq5S>x&qn*aFyh zF(6$j27u*B%Oc02M!)c}pF<#eCtS1axQZ@*q$6$6Cm9U|A$_udQpogI$3oZGkq-g* ziyh?kzan-*1SLN-5u<>JOw?gsd&(@jGR}nfWP{Qx7PpsP6-$4uCEARwH6x5n^s6p3`TMrTy8}TL8&S6gitY;1Lv`!i9j-!r8pr6-LE;XNU4|0DEj{U7Bz*;c znkL^6sB35xcyx*wH%PM!M;)zuWmVVBX2>^+RoK!pduGa~#l_JN#ZIQ@O3wQ1V>SQY zNiD>b2&2vn_VHgjHD6z}FVzbt>ksW$ELkeg!npP=Q0R_Q!yr$8 zfi>wrKR7+x3TbN!y9{o9r9N`~cql%i;On(=TbmD9_onm`0ci>KlYjsg&)VOS?FSsCeN|v-ciM0&g8CDwz zI@iXViHTH{3HI z+Z~2aWu2O+cS`e1(`>cnAT2XS-H#)$D7HECu5QyJy4R%}6uc)+ykLV(eq1C`#E8{> z9=t?+dWvk4nXIN^FCy9X!8(iVUSnEEpMX~*4>%=uZOCmoFyl2r3CrZ$GYIn0I)x=1V-r0I2?2< z_K|}FnE~0jUfT=tdogpO`Z$u9wXs?P!{NjRPypywg0d?Vr*(DB2{J)DSChACwKwXA zfLN~j3{F-JBHJFjyd-XOZ-nm#htz4&nv2J#p(liV5Isgdu_Plwq?{KdMlnfdL$ixa zTry%Gir#Xi$Nw@*#|JoNu@dFk zeuN3!DeR}dpLl!%Vz*JQt*&=5`;XC}RZHEXAKE^}`N5cl&txoOz1TIxl$03(FS1_#wB-K=dDP`*r5me-iedH$MQ^kAb2q| zvk~qBm+EYZke#;LrCN(1n_yfKD3#dg9^*H5eKHM?K2sw_6N6pMVcw;F<84q0?3We! za_3ca-p@wO`VAcipaul-i$v9os*|!v_ze6I)b(`K%rF&}Uyw06GCJU}BD`djQib<< zre5uA(j+G;+RMeBXxqAR4q2z5)0Q=i%}k!fpnV>?YRbtVx9zq+#(YvHe8-#|A1{yp z6l!dQ$+`cDkRWGnkx2ZC0A`@)UR^V_`D=1A<=3wZe{i^S|CbHqlLB_)R9B zy11y}hl!*mPd=xvCwz`{Ls-@>``Go_MQb3>6iL78nl%J==W`0rOau4^Ar>-q%E6H* zxzT?)WIY!PMY~)Zlbzbm?=j2z94)-QTq#`n($zol%+WH2)(1%1KEy`jmWOj+zB1sb zCPWBGSfgno&1c?=4cF<(_Vr*}vlcDdI@BzMx=vN%5>8+?=0F-Y{F1&>(JAjLz)UxhI@w-C^+=b`K%+&R!gU@l2o) zn?2cnX<}X0d+k7u*6A-r;7f{6=-&dZ-GK2#sRdT#T`UW(c#Fnk($H~&>#6j71GR^k zQ4@n>1$(oay~0`d0u7?}GxZ1nzPTLnpE<}^yNjxdG_R_e|A%yA%tn}-C*K&6mi1Lh zObL$)c%iSa;_fanKR*w!yV$A;N!)X!?vOw4Nda9wd?{2eVdzZ zpQ4A>HFsGK7kCwW`sj@fEGciuemgwRNufRBp)#12JnW&eAS4FNg|2)LR{-HMQtH8n zSNN8T(Z()4X@92}CnsB9=B2uawr>=tGRP*@Z;X57K1to&tQKg+KQ{!>vM2fqRgRU8 zn!5iXg(XNb0K~Ry*V?zhhM56DpTUYI)dD^rQe7*`YqYh}2z7j=wt zVGg9rgJ(S7(K4go_%WleIb4C0HamM|X?;vQPboQXH}Kgz{I#lE7>T^)V=C$AZn=3C z7rHX3z8PBnmzb1p4A9;H66BL7Pj-Fu7T<@qKkV%4Dk>~=Jt}I#FuE#K5irTs=5A zdhr=*;re$<3VNH`zQFa7u`Kz{kIxtM_1zX1m$Cc!Kbj<^g@pycFu8gA_6MK{4Vbm* zd9MF2{juCQ-~tuZsJuW#R}>w4^#T{5llNC>X}g(u1}k&bu3u;VM^ZU@05bgWDK5XE z@WaT+3vgW~08Q>K|!)2oqq&jU~td_X7_*X z1ePcNBG>)@zZ__dW9n}WJ_q;w-#Zu*sK1o|o3VOxYss>VswHyeh<(JA6&szkOmaR0wZs?cvcJ34TIM)lM`eHyCXWXM18~YiK{$CDiTTPg_tM}Wk|F@5 z2cEe;*L`tc=MS$@bX&Z*xDdJ>%jB|D8^MW*kQS*7n`CrZAYPFnd34eqkPm=fn$O@G zr`T`VdmaNEXmy&s?-mW^K~;H}G>-O^lkoL(G&n^j-0=Yz|FCt9w;wo_mhorkmoJEX z|6i|7|0LWWA>41Hm0Z2EW=q-7YC=WE1}nE-AYU*tb~zXu_2@#3c<@gNQGlRL4eh%a z`Awjk$Rc23rV2mbp7+VWV6bl@t$ zpniF-O{JYs?Xf350SxEM$f!a>25dAHZSy5j|4mBfoXTcU+#pN4(x~xvAH+`YA&;loTgExbEidNsrnob%X<31ZyVDY zq^_U)+$v}x*gbhst>4b*i^af+!hcpqLbR^_1sSb;w@&T()Xpwpu{+k-(-t^j<{t0< zW83L3JOF~4pXfd$uMyz?-eUqkwb1bJ_@q?Y@FVrhpPMN)09UcvV|;S2hWfp5ziO)R zahOt@o<@O2@9oO^{=)Ap?ZOS`o`dUta84UL$^st~9G7J2rAf$GxZ$9$AMJYcdsU$O z$%j(Ab-#dFu8beBa@^X=;QlHi_W~?(2M}Z=CrjInUs5tdQ;hvtgD_gSrLf@xu?^ev z={hoNWbv5#V|4g&U|$UT&F#d3zr6hi*HK;M?r00w%2N7t{)U9i%+6YUyHF|L%D3Z_ zPSZ`(*{+22JN*2}*&Hx(Vj%Fiw{6{aP)0xXBg&;^^wh^)L&DFG+=E2nYsB%<(6+QP zm8)Cyp0uWH;heM*mt?pO-$%X&*=RXkP2Q3=MU1s`Of>}SU$o#V1*yAN&Aiw{f~7J` zq({Zk@nzpzk4cubm4(3CRgbp2N{v6*0>c+BX+wkgPmbtr$jYV;WXM!OCcRtFg83I0 z7lAogK^IXg-LIZ*geY9Uz6hV@WSNQW$St=X+q7DsVbf|;4qDFUc-JTpfBfaB4VmR5 zC)q&id#B1$%D>+rK|21(B^{j+MKAEvOcd*^VA;=-V8^88`Rsn>=^}HM%d(6ueg3Hv zUGA6oN`I4g64gBR@)lWzh082tif6zw6$$d+<(HO@^CGn6=HzsyVs5HFeVR2)6wuYO z5_D-eWuY)AHSZv6V)MV{i(v`r8#}3 zxCgH?95?s3x~X`J`=y#gJSbn;O=6(~6CV5$Q&DG27fjNl=5Ra2UCuj)8xf9U`Fx2p zM_Wdd6v%kbxqYKieXTM_En6`hl_{O&h2Y;84uZZ@i)^~X~p6%nx zJVAnjO)fJ5QI5VYA=gi=2Lqpb0Q+4+^dmdFI;Dzv;Wv7wroVvYcDR|le?{iKG-si=deU2uUL6yV)%cWON0no|pkmALQ z(iF!hoAj3j3tiqQGL*+~%6uQ*zoC|vHmwB>&Xt&swan3 z;lm5SCn-$aYtNPMu+7xma{R6CFC^bTA@KO4BQ|?1i7hPl^5FrV+nB6b`Qj?rGk^L{sbcE{a)i+O?9o%6E$c&u`G(>1-IP*>$c z9)##mxyq=KnHxH+_(W)mF2=Cxn*2U5@;Bef$~1q5i$lUoUNll7h1Kb?`np`^eAlJn zYBgyk`MQFya`E8^F5{&-PWZuHvAmWu?>k@0ZTj<0dY|p!$e5^gq?@^+$f+$=7Od}C zuiZnG@1383C8|DN@-g2KYskEIwZ$t6a6|`*g}xBF)NeNJeaDLVacd>?0QKqhwqM8ziYLCFKe8e z2|o~lVZkf9^Xx=o=3>uzvRikwm|RFl(O1)FkQ`l z?MNzPkE80|Agk8If}GaC$_L`RS55;yCrVB~T#8gxe-r`M`OD_2Vf{;kmH?Bc72~=! zNI_X45E`&0Nk#xR>jCjGZu)jrQm%IH_U--xGmop4mF^4NQ@Xu=rzJXoPv~F1D~fsU zH6*~#A04-n1#C`gz&7>%;^E7e2EQd*m?|r`n3RvF z%D+-Hgp(&YsC3i(r0dgzE8n*K^{F5;;q@2O&3?Hl@2(zTKP^UNbV|HepqJlxt$b_o z;m_M&62oZxt}m1wX4?Lg2J`maEM!Wt2vGoE^1M0C924RuDbd308a)wz4I6Z+`0e zaNGKY|NXVqX)W&M3YwpDVv-I1ZZb1ZRTEY2WCUzN{^OF`zsbg-1 zd=Wj~X*4jqOD9}(ZMI4ucbbmgMtW)7xDUus=xt*v|CLbQ_sch*aDjo5=ZTH_wK-k& z!bRVRDZ39u_S%A-xdLIm?h^4yO)gz$g{iGcGA8 z2Yt-TP`Y3X#K*>=kK|O=D4jXSQ+)U;Yc212-(8&gGmq0f)ppmY)JM_=G*Xh!y}=6- zO{<+r2of6Z+Z3k^<*<6H47zs(q*5dhT-u~wLw&Zo80ngaIjsUKF?%yto zph zG4v%M&$ckq$oMPdCh3*|5cV`;+|hu9sT=*}wW8|b@t`(C8d3qD@aR&_2;~ z;vt0%s*f_@h9z9%*4PC2(k1ra+=mD&kDnEH`L9kJ)R!#YjVoCQAP|d_c*4~$D?Tc7 zJ}b>pp#KI|m5XY_{0ffpQwgL#*dCuea5|Bna48n3R1=yJO1q7z`H+Gor)v`otIJ=p zHr2%DYPTCpuh%v&CXIlvUCEcOk*oc9%T;6{+EoN0@J&VL1>>l?wUP;aQ!B$oL=UDW zoftOC{#!a!$wIl8z>B){mOckN<=FE1*;nLdv_5zy_w60RJIT+XwtEDQkyz~+WWy6-qF?qutfr#1Mr=XD5+2glM3xR zsvW>%iuu)1oxnS4FqO58>cpuuG@5(Q;0BPiFd=jWfoKWlO>|05KBqnH0e(Jsjp7t` z3<0xTe19k)RN%G_n6?4u2K=aJIa_1)-HF(_FQo6^?m@#k0|D<`<#OVaWE6g%8_4St z61tmqu?Z>l^Z@lkKHul&ZP}@HWvSY_tY=%hq+@jJlN$6gFO^2VasO#@GTTz9Fx)_jbWRmhfhQ$PfZ-@1Gz-P_xDoMDoY|MuO}ZeY1^GXC=@$OE1lg%0Z7J8k4j;& zx5r>>6KZ<>)Ot~wZ`LS*=!d#aH-BX7f3BOYD(+ z#V3r*UzipjL=ozwp?^*sr{0>p>gKrmj3Tbm-Vd_{YW4@+dZ=zh6_EafJ)rF{Q<0p{ zW8GbVg>Z#fzX*_H-F-TCt?3t8KgdQB>QokxSoEhIUvgAQ(<%R(jP@qoWv%%0=Vo@m zsRj=jr^3w2x-}m~B%w*VRo2}ef46tY5Xga7t*6p7{LjoaEje4Y%<#)<`zH@iH3|gw z-(uc7XPL>9>d`Vp;ODByZTu)u7lmzGywv4(^R$Q_uq8!E|B?Uz6%HZ zn|qp5%*saJn2qEIL-7#g37bc%OD#OxTW403 z!|6^=&hO|}BpvR`lqpcSRWREHo6CfFM5LWg@P5ZibG`hF88#M9H~DWx?wi46f67** z=bZ(960!(X*ab5nN9$cFi;rn+pFV%_E|`%&xyzkf;L{O|_(z9!A=AzI<-*=CW*3(xhZv z#4F(A-=NR9hekH(kS2GNj08hMaUl?f8+}`4i;8j0;6)*}^yhe4)SCEyK3W&S*l~lJ zbHpy&)cWWuU%$Y>g5$c(C{YD`4owD4JX8m7KnB*^%XXb+YO=L6yxnWAKBJ#GH6Pjw zAGAFQ(yj2)5KC=doa!DPE0WAQ z&$)5_94m*(&z=hZR+A~?Y!UP0Ce)1&>j4^&n&%E8`l-FM=k0+2E2}AYrplHH$o$uZ#P@tdO{H4=ux9ZWI$DK4AvOAal0x=nMCm8KFl>P16QKy5k zQRa(rDz2Nr^_0ctOgEKLDw&N9@X|(b?E!!{naZ9xer9%o3w=v=Rf?&-?Dma$76TSm zdnlSH4?~&#&A6a(Hwh;FO8!RYS!OGO7_exN~XnkR1q1B+@$5 z6!7*g1xemTHg3xxh{sUS|l564Yz?T&6I!bH;2uC96SV^n|4vdkEwMV{THSSU+}3!QGk}G zdDUqOz!9olVG4H*g9a?JeaCQ>m9&6KY-hL8mek% zD=s>&Qg1x?x_U>mr(+0_VhN>4VPQRYpy%w^sAr;!j5XFo#=d=f*=_VM$oI`5oKwTf zZK!>wiG?$=C?tmz8Ei;Fg*20yU54>{l|KA(lT%Fmuk)3-D<<}*D}Gi8%{R4K{vZwG-Zpb-2px}zfZACkGOs5&R$4I_0ZY) zdX4W_+lkV*5-%983QXcW)UM)z|j@ zgOp0CfHVjSNQ2bS5`wfcD%~aB-62D_bSWj$-5o=B4?Uzq_mKaMzw5rQ>%QMS$8#Ld ztN(f-F6WdQ6QqpvMflk$n-Wa8w6I?^m%ty_Hem?9VFy*19x0L0milcXJWI*( zvF-3ifsaH-?Hx~LNLG`9l8RVTHq_N!lk8>4gj}Ikh#JP}&RYwVIHJAmbk3;-SXBm` zNY`vSVMvkmBhKEFP*Eu8T0+b0gXH7hr-3(*LumOK`<}5Buq&u@gH=IYUGFRw8=n^X z&fPozfC(+3mvf2N`le5Gn^(h1vr8w0yoK}~oG4{B&Ns6HzXsoVgvjZ!y_(xJ} zrhS%E<+#vw<*_tm;DSB=qYZAz*TG#N_!Eyrvgyb&CBu1m?}xkN4#MX{hj3_EFV*Ky zaTWHPPH(s>{^kG7|MfZ#P%>Fw)?J0K_6`heBo~y>&Hvaw9MXcN#luIp{XaoZGbLb# z^@f!UyiXLb-bF7OJn4|aq2)*KJM-vjaen?Fk6&{#-YQLbdqz0z3(>m?bV%$xTvqB- z<|S`ovgeZJCdqP2szO5T>z_Y=GnPEebo5}j3~x+jqxU{wgdfzT%-}y64{xTV{RJwI z*-xu)s48X_PKv8ML;pl%fT#G%bL2CQ0^f>8YQKv4xgFUHx)fAPf5y2RR>24XmUehK znN)gWBv9 z5=rr(jzhFeVPVWy&onDzs{~ngIhEaTXlZI6Wc=E5cr2{&(UPNAxSOM1M^JnK>2cR< zca~ACQ57G~TKt!FdyK6dMq;D_$&Y&xoa_y$}`+j`OF!9pfYGTJS*CbK{ z>9o#webB*IIPdoOwJw6MU#+RA)mG*-8|{<*@7kbpSp$K+O~JYp+=BQDyAG>HQkW1E z)0}}b2`~(YM~?~<#4@J-bw;=MTj{cML`Q!NzfAj-0Z8cpVbq->a=OJ`c%=~ zkSSH6Z#du{VPs=8KGd)#sTi&chBJ(FHgN%7>dx-&=*2Rwx;nug!O{%C5sd;6HDU!e6IV){vPPGyd=!-fyZ^?NG=1a$Pg?4e>tN!$UF{L1i+%# z9v+9Mhh<7Ap>k8Y-J1J$WO&}(?Y{cdxi|e8d0(#TE9YKh#%FJlQMLT;GfmIC-Go+p zBV$R_`WGYsc?Az5EZNi$8-)_HO`|Yp?R!0<9;J`AwokE%Z_|kGG_3Z2_D$*BoNV*m zPdtQb4W;UbE$hHM>^>R({T+sesA~JPd&I|a0pAnUtU9+;dEsmj@6Lc<;XF)rBrNr;kKe6u zBJnlQkwj6ueMhm@aX6osaeYgwb?U=$cm5Pk>eIwOtDeTgU|p6MQY&B$i=C*(I^ zTQK4yym<0fuXTSj3qvS@c79kM(e-qP{B2!b2zcs{#{vwz(AAMkdXWKyvrzG0W?Xc} z8IyL>GR_b9oK>D-A>PBmAc>6*R>mY`5?4$S5t)3@&EdO<;K_; zziBmC(D-z7CAG`Q$mD3*F?G?!vlpfCSyzg_=T2$|20r5hItjq%_LAD`q*?FL=_A@V zjOkBwGOOeK(4c>)zBD|2mLP8U#OCOsE5m#OPRM(jYK0pkvM)7S>(KL$GZw>4DK5fV zB`Xopri9imsqb{ix%`9VALp&UZB7wu8D3mAJs%Z3krvTDz!UWQ`91>sTS(U0I-i}T z*vD6pgoY&cfJCQJbTlL66=-j70`uDwaZ)2iSFwNqakYGdpAFp6p*qlrv{~=g6k}bW zs!uDb=2h$Z*5yn>qth4jdo@TC+vN=n4WqeiI6z@qz^XYCFsAiz=mDZj3v%g(n=~8{kV7?_(dCs}; zK3Y6J$2Y=Q(yb}S!!waMn8;~={G+7-hiT6rzl4512w&s^d9fTx?Iki)<^x1b2Z`rP zWkNWPOJIF6k4w7d5QHfEg~yu-*6w>^e2nb_I`k?WF9t8GlS!|xu@o=t7W{PaQf;Wq zfSKy4sp$}J?Fudw1={}2``pXM)>N5>pU(!o1d1qePkndCwZY2{1RpuUl57wEYKcvl zMl1&^NSzO0LYGvl+`2G`DFA;(Cskq_nTOiJQH3H9aTN9DYJxmJmiiOU)`lz1v!PDE zF06z*6i$A9u->%B&xVRCz4@vZmE%QIAm2X7@{!_EhY|PFkWFkdht!ouAjE+Yk0ZpV?d5 zoHuJf`T=kVvB+NutUuf)HXYql;jyeeAC;ANCgxVe4YB*;;s|wY+K5wTvL8272`7CK ziC+$6{h()Bf(r02>I3rp2eehjn@_%#MB-c14R#Y#dw8(CbcA&yia9kN(ButnzOF?* zXo1MegxCeOg3wu0Z%?DVcgJZwD*9bV?!lAj(5|}2Rz1k?Jby69Zk)>35tBP0*j~}l z+o@mVTU3o1L~;qyCIf`g*!RDcmez6TosC4Yl3h(~XSHB>25?!11>cNF_B?auy6qA3 z)Z!w$$NC^U9Jk6N+~ul(l&|amj-y-T>UtOCQhsO@={@8D*3^fOIN$_9>vw0pE7p9- z7R?D+-@h7KriZ+qm-ve}!$?3pOzV#J9s~i(8buFmDliLzmT&ttNv|4{-RxJ+lm&3l z!03=hujBEHN28xaYV8+i3cnjDs?pMNNXy3GNBy9r>e@VI$9vjk!27BJWl@__S2OwE z!}+hG*?MOAI8WD`Suur~|FecnU0vT|RUB!B@Pe&?WpO2h+iajJE~Q{+8{4jgZiV0X17bA5 z^GQql4`svfC;rds)09tQW(ngL=%2ur#W{iM9tSite61sl-|60b(AM}y%H?&jx(^Sn z>&s|@X?(QFWcy+>)b>Op$QDw)O&<5^Sj>_34Q58jZ4hvsl_OhaGyP4lZQ~NH*K#=;6nMh z*1Fufsi-0mmd%msi!Nkax7sdS?Oy@E9;N7i{}ftnu(#5Eh5W0G{RBw1|N0N`mo?;X z9|Q0oz_|GN^JjQ3E$tBjz|FnY)YJg7F2n8vjkK$Q-G7;>I+S~Yh?MHxhYwNrsF4>f z@DY%3XfXATq3KS3&Pcn*C=xiHM^j32m9WiUm+99Adl%5`_aNid!| z-WRdQa5sV}as?&#aLSzEuLvHzhC}7URNJm+Bg^^{w|m^ElsrIzt|jDL>>s!?R+?<1 z(-9lry4}KF{#t{a=N`A}D{VH59;dqprG8z8)+C*zsDxu=za!~8X}BW5BHVRLP!S#C zd0zV1csZ^PC+r+jzUy((r>wpq{S`Y#_&dLZ@}uIJ{_=$96>W+54rGD}wv^&&1O*|W zFD^cVOJ2Q!LQu%%l)csgtGB0pokTrDTO~p?UN0$M@*6r_numwz-45(hR0Qe9Y}CC< zoGK#UWKX#37jm(Zws~Qb!Kw3iXlEmAX*@?oIXXJKM}>Y*GOO18F$d~8(2qQPn&Qgc z%a2@4K9xjqq8Wa@bjf63oOS)lpIl*)b@F`4nzm&*h_kL22usn3wjks2pO8?<>e{^i z;oD77(E35#AMFwD*{9_^*3!=}d;<*#o-IVM-O$^g+gl&E&$k7D)_IFszxbjD28=Dw zmZd{|FtN4YK0rg1q!5!KIPq}sa?JM`(}%ATdruU~CsJC!uo`W4ey6@gy}iJ=Aedys zmI$j*JjroT!0TpjrEba8y$(Z;t-0kgJYC(7)cMMk=0AsH$O6sA=g+Q`gYFXtSDdLC7z<)HWHp zW7PN3J?RKSiPQ84)o)iR_-s`;vH%MILP`KGGC}j0ni#|V|3EvIl>Up=*Sq4XUq8b<=G>GWx6kB-2Sdu-K zNW-f9&XkeoNB+qm?}n=6sVqZ?nc2`@4*H?Gw*VbF*j`ugs^D5?M~HB^EWqrj#q*nY zp*xe?@-6bmX5upBZal)_UF3xF8=dA`=#D4xP-tb4am+j(TsChR2j@&&+W5CiK6&_!toCLzGDUFSu_k>zZ zLNox=WxtR0@~D~n>TRI& zI`*641SAuTQ8&yrw%pkaVDDQL=S3H;Sg8|+?`R$=8e5fkK2cQgBu7NrKq`kXXI9`C zV`&ttU?iw8?+}0EK=O^!~@i!tjjI zaCr9cXZs{~7;YG~Bb@=}Y1^lUq@pWDL6$aUtE~wgTg2eBTEAo4{*18`(S-2xeV$9q z`f8D$-@_5(HxaJ${Oe}jVPvvqNcAZJwqZ9aIp^zGYuLcXbcMCiDv^qv>(VQxnj)hT z+sVBMcN}a_9$}<9PlekC^Az-}SnJ-QUQkR>#?5 zo%94%%a1bclcG}U*5lIycIV}_H8p4fxwfs?D#dr2#Rb1{EkOSDzWw|ZT|NP_yq5ED zJ3OtSs(#L*hIrB0@1LBD1A$s7jV}s36@RS;H@1f=@M-)}s}8;nzYV(zcO+ffv0++R z7BLy#_@T2Xo6))+XS6uXZlVR9u`2FAl!{HW9_tyBp#_#jgn?b-)m7ApmL<7xaFTy4l#(`Iq!yCZJ#O%NI;V)50iWXMjGmq_bU^=;@hb)|?pPyw39KPKGXR@R{sNB*fe8&U*p0n{2DemL>NQ`#IE?i|A;N#82cnztx~z!$1F7_ z+CbTy;ym&}qdQY9flDZd2dSZBZ2bW*zw9=V&qBXt#i!e0@CO(@wMT0ZKZ05?$NiTD zEK-s4#|Ml4ic~}t7)!OP7im8tb7IqtCzsA8WMaw6Lwbu#X~X|;YpkxD3-I5R?R$s0^6p|9$sbc{$~}=S``M`kQ(Kr z?VI|Y{;v~t73npKMf{~N@vn&H^*~^#wv^PGO!Z#T)dtL}=Mz27(2Jig%Zi)qpj~4dFkEoX_z-tagF!Bm z{d&cC&Y9QtGG!X1&Epr>|K_W`KC=cN1^o*qNb8i=LH?{*(IJGt_u?JS%h%c1w?zaT z8H;iY7g!6d$CpU3)VJYar?4{ok_pxNWTm%NLB#iy0wP&53f%Gp?C_ zo=`NBkvyWNhHBb)GB1|=uHljxG;OMQxW;hf@J&z8uZrK^CVhm)`l}bcfRFAKyY&*O zR_J4^T3h3`@DFwy&7B!0cyv7UaU&lHa(@xNv7@(f?Kbtg*ylxbH0*`77zvT)zIF>I zlc;IcSFACUHiL+qSS}?OPv525=6l7(y>-whOS{xkWIt9GfvKM_7xs4|g>FM18Fr-{ zFp4S^T(B9QQ1@Om7tNl`s^>uh7Vp6Wz_J76RUnOx6$trxunn5eZ_7A`+L#}d`iH$W zR7+8u1MauBRuuE!E~Y*>%|#|gENpXqeQ+bed(evs16NxOxE;|My)X5dx(H8W$$Bf2`U5~ij| zh~hWu3XjNBO}zBBG_>)D^38s>H{%a2DP@;~t&zH?URy#bc^kv@40M4bQ$G^h^|u8K z3DacF-@pI5{)w+)z%4k>noQB`RUFau$Zt#Ha!j0@gz>UtZSWL^JBle>ZYP{dF|Yau zh58X)M8fBz!iKssIp%7Q+T>R41>81VD1s^Kw_T9@p7_QxW0BLiYE28)3!C;bPU0Ut|NqHD|IUD&q zvs+kU>HgQ(FTIb+&Lj6_#Ix6LpG1#AqR|WvWVRIZGH=3{Hj86x;UV(!xy@lzQ?Wt7 zUHv{Qy^u>NDArbRYqo3)Cs-=adK2zs>3^uz;@cFV<5dpjD3=2nHB2c#Pm&6tsf`|S z78ozyl4v-X`k*GG>+(QmJLzQmNl){jJIIuo&*3?rcCwfQ`D@Y7a=^h|0jDg_5p4j; ziGSR;@h7Du*V*osZ`Jyzi%R-jOERr`x(}B(UydwclhvZ&l9ac@Ywy*s;=!bZGO$iX z!;>A!ngBJWE<|Xp*Z~w3{zmum3Tg=-jLgW^_su(mgfs4$Hs%y zHR-!gnAzO~l2iyMBHK5a*#4K<ZTbi}PE%@2Oy6Tg+EX zZIKvm@S_HiD=KKwKTBN`0($vefQoDriw9C10YlwcSG2Cd`RI16W_MjyHl$auv}Ny` z2sJedz?lbyhiCmP|M|!ZJ0s1WbpGq)I-bC*3vi<&BjmBA(xBYyh3i)ucUNT40+hnG z@R(;F>^D6A?Bo)gz6M(YE&|P>UgBb9j?E*YBj@RPJ*39H`$9Gk(y+p^EILFPi_sII znOGa64E!lm278%0B`mAg_!Z_*w;=cEHc{`WX8)pNyt<@`nfGT_YEqU98*Xd6x4cqt ze{vfasIADMs;BtHBs(~XFB>=E>}!XSXGh(@l04%5UH!7u5=c9dqL=RJB#S0NJN4$b zaZZ$n2Mk%#kKZdo*%xWgKpSj6b6!c(^Z<;>GWF-FXLE@7T0>`Ii26cdR4?V_Pwpgsjsst^o!b_e^bQpl%aWj zJINrC|D4`fk#cx^iIRcCQ>aFss}L%uQEl-Ph@t>M&F&2WZ$cI9{G-h4r&D-HcsFjI zHQ|~!@(DOkaU-H3kIQkxV=5kfOm7P(aL$;*p6ewHE9P!pOTPY)ey`450PKCt+fXnU z&1F^FLFQ9xRoU;IoD^HM+3v<7h?6cJVJ{Qo?reA-8jGkOcDvM2M9<~2UA#FdBeDbS zvCo?!%*=)GJrc2H3=(-7T0C7nyK(4QYvXpkTS8^H@&r@+-(PC-cW~@UzNY-?bl5)F zk;Ls7=IC?jG|=q+hSD#x;%xg64^|b5*A%|s8g8<2;P3$7+ajOue6h38)Va)1iLTd^ zVS=(j>T7!a0c(b(D4yN|DQ7ol6QzNBrGI%*;bkl5LZ6pb(_o_vJc-9y0L-9q#;)Hw zI6pqEK2%UY8j%!xN${~bT*WxTWNM+t9vU9&df5OEaA@(9sUE^1cMs2TU^qdz$~*oN zHIf`N891qbV?d=pjU`N3ZGtC5KZHWToqNNr?$P_8MJRMxUgD! zY8J#`X;TSS96oXJ1NB8B7I4_8xr6lll^^kc@6Q{)N!rwL58ll1@>B8#Rw>2!9hkG- z9$OvDVJ_DpyyXYIc`m2n391J>OKMhpPAxKq#$pYLepe@=>}MlJ53!4lH!8 z#%3fYbFxKj#Y!~LswZJOT^~m+>gm_geDJKK`M@OomOG)`$Hfho%VA}LDfri_lIv}+ z=<#&k-GI(rRlEVuZKo4ez|Eg9s;;fY!;7@O_0WW(^>hzEC4A}eA*2nrenwGymfo>= zy4TV0_35^^?zUJpm6-o~bA*zD7+V4Am(3U*w6b0HuA|dg^0t#ue5}6wuWK#@!9UvG zK1CwJ`SGSGS4eb2wsev1=K^O5Z$EgLY+9B6bRTDXX7<=l?V~LwwD_|S4Km~CS_k-1 z8D0_i&b<0sdoFdilkO28B)Ef{EV!h`Sw&KlL+s3eiPpG)KuoRko5bK~Q(+kq(cdwu zrrK&jzKln=3?O6gVU>Gi%nA!{_#ZOjctgXw^q!6YVob7kjQnL**mPB5l`Uu3Qkqv} zmg9l0R9IYfd@JOe$8Ae{E3q}z${XYo(*?Ia>j{eNG4u*Ko+;1lmKq^7UV@3vcXjDU zQ`;v^eQz=wv}B!s+7TZkfp7H>i=bNNK*L5WPX`Td9PaAHJiYI zJ#)Ab8(xGjF0?WqY{FZQsHMlZI_c?I{hmO41eLy?WD^j>V=odZvSXY)J8q=A zRtCQ$fZ9&6c_b^GK}4a*t>DO6ZPND%G<>l;Ac?jb7UbBOO-US`I}2s#nx$LvZuJ{M zZKH9$7qnEch+uYH(mEDz zea16wDJLOIQ_iQOQ@6|Gxpq+K^*X%XO02KBF@ujUUfjYtP#ua>N^ve*?R`cW+EbYPuwwZ2b@2eOO+FmkKTuqnHd_U)LI<@;uA{C9tDjQsG zO6hV&r&W6~3aX_c(Xs0Pjn!ss3{wkUx5hvXf_Z;@}xp-@1kN z5$?TDWQ(JR?CZn!r6pTM76aPrW5A=)r|eal8-QL%_*1`MKON97d|q7YkwkZ?Twi^f zXR#^W*pO3fUmn65sursft^>ovaR{-Z(1S^vBlbQ+MAspHW)DNF_wy{}qi>d2js1(Z zeLO`iyfymWnufp7!PL%{nq1r#tq6HQX{x__mkh3?Dr3?hziHm2HFv)a6|`LKrEo;^ zgk5$VYJPF|c-hs|GoqWB{Kt*&f+Q!8vL$-Q=rld+N!%LuMcsOByuD3|kq(*Xju~F* ziZH|;OS`0>vShmD76p31z&1;UUW3UQVF?p|y3#p|X}14el5lcuU&BNr@vo=crSv}6 z5k=a-t6y8t2(!1B5un!KKw=h$vCj2T?jcf6ZWjDdkFG zrObG?B92-^ws%8%*7iw|O!pDkP8jQUHmQb+tpAc#&R59H$!ow@|G*qZnRgDtPAFR) z)UjQiQSR$MeqsM0jaK&#YrJPr1EZ<{RJNm5O)M_C;j-z<{>pMLnn&ksIYVIW$1H*3rhSGJmMeC7p3E$8O^)n~7k)=2v+J-S=FMS;nIusX_u4cS$T?)Ay1CHHIfEgYm!Zkxz0LJ z**M1J9@qHx=6Jui}~6pDj&9ZU%dB{v2slE#0* z{85e4F3`NB@_1!dzQvx6Psg4|!rhs^kAwE~_7ukW>ySaOr)i*W8?%^-CuqRMpg-kn zJL=tq94;dDUCl!uo1Z&Rzbrd2A_K$O1$O6~!0IlqZQ?u|5ar-H zNUXn3Ze|?);OLW9fKZ;^5qgWUl8r0x%wj<#KbMGgvEDSbU9A?@7t~$iz}_#4jO*rA zF8bvp!n^nG>0BTG`b-EV#qUFgvf~%#vP@{;_8$)H=Dh04z_Z5G&q?8RU!k<`-swNs!6QGcJd+VL3_sFFyj-e>y* zswtuIB>KcgX zhzdna@*7Imy3qcC-R4TsXVs;m8yP#|nbN9SfpNgl#^P&UDi2nxQQYLizy7I~d;jW+ z6&He$EIwI=YcaQFEMV;MelfZykcu9whGs0$36oX=&G!Rs%v`iZqWG`u@f@1l*T&{I31iDH z<(LY_Q`XuBhd&c)-F-Htv~U?&osWMVT*&m>R#p#IP@G=|JTvtSdH&{_M%(*_XD@>% zDY~hFfK;tR1CE8)brYnZ((hs=>5o_!8f$gyx z@UOYW$EUt2FTxV#=yrR^#_>pogZ6&d=wg(R`}=)x*20i_wyC@XfAs5j_EF`ji;Egx zb&H)~MY?KVZpV}9I?tOv@ZX4qfmuTWYj(q*4KiHTYV6s>&BB6cppf7|HbN$yv;0?y)MOQ8t=;78# zij&?4r>_K}>Y?1TWykjxWXr8xv#0~1`nz!&j5jbTxbx-fhVxyc^HIC&_Sl|muHcWi zHrFUi4WZZn1adX*;b$NaK<<<38&4%ZUxv$c3&ytqd2jp2 zDOUu%Ep*Nph>uWwKl{9z)jNZTT}ZCD3Hy8Crw^sK1kF0ye3sXSjOMq;GFdvm1v8jr z6_2{qq4{B25f~nxWx`%4F9x7>5Z{a^O1`)$T(~yet~O{dT9zL!S|_D+Mk9}4Vg@d&KP0(}ZUpB-7f(`(421a^VXdoBYm=z~&af0G zf=JfI*5D`ysUdEMtI3Cl!HWKGQKC}krBBAE{q4#JsOxJv4X{v z@{$T{)ap<%U?u9bA$-Xs-RMbw1Ly4X8L`QuT1M@8>`dIrXf!T}Z#!HBm|Uhp&eygy zDYD|*97o3P*umXq#q}Smx3Ill`>*XVzS7}IET;Kxp@U@F)0p*?S>()I)6nLgvWKmK zx&sm%;hob;$F1|dfZdmxbUw6Mf%aX}a9B6Dij4b)r`qq@ApXiezSEmVierX>7TvZZMcT7 zGh85aGL|Rtzm(rOaFhuLu5u4Rdy6~{hvbCrPO`3z+L%4+*Ixs1D;x?#OF5MfvKTfN z$KYaw`<$LdpcKfVobVytd|4M3%0loP&GvBEX17ege3v9Y28`05D1IB#Zud|j$Ak~A zIZ3#G8^?ZYp7N!ffBzROo_BGk<>sLgdhAS53zXeP%RR^7XR5)K6DT{rLLY|8biHai z&5&4WB@)6+X*$iC zHZ%3X!$vFglJ*{~r?sOgZTe+G?%zSFq3vnJ<~2PIUu=@EyL+jRs}z8CEqtSYoK0M2 z`=J?WByzXOZKrY*;@7c!2+8n|xpAF%60p?UwWH=3>6kpcvVZ`UIyKAfGqH{{;$@)I zqSZ~UkiIKn^Hn%Ha+iyXj$Y?1)ic1c0Y&t#$W);7d4-6;s;D1~_a+&U9JtOHUUrMm zHsgkSy!f+tblUJbi_+7YTO^unXaQfSbAraiDVQ79p}??^c+n$d_w&VF3ZKh@Tg_u! zoPZcD7H5+42bbdvlSoG0qk{(5t;ln((KDY~3( zsD@AzKa-z-loIlUl3}tbB`GLgy#k(5ZeA1B^NVk~-qb6i|bS)hE>?D~Crni`ch*x8e{L2OWiIKJEvZu=FM=8oy~ zs`O0)51W?fB+}x_>mgz&=j^6JHfg94YtPsMU#{NSF-w$SKV>+p;t!^`X!I4Ql6SNm z-H!lz)v;taS;ahcJ?D{$0fqW_Kn$02sa(^kQ$~vHar%B%;f$+KvX6^^R(e1%?V0u2 zb?XI0So+tCb@8;X^Y_r?NeF2Oy^0=xf_#si5D-Uv19M?8WjxoU=<^dHhm) zaKb!rx=In`8Zek)^{NHaPhBJH4(1fAgZgn7Vo>zJNlRMMsJ(SB+zPeIe(59ALpsZ- z<2MqRr!-w7H!;&!^Ix|O=>x>Op7MIHkrbB7Qy0&h;|hQr6K77Gyt}H~&HQ56SCYlL zJp-b4@^R#_1Ap!oayX$@*OGx>3Uxx-!s`SZLlj%gqM|WkJvs$^iEvS!_GJN81@*TBfX1p%%c$ytc2kz{;l6IidtsB+`+U4gy{3{-g{NL2@!b5t-y9 zX-TpTai8k(lKX0lS3cMVP}is>050E#IMlG_?)t(w3$_f~M~}R0cA|>hJE{t2>;jSx zEQ-^3zPD*9nkDdv#h?F$0wg`IE<`_rU~yxCLmiNxfE zKJrMP;U^#8*@;hLFvHVE$fcIghdi)F1 z2Y9HGMf8@$@19=N{Vn}j^gjiK>F0a5QcChvN({~LiuI9l;~YXie?hYf-MyKOal1M_Vup=fowu`Atr?g_RYjS+A+)8)7PTefMOue5}Y@ zGhQ`3w9gqc7qsT`6{Op>S{2%>9R;hx6BX~f7te7jFuP#TrC&nVbnL})D|@y>#{oDk z8OVx2L1))B<^9I#IL9`xu(Uspg2tlfWbl}Xia*i4LdMkA2E0nFY4Q-^K=Z6)L#ldr zOwSmK2zTVusb=J_4%_o$s}ZE}#+|W%7VV$DT49K`mH}04ANurCZ z-PSao&p$5rLKu@S?o_}GU@kxek#q?69IqA7QW0u0ED)~R2`y5 zg3DvUKH|9A6eh>4KS)plnzt97@|DA3-QJED7DnReC*7;TbtK!?C4f}Y3hZ~I=U*e_>#9U zT5@dx;E`3se#g23gKy|524C`fO$#AmH^Zmo<|O2qk616KMZ;tOuDp0C)^%$W9He^u z;=ED$T-KxK0P1qOcUyXBnkzCRsWsh;H1SMn0ne&5mKz!@z^*K%ZI35JB#BDaC#OX$ zYhf?{npaOvM=Wa=gBb_bY@_rG#Ug;={!@Q=sHFW)i66O%_T5k(5N`myL1H~5d)~%W z{2xDjDb09E_x%arQp|q;df2FU-+J>qWp`5cx~$<=80ks)F$65l2vWoKYD@gt{^)0% zRz_3jm4;B|n}4nsEd?Y2H9l5#(b&^ew#hn7Ht;5z2OR^LvFTger_mc<&Nw3%cp{0L z=UZ)QWfTDy-g`z^i+c*vo^Yo2g2E66tcmv>i-3q!;nTyoy`>&vYv$5_Q0=ja zMqJ?3ijwM>_c9g#Rrv8I?EYSA(hfd=SVCsU|4(Jk{|$@(!=nF#9kWi1dYZrA7adRZ z_$a$C8k==BMG`wax1FT{5WiA#i)R%%od2PvI^>@V*cpV=!HX)wvJSF303W@%)yz|P zwTv2aJbdj^NAOjauKIkTGGvIuSZf4;q{Z9n^YU31%?FOu<*4i>{+9~q1nWJC|6ir@ z_5T9D|C4$Klw1Da9$t-|t;m@Do5b}`T>wkSA4kDKVgE~b6X$P^!+(9`zghl&z41S> z?f(PS{r~I3N|J`D|52TrQo3(nM1LFw#B0d`f}J53$hd_=Bb3!Xn-18?okxbke)wZK zcp>W8{?Spr@6G&?t8jvYLr$=on$f_sX!@~S1ri3Oc#>Fl5U^kG#8fiB-C7i9KkI@h zn-wam@5L3;w*I=36T#3iJq_{kd0R96?cbRY{E>hh;Hj>%Bnq$r-PZ|?%X)9kdEhPY zF<)GtIdv{T$knO@`)`iY-wESB6UXn92BP_x@qfIT{qE!cRAMFke|4Dc4JT(=XJ;o_ z?7Qq>&7J9)u10IS!vmlTa*-1NTAzQ*+B~pFFnq1|nSouFBO+d`#!9$$l*hoesI`7|{Y8xbI3pC0UmjR-@L&s;0>Mu0gu(vh*~~d1!QOPZn`hzKN;!aGG3x;A#X+da$l!&P*{9<#Jl!&$~cPYsX|HpO^DHGE|gLdZTy7ZE;x zZnK@!QD<vlhdnxg{tx^4{^-lF4W*?C2c%B;hUriaF5eq2b%&39Ukn%*N5~1q??C* z=((ElQYhbn8le`saiF12>u<%xJBMa&G=@%;xXTBmz|GT!;7&YP|9&>rGX;&8(5A3r zyCE^tnx3pJcMDmH{tt)+PD;FiJJsmyP+`!<`iyxLDs7#oPGIy@m!5-CS4sCE;oc{RlW+x&yGcpLN+md#KXKnbt&t2-FDk z;^v`5PcbGImQ0NrDxu?({xjWt!RjjrYwPH%^T?)sK`r-+yK8{57km2$-KvGZS9K2i zX#ge~L(66dlKpUQY01RDtVijs1>!?yOqw$wkRgCCjy>%kL$x0e#hSf>0W<6k$#iL-iGCgF4Uhc!z1r@xieIh z*^E4v&>t}4A1}1D&<-c=zw%30nQv$1(}ogtNZTW$ZaY()E8KM+b+6F3+gq)stMS>a z2aRfqTt9o$VScd!@r*-T$h%2*XP0~VQ-S%~LnC@(Q<)913MDpoB8`6#)gASb5>$S2 zcbKAbD?Qy`k_C1llAdbp@4K0zm7wP+GC*H<7v1##e1&t&mkCw4{*z8#`|6g1+#F&v zJ<~T^OB2lo%q;;|-Q;_n5=4tmO7nT35c42cNFGeA|>a z9vaXf6}=o7mXouiHz3xuKds8n%~fk~zbfH`6}7iNPzH}}O|kl0idvX*yjYEBD8mo} z9#m*P*a#TnVv>`Msa0OSdeyne^PM42@q3x|5|z0P9A}>zMJ=l?*8t%8H`Cbp=3@IJ z3*nHhev(O%IF1aaMWnTs_WN_@MB5HlO+hD?1pJl&yf(U>MaLO+e6FO!0v)d15N>^1 z@kb|??_eSccC!b27q`wl4VK7+S2hK(_|InQ~wU34j2>cMq1 zx3OGfW*FtZ8u7#bF;Z4?EYv$;nFIOjr@*9AZV7wtKK*$x_w?bOn;U9NGQVF~CHFIe znD@K$DYg|E@L<=M4{cuyd>wj_UT6M5SWu&nE?2c7&-H}IO5|;w;~NT|du?C7)hF3DT!C-kfhVr3NMvcTfC z63S%xroAWEUG~>|bG{C;axZy`u!Tz+6HKU*HJu9!5l*wt8g3B7c5)$Y8k`1m)Zuv^ ze=p&&_l`pB=SnX|^~!M55_0c1cIL0*w)>=`ZU1Mg2urnu)S5^gYr9+T7JC$%U1ay@ zOG}ZFisxf&?Bvs1+tPWmFh>`&1=FJp*UOq3uHVkY%CWKU75WWl29}No2x`U&d~BWx zW=AJKH>vw#;V8mNDpypt;k?y80ogOs+-J+qb)?};-T435d&{UeyJl?=LVyq;gb>^k z2<{ME6D$NLA-KD{H#8F5f&`Z&Sa8<{8h5(UMjE#cE{*GSp7WjeJ?G4 z`p?aVeb+AARaaGkXoC5!CX+6BOXN{+VUvGO);S8kqVziBC9$_nm-&je;pQy+xHwgL ztB{h3ugouTQhdhriI;d=AgE$bxhVO~uy{+qRN+#6pro=LU^xA{V)FU~f~qw8PuG=W zq#*SfwlTcnFjmJrI0Z1=rD>!PKBW()XJ|gu435HAoG6p;R@E;nfdJjx^&kstGNlJ0y6OY3Ss>5BNOAk zSy6R@Ck7VzO^NFJnvnAJWh*VLh^^2aoJ=U`fd+c#SXUpXa+7t)?Yv%20JE*gVe@##_OEj0 z38^^(pUJ{lu1}_>>1Rr7n9IN0XMcQf05qSv{Gy?O*7ayzH4S7~E+Mguve1s!``R~! z#d(@AvR1>_8yXvcmw}{(GTd7U%hfBBCjbvr;ijk+1Z{aAVKn^7+p&{ZfJPuBoc4~X zy<>wDV)yy=1Cb$QA(Z@*^G4PFj-sP0NVzic(_^)fu)S^=nlvR*NY;#Gd??qFe;B{t zNMO2nI<%I7wj-L-$phkdEVndAL{HKVIP`&gq01f~cS(A=U||TJaS-(Ax3AZD9g-5e zX(kKC=>nmXI8R&BWo?T07VR9=!1_a!ro-UI*5mVYxOC~m!ns|QD3@w>%`;KYdY_e` zaMnlpq}B4?f_n*K2=NC1>AggKy0`lSx}O_{~H~c0&*)-^u|T#|{j- zUJD;z>`Jdy100DjX&>R?rT{y%mP7pDM!d)A@@!0Yf)r(KAV}KPJjrtbpip>PI9-JA zt*U+b!XHe7VmIx7-L@03dYZ@U_0`l=Q<<(ECi|{E-7{ehS)|kDTXK#RLP3KrTt|Sl z(tHlTSP*14^a$OEsv*#iNv^Phj$;!uCrd2oNTTBGM-v%2PF|$%o8aI5xh8XdwAD;E z)FjZX9!eDHY47MA-3&JYRvfU7&=9_?t0m!4O~`JBup3E7;OgzMIp+k|_G}+opwobU zjw+z}gl~WV_dF6dh#wL@5F3EL+6(;K9N?%ta%F~Qn-Xx*%W8kac5 z4h-WWzW7OxeoRzN^VD@Wh}3J*gW&Iv^o{4boD)WJw)yS^lTOuQ218SMeFg8*+qvTl zib?!#@*m%gEX?jO(|JUdCO@HsBt5-y|G^(}ZbYEUik)9d;KXg$WsPE9W%~(Jn8o4R z`i0?Ud_2cGF5j5I*MtxU9l`w?m6au%w>FhvxsP4!jPY&p#y3mU_09|slYcv$6weWI zGp@7&X}zc|6X)^}$bJ@0ce!dQY8T&Z{S6^=dJr$hB|W+MeM2^1L?n3MMT8W*xf+5+ z=S}b|eE`H2WS)OI3h`)-Rg>qTWl<%+qYfU2Tt`B zf5KFX&hGhD_ZcBuj~vAoOFhMdGKhCiK<(S~+u^+}1bd9J4fTeUZP~!e05Yhq&?ie_ zrwOMSgGGdN_Vp^YC%^(d#@nN+V3TXTnUtjVxI`+fsg-5+> zGxWbwh3qd?id2X{18gHRWRr3tp(kbyV*4TQl?y1%podj*VF<|$z@Mb zlkoX@9-2ZA4D3JnL1DEko-`F{h)3;wdT5tBA*=zVL~=y@s|vh(0y?5v4_9h-g`$yE zlIb`XIkZ{MmA`!X4t?T#alrJ~2~U1mi9sndpPBV_#Cl1LbQ2@#rXibR;l%%n(%Bdf zQ5tYrT9e=O&0O1g?}R$B1)8=49^7`DkZ7Z{D3eaj`#v5=Ed7#|#pOc#;jWvfq5XpO zLByK+v{*CKFz$*gT~IK5q1(VK)@;N2=Cwr&kBKqULQo|^fN^R7v9Ot+Vw*Bk7aIjl zEFS)Ln4NNI|Lpa5k3=L*!Bp%W>cjlCypc0;J0S&gs~nI009WFHr0uCkOa>MIO?MTxjt@)=3+#Ot zY&Uf6PLgMmn~PUBy1xSZ1*%@sEsFqqEANk}lH_A8H!dYlZrSph2N!Kb8CEQKUCfqo z^7|xhvyHv4hs759MXHZ-lykL_4om$rR)HjoWW*QpIa%g*=4JH;?2C2FB05LE!QWDZ zq6a5)={LE!oKpwUmi-|ug7LzY?jDzKGwGKx`V7Txhe}~5Dmq;ol!|N^A2v}9-m(}D zPd3T9&wY}oNUeB$Zp|5$fI-PTjgvp^R7D!9@Ci0{Tx@z&vRRGQ=K)otpN=~)rY}~Q zbFF@$n!McXgGH^HZIdsUah~q@biV3Ek=*#-L;KGN|X;ZH@Ae20Ah`Q zg}w5FQ1{Bf#)o6Z*Kz8VNfv0m-2Sz=0V{jCS$EIu&lQDk3>I31PN}&pg%KWoxm( zgMI*PAl4tKa8!Orw$sFrnyv+1y%Ll}*wqGo$-d@wH|BD*N8h?7&=GNaMhSE_T(>urZ*%=G!^0RD}0`DRb zU*;c)a?+;uIUFu=X(y+A%oJ!BbABKr$>%J7!kTgs?29t-+TU7wUXL}s@`&vAtYF+k z0DYti3$NEvg2Ng{R&yBXI+zrxwM}p650tb*Tka$xo1yx|suV;^$Dk@ca++fvQAuBY-v^9-z`anw=5R zrSIk>`zWM;@1TEFx{L^PacJIiJBnznUQyi;a=5Z}&rWSzhC(9$)30~+asM+Gc?hnw zrHjI41D0N+1X|+ukK}Ya$I?HJTA|k4c8HH-VfW*Kv%$+~L-!-}rv%lA%oEG{lKP#g zXv)|?;au_XeMVwWxeirMo5qPC z#K+S)X2h{M5PeZjtws_KUBgo!IbwvG=F)wCCg9TKi){NzWTRcFY;+3XY}y2|!D~}Oxz>)7bj`|@x zJ6>?I&mM;V&Y8Gk8hl(gZ-zS&Y@Wjd{5uT@oD;i z;l)4^ISlPbRj# z4bjdb)l@i>Uq2t6>30X%332^9eeic3mTdQbYh3jI=Di|5{O{HOFwFlgH_V_qTi@+v zdGjnRE*_s8|NMKr(WvPp3D?_2xy+pG8zbp_km!V%dij~BsFOnV6aTC!t~I6O z+}-G)2gwnSp3@(KO3n;2%F1l8dMu}a3YWlX9;mIY zwxsz!n8Ns%@7|M~mEZah8$CH z=+~ALGGTRYhOXZykT#2CWQxDasbc@GlcA{oU!vAZRv3u(^r?ynlNK9l#JZekaQALk zgx*2x%Lv_$og*os)+lvV4oobfR1(#QR5v-R=Ca7FzLS$Pt{>iZFUDCiP1MA;t3zBC zT0_^8d^Vhb;a8Ow>U&iqI@32^g&U8rj5e!W_BECk4Ro7-4BfG9ZdB*(!JC3lJ%rP; zQ`U$+x{q|@ZBLWrfzTnz8UXfi{7Qx-6Y##R&x@-y)?Y1M_c7x=qe98D`M7Y|x&7dwyx$d-gx2-%)dR56;#_*QUTj2fMTdm2% zx`@3gmp8z@EE=VSMDwt^k=Nq9ar}^IgO%%hom^G3HAddLBtaDUZoF9{ZAhS&b*YsNp@m>Ykym&3agqp=Gq(LCW_4in*vU1rfw4wOYd>B{+7zbDg1_7*H zSLxalJS?%;hB{pTy%}&v|73TAe+W|!g5#ox>s3Sm{kl&3+aMGE_DAYx_vHR}+c3#s z7Pr)d=Q}p3sI6lWI4K2n;$ZNw}&&MMbWbkVwjC3GqeGTrou?*Y9MOM{M?-!N|IJ8~oJa~d) z#~x2us=j&CK`Bjyo5E*&bi(w8HN7q!;Mcb@y5lIqIc+6L-(@7rIWM zs%Q@6r&7O>?@_izZZ`^3(3UIu>u`%|RugHT`Vg)tga14Z6Sb18 z88QL>(tss7p-US-22<#>=H zD6L{}qi=;|RxSxz57T1B=8zt9V;gt04TY07S83XdTBASO=I;wNP9M-LM%QNph#fy> z$4(Iegm(wD#+=*sSJ!q8LtXUCRvZXbPVB@Y3zx;Bu^mt2b zDH};5I*ew9)`l%?<^1_pomU}K1r4j^%zrjzKBR#I{p3=JVX`9Hi7-=R(%Va(GyLgC zF7AdxrtX$HO!kd{obA@JzRcG=gCnXsBe%)srrjZIjdPAv$1Kt5xi5eLfnjQ<2oB4D zkB<`giM$yLb|Q`pz!-ZwD>6=n3SJIbUx zKQnd=;0@F}E}794q_Q#;Rk{XjC9W(UHL=xJk9qh=Kf}QESVD^g^9Qk3y-vFt9ly`+G6})59Ht zEaT;VpN8b?dGHg*eQUIn*&|n0(c%75){!?R9x7*>h#!TBPfpjd5%kr!jS^guf7Bk3 z@fWhyH?cQgUx-hN9R9egHI4;uyRIIOG%iY`a2{F4uGvG58;Bl)OF6(* z>oMrTrpnUmO7erFtshI%^06`QHdMv(Iwl{tb^nE2ktZ6{fR}Ia$dJ?psn&B+5+y{3 zln6YmUsnVQ)Aj`L$9+>6i{h8(g05(bBG+cN zhpGsPkjRYc;H&j=r!()x*$~Kno5SKm8xJPdM03c#LeZ{FVk$d*gXx`=$OR6)FYM`- zJbb8!D-aUo;2_wRbNTo8qQU!eQmz876|d=BWR;Evm17*xW+FRa}M zwVcHp5A9j>z`@EM?{e@mtAkI;iEy@w{-{+T@I|*qzJp0;E<6Uz*goX)WCXkmN}Ini z+aXgLnDw6cWJ*OVA|d{f$Jlx%#N>RN&eep|kj=NT2KJLl#e9_*)wVWYn=TyF%+=Ra zve}YPRwBrq=8}7oet36Ltx!I6oMSAP50si{5Dm~gIVtipezh3Fm}p=6mq)e!7mu>- zxaj5l2a{ruRuUtcr$osA2za6^BKlq|Nk%~K?_t-1B9W(|)u*MGbnrHpRH?9{tOxsV z*J)<)MBxrtSQElyHh;=dT+0mBI_w(D$kDXdZ|gIqQnE7YNbIjTi;Es%liaMrw4T{) zy;(IexZ_d#cz;f%_mSfqIy_(cHFyD;13$T-?ZqRTzxa*kd)3fE&7CU}QGI7D7Z=aq zE5n>!YI}+GD&}AxPt7&iL3C(x$L>K_+wXNUl@%EISwzPtD}U$2?ei$Im?x%*f$c-Y zvplaKXLAK^V`y@HoT5PMvS^Ka%ENb4$m5tj+KnT2@6Kg+VK5r%)F$raic+EW+pwEl z&$LGv$F=2Fryjlsdm`i4?4*{Wm7-V^qHn{#)>-r{*fuJY=3c!DmuBLS(i2(sy&rb` zt2xJs2^_t>Vi+tnh;!pKTYm_FBnBy!f#*vun-k#z73C>0{6L>AMxqZ z3MhBOYQ-4hejh#gRmfOtz5R5pd+#BKJ@LLF-4xF~`h#&k;q_?RhX_*bXRV#JigX>-J93Fw~;x#8IE$eS2_wX zt7dh=5&hKY-WAo$!!@?xxC(Kkj)Rcxe*MOxW0gS(YNqMBM{fwFp*Z~$g37f?nKlCz8PKP|i-QTSpFH+Q(Ns7Ubl}t|JU~>?Qiet5Fg!Xw>1( zB2${lIw`mRH$k{&0YSax%Ri(f()vTJuyTDl)2S8QW%Ied+yd^( zs7wPiTv4t5glhQw6H7_4FGcOJ*Rmr{jwWDCJn9f~&EwE@vZ?8L1|P)r$pKXJsBZB| zE(-(H6KM;HVq&FBR_9Te25Z_Q53S!YFi=lC>u zrry84O(zr+DcErMwvx#Nz`UB*pKx34AnWX%W(QxEFxVKfRhoGUw!~s5`Qc5lJCT%@ zp4b<*pmAia_+jLcDQMneDNX9SNY)sS5nwB3hSh*MY{+X_>0B1AKdP0zuG5;_lEtrgYPeO4YA@5hMxGu(S$d2xq;@!Ci;32<6JgRx0bRk=rvHE-RN8 zN4wi%N-!LOwzQGL_x94O?Y$K*I`XKq9l95johDn?@h#i4&DxgI+&=hS;R^s-qXcIV z#;sFU5l=}2zWi*M(GEORnL46co7!#f8*DL{1?M>(&+&9T?-?LnCxb0biri|PKDy^V zx?Q$DOu=HeFs|B2XyZ*!hceb$_T#WS=D7R43c4hWbK1(pI_n_74fm>a{m@vld#5LR zey`Dy`K@?R=Ijhhj3<=oo9#`kks3d==w_0U&vwfCm(}-&`;JyW7SVW&y57%LP-dpt zWGd(hG&)dYWQ!tTl21zq*lplc3R?M?8;-MW9k{MDqB>fGDXKWv{3b!UAAQ+4Y%bXD zFBhjPeym25J46G0M)?$dyHVJJQC?Oxjt0cJiw&6v!{rv->a|G+_X!t!)-7}Fn{dvFf<1s} z4vU#|WJbcsNxa(t7c*v_WE<^=CTCIu_+{<%@cNN%fAVcx!$JSPuQp}oh~m{{AST|s z(^_RA2P)BTDp*xivm>sEj@ULJ!g=6PSceO{QGJvwGBJYMXw>`H^zqRa>_~f8Xup_k zU?3vTND-lw>iEg?S#RJ>$79|v6~^Oxk4@>iA%_sdJXAb_A5C`S(DQoHUWuN?1C!E~ z>xj~8_0Yq?XxU7w0uwJthEoT65{mmFBDUD~{+TPY#GyQ^>n4ApUGGUz7a6|@N?u&@ z%STNS@}(cLdE!nN3#9b0#Gmhc15UQSt%>e*Qe$4kBRL1(y(HJnDyrBj)zD$N$)0pB zr*SpFKU=fX6WTDv$d35nK`~kX>tm`K)5T4whw&F^#UxwbUT$tp+EukUw>Da(r@NPS z-pktVHh-U_5~iGn*B(QSK5G$^033O(Z`Y<2b`qnt{LhTK_+&6ib2K^ED5A&VCMt;; z$*QnyV24k@6a59S*o1~w)iPe#xk(SIBc{O?>kGNZ8rR1uNZ)VfMKNZd&6!u#lN5%u zp%Cg_1)wL@F=ZLj==A=q+Y{=wiPYMtcFOLywBHGMSn}tIRmLPaddlbuV})5*)>uy% zi^bbp0wX_dl}w!iY)|uVevp}3aT*5<@upan(X~S0JBmEC&Pv7Sf(`-E3oXwoPI0Qv zoq5iUqwa*$d6N!kNbI1m;ojLOCY*Z-aH76eL170eTu@q6R$fCvPoozxKD`tQTZHS?(fSA>1MyV zl=|eU;=D)|9bmw#oMS~0b%9zB;prNa`6gD`M4XU}_zPn!k!4;& zqMVo=q6l={n|r??8hrW5h}@*1ur?;{^;i~bv~Ib+Z&mK%(WabYcnXcxu+=8he!1rp zle9^sFR7P?2YC@$9>!*ms#!{BJ?oxC%j+rmV-ZOR#K{h8C2;?`{+Ulj&fR1}9aUyJ zqBqlgd(l!?>5~tQvQmc`s$_JQ`ai#WFHai zYHoGC#{pwlDPPiT`ePL#qTb8j0C>Vk0A&qRJ83xc&TJ!W@9x zVk$z`-~+)&nDTR;ESS2PcYKvhJ`+MOCT42+1XHE`8mk-?sEBffp3q1sXi5jn6>nWl zkx{5#PgwNG$6IPIODXM(vxql@OK&E%&lH{9BqK{=G$2{E_qm{OWKHyE32(6ZJUTdFemj@MGjvSptS+4~j-2v}NFj)lD3s&bQmChC=c zJfqwoXm?OvNZ4%b*6XF5%M<%`ir8Lg%e@<*$3BRS`ZzVd1SZRz&j_{3Y8K>$ z!mz__msL)B{@e;E;f8o98M`Go>=_#0v3im`+V|rgLA>+zdK>6NFsI`5NVB(9G-;}+ zk5E`7d7v04-)hseFObEaZX5zk3sLL)ifQ7`W`Rh=k%@b1_IXOEQ0(m4ReiuyH|1k_ zn>RgimQ&1js_Fb7Rqg(_)YR*1-&n9&c+LDl{o9y4F*yiodHMPqKZAKKw`YfiD)b_( zF-O%zA3hpEU-OYYqKk-XIGmt~8pQ4}-Jjs1(**so3zh8tWg40O_WIWDeQhCx1q0Hm+v|P@S4}Nvy>q)lHBUfW?Hv^bqZ$4}7tk5H^EAkIbC37Gc2(UsLz?xwfxXPuR3_G;LjC#WTz@ttxQu zvbJK3t+|5`qnJDyhUkza54fAj!+huqewLIpb@AB?T`?CvM!vhb$Gj4(U2n(c*)}%D zM~ORg0_e?9drmNcz|Trd$BGC$-BG5dlw%st>&wgy>B!L^ZBxe3u6c7yNZQD0(VBu@ zYKSm9SrR&X|3y{jHXHTd2-#qopY$=Z>Kpj=k^s2Jx^N_-_F427Xc^cB!$BDW-X5}g z<7TkmUwl}O-b>`6N=PTl{7|2(E(ITo!T8TOWKwNFe1t#i@ry7ZOl!Ji;> zW{K9hgYrxc`&pyMmy_Z!Um}B6GvdQ9?3KEQ#|k4xO)+1&cfq6m0=0~1)Vo5R-s@VQ zDv9i44N?AZ0|eGay#niW_pD}<(5}kDv{qyS9oxkI{ORsBE2kGG*$^nJNb=mw4~-dO zpnBcP0TayEr{QIY-|LnQ3_1YExiBLg*GZES(q;R~#yyMA_3!))7G`pI-sH2JjVr;u zTeie%W*CtN0d~(v;et)3(ZtIR!kw?fn}uZZ9WTdr8=iD^Gx1uM-HkcF>%n_k7uVhX z&^EMDQLRL~72laS9F}TT<>_Xr`9M=K) zuS7N|YkhN{#cxMcT{;}Rp5snQ@$M3X zM<#q;e9|NKHRsekoB6W5F!5kEkX+9DQizUzAE9+>J{y64iN4jX$9m3?FOP=BzHtC4 z8QA_^aZ&kvk^@!~mt*c#X@W=pnwN~8o~p_UO0R&)2z0m7b5+rY2m<_!tlO zT1jL+H`;Z2*bvm)(?HeBP;g-i?ieuI=rn6{j|sm`Nq{)wnc1EJqNWRdENsT82+<^?K z%H(l^a&TUOr1&65|6p$C;A~1x!20K}1cm4Krd%FqdFl*IBiIq$Zd6 zGyJ*~@rbN+sjjIfE8^$W7-GTXNr_VK8$!QOXytgyk*jP?dmz(2UV5t3Z44PaQz~;% zLfdv%#zTQo4CpnHhT-RUtbuqll>uS4&G!@=#fYm`L&5#=HYlu z0%PZ*4Hu6{D>g~PBRLTqVY;(svD<3v4Zyv`&s5Ow%`8OuV)$CSuWf&OLABi4v}MlW z#ry;&uTlAymQ#_r))V|1+_E;$q!iAoCBZ(%>OXVir_Y`g`uQoA?;0V8WLy1u9vNap z=ol|r?u}TmQ#;u$+zXAGT$V@sg#F$as{QCtQGIj}4YMowxo(}9!f6&TWJCa7&L$f(&@G71}9 z!e*#)H{m_5M(K-|sM+=$<3Wq=p_7#$$-76bC^4+C_3N5CyWgw^oRLKF7(X?V>U(du zbjsjzihMMjpmd+%@^ckb;w!N@0?C72sfUSWE7@-d(J?V_OFB?3mi(#GnBhFll&E`M z&-Xs<+PRxA zG!Q&B@se#Jx7Ad=XI2uwZ#j%tdpd`t(oq*-v%-}=i*LE@$$O7F$dsCJk&0QB$uUfp z-`e>JkUAKK=&0Z#UcQ@@UQBW#m_PQCsU)pz;oURZJxO%3Cwq2&AeUy33F3q z+vfs}a=CZSFG3#iWFTkHb$@jS#Oyiwhp++r_38sUhzV!X_;O6oPdGL*@x3vh8PEPO zR^sRcyp5LSTbna3HE)qswbBkmkF(+d4jRIT*wP*xIZ5VuH@tAZk{Lj?L@Q>b`KLjM z;%dVzr3pC%F)AzUxU<3WMlz+NWkCZ^;vMX!Zwx(6tPJ`h5?SK64rcUI$W7m<8a27Q ziRK;P`XJiI zUc|9;g>s~-nke!qtrFafZPvNRWYbpz=_GPrKeR$7KlwqsB|XXFJD65-*m7dYJ-|CG z+r~-zfid^hd#uoj!!LHwGzXR>1>Mx>xy4M!kTR(2-6MPG0P+Q^?^e_42=?=%S8Z_h z;n&N5GtdqHrwp`WHnL}`7I(?9WA44H7u-V`{4G$Mq(IJ?7g1$xug|~O(YC$7ga)0+ z+Z!nlP+A!vogtc@?)X_xsH6%W(-S_ohhu+4y4j|YL9V@Ag~9oSQ(l=6b-i97)m!=-a!5qw5Qk|*&w53jU{4cMr@=O*!IH)>@J zpQ$OIITCX=7`{vhQ<#ZrQD^dS?e$;3*w`N^r@BUHTt1$FPpt(*nd*UIPZ&&m#O`#r zY8Xvc$B)!=qz4iBZAGcIo`Gd?tSohd~sc>1FMF}h`H~#y}`u~Iz)n3x8tOLIRyuSc#0`l!H;etgTEVm4Clx%FW!Vxp}XW4g{@)- zhDzI6af>esJdS$n>_Ejmy?zB?QXE-9jPjNk4cID7P+(`5dO?WY z1Ls_USnkJy96}iaybgm+)DX|uETmhgUae&g&NE@o3H)+h69Lfab*#QZk=tCoKQ8Hv2Wa-a7}|1cUOr}|L^bl&}+ zgy`kpOU!w#JKk)?geOU5fe0I=ayJC@+WhA>f-yFJQ=t$q6f3v-KXXvEI<5*?d0YRc z<3IQteO3e_it(A^f7S$}NF!6>`rnJ?|2I_W{|c%!U@F^o;@v)RbVC^p{ofr5=FDl?bWJ z08t&T*k4CkcU`1pVuFdD;e6h9+ezoR8>Y#r^?Znvvn&OuOT2SZF$+p%(wEOWX^{^-CXY#REja;aZg3PDN!Sp6}DX z@B&<)*eh==*4N)~G~z8P{n=++$m~ex;?uskPWrx#S%@qzyIQ7svb+ zs*)nVf_ZhHW)%w$Vrv&%40$D2mG2@`6Emcjk%`^SR5ud`Zc`F3cp`I>n8xq=a+znZ zC34#u6V|Pi-D&x9bI=Qi?ENiy*N(67_RJc0dRrJ0mjW;W=KyS&J^Rl)aTi#hQfA8P zm%&9q%7ChGC!V-_%m*7c^RKOST0zf&+bK^+mneyVj@iu}(ngUo-?v4pg!+5x?&mLBIn7Ov*EuG$C_GBX-#jMBeX`qM zD?dFfrZo2Eait;G$}Xu!_3S88ef}&uuK?-0DR$7{;P;2vhPzbNaRy_f)@z&E9PD^8 z=vz-0f3qV0=KvE^XL7DpAdG&FXu$AN0<$jvX3+(PWf%`S<`$@ToFoeh*Rr_!!pzlQ zk|Jy~w?x_wEvkA6*`VnG_)iXnZJ^oZ?YGO#TEkCfOzQY*v?Zam0^KI~My%FBoC1G!leOlvM3QDgC~XEbxd9fv(THK|#e8 zeL5!9z@O=r4s&X^{R`pC)p!zjQ|(>~^kW<9jt4U@+5>VuqU91Y#j_Wt8*5CEEDNHG z^3W3%)k1~Sy{Y6H>dKRYT_T}G@ofJ}0xM*I_1qz$9Y!lkjs?B7k(7Ya3RTvfYEXHb zq^&9M>U93s!}g^o1-YNp@D3VAC(U1o)8Yj=;LdJ8|7|Z5rN}MFLnt)BIe;}LmKaD` zJ`>MM9`?nMO>D1{gK?oXt3gwdRKy$=iTUT_8q0ho6w>-opMQhFHFdew?3e3Bo>P@b z7!Pd>xWDA2r>XWUZMk*WzA-dDnq+H6c76y`(i>b{O*(q|5OZ@+*1vK?vw0v{!T5Hn zy=XuUAn)IIr&=`E&=zx(yQHM070iJzgL|0b+!A=`fbSO<>;ENyT3Jd$UJ%Z&pUUX^ zmbR%HJ3wmKgo~GMs-?o|&s7_ySn$K>fVZA7M0@bV&HAU%L^I5>uCMW01Y(Xm!N=h* zMrJ7-XsZO~4;;V7Hk9i&K0diRR|J9g7ueeeOWEzv9POnQf8?+D>zS3iNng?90RS(8 z1knT+x}GCw_#GL2CGI)t9S|b}MUo(?=Pm@x#L~m(@oSc8kw$u`sZYM=X}b?`{xn-KeM^yeh6{RacW8QgGWLc8RtD}&+IAO zaOFB?tzOX680(L z`BinDv1YEOBH_%wMk{Oh_^^}hk3@{;AWg{oBL|K5OP!BEpUXB~5teciZDl9Agy3}1 z?%~~AKuk!En{JWkf3aJoZjpd{6AAB7?iI)fM8TIZ(k2fXf|#PlT44)rr%?(;*!c^w ztZ-}e7(tI!P$T0}d~@X9ErsrR?qDT|#vF+>yXp^Ciqp$j5%R}_qO!5SAI zvL6ZXolVuVY#ok(XS!~*VZJo&vXh~wjvLxiBJaQ_gU>PuMCN%=mRT6wub;M{6Li=e zffgj~()o`BtVmyDIK=L^LW;P!USGU*_7%-E%z+e%?lsu#D3($WmihaL9D?hy-I4^{ zX?em=NFSgVBA{hR-vnFSjg|5*|6@5%M+g@53a_=lXV9Z|!0vOm`rPdi5lKg0f!Rub zTM`ca*aRE~FWqB;Jfbl?KTF1;1@8KC0FR&SeK6n8g!5o*Q7dZSxY8NHHwCafe%kM| z!`j8N2?Vy>VD#Vg9no6-$U=> zXl`-lzmCj^1#wFz2#UofKj7Mf4T)B+66Q=gIgCyBQu`7eXd8P6Eii0hf zDs0m#c}?v9I6$bc4~s&`)zUpN9K#S=hN_arG!E57aVu`8HnFJn-YaL$%q}Rn1F!Cc z%jr)&D?GFF;EqyQui-03F5*2A^Q>4(@Ps`iCksLf`uM~2GVh59{*#{lDLDbKIBqQ_ zBqyWyyi7cc|MZ8M!3diRF*j+dnx(|(@kNr(%?Z1JlQ^be7`J&BFC31V@m0wAd(VGp zL=xQ@mSrOtR6jkVlP44)mQ>TFCH$>Ey9RaYd9fR9OW%QFi$RT+XKS_8l;yDvjki4z z6j}^Zg(7ubukn){rLROyhUY%r(UDJbheFa5b|C+qFB}MD{;_eYs;y#K>$B<(;~d>c zYi8K*w&JZy#hL9+?|KBu!hn2N|Dr8CD2i58b7j9?noMk|QNxyiVT9qJRM#-9^Sz>%4nHtNS&YGqQ};<2|NMX2JyD0ZV`0v`D_Gs*ze?bT2VcA ztykNL%eP}!zT;~yn4$N+lv&|-XJ|aD!JmfZvuF!wc(#mWENe*Vtja;=zhDc29;h1* zeY0!2l%i^Rg-UY)6D(m_54vqKOcX@m+Ms>1mcq5kxz8cSES!aH3cVSz|Qsz;% zS>9E*dvE;4U|#B&G#xQRctzw5gc-xwBY*Zh(&iml%qFPoWcndCS%9hh?^;7bQF1D8 zrpy;grvcUh)6(QVvM+>omhpUU(dcvTqp+DmjoF>l>fB(i^Q+4ch)C-uRj?{$2h-QF zON^IlGW#Mv?h z0q?c@=2+uYV>5bOhSQ$2XC?_d4~e{-TdZwg>-=hf*Idg(g`2ssZSMaKnoj9xax{ff z7GiNZ%Bb`3!*R}-IMKRuV>;?oH1K&iBYPTWrQzu4GZt-trdZnMN5cTmZLw!a-tnYD9a?& zTfI*X5k_|g9jp6FTsj@xcB9LUTt{Jdmw(UlIQXeJLl*tlHTvhnDSMw}KW7-M*RgoI zzxmc#CDUTz>N0O(Vjqh=T%hLWPRr*3e|L<_PnUIuhRy}hFxJ%&Og}Tm=`BLzB9eH<;l&8QeeQ{WaMmXS;z0?APp&epIU3)#pAo^3L{9I#pc~JU zL~M=+NksF+2@g;xjUUGhC9Cc*3CS$}XiFCuh~d^bDlsFByhfQdHnq5~@orZp(*h6Y zjNxLGEG`!#er$Ohq$x3nw5kTxVTaHHI(=fpO5Y~zqY&e?P*tn_VV+z1pQO3O4fzbl zoDHSeDt%Qx2gdgayxH|!sw=c^*lsIXTygZc#q8w@e+jRes7#vFU--Pz#- z*hr(zG=$oF)~yt4B@|od5X@jt926?t{xbVC0A;*Lc9Zxq1Byv|F{oTv`0~Ivck%E| z?RiLxIOl)411ABZX4+K_E|iaHDb|Fzq~wVVl>_K5%Jl{fDZ3LK29vY8ZCp2_6O>n3 zIxs%g6uIT!*0N=G`IA$L&OZrTRPXWO%;<(ilvLE@vi6SCcWNFmLozR~;D)XGl{53d-AgVMsFWG(50 z$GPL6PXZR9>B-*@(4pz>J7`wVfGR&Za|F{S28w?^KF5Eo$l2fSzT`-4cmL@1#n}q{!ZJbcDR(4n zzl`W->PtqX0}q*=mXgx=@2o4K%ymS@M8$)D-C1yO8@Z;6{c=qRj@QXtvokmRfj^rb zWavRgQpWl3(l|PVXzIv0Kb*yG5{v8Rv?f3!#gO7)n^$0T*OwQeV?WmIAx2qxRA^j zK2!V9#1Bu8=Nr7E0Z1c=c;7y&bVN3LxW3u1c!+FOO=P2d;gH1Ixc4?ZWuLB;=6zX1 z2DqbqH3)EX&mNbos%@YhoL=Z%hsv1Zld&?cIbM!{T(8FS@D2Lyw^Dv0w}sppLW-7R zxvusMQ?(N+y%F!&X&8M~Zv_|q#6J!@+I&@Nqs(<<*t)T?-ef>4Dil`IA|Z!lSVVjQF$Suee0heb9~wlh!-W5;(q2@|i0iF=LQmayb+JhS;YSAq8| zSw2(6apUqr*=Ej(;%DB(AF@O_r~&%qJihOy$T)ryzN5nJR2CSIh`hi%TaQk$5@xD89 zTEQx#P+x&4#Vo8Pa(LA3yS)smNM0}NaU7Rg>#$*$se;NA#!>332j(){Ejz%HO=vI` zTVm|Q?`2pq&<4(N9&^8vJ`vn{kG?q)Zgn*!f&N{mVRr+g$8*^Inslh#wED4!q#ksOIN#J zp>z%7C%I}!#z9Xee0h#5A*5x%oi8C02R`A(y*U_qDPTb~SaKyg#{L^q*yDtcScP_R zduXk_lKOxjOQ>#Xq~vNz&QVF}85eEUjY!j~#X3W+yUR0+=4Af-(YL>`_>}6e(z{AX zPj3#OlZP%0hS7IATyYsvOX=kynr`wZJv)PIYMW8u6NNgZCn*nX$(z&XRP;l)&-vT( zY>r~?8m)#~VFvHKzc?;FG+q9G5v19S8FP)Z!vf3H=v=J7$@iRnYpcf=x!|7^EoyCg z03eiWRN)Z%Pcn`f(zonHur7OYCy(nh`}jY2PLT(FeTV5w0C*XC9-j`J!$DurK!PD+ zZA@wW=VscS8~k)>nHb7yeHPN5sRc8$jYZ8z+Nq@m=lxzsL0d0PqSVuEYdB z^sdfU?i^kP)?ax*dj83Eab7LeKdb&e9#w(;;OF6v#>4y)ae>Gug~~-L0_Rxy#pmM{qTFxl`{$7&|K6{KDkpF1& z#iewm@ccn@y>y92O_l;wv!1%19C(GJ!GB@i?wvw(3&ij3Gf01vAwsLtc7`Vfrac}x zu_Ulx^;xoq2#(IvFY&ukVTS~5C2y`qoVz_LT6GTg!b(lJ^la-J8No#IR6;ZG;Kp=x zM0t(}8`w72Wda<&Aj9y{a!WWFMC|XAnfO2|6g5<33+rE9bz64+5=(P$^in3i*l=bt zaM)OtY=&x^Y$BT@~0XY4WhchuHlvo>w#oE@E^4)LRI@GId89h~qGV=GC zV!{@e%L1qULSWrV;4M%*}t>U$Y1{2scvV8`AYde zH)|@xj*Y!k<_PhG^P{xSR~aWJpJPPl-}_NYVDTCQszN|`yQ2-+KD?^3-RNO?jQaVr z)dcVSH?UB&q?f0}%bo7%c(}6IttGAe`Y3;w(|QlD8F+rDTpq6JDYXRMoImbxy|>@X z3bF$R*GnU6>#ZUYf%t0-MvZF3h^f9X9csK{1KvRg;MdcUU4SOVJiIfO>4UY%c(oX) z6hL4t%_3^VhI)L*yFrlOn-K6C}$e2xU%2QYW^#y7qK zI%&;{(w0^El+JQ~=-V3wDYJ(IT%;%PA5Y=j+pMq~@N{uCG5^(ouz*N7nP6fv&vW6n zTG?cxJ~X&TJoR4e$9Q8Sp}rCBD~D^%JV8F6WY_bJMC0^~j5R9mtK9)5g;AQTG2}E) zYb;^dHK^wn)0fB>Kz0#8xi$o-s15wrW2#wuQoCN@x8i{Y%)t)BXBlf#QZJ*^?46Jg zeq{U`Pp3vO2~7^Cv)0kLcSfB99n2S5O)r()9_&5DT;w`JJKBgks|&1)J%yvcd1@*~ z9+527J6=on!guNpmYb4Q@moGg4Vd%_T(hiqK{qEE=bK}qcFUJ-l-(V>TdvNMB|L^2 zY>jzckF>;A_LrBgSLdsmk2gqU4^av+8hI?iKqL}wsg8ikv_baNJ%9JlMy$*gN{e_* z=4E~+oNepX>a~9;-~Hb=CJq_Ze#ao7Y`rS%FiaWJ4E?yGR#CiQU;2vk!)(~#ko|jl zVCgWG$$n}9j1Ag)N8z28V+P%W`NN16AZqQay7`WVy$%a%JZ0A%&oIyqJ8wpE1-*4VJ@(x|EOC;GA9+SXb>V}=a_#jH3 z|Mj9aIy*vjF&k4&!bkO>E6c;W$1mlQU0BTjU|9T_2%S=mzJd0U^Of0%X^*<*_I}vj z=8FYfx%+Fj6@L<|j{Mq?z#{MM%BE{^d7_$gb5oPMFSpF=d`jhyl`hQOJKmiA%2QQR zFQ2LU$8;e@i{&aZ0mhTo`w3P8#n}B))1R8S+>oswukqZ6;G?kc=KJiNhi@NyAnDN7 zuB2h*6anX-omrL*Vf)9}yKChZUY=fEZ9YF;#&ZIR?=GSClFXi<{W2MRoV#m7m6n#5 zmdxZo@6PS}X(>W|#&=T?3)pND+~fW&v<DI>+Vt+f9{3J zZ;cy=wL0ee_$C^fNzfR|-xW5;yWz)AVs+wGh+zl%QH$d%V0?A0PI;Rsd4|`;bCbKD zlOs$C(seaqG0hRe)Xd%BGR9R;-Oe4jM?ktR|Aq&7cv}GqVpJYAbq)Xv1h9sol-~uX zE?J4tXVLbKHQ3_2xj!TbF@|Lvaog@5cW7MrU2jdoqtdTlJFdQ#zdpXRvbEh*^|3HM zI>1llhfo92aDX-)7GKuNCkm{wxDHn>^$iUtl2ev@D-TBg=JqWG#Q6%Iecp(G|L|k% zkZMFu|F&9qtWcT${(j-*tEuR8Pgr6nMN13Cgqri-Za=Fnp*|npdYUb1 zX*-N=NZ;3&u@uT2M%9@X93M;Y#CooeQvy4r?(tj<8GGf&+=Dm37N)U=84c@T`(VBb z@UYkd+$?5GKf2wSe+<1_xBTN}9E?}9;9##&^Fz$vOa9gC*UF1`h%u;AqG8Q)g|taV zq>IB~GSMBnH@SiEugZ=HYWE{yQ&0smE$Tt*539YJgsp-6{o=^HV!7s zpAP3mT>hU!lCyL$jW|@*6LaR1HW@R<{{8y?v5S&tuY`dd@jZb*+(bmi>pD zL6kn^TsB4UyID&${abDtvAv-vTT!+TD-U&Y9Su%mg7OK}f-*Wm$OVaJe|PN_1dvCl zyr170v@exniqoZ5pwQJ4`>KlKKjX(HxNH&0n(&);<0*6=FPqq^Hs&6@s^_usoRbVNMO|N+kQcpI^rHO_t>@KRHNI#n;Y~*=tyzDNZ#0DH0ZJ zCsL%6Ffx1ly3lCRw)W&w7&dx>yUN4-<7*Oe@>v(QFb}N^sUomk4XO7YK9oUfHNllO zHD^(N9pBG$w$4rd8eafROY@1EtdoY6E9p>gV2!#^SDEEB`RO{jGdf_uu{002z8qE< z9SEH)JEAQt@=e{ZoV(mcZmo8|JQy{a#nIFj=J1XOeL5ZAoyBK4r@Kps*~snbMhn2ZkOgextziJq@$jijYFvVQMp zv1mC#G8MjAuohAD@%SZ%wc}@5Id^<=6a+fmj&JIpZ^bvI*LjCtCc7QCe;IKCc?E-& zY2VM8u!wjFM(C1g$X#-`UyOWLKdo85MY}#7Dzk2?z+K4~HokGytQY^35q}hC)r)B+ z29wwySTR>kyQ{4*Z#%3beIa7whT3**A^2Pgugc+$&Z3_8*W0#M-zsQ{F_@6Y^gC95 z7!O%=na7qN)?qypb8sCusTFL;5A4g=`>MsuxYHuXX>+Lgx^8+aMO7lbXU&;3A8QdF zhkZPaU9!6ba9>*oJZ)0jt~WR>XJW_)8Ab<`Z2$@t7^sE+_wk;QCZ~RT;E3Utk$9H% zq=WZ|&VNg1VftdWttw1Kf$p`az8827p-k>>zNfBg5XaQWVgiDyg9KeYJ@eDXcd66bO#I!qh%>T zO7tG=Eyl%fPHHEJ1_c7Sn_wOJD|< z@a~EE9jYF00?53+P|y7M;+7+9Hzvs9$!pAhKYJWmbsG=L!Ot*mM*5!OL}HHJFDE*G_KbLW zQ&i&1zo8p)DQ*naZa+Z#$zsr9Gvn2vw?4K&D63G1IWQG*0X*wVq*EnIr@ap>-ek%g z(uk*jsVAS~&uUx3IKmUTHQT#hWAbSHIX#MO?2{LDRDo~fh=_d5yWn=hX(C@fuz1L| z>v=^JD-CeyGm-SGN`gC3vlFNnf z7&c~4F`y8htts<9ERfpq^$Gg~(>{xJ=@e@ub17}%w>S~OacH12)w!Uwiy?_ANfnA- zh*tY)1?-@R>$9pe>3l<1^2*02`{4~{%!FmH*~}*NLW~PsQreR4V&c-s#0tw^3OHQ=|-27myUBB4P5O=gTIukU&>&UIs3 z-)kn5LAxdBrYc&!nk{(yjAmkytL}+7dB~G@52Hfm$W{>>FOM%t*J3;vtuyZjF+(W} z+q_dPY07sVg-+{ucbp&Lik~0!U_ig?!+WcL5KYkE)ChIl|7H;nB^t>h#cLGnop|`n z7Ma~e@H%#wtBU*Wl~9O%9Yw%1?4KwmqM^?~Q@c+U>*5TE?%#B!a4)^MaoPyju&z+N5z&X_7jCj&z3n#u-bE)93>fV<9A7frVIH9X=|Ac^+?*tYmY0+>iloWY zxTvwT`1eEz*t7IfCNh-0FGoHPZt%D86X0ShVJiPp-~f4wK~DUUyRIci0plC+1(5}s zEO-8Fe=5_cN~c)~_v=0%5KDI+5cpl78_iummL=aB$i$Q>!Z2$`%3H$uwXTL|GX0qA zeRZyRW=%>bZC>T%OVOo?xmKW1< zYQF0~*rDlkE-KgHvL^~T{5AU9#Ta8Fo4a#C^=h!;WQKHH&>4ou=n zoVsWr_}PmCSNm;``>?nnN7v&|%EhpzapQdv3a{{CC36bSslh+mX8SX4_|mwKwNgPd zsE+B|P2=;jXt;W%`NkT>$_PJl%32lojHdr@)-vNsnBwsXL?5Q0w& z>OALrE<&Yj*I$!+^;n>u{+wv#X^v=Nwod@PrV^|dt~24V^HGMJZ}HTX7*ns}GpkI8 zH%DGLCdlPB@HFPhh+;xt=8~Y9WH@NB8=dN#S>}`@%Q(1Oudu(y*Ad?0yP?t%l9D95 zF*R<-o~AeJPp-VI)X5XZin3_1aw5;!^@X=^nfFoJ2!_>Veh|n2(9Zuj{~pD(FSTJn zTE!WS$sct5hdpU-exN%Hqf;%SD-W)+j9bLz&DT%KZ(miD@{FBV>**`Ax63nKJt?t0 ztuMbX&fx7{78-Rr;?p5sUhM9alyc?Y*{hbyrzcEt(^K%kB_Gi?4qMILO0WGOW66gc zA<^4BAnVDM$VtAfsFg6}S3S_&n*9oteiwksqa{k0=A_K=OokeN5PO%4GwyAPjkDwW zv-q9QlAa7P#{p0Ca*PxgDE+!sH})VYdq1UFRTtNqe%h0#x3?%T45=DNr6tL_84}Py zR%kG%dkr^?WGUBcE)E1#L}B?dQVC6IZX$2qVxwxFVaUC)7bjTpk7u(rd$*30E#-9g zW z){uidH7s5omJ(r6iZhC=FeD6A2mz_xon2*nG${66;|kIS_NU=-<%ZA*PynjT0kcX} zTtP?VNJ#2z&GRYcg5v7iGrd0IQM#I}I1Zdh`r<8qQ}93SXd-PiXkG+(uR@{$W)8*5#>V%||^Oz;+qe)c2i*q21R zWBB*DtZsdb9GVQPL*N^Py-qkY`KQv80bwf=_B1CK#s#*%9+QF5qfxCeSL21vZWrlfrV0Ru9rN?jE-XU;Bm~%wL2b3G)yvW-~ zdkey|ii@1qgdQo87jLskXIsucEc<>HEKV*$@VgqGy-GEaNApx3_>0#YTr5{W=Z}|Y zi=D1pf^W^7j&Nsbam&^e@^Ql8N0-kPSnw;by{xH9wZQjMVVJ)k+?qQKI{0?`jclH` zm&v?aJ~$=l!^(-y3=q*|E_qv|Z<~3);JWEN`qQ;B{&rYj>7o~qR6sXIik%s~6Du|o>fM;}()Ikb9%I(U7p{Va)LJ+K*DnKmkxW@i zhfNGl3hN2W$qgG}#6HM?B>~F%nBVIh8hOy*wTT&zMTTve@t}AUQL@Rk3y)^oLXUBRz!D5jvlHB(uoxYQep+zd0L+pOg0uI; zndU7aNagzbWW$VTFTM@=D7@)1z+=zL_ugnxH!GZ5*#3^;x30kO#(G7-z)a+e^RfeZ zi+j7P4GwdAr> z!_F8c#_MBYSMRwUd0ouc6oylJs76DLom>^#qgV9n^iRFAI)~;pM|}Bqc3lqyu=4bu z7dsz!b68QJEBJ314}6<#qpx#Ne`K$Zj+p8HaitAFYB0O5e;jGct{&eIR6kY=h`*)p zO}ASZPbJf1yZy>q2)XQ8hg6v;g(}hFN=&FmhYII{oXsCeSweeWaD@HJO=Jkd>}q-w zT&-?$G5cZWO}&Z-6KffT$;z|+=I6EM)bgPj<|lX)5b8P3+F9@Hf?@DnaHax7u!>QI z#W%Ju+KdNohq*3h46PwtG!fStSg4_t9{MyxN*e?-Y~l8F?2>g4?lY@)SauaV>UDOk z6_(=lUoGK-p)ShJe$>IA;-M*1pMP8;%#oDvj4GMf zqq~2-F`^=2>)_~EoZff&; zvu95Md_KpvQp-o9&Sa!6ztvtojxUF;)HA**WD>s-<%Qry$XQlV+Fwb5c2oBBzf?G4 zo3;(mSRy`vjs2&p*sUe`_`2IDr)@F?cXj5lDb1Kc_;eDRdUOC&=G@|!7@BQ=nMEZgFmIa(fW*|46xu4Cmf+&haV&=g2qQX0ipo?4W96M8{%mS>xe#DITo?)v!2 zCisiPP9sZ*njm{EHcdHa{JL8+Qv4qR(;FLKPvMdljbrl))2?@X!m3k;(^`P(>EKD{ z{z+5j`eUxYwMe2MwjulKEB?MBg*cY8y4-4W_fg*982aIFkg(?*!-;2e>Y!}G8L3i7 z-FfkQ-ScF#-08487kyHwD$O#Xax@!WdVpWMlA ziTIb7Md<*}1AwMQA%3}0e5&co0X@>+wBSsRgbHaBDd?HL|3CvpX}0n0NxK^Vfp3ZC^jkmVgpK2rNmf2RHIGDZMBXsg3ONIB1cpH;WFmLH5gHQW}r!7bkRlREc zf>%osz&CMc8|3~oIG{vF9S7(=2$qy&c8=-)91kfz#GD21kH18hg*|kqJ*c{10K3{q zKL`N(6U9jbCcNv1Fdy5fzgs3P+u(suoMpiOX<0Ph1_41Ai@a9eXfC&@ z!#VQrnTS6;2&>$!_Y(!th2IbbN5m2N{0n_jK)>?Zno#h+E{Ztys|aq8OllDreXSeu zbV@}5r}WEkfu`YL&lb&{=H0>_fkY)agqd#x*Ph1swN{{OuAl7ocH=EW(Sqzd9nIX_ zZ*H!G7XzPxs(JUHr9^TjmrvIJBX5s=w`p(LE-Y*@x*>*XYG4g{F7yAmU=j7-J~y!d zF`<5U&Cf6QB~C+7!osvvv-;oh2K>qSf@lv4+}kL`b5!c@f{ggHAqrpukwx7DlSkLf zR=vFcIbSs8Z|V@sqvO=_-*5Zl-}5C+!^u;l|9x%I?m&c5xN6}2<}5EQU|0OlA^H06 zEEq z!Y)%lnf$MZaxwzpDD7@h6v_LGC{JG;SyWp>4^y;grDcY$FQ={mG%?zmh1J#o9lJVq zd!7QTM1k64z-ah&;(ef;W^cJeY?1o*Ux_2&_WfeBT`kIhV)x*i%)8NV+6x#HLX0KD zuU<&F{2=g%rBjhm!GWm(WvuCvlN@2vAl(7HsO*jTt!Ayl?Fm-G$l*V`dKj^END2QN z6wWrksbFkQBmyU)#P0X|Hhc|ZB8`3{K6;M=y1fP2p^U~w!EcC%6|{Oh@-K*d`HIuE z`I!GmnwH_YX&x+aPTe$gmZ-CXQT<8q_xw~!Sd!_3rAoC&LPu`a(J)Jt(t%1bR653b zyv{iBaxC1<<@yO0>3#ayMp4}OuGGNZBme+T{8zxGK8ht``zPQg)pKTk8!`gW*G_{Q za^d?iE1l1cPB2knI0X(V;QON0KV)gKQIxk#;3h#(M`Y_H42faX74D=!v+d$mH@kM? z*7b01znm8vy=-yYte!R%|9~-op1pfNsWZdi>dnnXo;NQi^0dYF&4@z@W&T(kAhq}p zB&x0BfOc)O%2j&^Uogo=`q(|1Bn`!DSI~`ap$RTasgj)55~OKsO#fYq=TJIipxFbx zL2`94uG$YcBs2d0h`I0An!Ou)SuXP$IdA^nm?J^g6UWU(>`ETHURZFhMrmC3^FG6V zCC{C4n*Wr}1>c!mG-c+{iQCQFtE0F-cI@n8d@NANO{o zh9CCvYR#G9T3z0l8CRC%5bsM`HTE;OfKtnb>Tt zrgY@JLS0com5YjUdMJ%@E|I%w`2)Obz04YEjUTMKl1JSe*WGte@zOhfg%gFq>m+!- z8dNYfF{XS$L3zg;DO0hWiPjFtjmc8K16HeP#_}m`&B!(v2^bB=FW)j^o%T*jHJdxi zzJEmgVGAxefYimM16yWq_B=QST%m(m}$}o!xy62bh2}KIwIuh zeF84qEW)MbsRjw&xgAk#)LL-dQANMU9>`6h-0nNWSDs40D8bq{Rs{#2ebtg+s3s)n z*!_s?cBjllZCpI$w{-Icdqn zL*`4=29qdh+X+5EKW^VNpX9`Bl(o+ZC9G_VDoePdaFQ24w>9yd75gPWe`0-Kw0aVe!c;(DH_)T# zbnfX!e5nDfIuIi~1O$sx?)G<4DV{bzc*GXROlht15@R4#%>Yvk}?)!+O%x zfz(5Lje!8oO9_|?CiM93h%#8f){^BYyj$^J1w(?D1rASMJct5*66g%KX9fmj1ajxa z$~nS#AMFO;qa;(BLPB!UG59Uph=^u~PJZ?o ze#XDYu-XvaF4sr8yCUle5nlG^qgrgJxBXR$E2Wb*kkwENimD8nrelr0Fm^BMx}Bds z+YqSTms~n{&5*ABYeh+njtqr%G}Yo(T7|Krp#kN=b1QnguY%_+oO4R9QV8*bo_p+lr`*YH?j+ zw6B+cJ_uCHill(uJ|cAD*6ScQ&q5#bC7Uv#K?u7nvjW3$h|1zCLAJOYX!*;oz?Qz> z+-Y(anW1D81(yJ6$M1fY&UCe&x8cYbvv7zw-0-WvaIU_cb=>L0%4{U!1h-s`B-Qvp0?b+3wsNE7%K z0Z_v)=;yY+ht{8ku{a#Abfh#WRPA+nPF?|(-k>y%$b6uqivZpoDl#cw#cgVxq>GTZ zWteBz?>n-sQvM=W6eYkCLrYpOTkEjy%V23;^xW6)5Aak=+VXX;$4aaIdzi;3E)IAE zyId}0| zJP~aw$ZG>L9xzNs4szm#qFVg~uc%q3+RZhm$=%6x^rdSeALkVC>(P;O<;7qIW)pG> zd1E>(ngP8cXjWd4gSW>zMw)L14YO$EY3$vZ{4%V&h4C~Z_eV-xE2^JwV=IX2vHh%Y zC#YZ!%UgU*G>$xcw^|_=r#(1|(#PxL>kgNy0sx(y!(pE|A-me`D=wmTgG_@r=_n?$ zX5)OstkIp(}vG5-~)|3QSK3N=5S3jWlt~Ezft8y)X_yK!= z>(grfL$@DyNQlkqwndZqyL^T8o!l)^E{j`kXlq?uZrOt`9;3yZgHkIbfJ!pa=J~Y2 zA1jIns$T1HiGGGp60yS&vMfEltEJde78-Mu`j z-?YfLEZy4QmnchfXCV?qzu7hqY4wy93xA>A^86MF34Sgm`td73yAxmGPU43?%~r2E z>w{TN7ru6PS?y%(cmSF?*y;dHVLR4M)-A4EhS2q`6$iRZm0BG~U}VWv#7QE^ z=RD7MG6D8gV2{|QpLv+l^_u{?x-$VE7ENV1W3)BL3C_m^VQuMCW2_?G9L3>Fkue^% zj>d3>wH4a9?ILz51vwfawu5_pFCvQgFex&^GlU15;f!01jI}-!@dVA;ZJ1(+`w`_t z+)&END--h9>zwc6#OMK}fS@lUO1XH*-kb?p0&mm}nxbL?S%g+p4W}PBBo=#^6ArM0 z2 z$^bwaCFm=^jGwX6<+oQ8ZnD#v`lL>GGitK!(7c|aNRP+}wZy{kb;4IML-n7r0QuPv zw3k@U$<Nh4H9%WUBL=8nwjwgj4u=b)^Hs5%>C z1Zcc?sROPG{_|UZ#Gsz;h(uz-M4_4IBTS`lnuKJzYvASa z`F9e`a(q+xpowT0(a5>+W&$sWBirERJ5Co7eKO9Tcc<7SeIc}IIy0Ww&IkG~t|@QI za?n_#0h7O1G6Ctx7>7?2Uk&x2&JOJN=c)GMaB_N|*YKufkhV|)3+uXA`sO69_qz_5jbWJw3W! zCLB?)M#ue0?b|J)>R{%+v#>yC!2wo%pdSgsds8+r=*i`!Gj-d4; zslB4P8_eoM_Q<)ZZ{4c=brOQVyKZj`z`+Yu>6AH_h*S}gZHuq(mz~kww4(ZSEbAX( zSXx>N2nbl28kkdY5QVmbV`5_FN-+DvJyAZGrgP1>jfCExD-lvthn30Wy-LYZKihF~ zR$l!8Ss#zdc9w8D&cqS8nX&^2aYKUoSEpAYZ6_ZLdCFQ^f6WM)UtdJlVT3^kdmbsw5(~s{&w=`^6z@Zfi%k6SFLiiVicT<=o!?yYYBxo=@ zqV;R2McXl|EzTX1MX2!?ahkx$v{w*>%Oq2e)61J8GJ>!}eILe06VQrp#X3pdR(Epq zy~E6m^py%NdFQTXghlbRxF!r6V__r?J9ysKBtDHq{j2aaMlTMpdf$C@A@)vv?R^2{ z+!#DfxcMoE9`B~y)nX@sgZ~B4*&bQoe$P>Yz~_$>9;mEcuQ`~zYNrO(s5cC>aoVEh z_LI_l!qD5a7$n=zTTG^BkKL zZR+^tf4C0-rbAf2M2J-)l6XStHuEdi>%B+aiD2c4rLo!cecegM;~*3k@*#cTv!^3t zP;b5aVYHj!%yUQ@-|i^e!A$N!2f43_woAc{~>BH z2ZaXqbJD}F?W-@Z$Nz#5S~1a8n8Ixi_qxL%fT0<5wCuuS{Ru-HwC$q=y!rcK@D_QI zz8P|RU(<+l%LlCskUC+q(C`MpSUV6d508p^`Rv)VYsZ;3q`6vi`c-#T*~Qv6q>My= zw4>Rkvo^T8t5uqyYg~gAn8kU}lE-E%qN`R+^iTNz4SFvY337|;$$Y8cA~8(qk|8Xf z{=u(@=}l#kuX$0t3I>0rIpoW*5DEdiBgNZ8!INjzp@|9zG@Qp{o6~Ty4~@=(aQL?| z=wNVLzcJQaf8_MEF21h(P>oLKft<$rKu=cOk`FtW(%JCEmIV#SpK}&rDg1ixTI!+s z6+q@9A{1Y;xwC8){TCqL#fSE&SFiK#4wMmqYyWV0_ibl^b$)n#bIf_p%)tNg#EXG-sve2U0e(hMB`rpG%*_)9&wlcTNUGJdxc6nNFl51~)EE%q1vY>1rP~nw`7n z{IX6P4~1Oryl&2|A;p+se;4-w!&z1q%phuy9PPBl=7H7v7{|l5^QaqKc4O8++fBli z72M+-$2s!^fsEhfJ1aEyc|ayMI~vUQGHwls*Z*m-C5w#w>J?AOnzAXNO__v2uj~$q zegRBNYU=zONE7tM}k%v9^~8Hn|c_U)0IWvwsNinDYOVI1iPMJ<;wG zOc2aW@WxINesVQEI6E7DpUugQ6twzN7WzO+UDAz) zZeyf?WE^nW6U=o4^X))QDBZm^*0c1^zsokX>iPhkBio3 zSCZEBLk!>qKAkJa^9y-eEmv>4z9mu6oi|4_{&<%!=~o}^L|Ll2^h#Ckf#)6FhRRXN z+^Y|Dkpsga&w7iR&m;kZJ-pF3hm)sQOJ#D);xs4ztSHB4<+b&f zs=yjM~uMHB?d5Qi~9ODf6FHI?El+w1EODsV6 zEO*{-LV*0;3}_G_JT%N1*4OgZW-oyN4L2Fs0)%Zd%c$`**wZmnmsTbZFGoj6(aB;z zFMdZmbiy!UM5Wx!>Dl_1n&|EcIC<6Tp#O{Cr4#rjv)R%6jFrs~C;sJ7#Oc`!7IJm) zed2bs9=9P=93p)2BqZ=!|3X{Xwl19*+6nZH7uRw?&`Us*%s%6 zhRyQBkO~<_dTn}}elv>(tN`=q(kE;7~jo^CGxq zMXNx3-8AqYJgU{S9__iu6(_gYH4k&+4_;lhA2tPuzH=rCrQJ1IfLhG%>8|LPFE~A` zuTMTr(31$CaDu6Yx>6l~vC_G`hihG7$Cat6REz@uak98ecMr0EVp*c`aVf;d9-Lcub)b^QnD_WSuWvI`SkW> zQ=bd|@?-5=nure?N91!QaJ=!z>@p1g)J`0obDSFNoGs23s zC^K@5FC`Kv#_W%=DR$J@ocyi6aFY5D4dN<+nVgiIIyP5cG}y@^-0=+FSV}O};&c}3 zG17K%^O6*%tC>>+ZLyL(30wCoZ7UF4(9*2}%HGQk)Y`nA+p5-S{f7hTG@0pzq8>3c z?$RXvf=?d21b{FI@%q|YV5)$^P4>@E!&Z3fFaD$YMP7a+4-fObRpDPtB4|=6R}7lM zcfW3)M-9wZgbKCX+1Q4sA>G@ol|6m-XW;ebuizQO!l$m__DAO zXB>z&I)Zn494;?UhZYH(SHCYU6~AQ!DCIwYy4c8A2{+Eskl4)>tFyaY9CZDYQxwhV zR2hX?8m`(YIU>5=2@uo(%b`$ z2uoc=u=^vt+d799lUrP`kgTpHnS}4Z=eb@b(;q=AE|z%i+TbVK@pni(HrFgbAMw3u z_IiqNKswO4GL;%lt6;NhwT#7%5ClAXu5dD&8yw*7##XeV6Id6I4G7`*j9=pv==wIi z-kek|Vu?@1|IUL_3~HMNWvhv7Yc#0!HI<$4XsP6GK}W6k>bXUkNO5h`%$ay-^Uw`B;mZ8!u9EB zpR9tlgV^)FE^gb4UcXBVO9$GUxy0tDrS!CPN!V;M%i0|+`Q9++pST%3V^2?#8O{yNWLpo1q>Efx2);kHKNv$Nht9ml{*3g0 zPX+J1BU!^&k7*SmYEImd01ZMv zWU&sRiU2f}?ZB8pZ%Y(~Yob*eLoFN*masm|^j`6*Tm5u}l8OOhjAL$ly@jdO&BN^x z3G#=0dH=eH>5N6Gq~y+X6VD7_-e2F;Py_lyVfa0}uh_*I-e0kxq=>_GbsAwZ@y%X7 zo3u1ZQ^u=*Z=h3G?WewTJQ7w?RNRR0xWDGsOMdsFy)Kj-kXBJPI^=I*IZH9)FMX8R`><9zB+FxEE*rI56xi+8(ej4_AlkCB#qG zL@0r+-19orRq4L4)KpdcNb#M2*W{);gWBMs2tlTY``uZ5^=#msyTA^)w3K$j28&~l z?j(FTAJC_C`1n`a4M-ma6O6!6?tpE@c96iT`xPkw0?;ur8J^}y+?*Bd+3gc`H#)Aa zr$b8%`c?5^cPIYMaG3BO(87%yc8NU!ul$+ZXh&&#xOjiHiJe*%95B^#KJaTXG@1!O zCTp4id5+MEIS}ParqwD-+!v17g`+)-cTQXvt1r8Nr>Na%w^_F5X>F0&YZ`m0X!~j73>hovRub(}k zZ02N zxp6qf_Na}l9H*0o!9ZLJ4FXQ6GgZ~=mhm}WFLq>wjf^`P{~-p66v;XZgyk z@2&+jJU3b&O+~eDE;MkvYT+^9&>;|dmR#rN-{N_s*thuDv3(dDvXSn2so#~ydHv(2 z&dS!lukoVjk90{Yx zAm)AS^?k6fm9<0H5Oa9XOi40MKo4vI5J*-0Pq1It1J7p7Aj2(|;+NR`| zLvNYJ-ZAWaO_gX-d4cm~v)fc`GJ7ZsEQix44sm9D=IFUCwX}^--%xohta*lIyTw%&&i<@?fcF|iRP6s_ihV+s{>qy z*=YSj`w^F_(ZrnFw)P`|!ITU#z5|HP!a zc2QxOq14AzPlgu+P?a7bg^@hqtIsDoZEw$x!RJ4I-#!fHt-@;`nk0sR(@UqhyW~@a z!hT)z2;2>Sz#w6HWl%w|+;q{I^;lPLyfe4Fyu7<$vJVFzKeSZg`~%z=?ISRDr&)2= zAhY6|YC&|mG-T+TXu8x4LFxENP7E9 zW!v8I-|T>Z-H$F+jIWWdZ?Ec!cCuc}*!Q zA@PYKQg0y!dn{MRkszq&^ZVF(hllrZOu9K=vMJvEMxl{Uz%Vw(4-lnzg^$19-qBWJ z@xTq7^~WO?y)Lp5+|%<~X*Cf!UB!cig~dxcxASljU9C=^lS!8eiukIlJol&EvvDs1 zMf(Q_J8Smifn5V~x@X0U$S>R{H&JCcxcI)`hT^}vd__EAy|H$E7A`Jiq%8=9(r`9R zTuJtG{7^svNuSyk8H9jYPN*7{YaQ?o*I$f*OD>an_2S*=UPT;8&)k`NAr}fL!Uq7B(&Th|PQ$`Q09qo9Z zpP&2BbXwV4`^(aZ7=A?+4|kDEWng7_0a}P5oI6=$CbH)}!VT^@J~=`2a&a!jl!~_$ z|MyQ+a2vuX6OQ#`VwU_R=OX2#Um)+ULmv?E`(&*qYtK0aU|&&&#b4U-s@z5`y`iAU zf^!5W5yw)~(!OP2s8+$f1y+)J2f^xv?k9ho4*Um(hr74w@yV0ski4#c@n~VTg#3Io z(nzMFq7u;b+NYd&mSf|JE>`-NukXyFEp=8eB~z;`0Rq$idt^zUvo(y9kO)+hlY^53 z`+q;x2ST=4$f+;TG~!=JVf&Ui$^tN##KVY+zqI)TNWP=VbKCZ-ORp&Z59K5v0r6x1 zePs3eA;N+nu5&g4(%O25@c4fiE6VG`ggB98(#)(rP4sZlzY7Fn8Y=s;8;gp%ysP>A z2wx(WMfN`*KoXtd3UWylw6(Ssv9XC_ksXOhZ6Q@uQuNg?lpp~uyDt47y1p_htElVt zL6Gk5F6od?C8Sfj!9Y5sq`N^xLQ;_Kl zbI!ewNxf|)2E_1o4bv!kA*vTgs@g#ozX-D!oVMPNRg5D)xav_nHf2*^k=WI%YBSbK@#{-!lDp36nB`;~hr7 zt0h2UuDGeb{oWUftf=+U3YBd@*!R83hgF+Q^)I}I18U5Jt~>W9rSIe-w<9IE@|q^w zVWEX}BQ)yXJ_t;_Gv%V4iLhqtbbCoeb(b%q?p{*SlHm#8xpOa zcip}D2V~)dRGhg4$0sNM_o>X~h9cAxhn6^GmqgfI|Py~ zzkW6ony|iozF96fRBG*cdMej)Z=y^O1*wwOaFB43r z>ecW^^B|i}1?}5=UH1a9f7x#xwCXO-W;mkb$(xkw%ySOypI2pqGA@P?OgZ%f7ryOZ zXx19-_&1ZYYC@NsBT5=7u{}HRyt!!nsWCK;6to~f!s#&;$QXyVa>1HqC~L|tm`WH3 zg)=XCet^8Q%c;rdAnYOX1wrGyxFbyQf}*FEGa%e{T<}9V7a{cQH2J|UNBvocBXOe} z!i{IVPshzcOYLYV{;K){NME9!`D&q2586NP6d_dl5L@I707a~_yoxMT$(cVHG_W!PWD zHgza6b6J2xMGir_e_-JnhR2)zrWCciyD_f9PVwHO4)o6_>~BVvwc?x3eqL+dSQE5yZq>-3G5l?Ua=pxxMri8QY~w`a4QaJ0~BL=N3#XqbGurlO*4 z93inka@`dY-41BBf(${Y*qM+s>)Y#O1j$Nu!|K-O|G+m_sC5xDLY}L0QlcUzbwqNp z@i*vr=NyQODr!WS&UmmNUq!;+<2A;NuLresiP+~MHd`2}-#+%dmuy^6b;BL(_?6ZL8OkEpZ;cnEL%mIK}FeAmZ9hp0d<(9hph9u2_Z4 za%|5DMtHTvLKc34DbHCx*1Bt8J^KFUCf8g$JUDhW)LpaO88-G-KA$b?!OcRe303tCT1$M-PKm^-ZXv&IHuJx^l9MBVG|vudPW@Xy{mrT- zxNSXkzt{@6=nf*B&H9Xus$q*vcia$qJB9qc+X4*-VrA*i$-+NHGc@)S{Rl$FZ_~}< zBN%U)fc0Vz3x`_5|26`NPcT>5mYz4XLKM~In+i*=4*U$+Q0a&99vglpd1;+wm5~MA ziCZ!eU$KwuPXj4s4}&77ESNZh#&*0YF_!a0CKG;U&VtwGwD$H=g0-z1E; zW5k=RakhN@V9>Sf`A}z|mJvZaC35isnT#FA{=B2DcJM7SdZ1zF;XS^v8{+xgGeOs; zbbZSujtz-ZN4c*1$NpWk>Nu$4;*}Vwg8p7TYIWJrb|CXmo4za=F7lzf3`8 zd!v8ZLTElRw(kUke|U_38PZl_JEw{-TqYt}B2>^=Q|P5 zlo;i#&@uj|brY?-qI_{a9DMm$sFm$c>4U>>%sj(%b>~ZA0!RNmxWDgm+l{0TkiF4B zhlkLeFUyp%yS;G>Ioh*?O#N)@?PV(r-8g4#Nb!LYwBx44ECkFE@p){lnmp z=j&(RYr}yC87bwtC-rjWy%=pg4!){)=Os=-nyO8|Mdk<$#_(FXab4Loeptc4zn{6) zE>am1(N50SPPs_v8+JHm2s`cRxFU-k&RaYj{!83>h0wOfQq%m^rIqj%<{Bp^gmf=RHr5ay8t>D{kgFK<4%+tTE1GsJtP8 z>Z9rODwDcPSR+XaXQz@hloq@DX39sa9bWu(5S}UJ7Q4VitmK1?xm%nn)*5}4KM>-(oZe@dg`agESJ8qrLe|llrsTlz*TDK zGQfoevn&KkmdF_b88DnKOT{QU?JB96Ev0)Wuz_aV9=;e!kvr0G{JXz(=GWhneQq4{ z-=yuo$2o_XT?Nj?KWVW2cIoc;{hZO3w;xt-@sf1*_3M%kc4%vR2(O&ijrglzWUKt4 z^r_f9M_=tuSHQIG7MaY}T&J`TNa(K@7Qeg=6QbL1p*Lmty^Gw^8Pm&FcdUOM9`CrB z=eX(qzHv3qq;nKiY6`q;h>_O8JR6^euXW0^X!jCJ15uCNMj77m{!l2k|A%(2`kU3P z#L0HDRlLE@(PQV^`@a^u57sX7%x^CQo>|N~Axn3*IGc~Yve0=D!u8awQGX*gWF=QY zv?!Bt$L={n4YPtgF;J6glb_kDOAT*wp?5EhpNlh)fPwKhckDHSF0tBwT0SmlxT?Nf zF}oEJC(6O)rC7dJn|W-!hpKUfcG^Dt6YNg8RByf$TI0U%Va;#vQO)PXTBmQ4?Mgkb zOp!gW9QuCnK-<%zwRCI28CrY_tN$)_W|Y`a@2<(6D1iTsgPZaZ8e9zAlyC* zy)Q?1qH>0?^bX{)35o%^BxL7=ibve4b^ScPtqTVr(A!gPKP( zcRoYmTJBA>_xQg}p#u0aR}W|YPUWasCh%W6A#_H%lE`vfb;Z0*RXx;Wv=G< zi;YDomxML+FajEbl7aQkx;46`o9y?Bo2CrX} z4lVl|(jQaW78yU64|Hnk8er~aQ_*gOyN}8FEXq$f?-mw?e*ZD^8nyQQ9u9J1n91c` z;8i@Q!^=)f1hG;}wl6$u?S-iS5Dv80X)aCti8h;!BTW`d@l>l6UPcl8>9h2Uhp?E? z?4`oVEJM$9c0u2LJU^@Y?F%mUu2FkjLpO+x$DTM-{wM<>^Yj;rA$}4%r^1eJF2yFd zMCKU!#=gx(iU_XT0kJ0O#ARy?f7SB7qv>I8YeB*NH^?trwlna z*T5}Y+rS7~_AigT*S+%Ct3oyI74Cmy(fHctjC*OslHmi|iBIJij-G*jz$YQguZIV; zyMrbSwTHsU9KHI6BH& z7sMf=I^?X3%2SoYxlNN9_4_>;3Z3u|?lc~XC+bb4-mmmaCY;CKtcOS=O&T4gPvb9H zpf(eG-?_GSU`r{Q{~R}a!Wgcem7(VR3RW|IC*K|h)|(+34j5-&hCLhERQ?sDT$7J) zOE}m6JQ7colxFnGQ=YBQsPOy^6}uh#od2Y`nJ1I&E2gKml)X2%6`n}21#NOM$)>u)oxjMlAW=i$WX8u)T8CCQ*>LCEwYJQi0yh{rlyWOichC#oxNJ!N#m-j(2_B-l)I$ixzBq|-M`!pIkh?s zQ#T#j#0vHu&5wC|jr_NqC*p?FxlsomMQc&G!d(Mx^3i8J4g5CZ#<1ca6q_IvuqdR)c{ZY4~WeD+~SH`jD0FBEb|(Mf69mtFg9 z(%Y2VXU2=aXn3C5>gl2Rj((J$9df71&E+|?79AaW^pqau5nKy z-=m$9k8FoGUxTMicl<^1kTTxHTF1Pl(P4%8O)vS@)QwB$Aij;JnW)o=m4aV>O43Y4 z1Lg}6)x8}yho5DPrt9;zO13gLq90x9w`Ucvv{8y(O){Qx;-VLWhlV|tne#%p%Bq`u z#z4zqnb?`9h=V*Bw4ED~S90ZZ70!yf07MZDn{`->sFaZ47tjpfi2q?v6k28(J?NFR zk#w8PnP5&xH$Ygcsl21EE=M>ws~W6SdB&c%U0Jth1y>H%VHJWJmHY=pN*xDg;e&O` zW=X};>xBG~;p!&o>zCVn|I*}IxUtdyFlyZK zLH_U0Ft}Ww;96;XJjWFNdfWd++F;CM7QqFU*k{L;hIl+Y)O2(RZDYvO)3X#@G-~)+ zU)tFxgxm>CtVK+A@0c)D8|_;cU6K6zzr1>!@Cjz4YMFXKZ*wU=vS`=G`njb`&Yu+H zOx~MP2b7nGv+1(h*&{_Ie4|3vkY>?<7X#PpSJ#pj1{2T}pnk90vIaXYpw~!{X$R<< z(QJ0%hF_4A#;Olsz(It}`iu#r?q9%hPX7p+k+`*h8G%Z zTNvGlsHI;u*IJsokJOo%0i!r21`|mpI#H; zSwAB)SY-K*lCQE99Owv%FR?%1P>6_$M5mA4Zk<&6Y)hs-9@h1b2|1;y0mm)LtDE2mG*?*R<>c2;i1V81(MWeKig=4_nyJR!gdb~wC*=} zEoIqJ_(wsVHP6C6gKQw&4X-y zsV)eDKYQutIU7%vX!ri&;h?uWugf;R$5cIPM@NV0Vj~trG|fgdTR{&4ha|Wob)aq9 zKD)$toI|(PjTC5S!&wdx$j==tp(SwRA{TqD8)Q67Yq=(xHD&~Mc4fm=2jxC*?jv=J zL}$Io0q?bSEv^{md{5K;j>BQLB#mmQ*xFNy8gp5XBDx11dkS^WN1$ZuNeoct`nT3> zk0P`0#q4P>O1&pliyl!U*R!kVS4yv*o0woZ^bHNcQ(}CL)@gh%H|u4nsinQTJs$c* zdE>Dr`=&)v)YrQ~AW%@=^eil${zxCk+*hzx&~eP4K3^zxF%k*d@Cql~A;h|s zA&)L525U%0w&fL1n#`GF9rcHV;|rNFJ&F&EjoNUEiq>a$`eZk-+=YuFHDt`4Nm@vU z^E1rxmm30vT~C=M-R^1O*Zl8=&rgXNx^xpJz(itR=Y&|0TT_4&FFp}lLd^(T}V`*DZHP_~mnJ^QjHHul=;pnDwzqLPd4g*ZJuO?V+M zSC0fKDX(Nb_(&_EtV~f>&UG=YsG#7}-iJIffwtH=G&TlPwPJF#lG75;XHEztlaw71 z_=hS>PJMhnbdlR?Qpext&Sg#p5U=cPo-b$Hp+w6@_;=ej^}J?m1F0gujx8j^WtrKB zhhY7I6hazJ1O!aKK)8o@Jk+_#Fi>p`6qvz&^5SDb_=Lemn>4<2lUXx~?u_R6i3A7- z3gJo$3f!o7b!3!L@FtQ?5q}T*eSZ03vFJ5=RafKxq;yI1K}4v^XSK63H;J5^(`~0~ zM@Te#tE3s!_6GHJ?psPAdX|-!M>$~4^MAB9a`_FFl}ucg-J|3g!cR0Y}8-B-qVY`209>nMIW-0^gf6_?Ou35xf-EYx21Ss@L zB|O^wcD*D`do6q`$BMfKh5_c5mcao^Ar{#w@w1;4#W=pO$Zh5(bmUA-*oy^MgwxYn z&VM^J*le1Wl7#KSam}oqp;VHq{>#5gTzZ|RZa!X_p+ZdY=Abx5l0rT2rvp(ECmw|; zo6k1wbI;3dHWhqo7yWFl(+ryKAGOtL=fCy*`g%8iiW{LJa_$H6KhqDdZfj)GiSWV| zaXpbC@$By0;Lzc4j`uID78ROnkUo~W4qA8j^%Z>nEdSxd2exSL+dL{FbDfNj83=8s z=>H+2QBanal=L668rRoxD2}rnJvTv(%(3!IWsINu`6b&rx)q44nir>*VTuRz%@=T% zrB?EdC4Wn?^fmKFhb9p%>A3Qv-FfifM1(?bk>}}R%}(5Y%$YXE&*hLXdd=hw5u14Rg*QP<{Vy_`~ENaHUH*xXO;}Bv&nza(W z6jZ8*Fxq5MVBSrCyfBd^v`>lYk?vd=vPRcIzPTMV&aCR$-*G(f^QD!QfVJ<`O!^$f z3i)q7OD`@k{uTI_oC73{c?Cq=1Zv(yCF%r?VfQodK914@0icygEYRbdY4Ruh>PKfa ziU%c zq9JtvbqWds_i%?K-E+ZaI%M;xbr!Mg$8%h{Pif9BZ4HZo)Y%$XTn>!JMm_24@!ads zAXPsO;{pu`hOf12tr|NN9#g_t{9iRYlQG$1P@KJkG8+#vO6yrJwH9Pxr_1@K{nh zwz&*)Z!D)SnH5rnBS?j=4M(pF@%i7uv{G4_o<53lf7E)vMnwe#Ti5$qH%-GEka_M- z-@pL@TW`Ktm{`OX#`CU{$lKEQXmn$-m6$TNzP=*%!p&LyJgOI2Hja4|NN%$16=Bu@r|pp4at*^ z1ft4cdj~k?R$CLRwd&Qi)opXF&wzfa=8*z{1dBgYL}Q(6j8?K-wyM#E5)g2y?8-v} zO1H4^J>=&}*B9*TbA9PW+b3zxxF0lh>7DYIHLqFKt%5p?Pj|1VM>t1HKVMNM2|6Gr zdd_)?J?sb8)#0V=o>UyNK)ir7?gfPU`?)Hl$KOV0M;NW=z3=Ynkz8yXM6447_^BP~ z*G~q92(=ezqIFBChv&x_3phEKKgYPq z;Q=ZTWzooqq>GYzc?~u(2Cl79hqng+#aGEt;LJTZNXqGW6jAw`0Ryr*da%Ty#|VyN z3df^*`ZpH{u|RKCPb8212k2004sG9=2GV%ZsIU;XI=9~$cxX2dEO>ae5HHae=~ z?Ck7v)jTzYzl^cog91R->Gn7tPiq_7_4u;0?U*4b{;(hf(%<*yMGK0HpPGtOE^T-_ zV}BS=x{SSd(6%MK7?QOsdyEPZ2T#R6cTpFA4=)rx6+ zg4E&8d10mYf}WC+*SxFP7^4ixL}?O8A8+jq$p(^yo&ziBDLRWm4Lpw%TE+3X1PHV4 zJrdiMb|Z&WPt;v8P0gInQYc_bBy+iP3Chu|pU3rU!13XUC&g2CutvG8i>V|=!%!Lpb(?bHHKuPL+Op9O;2`(Dy3MCz(OEq0Tx-(# zWW!af=O*@4%X&HK=f2@}INE3Ss*zgx9#$o`RX#r|b4y%*nHZWve&j#j6?}iVv#4^% zd3|P$AfQN4pdD{NuF5Gk!26(R*33p!bjqKR)lIVI=}aDmK+qLyEVBq@b3f6 zeq|p=&doxY%5<-}Dhw$xT~^`c=QZB<(Wq{ zh;{8?DWNe^lBN+<>IgCM7|1s+Et9mJ)TWN5D%=}QmwZ-YBUCE3H(|RVu2Por=1lKU zAb*T$jz3Qki#0)_^^hjwIl6~WpyF8=z71CP4vr6`gbXg>L% zgToH2coit{t?3>1QO*Y}xC0N!=Z=T~suBax?K5#1L?apWI2C0q5FM%+t67mDAX{VtziHz z;S(B4^iB0!iF1!&p?a>MRjnK6|I|OzG?-VU&+#uqO4g4a5##aiKO7v(6W?#9HxL-$h94rC8(2K+WrA+y_GUv6IE>>i}Y<{nRIsN$MIKJ#f^ z#5Mkv5KX}K;st%jUZ`~S`5WvqtP{Wf$QWS*#vH5Dy@qd%t53vD2k6fK&C$_TYWj9d z;iXP@x14WWAkRCFAN&iA?jP}qh*mfHZNl#_Iy&2%L1PE->^QrBD-<~B{p4{3XK-6y?Qva$8@~&^+{7*0Uqfs|V|$75tKU#DUK1ZFk&r7&3MMssp4~!% z?6dQDlN(Mim4cxdjMN@AJmFv8WyVy$!O?wrJ6B39B$LnXjOc@Xp3hJVEq9WpAb+~@ zH!B>suGPtr_4ZVdr=si2RIo_(z;l| zPrLLCJw#h=@l+vc!^}*|8bd?Er~^!=`w^gp_q>HU`6ucT!=GwI4n}^eqDmw^9UW0u z1ey2iFRn;oQ3xZv zp#xgSJ4jS%o6v~NiHL>1z{_M}I_*<0CFfcjuI024R$c1Y1~uUXYIF)mHr+2!IZL8B zZJ*jww|6a1e}pw&@=8Mw?buo<#KUF2d=`q!;t$~CqX)6N+Vrz~I^4C006aiu#SuRs zpv55UI{vgCT2LV8(0~GY{8B8FcEl%DVJ|sa-`C3!&j(1(TZW9xosC&W@r(ydOoMBR7YgGxwVF>r1n}of?a}evbQqZ=f%Rq_J^o!L?9=f?hjpS;fxTtLTnJKg^(v2mF zDQ0Bfz+TQS(N$VF?D{2;HtuEpVDk_}j~3=9U^fg$M`S(*6NCAyfG>OV;6Fc9Ru^6J z&;7WD2g&W#<}6B6;ZKB)bRh;;&k| z03K@(kl* z*iM93x|~fP42wWXSpwcmQ_e9YMUN?rjdK*$Nm**lG>NZ5*Y0D_Ra{BJHcj6BCGRLd zscS8-l5L=AHZwN<6vl$}Y{;>?>OTg+oZ-<>U{Vb3FuuIJq~hYLQSXZG#VIL|20#E= zCR1gq0E^=X^1c6xOk9}+vB<4!-9S*R8lYEWf8kCX~Rqavrniji_hpmQnlF% zE!V~&o^+Jk7Sl7cnsWIwXGM#$DH&&L??k=4dif_!`!G@HD zrm0MLl-h)fx;hI@Ut$_u5F~^QI~bD#u2Vl;EoS63%`qop6lPQ!>ELd=;CI}K`%qTN z4*~F`e@B;Q6aVQYe?t~5WhKH>S>iBM`5x7-+5e?>S@_FGCfi6GIuKrKE0fI%I(#Wa zsZX^V&qI}Hy`m=8vBh9en`bFJJ94X}sf=6dK@%ANGEzxjhwmh&iVjw$N;=0&S}hcy zI9!xT_L3@?Vi=-f_0Hh<7xiyeLrI9qpeEPQxIChvP=$_}Km;-baCyuCp zWO|V%L&YgIYvSAZq)@Ahm<`uW_21jQQpBZe> z%?ea`p(fS%!<)#nlbrpf+8rkX0X|{#3(W|xH2tqN+NKSZRGbuWaIs0Rln2_d!UM95 zHM=v_B7#e6F!&>_RZZr2K1wls$&F-U-sg;l##Yo8U%YCPVXprAcLxpP za(~JcPATRF`VfEpHX59WPT@Chh*FYGou;>4<8xA zX0*-fpeFWuZ1eBTm!(Fj$`zx04_1fjZzQx?(-w2PHLh<)?hS@ z$4i=hQ6bFAv1)Jgx#PJmQt<16hI%-UtUqtxGrU{umsm@42C?6|&_!s>jA%~ugMfnP z1sXvW>AkC(dfsazbqqufvig{q?=8RTRKuGz{-kq=-;xBLRu{lUC|{}TeaqwkEx}CF z3YrP?z2i^HPneCYsDVxOUhP9~zpuq1)|t}xuy)Kdz6j!TBy!ZB_&OtH<~A=5OBo+e zL5e_To__w6HGZ$0lcjnQ>| zODdFHnHc8Tp1RW*zv}duQGRwre)vo8@1K5cnRyyKrvGeGVTL9Iu{_lFbSJdh{)N_5 zMkUC519#3O&wog?X2Ibngiu_J_s23lQHkOx!R7COm?FA{!eTqgMfJC>D&ht6TS^OS zWEsT#MOs)0`LnsYDtZHgv_R1O0V;q7S>pw3C4^4hpvZC2)AI3gt<5lYD~z$cqO>m^ z>K!KnD$BlJas|s)GI3Ny`J%yS9=DjoYbQyH{ZqZdZ;;3pZ7FPpq6QyAt z2e*g`1Wa=t+5f2PIm5&IqkNzmVSS_pZz9c|#ryWvW`9A9&W(|igG;F)fvVow{F@3Q}X#AT~9eB+VL7qFgoT3b$omQr8rtSj<%>Vzcxyv}Qga zd1l0*T;#rG(7mU5HXU5kn)O9ZJ4bvsSb(?wR?tz7-)qnM&KF6^!LqTldg5bnrR>d!>!>4WGLd${vcTfHO z3?uvfG*YJ-zBp2y_ z+=_c$FCKHjeVBJy#y0Z@1}uW0rSV>ZN0xNdWOYmdRaF+t=n^VZLS}A`OrtouC?|fY z0X!j@WAhX@t|-E`(!vI|+bOWKXv$RwsZEWckLC4la2*(Ps1Rs{D;2lJJV3PR%jaI4 zq?0!&;pcseiH@yQAoMO9;h+x8p1j%7`eqQK!u*YhcB7N6GVjV7>Z$lg39m8{fCyq1 zCy^1gt9HCuP1OGJa}TNT^n)u+O>wyT^N4aR`$~NyWgY3s(XTFb8^atV}vm zMl6$7IvHz;1dk;qfJ{qSf!)eLZp6&|<$p-dtO&66C0&y8X(P*knXnbeZ+H&}u!tPy zEIwf&em;}YEUh-aPepUVr+`sCxL@jO@}#%PagW{^PCnXPoA$|KUD!q#sjb zP!4MAL&$ioVa1q&kJs`-q=PF1l0QLvCzruFQd!97vP_lt)6y>8gE=(=K54=D>I&CU zb0tcqaY+o_Os}oV_P?QZ)X;Q~m*q4xa+Q*Zlv~jv%A)Ahf)sD8<0YqW` zzHjrT2YvcpuVs%XIXh!(D-MN17=^TIj9B8}#nk>Z#2Fksukz}l{nUtWK6mGx4 zPY4?RP(mliWVS#kgBM0KlPq$TTPtrd7nfQzzq-}7R+Uz&xx){ua;7U@@~jenddX{Ea5%0;L=nls){QDfKJ*t zmDUl!v9dfokC5D137%+5^GSYct88LQORvtg$r7H>(OMwM@VSe1#qI{oY^*w4DI4Ik z95-qH1(<5P;$w=6T)Ixdf44AU^;+k@9X@Q@-XGt9_#`;5XUx$=S&=UY-u@^ZgO|+G z#>QfOA(j#=GWm<1naN*9ixzn&2~cE7KI>a&9L=5cxY6R?4x9p^MP6p zl(@BRC}!zB8hE!foNLzYfH-a;U!(k#cC6@U%Xb-!yY+|!dpG*_ReS}yshZD@a?vkH3|=~^5C|yT@*Ti>X1M-tVC|pXYnbY3jcs8(l_joceA3$3 zJ+OwGmf^8NNq);+#omuskb)^hOjEr(c9|i87T$sC;&wz2b`ZF~b{rVz3GRcr6W;eh zHMup)+YwLByFK{V11Z}#10qnFD(Wk}Px2>kHn}f=EB;Ty-q40OrhhR0_WCA{Lc} z6$cYZ#@3B8-c(iD#I!jqgywmsRBcp1w0SYPMlUsZDJuAY#P!5T3I+3j_gXvr42l^p z;tRJ_hsmIrSo$=kLO#B9Mp$DEx&ClJqhxe~pg(c%$9`7)#O|mm;8Oij(~4|NHDB+K zgum}U0WG*~Ss4IiV`+~U044%#K+1CO2JQNhtnH!U9Pi%w!a(<$hWJmb%JO^y4B*cj zvYfm!ecw*K{Rnt?0N}r3MtKL_+45eGKetFdMe}es5kX}V_RT1Hxvck8<$@BJ=G{1e z^TsRybZAh3G|ouq~D1&|lp_!QwmicS)DY8{2tEv@}fa?|-6N$%xHT z`6<4zjHx2&v|rZ!R;P6RBX&A{wkCejw+yIGMZ91NfULO18Vt=oF8?3e#oj$G3H zK7&VcHJNAq4QoVEbr9fB0F;inMcx~z$?DEcCLY+sshkPP>Ag1>1Pd_2`v~dv|RzTj{@7ZLFGORB~iuMD4ODDcDT7O4@EX47M@PrBg zM*`LlwSVSvairqP!4(|_=w)S)Dv44z(%(DL6`IFlzsFnMj!3-ROZMfxXmfbi{t>C} z-wIU5dD`5X_c7C7Mi*eRZ?_3m@f;jnk96|3pU>~vH{}|XE&qlv~gRSx5-_49;KG~wg<>ao~h?GLmW zRumSVn+?!4FX+Hl(Gh!VTac;g{HQ8Z&XZXFpo(NN_2rM>@|X8}RtUib8+(Z|NHGAv zU<8nbCb_z3TXNBsa(HJ(*RbhY1BgRWS@^IPogC*_e6=UrQ(b%aA-ed-5q-gYp`o$< z$>QH{w<<|D%lu`Pa!LOZNfhmqm-X`+fc#}x_5fl8g?Ai!{J{z6G&WLg=mGh_$g$sn zs=d>g_xZMCA`_SsWO?&@Eu`|$uhBVVSWN^+eA<=`@2J`ROuUl8U4SOUObt(rXr?IR zMGvb)`#mo$x0zusn{S$Q|E80QGvU6TEKWc!DKH$E0Otkpf|UH31@0s$2$1;}QeL76 z{N8Ix`RaS=-enNaX%6*{qyOEbU$XJ?)ZA}(E>egBuGFDdA?(XvwQ%95m>WBMn&gov zfRuF?al%!Yx4EW%SNPb&Jr6_#GV+@|U7LELR z^7$x>nLM_!Q9<>}_l2%#X!n1uHqv{5T5xG}{nG*1>| zMtoGTHz%x*`vF0v&iuJ5d~(&0DYwQ^TI=5-k+-3ML{7E?JJ6#%eytInx$q0EPBF`Kby}@NBJR; zp|fC8unE5_^~TZYB$DV+94yeSMCRk0-kQD8S{BRiSx0=7``(&G0G~*E(58V(F+A8F zj?euW1{}447QEIXUiQz=Q31SEHM$fQ|Ll~AT%O+mUQ6d!&3y|G)_eWfGow*x3mxs2 znSK@gBA(#17xYraE;N4KqA&--ENtaPS43NtMy3ps02!hajo+SAi4>wE;F&2Pa#34G zi-AH~vAvTuKA|&%38?n*NfgNs^5!cuATNI4&!HG02K?pnh(6TVL2C-F$zk)djS}z5 zq9+<95Q~8BX7v73c)kYf>)cywhxrcKO+(Xn@T{z45Yhi-4M_#^k+{U7Uqdo6@NA47 z{eeXzj)?r==|hvs)OLFDVI^jGwPbte41|%mTe&fnWF%qei|EBJU<(0`E*Kx*`J$#o^9!5J+VUeA3-l^) z?#!&fAspbm79=OE149raQ2({3Cg>E>&@McOOijBaevLo~ttjR{fC&0lw7d?>QF8=O!Hd+(CJzV_)zP;MB;0^^zNm#CnVVyL3j{#|5{+J5$eoK{+C0Ai-Df0 zeVGa_?JWZasVy{c`${P&bb9-GLPLNpH?*%0nU}W$0{Nd~hmMRI7zZeOk5X1}O=-zrs2>P?QoNpuV70xM!Lf@*TEb=uOzZijs6wZwC}t<_ zqC7VPV5V1PD9yVfE=2|+d_vLXkD*|tzMG#YS`b$wo|#G;t%l&sniokxAWlUY6IBhQ5O#E|iYGhbgEKH zN=sY(LpR5QF&?eE7$9!Ju~G1t2QkIxIR$y=_k*afwX_IcJMKXsnp!-tl6tFco)yUrd#qMr_kr_koMWUuf*y+o?`+-LkKMyaW!B+F?Y(P$t&OZ_JQB~Q& z=d4i{xc)u|@dEA`eA#fr152Q%-AK>pjd9gLLHK%HY(5=8sF;6uU=YPA4l&C9`HEXO zzoYvDV5=>`MijXUISa5|WBGQ2ZSA9=8|8uRA4OKb%6!Kjinr9fNxtj!fW~Cba$Kdm zsC)&QwryRTI_}Mim}tIT9WA7`1o8Dd#1W(@jN%%J$lu7wC_^r85Vz}^$uBXlEIm^G z{Q1sM?P%vGA@9E{;U)edWH#=b(l>(>nb^P=jLg2~AK&07s(B6&{UCh3@y`3QJeZ!b z(4)6Du*NfD?6Mr;W%gRf{3b5SV4|^ z{42*Xp^rxcfq%AkOrvbFCP~`;@eFRDOLZf3{O!nVb7-BBDN>!jW7LBJnYy^J`WdnY zEa<=yusM(_`APc4W9IuihXZ_z-k=yzF$$EAP~B!{WWZcqU7>gYZtZKrx9k5kOZlzo zukndOmB0>-gR0$K;MGx9`~fd`D$c-_Sz6Jol4cu0n{<+(SdHBv zJwRdR6ovyRJ+BnD+g&m%!1SSv40PbI{;7o}H8O}II)XwM2o+?j*=m^2A#Y`H0G&(4 zRlAKK=#Ft6==gl)fHRgbtxePO@y`l72S=1cNL6Q-a~~XhD!fB1=>oHVRU9^@|3Nb` zrIgIJwM4)DW*yFm<%jL@d#kC0NYIsUlE3sQr{XRdFl1>Lt|X+_{Eu4JSlRWvPYNo+ zWmuJo@o_gZOFwG#z#afBZnfT_w_%RI+#Z<=qFv%oVR?C#wgw<-j**VRVM(yYN1lwO zAa{F}Rbca2FF+ve|JTvt4xZ{|#j%)*3TCg9$o0gi_X?E zkDf5F|MS>pNk0Gs^-kx)8fTKnXri7U#l3K-DuxK6^r+J~0*tthK51uHUG_!`MEna3 zf)eZZC`kUXibnR*s~}p3dw50ql~3pY5ck$`Rdrpv@Wwy|6cK3w0R=&6=`u(u1L;ob zl8{vC77=MskZzIg4hdGDiJ!$rn;_ZD0&J?p0MG!w;? z!|t}218XwlyhDs3L=g*Y^aiV|XTAKe5QF;kUR_tp9`B}o#`VEyGuK^Q`ft{u9N){n zVZ37e@;WLXi&?}Jb1|Xv&aKyAbqSvZ)-dO?ywYRT`*QZ(NgcY$Yd@YAzKwH;;3WCt zTuV+`pXUzsOz7j`&e18iLxM@Lm2%NgL`1V@=H~aOrGQb@ey*K4(017^q#YP5i0aWV zo&#*u8{0+pqUQ_l6%`vd=;#iuHwJOV2Zd!znk24zzk}yFe zGKB6aL*7!YKD5#Adpn>QC~cZ4z;!VU<-|Ws6}Hjw8CaY|y){jU6Z&w48lNp7 zAp9)TZ8lf8dl+t+=M}9jUvCCwAoW5pPEhh+{jDpjM?lV6lgvN8$TK#wj+yoie$;8q zGpzE(T?cHJNxU>n7+(S7<%Watho#(CgZ1bDl=w=VCy&1P7%g9FL})&nXK7|iM(fq` z_sCAzIv@DFGsF1OYgeUgbjv;618Z2ikW$@~z+pFEaPDsOPo+`J^ihFtC*kX%hDvVR z5_Yr#D>@wAyoB}eG@KO474#bdZMDMaZ{))e7X%0uNEaMI>7LAW@ zFd}Z>_L!`zHZYdKC$=L3M#fA}I)VFnB1A9jY_U11TISvfH#{~53`|TMQc|yqyh_{8 zZJmUi>SwiC4CnV*PYvW9-s1hFsPdL%`CPubhKYYP)Z*7*GHNw^nAXtOcYCA4leO7) z(Qjhz-v#z>pclg2;$`gck z<@U(K3BSqef4o#Lr&bju-c2A2mhuBsw&jYG@t@EUBVyRQjQ-*#Nr6r30o$!Vlp(2N z?fZ_9>2(vNe3j@yU@{_hM|Y|^zxH2Bcyw9@3c7>kZ@C8q2%u*6vdP@a%H%raz#%}y zqx@>jtb1ClcsTMeCevD_iXn}izT-G$*nW|=fgfdPwu#&d%6QP5#_M_XgB=;MMczk= zKo(fziAzIKgip128(UEgIvsVPbVhNsgd zD{X%A_J05`7a#xo)d1uwfl|U;`0)%BVlA&EWzT#o%Yllf88nQW`wF>t1E?WIH&~hy zVM^U2yiv-#x7w%=`I!^9D|l}`; zt~=h*Ln7*LyXLhWj+|;(S><+?^tSLex7+VV-ws=V;F2?k_OgNv8FL`b38TSVZtZk# z3%*tBrOZW=W=Su%RyWNyb`2jUKi}d+t`x-4gfrigFfe3njdy0^e6|$WaJ^E~L(jwf zGhWVZh>QvTLoki`b6lQCm04|~T6Jyh)3|_pV=u4!yiW}%)fylx;nOFs8UMLyV{#Ul zluS#76lMlv2;-;YO(-Oq9#JJcPByceZb2W~JkUTc))pk`MlQL>8VxNFs63YU##AyL zUFul%OQ;jJ!eH?+Q*R^^oDaAUp?%hNAVf5y^P9aFE%*FkhC-%utRl9PTfA>FKA6VU z;Cqi4!OCNdrNz&d0VUt-nrdU~jK4fw=5hMbdscaC8~p*sT)FJq2g&!k#!ev#$#}Ot zcYz~-iH*@NXb@3EEPf(@sH9pSEZ=QG_aV8O8}LPNaZ9H`Xle(QeMLWDy>lg1RJTAvwZ+gp86J6jk#Oi<5LCq*==lu%> zeWF&=bJYSqQdASN8*wzJW$x6a8(rC2!_p*S$~GU_ca`jmp0OKXhiW*AWktG!Xq!vP z?cJt_apI8v-m*WSb^VpG+lJt9UBbJszaW_IOis?arHRaqCWg9gdJWDT<}YIV49AF@ zzBuTKf-i^$m2?RAhyAbsjYgWZ8ets;1^JaZ#^70>p?izZXV34o=KK7XO4(WDG{Thq zR=zv7u;50s%X=QRw7L#d5=MlMgz#r_rlmAyS859!Y0%J&U%Poc1q<*`zRa_062S8M z2GX4+r4Ft(r|GbI4i^DoP|@~ zs%bLq!2mGtaZPg`s5o6n4kWUAp!g$^V0?bcuy3>7t6tIPQ`#4-kUXK$0Gq>FKgVn< z)%Li@$#1M^2t>+@JnzRub^G)l9<=2d?q~>-7y6CweK+1rd<>qK7n5@O4krid!>13I zA9>(r*-t$hX9G5gea}(_kWnM7?D2=aA@{D%2O^EP=r?ZW=FIn+|manc8CxJ)6m5QRpvR7bWLBMx`_i>*H78NrRt_hEM#9laNO<18e}6CemXK}Dc_6Eet}^0}kH@c~UcO%- z+p=w?jO2F2n&ZeoLzVDvoW~;O#Cmy_?kQ1?yKvuTFGJey0*T*rV&?q(uQ%ZpyqLL5$9PU=XcRpOB0K4=L_4R=6WkivVeyh8{lDITg)d;BIMlF=xG4M;7v8y2sgyt%?cV+kSX z)k|_aZYd9C72T^MH9ytsj`hq6*2I*`Ee^!6ojOt@_!r-g*lTRwhzhIMXK?V|r-aEP z@jsaWsAXHDE@WPus5P@R_S(kOqvEFkF4Zw}MU9HWOfAu0TD@*J2T|P3)_C$l6NOR+ zB9rsNrJ6dSiJ)3?!@=n?y&XP}<%!`cP@Z*q)}am)fJu94wZLJUw@hJ`?d{uz%BreM ztJ4gxK)klcDgP3PMc+GO!$dr}h==zoVEPanAOHQ<^JR>P?!da{kIp#@HRI~-Zv!4FEBh+2PQxC7hloJKysAn} zw)uxkd!Dj`1Im1$JoJY6*Pl8a<%O*59Iv~CUq?=sP(KxM>Ge(!Q5(5Ad-Fd^4uHOF zaJnC#g{39iB@#CC=g-jaWJJZ1Rqi%@_;A5if0A&p3^%~I{NS2V&%DEh#0lLMb#8AIfZNV5tPCOoO6iSG2lnf6kS1c~TZ zj?QkQh{*NwPgxUNJ3Fn7<`<}!*JBv(Jb(U4*k0!;-^Rc4k><MI_YEIX6{@~ZgdJu>Oo}R(vHJCoYhhfC`@lomR+ruU-)XRq*yW;BBJf;+5`_hD__FUVUX+H;vMaajtZ!#*qUnl9~C( z&AO6(U&NpIeYCg_U*ouNuuJgv?V`rF4`UF>+(7Jt&dP39c3x$BoCkQPAm)J>iZrDh zBB!$SK-kW;>H|O#qsDhruNoL25Ukebv|$N4+`A$b&5bT|jXj}!SAdhNa5O-r{9{%Y z3V4ejRLstRHuarb_?R)R_oKKSubf*px7`SPg?uBV$bgvdCWKj50ix_08X8_t5(B6h z7>E&Y2{6Ogur;M>QCGBO`qgDSC~i~Uy!k}M^dt)TBk&|aFP~(S(oE0MiD5!4I zpDo(nfOaQ;jz?Ot9F2a>%@RmDhKNW%bgPbMYa_yMX??jqy3|>Hb9e*|rK|fGQ0Zz# z-IGd6Jg5rbc49-)3(dKl9r;yT%PQ?p2??VExi=9G1#0QpteY(V!JBX~X5Flkw9AI$^O%%$AB+F=a=c|ox{IW&396Qo)3!M3|1HwPAuq~+?ZVET5c^Mm)`k5pk=CM~SLjLa+ja?A-E;QW9cz!3*x3+4q2sloQ20mze6XsjdxmTuGmj&l59F>atgPnS zO|>2f9~sERa`zeIK76=CWul|wR-nWT0k~{aX|%Ndb{KO2VWkL8n+0>zqG zUdI_H|1BTgWdw-yfBO8t-snm~PIon2OCY+Z@stwlnCSo$nT-Ug)cWgyUav@n%3lW? z-BBSI%ReQ7;bU9Sk?a5KIR5;7ib?JfL)j5;cl6~}Clg7+-eIaA)Rr2T-A~W^q^l!@<7l)g7 zutN1a1RHl7qhfwm!DLl#o>}SzA=QMzj1CfEA#mEpFYYnF<)CgyB*X@Bh_R`KS5eM; zDf~T49~sBPoZ6Cij~?oyY9u?29O1r+JG_`QGz5EJ*3TI2uG1hOILMV$MHSn8`*>du z^%4SFsi-1KI_^t80#P1F&{CVCQ}BG77Z}wD@e_5Ym&UFFET!|pfLn`zNk!w6`YelX zmdQ!&IMWfm(*b+rh03pBM|$(1rG4Eins9kf{3jj-P{ym>{qK~Q?IR^FHg5lAYWVl8 zcofv0Ac^XD{KOox&Ol`XEqw|$Ht1LDh`WlvhmHEiew9%6eNTbiI_0|u@jGSze+mP! z-TPgTYX(z>LW#s4n)s^sG{4wd-u)%NQOnVH@YTfE+3^yXF4P^m;1driczBd1%DlX6 z&`_Y*^JBmH6M(6L*4F;Q<$$7y0zKN;I1VSX`Tw@wk6zvJv=c+5^$QER29<}P`G(66 zHAnAFJqh7HKSN~qQnhuu{4lWO;axY^fqYkwZy-?cf2`(n9fbmVo{%_yT}^%+B|E#~ z1eh&2P9d-$okkYJe?$dk{&-%Fe`}GQu1Y|s3Ay>kEOn>x{@^Q@;subpjS4qJB-y~HD`t43;wf4&oQ1Vep5+->3QFMETI^(gj z!?8}!2(=O%xw||_`Pg4#XpS+LO)!w)a8aunv4?Eb=U=4DZ+F`;UG!P1Y)-y$V{4IH zfvXUa*eYRmVgW||c_pU<)uBWPMM9Yl==bt0Nt}ibSdq&ct+=qYw)z5^8ORKo)~)pe z(%>rOGd-@WUBK<6rV<3=4bdsmnPmt9K|sK9E%BPh^4k|yihQx+I|rZ|@-Kq^+hYTb zeBMVP+A|XkT~-@J3cc0oU1 zUx9Xi3=|WfR3nqKhXPy-zj~+3|E}YQPZY9-l9-QbeQ+N9y&ZPVNAcNU00{6ZS@89t zBPRjE01gUbg|=4iL-x*cn*&+PN|F4IKrCLXOjuW9e%^4_Rb;T@Na#jeS634eR%sBe zuHhK2%pWmw%?uFOnBTuYA-_Hbk~Ld%nL}rdNPJ`158eGn_I+iC%g*-ao&-uOjy1Hv zfqi~M-qPh~)L(?oP3GZ(?`Kg=P8MES$(83edD1Q*PEAYaZxxxEnp1&~aH^=;{kxtj*5hPyuMg-0}7VhU=G zwU6LGErE_s<9?nL4VnR=fV2J& zc^=f&KvCFT|4V(IBNZ-f79zN_>k5vGSzHL|nhm(vJ>P(63O&B4)ypqE|+;!+2`x zwR%1whz5>)*&0dOmIb}C@`1fpSMmg|eDRL`tpjZ$1Z5e?`0km!*jy3Wk2y9ypg5En zUwp>Mc;0Mv>b%uF(#ZzO7DIR2HJih7Q6uR?uf0sm;!KW~3QU6{+GaX!4RiR3`a>fP z2kguelGkt0-MR-2P=uB2?1(?g=WW_z1ls=S0lOU9+iqT2w_~oQK(VlMul29{@ImVY+Lw=!r{nA$1o~ z!GUOn&Hp^Atn8rSYukOn+NSef$+W&$eh(EDPoSV)Oa9BGmV|@hElsVs)0;igRmS;A z2T$4R82#9B-DhxQ*y?r~s^c0DiH@!?#l}s+O%zM=ZpA9L)44z}io|CEbN%jJ$LewO zi5NI}lWOf1tR;T66*g~g%;n*=m0-M0N8V{%P-v_H0Pk=<8h#d^>BaO2wq5aJyQ zpR-w5ST3~>Vt4KTx4Uw;qidan(}m$*YIvYK6L|Jv_g4iW>?hrX1UgZbMc0*XyU6Il z1}54jitBDwmE4W{Y-pEFqd>SU`iI!J?>CycU9K-WLe>0gE=nolT#y;9C`1-jx`YYpr51^Oft6KF;E%)ZnKaDf@?+_( z!dQiQJ&QTnTWLCZOPiPv>tTvjCcCkk)Yi*}_1T7gS(AB3Cyoq|C{Dt$Nn@IT{E5F zpqF4@fl_t>qRvCrdFw3+M^&cQkWDJwWYr;mqz^L4>3;M`T-O?XlW{AZ9z5fxBTile z`4h`iptb|5daMFlgrFJ%ebq=oXcfu@vrVcEKE=n6{u1lF2nosP+082q%Dk!k{;;yH zkVam_C5X?qnEbc?!K2Miz3msU^K`R9!I-)4ahZ*Wuj?%+$gkcNlRHu$n9bIGWEsZ- zyHIFo=v5ZFdwnv7|2yEyF)V|I0%bZdBvlNMOubt$qG3h+6IWR(HrQZBPt{s@8#yu%=n z3xaRoJpZBDkaz^XcxPojq-H-F4p@{)4)!TLOFt)?@DM#}KfxSvlNlcukBy0m7p!yi z?f2kKjKYneFO-x{C%kO>L^@G2Lt@rZ#_p&f*o}Oo`Q%uVR@7*gAE>A!N zfSL8jc>p)9C8yv)Jn|3Yd(phJe5X#G>iNlw?^BE5j<%nr1wz9gq?E+`HulOYL$?1`Rs*&_tBho^J<8SW=n$^csC+5xi>w%yiTA_oyijc?O_-he7Ou|nax5c zs>`sTF|qrfHEOdsFgae>5nw$Fny+s}uR&QNC8fzQqJ~_;VNC5U?w!4U=u{za=HPWs z4oURP;Q4-qFbHohlU+y(eRw$HVLA5mr@xB5HKlg1>C<7;Z!a}$Uv#C47DT;VWKRKJ-D2 zZB|||Ms;_SXv3?sFGZvYM2#fgIC7B33&mHNfHbp^lT-E)P`EC794n$eDD_5*K9H)K z{)$hUH7Zl}MTeDm5<()s; zQ}!*@V~PSwORvzq(-=`JzP&TQw=d_X#b!-LU;3?M2)BHpZ>K`gE~3Zy5tJJs=+v-) z%@{n1Esa%fXrV~;!T62vNK+Ai`$rkQ ztuA}v$&D-DlAp*43W;bgC$5@p4ALUE9>NeK@=)C#(mN>7fX;F08oUDFv0-HWh^cA- zY@b!t#~c%?OJK63GKw*h{Z2)VJac(DT?#x+x_JcRJ@4Ci{sam^^qM2t&d=(He|7Hc zc#K?tL%vh4u=2A>&k#^UB_-q<*Rg8u=)eG-L)eyuB6`rEu_f^)8Y(Q84P#|BFgWV8 z^WjSmDHaZE=IlqI`Ag2&Mg*r(O3vFjnSLb6fon``Y%YBdePd%OKTwMOOD+ZNUq!h$ zeWX3_%dAQE4K%iQ44wR2g!49ae_JHiIUNOBUS8hr>^cTem_#z9U;@vd#g9`iCi8}d zx4u>*j&c6r;DLF&uaF{m_b%GQ+82ZW2KUR$+qePx^ahF;kn$N*!8vkMV-r3?tQF#P zuKtIb2}>ig$2^`%J6quxE-_=w$ z!y_{wrbzn9o3JniEk{f+_yC3yE)A+9(%=@mDw>Pf3=#S4@#&CM?pG z*LC~HZj8CT{M-AQE!SWxJK{1KfLc5r=rj9ORXG@?f58}wFfFed)!1KZ$yY8j%QoLvcz$C8L&Cul190l@ z{qU2BZZ4}m#c(+1`5qP}Fxl7{9&RV_a5onv98WU(6T42(_@ht|&;>?Bqz2kvviP0j z7Q<&}Q+h%zT|a-=BJ%Jd4`|k-?cOvFqUH_wW%TQ}0{P4EkPwfV&>L5H*RT`HcB!G8 zsxM@zO4i1oL5=s*z9S6BlbB26ZME|qaSepy+`&xEA&R&>i;@xN?0M{s_MAv#<5C%( z`*}BRwUx2h^s%Sjp8|n5T!Cyim}vUdVVUN9&y;k(`|V{j)37jHkXzr-k;~R zo>wd2ERGeQHmRy+*GKGH!y}jFroL(O`I>TDjV*E8!=b}-#mPF;+IQ*LT!Mmpvc%~5 zsLoRo0z*rG*^x1qa8OOHaIxz?frKjtmFNfT^g;t!zW!WG|NNS#Dd_+b zV%=Cq)wC#!XmTySaBIjBYOsioJwX6)4MRnY8F`ZReq*uIz0xUb{Y0 z{o!skGsxK^9MGo8O(aziCxU$!g#7=F$YKF^W`(|y$&mMH6c+goC8#fAz$OoHkJh)B z9~)X51)t44{ouXI$<2KUWWL?Xol(P4I~0=^r;!#6+*b3i=QKVd4i)Mu%L=uT@h?Q_ z9D#*CR9F)VEYPDW+T#vWV!%ZGKDx1wI<*p}VcrbGdhy}~v;tv~m1S95SicO^&g{j- zA*4xp1A$02YEI`vDMn<<~(-gmJ`>5vw zhy%;@k4I>`WfdA89_zR(WxFwp1{=Udc$O1YwK?*oQ#UW;<5vw1o&b?)m#B2UdzmW2 zP#ytqQo^G_bj!7465;7zY|!q3<^gB(j1Lv|ZO6uXHFT+k@-z6DY`>WykWmd3W9IIN z4;F_cEf0ocfDHPn)43wr+NTg_4rU+pqKUJbL#=^i{{1uMFGoi&h)Rmrg@GahlS=@EM|Y@c^aEUm z-SLoAD)JU1YUG{Re{OrLbwo*9mDg7x|EHt49-EYPxv*b37xLPl#39n7G$e6*06lgK ze}_xduR;7WCkQiED;BDj)+6}-!loe(oKiS*0;%!RFwuDRyBc8iJ}^-G`WsVAV~(Nf z$4`PH))!OYQ$Y9=RQ?RCGW6~J?d-QdBqg1Nkg_U)TKvCgxnsRyEh;I7_m^i&6hZt^ z=O&P~89%dPya|1%niBvk_xXMBViEM%?phV5xYgf|@pCS;q07G|){z|R5j3vea-429 zcntMU-av7pU-kmN!1>_hlOg6gdLUiFjZ27Ut%)1Tjv2P+EM{p~|G+ z>k(sVO1sCAB_uv-)&Wjl*C%;Jc?ytsMUn%KyWqZBMbZB|_VQ3Y6uB)*?O!xmAnV(% z&qPXh!D#r5-B+t&-H(27Q3rFl>g!RmH{=+%sc3SS>A|xiN`ug<@>f*(Vp5x=1$^~Y^Lp1-8dABP0d<;g%s5jDl zW!f(dv(;JSOxv;JL+t5DTAycoT%9J^zwGf;D^Plu9a;Qu&}H*u(15P~cO?TGk*@9( z6AR0|OfqTB>Y|t>s2JB8=(z~F;J4h36u}SBk{~`$Hy?pDj6(4!?XEcKKE8~HN6Et@ z5~l{$CD(LyA*uxsTGznfwbF7nqMMGm_TaO&t&_VR4&)Ir`d;xQcT&dYQL^XlFJ?ql z0Q6UCw_Xddny-@;r|K0p!s)h{yTzma&-y!_*xJI-LM=qV?<9x;3y7N|bjK%pQlrk6 z!}TJT0(S<}Ik9X_&Z6^kTuu^IP5N-J>X%a0|BTRj3H9=Ea!u@Ya;*afx*FM^O@|Fqo_kR83=_y(|@7No)8S;-F;^1Ar z8;_CX8M`)o?xNzekJqn#(hJ%Qc*9nF3XAaet7*&D=##9Li$hWU^QAUUHoB*bcuV(I z(r`0H)PFQZ@<*vh-J+z_c@vPxqlZf$^SJbqnwr3PfO4s2(#uvnO3M6%!yRQDV&c|5 zJsPtqi4)TPWWtN8CujQO$XUxGo5slrLci7u_G+y?X$d=EH{nYmTARM}VwZz)%dZ7a7z#+~)24ji8| z=1H+mxhuZ_eQ|SUE|;N!3kozoz%)Gfxh(Uc8FU6?h#Q4Yi0?jim}T6!qWr8kj|%$& zSrvTr@{i`(DVAT~ttVeq1}qJ2=4@NHN+1_8!@X|1-A&L}Xy{Qmh#Ob;kcY+l9Bz!> z$U*7U+KFD0!O_Q8r}Ew#CzBEhsjKTq#fYhoexL?Dj(b@Z){q@gK9bO~E%&o<0L@2`zKUkEq^`RYzC#_6F>p;TLt;@$1XA zKckdyjIO@z9e*v7UnqouZ)Px==kBXYw~h6i)Ip6uXL>UgI^Ro#FHr|zJ6?)w_l$`V zU^5VW8xm4qxXLj_YmN9RfuAKR&mTD~h5BhDS?;r}31j+enpNVNtF21pIK+yt_Klr!T?)PNu2Tiq@PUPt4Aj;78TANFi@A6x8-oAZnyIIO1D#2S{jm=-@vFQ9D z*OM4(OWQQnu8*}nEzfyAd+%qL|5Pf`$ntDgn9TXiy1mnu+m_vnJ+(({9FrG{mPeC> zjRW@JYx{E3-XAK|uaJ`VJ74YL{@UE%ANK7HlRs%d`Om7MvN9)78@@zRTr4PJB+p8S z1-lQbV61+J#$>YSEC*G$-11OEQAaol*c6?Jbw@X0lcT+=L2~xl-dHL+JF26zv%k== z{^>~)RH8IZmi?wb37HX7n8f^W>4X~Bd*ru86%vpM``7V~7UTF+j^7ati~Vz28COqF zZ|+(l27GUF2F#>S1;0lZC(!V1bhJs-HMx&FbY&z8a)k-X9Zy(I8*biY9oRvtax7f> zZSA&yDA1?|R5S&1IdWHWD+mfUT_u;cX{An(ry*#BG2fyRNelA%Wa;MFkS;du9T6b? zg1j}F%P{Je+=m@H{%!zBJ(a!wzR$m}unzCkY4p|pFABbn)((M(jF@|SdttZ7B&VDY zaeby3^%mxZcz4R{nF+CagiMK?oDL+SSX{`b7~+*eiqmqAM&@X3e8PHYHbJe!LmJ|# z@pWGAr6-33qt8`XM!8gRX4ckutqeISa;bNNN0|_$A90|ohmia`Yz!=RXU2mJWMl*dO|I+f|9n}7pOQKL1Y!1yng@rUuJsEZ)HidM zY!b0m(8K#0*0-7#Q|9wYt5ylc0Sgi*KmeL@Fexa6^$qZtEsqQFhpw=v_U_$f>*St#IWtqD=f;-4Q`Ip_JIWeE3dlHv$=s=WW=K*dUC^u+wK{9IZp z3$Y*X;hwYiRir56YdN-CLGkadq2QTE1ZG%)R^7FBZZ=IAd)6 z%^CeZKE5;hbj|?Qei}CI;{^S?<~TUCV%%~^ldC~M$5HK(fw0M5PzCy(?X!%;gKC}J z+ul&{9RP-I(Qyf%Z}++GWYGPFrl!f(h0-*i_nyv|`cO$qR30H@h0mfKgl1=FjYhJ& z$Lq3;=Pqn*@8lS^S)(@Qhidmuk38bK5z14%{z+^C|I4#sZ^1RkV~ZD;tG@Ik9a)utaelS1PKc5>0Ia3!nvMC=hR-6{iKH!FZ)MYuO)s< z@;jmCv`$;^U)vdPX>;Pl38HVNS1(-fZ{8Zmh1BI?-tqJ}nj@1VPYhm@9A3+MG^)74 zJR3|f>nx4!bf9w%Wp2L9m45H=exKAcO+jM>HFFkmgNms5^eWRdS%6u5OSQaCBuZq?(%y1bl{d9&E zIjo3h{ju~B9Hyh2!R3m2C!ys+%{*6*nWg2lGxmj#x-H*t?dszU*ch>eY!??DL9a*V zJJ4Aq`J73l7oTa=^Og)9a#$y8MX8LYrORk)&g&;f9E(GD)`>N=w0tV_Y@Z0I_(&H2 zN(;*9Utgd?cAS6o<+Fq>6NVKV!pETU6a|Y>?2~$Y)K@p-)rIc`G2dFBQeje1*&5n=<2R z?7%celLs}{1c(zbFaIFu%Q8>5%D%L^ zcR7FVg4DxjEq;c0goHH{_hV{?D_;d9I^Izpbef~=N|MFo;IJ_=Ha>@uViYBLr}ob4 z*RLB}TkA&3Pb@5u^$2+zZ_Bl*JTa?MtPCfq?cVlZ=t@%cd6Fn)AyUt+sZP_$ya;_n;uHs;>hcFTFzoM*sPkNiw@`-8e9%lfSap(0;#!^FX0s z&GqnR5cR~bA1wtTb*OhUuR;6uwa}NFTXK`7*u$FZ;R0zs7r}cAZD%xF7*v3cKjP12 zuoj&|%agc6e(E%LPIx9Mx?C40_?A1Tk|w{*N-pWxW+xZl!FO^Y(Q=xHz5^>SkCT)0 zZE&y{+_rE45n9C|8F7%|#cdpXU`U%DMPCtw46=v#EDFznf%#rlp6Y`U+5 z!)@64EoQ#mb@#J9%iw23zR`z!+o12Vy}dp3J?t;gCncA7F`zk_p9>cJTlvVHd93$w zBfaTr#$~1k!)bW;J$PUF_~ZzMxty73u4haKK7d$x+2*+VV#PFT0<-g&4eGZ3;OpH5 zQr~iCAs7!asj`Zy+SRR{2*xxU4GJbE&yNBA*C=Dr(Ot&82iE888CAHg>Z{|fPzQPS z^$nG5jw#jDljq)$3r9ZZkZ+GrHF~%?LZG)qDh~XX`v)Aa8ydKK*M?XKv3U1JwZ4?4 zlS)ao3YknVEL5fjQLAl?Di|ozWtMGRipV$mB1(X`HZ414v0c7{TO8M^qiE>)g1zx> zK8k;E1D3|1{pQt_Q*zl1in>I8!ougB!(YCQC;6i{$bwXf>b-(!5V{lT_aTi(c}zAo*zVZ&-c6Mhu-6aVH0h1+j9Qy- z_rRr*W||E)N8a3HyGTyzRY~V5Lk!Q!otGt&MwtJ;stE&E2-$_34J2%P`jjb8^=74g zY@G(5A=m!1?)GS9<^5Y5TE^cTvD-6@MWBwdNgOx&rUj359D$US)D>Rait*xHa2Ne! zICZlT7I5MA;M+<+uuD^nTVysIHp3CT!CWJ^V!^w;!tL;_=vf%v{x{(EmLvHi(zU4ho5Vd6C7Tstu*K~cAUo7DLWif@^K8Nrg&PFbm>Y{zNMZD`{QEx zSnX+TR%m%Bzc+D0HgnshP0v9>Ru(@nH||ywe$OX!%hxAdw#^$)=sGN)1J|Uoc(L^E zg9j|e1H%_WUZc?~ewlI@f1&DZc>+1<%g8_0izk3{<%;m!z;~s^4FQ6O%x}I2KDu>i zMKsbD0fU&qm1&nt3~u%c%&RTipSwoGp97KGf&k|nW~z5)W=w4v#@64e)v~3$7=|)2TBN z0w{%c$7tSUb?rU`y4;fDP)vIreB2HS-dnF-JT6>>>oRYX9v`pu!6I3Hvt2f$`2a&? z0z2YsIg>SIuuBTlLOk;oKLLpt)&1Fy!ZVlzj%~1CqHOoOZ6Gw8nq{U+x}@x;RX@QP zVKC$MNGs`S9Qy=~Uu}E4SB{=^$PPO@v0p*4{Y7%;cSww!$Wx>sA+D3II^@pFY=D(2 zn>ks!IZ~s}#I(`BER%GxV$w!ct8G{XIoWRYb9p6|G0U>|!fKvYG?_^El0gZl6IMn> z1~2Q5P@d611Bs~=ONdtrZuLxJ^mP7+^Vmf4VnnC-NmyMDC61iWx2_Hq4c0oIB-dUJ zSZ(QitN_7G$@>$a|T;uEOv3rV(R&7Uev-&Q|TseMem41 zWy!XsKE%>43(lcno@%FBNX(x<*FJnD?=u13Z9_}-PTBbTD}|3Lv{|z4H!oN(4u7mT z4r>OxHpo5cSIQDc%aY90rcaH{Tk}fPlD4=40?w;t$|}msOG~3a&Y7-${~EMCIgtqoBz+m5Bol@w->+T2 zzW-|n|JY}b?IcxsvGhu$v9)P@b0p;CD9}?Nkm2=H1>SN+ydCIMUFGUuL3`Voh-+qT z4&ro}Q2Raq>zCLAi7z)S5B6SkbapJ2%527qJ$PV|t$P=Oh!0>+OO^(&ojBOMkiE;m0Q~@UzL@fS*o;;S=xvoXPNuDI6Iu4SZfVF ziG^iRybBU4!l6kETh$qKfd|6E2Vc@p4<9ZW7Y+COZwfe&Fj$R}3y`%%m-2+|EzI%m z%{cBAjng2$`+e-aT!yMbOFgfl{E)Wt(5C8u;rhWvy(eWQ3KeDCi7-qlhD1UE_?6)$IFhg)4v;Uevr({9{5Tns>!hzbjljvvlBLy4svWh1eN?@_=a{MuD*a0ojZ4w4TD} zBNP|&ngLs)a@?`{vGB@fxjqFCHjI$K>XwO1fVFT8d6edJr;^La8!58JuFR<)Ji8f$E?4&9jb0E_=- zMDCy|gf&si&`=~tH$BYYt0+bFu zl%if(Z9RGIy9n@Re5_={z}>B}Uo3B2;NwZgf3)vi>GKKG3n5hM-&XuY!pGOx+&l`V z=Nff16%P-lY0RE}2!^d~!NkmrV8`jN>k>`G;IzJt$5be=B@>S0SpUhM#c<+|=J*Q~ z;A8Y1rHqmy!4CS|sj*O8@9IPF#LU_vuNA!ZzzE;hzo%S2r%Po83~mx&Jje=;tzAv? zQBII;5#^6y_wgXNYo;6;81RUkzw-GrOR_x0%gy1ix<0*nrFYDBcA75quxsJZ>Qn~B zMeF>0M+DBRlAcQU-@p`COIurvXG*u2sOZ&&Q78W^eD^dvxT@||G2>&r?n)oHc;?I* zz_JXbZep4&ehVY&)U(vvRP9lavs(Iw2JF~m)lz(Pm&!;oTovpmQWthNexa#PF13f` zx`l)w8#a_tM|8s6nwU#a6kAF!v@7C-Sy~Ua zdtqD5fma8;JGJ}Ne+JC3NLem1N;Ar4?BNA93c{Z0ytmEcMX!&`8G4n z?OWBoeBo2&7LyGWD7)v2lG9Q{%dq1cPLn;K?TUha&(`yO7la)0$HzBv^jGZ+x;(YF zvJ#ip*C!5MVRw9RqO$%qT-jqBf!0^ahzm^D&6@c~{8X8dQ^{wfyGUwu8lm`3L2>`_8dVa$n zT!B)FTal!=DlsWz-F-#Itl7I8SvHFdfHNd1<)h{2FABnDigTH;834>}5M$BS)*hXj zlImr!83(IH%9C#aBS%C;R8#vaQR>$-#gU%q)~F(l+jgI~>bIMtSvws{pm*=s`1pfP z>XzB>@n@LZ*STJ-oI=2bM5(ARwx;otfHDdSb?Y1+$g`XFH}vP|aXRkYW-}DFP=YD7 z_&sQ5#x9c2CY+YMTzbB22o>U(kAhKp5dZQ{IJ@serQMCi z+Tqsd1WCn?+|?)uGWZG$sre)LgP*3Z5?CNXMT7^yY<`I$YSBVobC=}{SpYti2cTP& zXmVn&$x(F$Tq8NzRF7MCxdbJ+QKMWN2gEpg@(WIOd8r` zqfF9AS8p&8a@g2tYT1BtN?J~4LvJrOIr&JciQbWqRN0@CXzE>lF0Ne^FemVT)Sm1T zY}x~$bQjPNc&(&|?DmpXJ7xC}Ls)oZULL?xIZF~&cOg-)5yXSS91ED%Ykuu=> zff1p=bAm>GJ&kh5=&8u`F^=DDwesUy3Y00Iw zD6seg+^M1n;x%aZ*Mm$++V#GK`L9pXbC2YKks{sEeIEZ4=xx*t8w#|bwIjvw67 zOG+K@|5r~RO;4~MS^4?(odYByA|i9QjxMZFNJm%qt?j}U5PI!V5c-Uq|B5L>LxY?z z6w}eweq(#!kll*Mkiqco=CoH-X_OUU;e)O#D=VVnk`sG{IXw#32?m$eH|w=o0>kYB z0qO0JKSBiGX~6gt6cuSO5pp{Id}n1H=&--X^keF0**(EYd<}lNzV8;?6qVcquhY}% z@oqk)yna2**B5Kf2)_9o5f=L35MP6+_(YW(CjN`-?DWBLad9Shjs~{o79%4R4EXfk zE*fZW6x&2HVi#8nV+pA?ph}JDN9g4~SY>Vi4uXSdW>&Bl9b5C7M46l7C^hSOxggr! z_4jl!+#YKC`ZX7s@ezZ;t+>~TkFzkp$F8vb|LUauKVK1nESV7T@vc=|RLnKff=S6i zK_bmq&O28#hx5ngsI{jC4O169xZ#7pUjgorlAdMT%iY<*ZK(_7-dby+IDk;DG|x=a zstvalCAqDAxjh`dhhb$P(pk6~)zcr+Utms}S0hN0nAuI&@z&Wg>Eg*gB>Obq&H^%BvunN!Kmeu z1AlJx$1h3E$FWwjff;KNYJF8g0!vSE_8&iH=Y#mHB|L9(F0)*HBQmU~zqTj)z8*SO zLCi$`1krx88BDzG5UxHbMV_e%V@;&*ILrwoX>H9YC@L7AnbD3q{SvtD84MYmJjEx} zv)D#0^dnMBBUO~42A0+I(1wvFac_c$n{)i9LD=-dlvMEOMZ3ZN2%F)9&~M+&Qf*%B z7g?41(1`Gf+sdDUl`%Ov3B^LSFP%;jffJ8~?oybR*zTFwzWaF-8e@Ay$l`y&AAgr2 z?ZYs}&mX!gKR@M%?XRC$ATldQmLM!b%E+iF#$w@()m1=Z9ittmgzESXS?Vl=Eng_P zpb_YWe9c?l*!YN?BUz=iv0l_M_w7g+W#ud`(A3-PtyX~OX7)k(wws#2zudx;KU-pHqM97CFVnx%VshtWu=KFc396 z=M4+&)urt==c<%~)W*hZF9Sf=2|(`D3Il^l-@t(7UJbJk_sn4Wd7F)rsBO&hoW8^K z@x>F`h^@7l+tN6=vdXsd;mmH1Sv&Tp_{2vX3H8z{p5LOnOKSCuI(u-i~nuy+Q7Om>T=G69_F<&Bl8dn>2GnKp`| zcYDpw(8|!Ks6yiPP6%C3FWVL8o+LfT%PT`V z*MLn_LP8rnwVr;6aRMRTej>}Ddl3W=s){__-qR~SfyDqbRbjgxW6lVoud8$^44{I# zx3O!%aE%7dY;TMC3Taf5LJoX)tI_w8SAdVrwSYgWRWl)N2_AAJr+FkOVs-$S`#rCa z)W*hU3t;s8@R#r1a~G2RXkZq7ty(S-vSp7njF}`v{?|4hAHd zE}WlQS*dwSeEFMgk}*6J%M+bEi>??vfG^nM*UFanE{GG+w8f9Qg~h~(A7xj*OA4kG ziO~^0G_YQKq@zPEA4vK1N7ZdgO3DYWuH6}C(gBu0X%?GQ9dE7JvqPQ!3<_ST68V~% z$XgGu!}=5I<)5BT(M0~yiE2lFmAOEx1T85mYt%El9mgN`2pW^4BW4@8P$H_2Tqqhr zLBU*yVR``6&)lZv^4Z#Y2<=FqkIy+E+wXjPzohd9YE*2czrRBE6C5HUB7~`17+H{m zL1{ZxYkMuMUDMibL1WJg_q&1dPUo`yNDmIk7d;f zA2p5E$ltVH^Mld$b}EkfGVZx{HZ~}g)l5i{*(zo>lzic-e_*oWqbp-$W042kF*&@B zyqTF+fzIv^S!2e<6&3Fy;158^pCTf}-Q7J!pV@lONf6PSB04h->Wl5Ur)cASYU@2@=2S)JS=(oWOJzr`T0HMXm`w+H^@?>eKnkl|yu z`S;SFn!89Jb(R^kyWxDR+_W#_N1dB#Pl+(G@B?2tr`JiAvB3T9=URI$8ztsCEbSn@ z-qKFn(atdY>{itL!O_~J-s_caA4f}ThUDirHX4FI$GCRsAO5*}_ZJB?nKLs4(AF3Y zbSi+02AhMmi|t#vx!Gs~ug#(hul~ohh{&>347a72*2qcAqTiGL>#)%N&A8eG_fDVl z(y}k3E%9YfNpL_(-~GK+@xEUMW0^LtHMp_^6s56a!gw~CEj(YCO={cQ6EwKZm6BX# z11#~qLNxO&e5!R@CTacIN_DR87eWOC#fYSIZkhajE?V9b>FAp`XE3w+{}68TX(?ez zTz6ESTq5}0oYj!<)jo9RgR_~GRDk=LUF$ZRRb`#$)N}}l zuw*Zs;-A;LMLjz?=?&i(oqGv7eEW`3pW<9Mw7F|cD=x(<&0Z(zxavstxuW7?g>>V4 zvM~<}2MRpP#SwC=u&{&FI0!D}Vl>A|hj82Z~qcK0Xsu725Nw9Y=AX#NJ5`>qmoVPtgl5+PwjTQ4DwS0z5# z@WZt6sD6}3BuoktvX|i#&39g#I^m(qH`xmFUzum4ko~{d<+x%~6)=W?+%T@LuI-Fm z_G!?~#>adA{j1y_FK7^NIXgEe-@ATfKAxK394z3VpLUD-F+l6iF5Q~1mpccw`ZhI+ zs8wocH_?7;rLS4FOq(-cmmPCG_Bhz7h+XV`HA_RABGM5OUj_0LV>a+t&~*$Cr@pAH zpN1Lp$HvaCzNrae(3O8{1YHdYNiho}18u;>%8I>gCAPZyj<4TKOf_&U-#i$8y_1-j zo3q{!!Pi=e!tq&ki^}c@PKDL#yed)3D`#%pu|phmIp?5$BH<$M)VAt4Hw_@=F+!W` z(|M+j6mXSk$_wb9AKv;rWeHZ`8$Bo|Ti!)iL^A#JWGY_`?p}kQxgXUe>S=>vI)CA1 zib73Fpo=Rdpt|o$OA&sdh-_@M^p|aR-ZYaVY z;^8QCZtdpfDj2-?*QTXm3H+YKg66)(YbD-xE3~M%#CB@NHlXb6h5qZmH45}5%86f; zYsg|X^!=8KG@ijZ*7fG-vZsK=MDHrBkLK(6WZW*FaMSv!csra4DG>w0!bspQW|4W4 z^nFngxO|v8T(2AN!!=Ikl#ns9o?s`$B_(g1x`D(O{pr(#rSGRVlTsOQeOL$i2MrB% zJQQrn$;kmqxFNd1FW_We1JtxV$M#)r^JjJ@g$X!u@sdy&%*=tITWLyyF@@uMpG3+Jxb{v?H@fh8Zn~eIvQg-xzErxQ0Ozy-i6RAs=BwTe zgY1s^`4ZUo3M_|ZfQ=70)*t|mXhpDKv(aFe%Wyz9IPrZdmTJ`OZx$nfZSD_@IO9w6 zCqJZ8Pec6znB_E3S{Y9ED!@D@%U5Pn3f;h~0$9GS$G*7KtrNW_`~~{}VNvFJzfzPR zIL%xVAAGcP6c+5@R_3U^0GMo&d>JT;5s zfWi13fTGV*1UFJfvPok5WlvKa%>s+sx#J8k?_l^1Yk77~lzZ8=Cj69gU z!{2Tma=#ntNP3EAU)H%_)zTB&njxd(vO?#&vrsE9%3ho@?!va+0qf01^_Qlt<(}y1 zTw}EvP3Fa@pj$jY;5S2V2uQ=4w&or1h=uLg4~c6P>G;05t+lT?^WL}&xG*sgl-S}Q zfcyf@>z|di1f^o-8b-%{TzdRuw9SLPy`61~_3v(XiGv^@#lTSuAFnMu?huIw2Fx9{ zN!a`93sz#Wht5P)Z=`!<#s;yDWGqL>DvjWPuyc>O9~!xCulz}4z#fJ%so*E8hmpQh&l#5Fr0s=XUcxcJ2oJk<)gC4}%2p^j7rw?@5c@$BKz5l4jUMJYK+7yNZ=|TXgyl z@H7-J<7)m=zH|o!R)Cnzk6Yh{vIrs&Sp^*}xaIFS(DBogNJp^hj~;O2u&9@O>NP*9 z(tQ92RB>637DV@$$W2Wu1Xue|e}h#GL`&FCpQok+UpI`NmJ5xvz>!q#b$^vB4)u5t z&N!uwB8z*V>jyR-_|inN{qNW3JS+!_f}t8c%Y=JHJ)HbJIDL;YZp-SIt6 z$R*Bc+{{@~ukoR*zIQKfswKKdN=6_g#K{Go=DE%? zb!K=Ado@!U&b;I8jIUYU7Zw^{UFC+@M}wV0RJ5SWtmiJ_QXjgysp$hQ;Vn%{)U#(F z8xD9YC$?+fbIhu9;s5JK-QxEQB$^r<*OcyqyQrEsw{iv)1901rsl&dr=I%|YM1;JK zrfxq&!{o3~+iic-00HA%V^&)yCzF+u-dO{BxIC!T>1b)=;R@2OUy=MB<8ToqFSb@3 z(K7DbOZGeUIxZhGE5pWjuf>h;avmGl3w!X}3qT4_QrSPx=X}*5qu1kAIMD|LA2@ra zi*6$@U&KYZj()|TfDCG2a5yY7(j?)o2%D9t56!Jd<7Y@W)OvwwHMt7skwc4FW0WgAp<2(KGg=gGpKFS zv;|MKDm`m7fWrXx_!ZG2B0mvDd9i6pGQIQ~N+>VgvuQT`%yuvI^Jk09Y3y9b#(ret zr%yKcK(I9QjF|w$3zTH|yu)Lx@$anc{K+|tw0h;8$~7D7Wh>8v1&Pf@+LRl#x?(2; zr!F=Ihrz!=e!7;^4 z3y-K)BbiFrE^2w%0_=+y@h{T@NX1@p6o~yW2W0%8C3HngoHbe3PXpea`qewaqnoum zAX8izOy$}oT&w|BT@Tbg&XaYi>L*K_utv$=;x1h_Zqu+G>j&VU-}ycfaDj{cEuxot zfq8Lq;)M>fH74In!vggsBg5kJ=gofRGZ!yjtZnHDfQul~c72suRpH@=oXXVOMo2@` zawnueUGWhe^gp)t*opl)`prHHnswx_DFXKC+0}Q@s*oO?%iu-w3`1kTKtKu!SLs8~c>dpjau2zU+Zzyuh|Fe555))pc$ z(o!;cS`3WLf=Zsrb+JL+FM$v?D9Y9_$of za^E{KxlFTj4>qlQw&#$$02K#op9;V0)&pC-U1&M0e0*pyJ!V`kiy!7pJv2)zS0tE0 zl4qLTE(t^tgFJOZUta`MWXfv|P?$ig`=_B)h>+sp8ARO*&k>{`*c`@%01yEiU!7-6 zn}&hJQosv3W6>)CK|zG1N6axjryt&~aYXiAVmpd|)t5m!^O&EQ*0Un!lGyXaQ=uZ; z^@%egF$ZHtXdgUmqVhqZkzq0kd10c*;ckxgsSZ*ad|(&t=;;W~n$J5;1wyALYm%75 z`a}zcs9sA1VHx*6>C2-X0;sKin*D^B)9r8TnuS((g@q9n!dWH_5i^_e0*gW4Cd2P? z@izj+Y4cz8-QgwXvCwksH9ZKwVL>=BFz`9de!pqJu$hjRmz=`Fw&Z%#Y3gNMK?@5D z2=~2n`*!CP1~^fWU`0pQX*&P27B^Qs4?hbpa`Nxb7IHj!ndgRpPg?)T#2;+ff5J#zyvppv|kHsZ?VEPnA!olRRa z@~=ZKsG#q$^M+Us7i#tGK3s}rXL5pU}7ZYrRf+L zhFx>78JK6at-0AcX7hPIdi3Lo2YWOQL{*-nk%?}t_QA7x{TjLZ)m1N=M45Q0@i8aO zwV@~Qj?v{D-iX|4u`U1#@b8wf!!A3~~Sii}~*x{i2|wkkw4PA?&UCh@tHlyUzm6(rv(R9Za+%mS9d=dP}|K#rrQU8aV= z$oISREarlp%s#iYuVL(ZxYdoVr~Zq2cgm7QW~x?`>xNDAMSVfQ2da! zv*Uz$j8B_*<4+^QyY>3mFtt*ve1~l2oa(-^i;8Ce*tf8-gstZ`$ASa5#?i96@IW#)X>d>QGt<;%J{s!mG<|Fy?<~JaY&*7U1VMcrc)rtSx0b zMqZVe?ls*y*aMQF?(gd6u)V`XXasJLwSYCVHW`c1dlU1I{O}`a>D@h!!6pJUyZzwv z-F{|%x@gL<5AX$Dsi^+DC{+8=;Z;7Q?p54TLB9-J&$?)5XUCE-Q}#KTKnlUYrp#K? zZSC@wGwhsptDy6Sb%k6>5$px>;>Nf;L`2GY6=ZB{fa`$M;RAG$*GM|TAT2pIcGyT> zAD)$-iHXEZ$G&kn6nx2Pg86iVy}yhNDYmu|J=j{S z$D^re`>DhL3)PDZhkHMNYjAK(>i7zI*F+D+}! zEhG$M_W0Ii+*`b_J^~8f5JH17Ei*D4(y$#@g${`b^4kJ(xd29NXln}+uA_XS3P%(e z!d~VZU;QZQoh%>-w;TtGY`H)k#P76v*)~#qG0M&!pmW-^O%y{ReURphu|nsk>$@w% zPc;_Bj*gkTlQ&QV(jdmvxgi*;K$}p^B6$xPA-sv8O1tc~d z40y~&;#BF&+p64Xszyg^+^skwu*m>k&Dz1t`kO&*cH(s=tjRY%o+_MKl_Qngvit1# zrY9K&DHPy(@J~ot+kNWo{0?8zJ3w%Q4x$&BIKl3^d^ub;}kqi}n z(1SoVi%5$IDf-V&V8TU7dwP}E(UPS+UfZK^O>Y4zhRcAMHaJM6f8i*n_Oh^C# zdDZ*sQ&d#rXQTZ9TGE%_o`?ZPcd6=^N~JxZhD&$JGzv^*VT%U=hY1KcGjc(mWR(^kK7Rh`xg`m}>@E@z&H8ANR{IpyLdD697Pn2rHelu-^fz&-k3 zY>&OG{|5b(51)A9y1OV}?i%y}W5~5zI*7zgfYq7F*I(tw^Y8~653R*Yd8o`hGzHPJC~`5=>TfG^O{Q4u6&miCP-1b1P$~+5{Njmvw{TEe3Rd0@%)k*DhU3MMPa%MV|~$E(4mL@&Aa0U$-t zL4LJ6(b-#Qzh4AvscGY*Qzz~A3vnv#HH}bavr*{juKa2ca(D}lhpX4G%fJ$sMycgz zEUVG^dr2F1amYHMbpEOkA9jB2oQg(K0ST;NQb1QEHn+>Zli5CBP_>ZvpHq_U@gA9#{W5&~bgx&R5Cwx5G6|kbhIdLIzq*t6YA^!Y z4E-$bEcZHjP@>mqRb;(gJNKw920TzIKlFU)LAt|WWwi=;MF)_@Vd3GT$1j0TS*50a z*84L6jiv!YV$ZRi1zeO_L%BcRn&U5>H2eC7ePLgd21@0pLOI#DJClI-z8@1loW@|< zPR?b!3mhB3xCN11GGLf{dtXxZeCi*X4}BCY-TgD(LF04Bt3G1|chQZZdo^M^;~$SSp^t(V zCbI1$DU^ba1xOi)3Z7m=g$5ToLE-rcN@^HG*P-w=VB=lsAy(h%(YMRVMY^|p_pbX? z2ZI--ox)l+M{QhxutSv7VF(YA^JOU-!R+&c8%IQDVANpiJMyUWK;aA*SWj+6D2S3WmW{0jYK`NCn2m`~Y(P9N`+uUU3lU7vS|E@_4F6UcH>&YjP9V zuea&GIW8^qM77$~TKjrql#qu09=?ZFGmoA#hX;azJ^jG#p>J&>k($FLw#s@W!(4u^ns~7Sj*a~xc;Z1%8)=wa>^c<*rk>(V6aL%_>0NUsPXk$Hny@arT8Y#7( zLm@yfL)kJmFp7x4zl~BMaw*tgGqekvr-U9JV}F8EiK95OPt|g~fVPRT38^&$JkGX) zr_G*5>BWl&fV*1^mVEFL+iJSryNkfYdwaC*4=|Qk{v{vcabvh4U|y1+mI{K$g&bz; zV7VIusJ~K*Pnj!2=B`v=0Q>_4w+%Sr=c4 zu!jL=;WGVOic*ja*+G!;1_UusNi8{vWL)rI$quhFvi{>C_s2VW>K)E(f3Ve?6v~?m zgRfp#^pYwsua3tG9eC-)Kz#r{J7_n}wMSY3<-4kIPSD5u7*AhHzVg7`1@Wf0T;NX63q}0B<+3{cEx8^?{brX+Ir`xT{)e1eiAvTHb{{0(Z^NWoHtLs-xf4A$}sRahSWW+tD6LL_{W>C>7L@?!KW|V z698!`r$@aqAj@MVjSh^af)o_P>3vj@A`Fpdsa1hL0~z`RXjCIt&=a{j*4iINE)wk! z!Hw9?24aTT@vXjGS(*@6r~cLZ%Se;jbDm?<&faAu=u&_A9uiIa{$ky77Sju|Rp!jT zJ5cfVr}BaMfqLY=v{i(?dLp>|``2{((5RYZ)#rw@$4h;ss$K`%#gVySE+4_lfBy7I zl=HU9mTmSR#|93O?|4;t7 zksJFj=_bOk?)U$H))(4IGtMalCpc|SFQGjru=17PdZZ{67F8f-!{D}mhjucY=B?T>} zgK`-$2sFG4Om;$_KpP0COzZy13F(c_HJx87=}l;6&)N9hF+`mXYb_k|J9-Az$h!i+ zsKMond17}BVML1UE2}{T4{1{**RH*se-DE%>A&4{;dwkf31D2;H#cV?Q+y^wRP|G2 ztP^90ck^SFi$p|5Z84(z>q$;~M*E5)r&A=5s`xm*@dnT&)j+o$yAl>hxrSOBdo{r> ztF|>Q6v3t$7*a^Qy~Ld-k^$l?oc|h)jjWKx7^_|C1P=AEC|)nNnFekg8wZD^SG|j$ z@bIQ~AQz6H3UCA>%J+a_2EF;{4YJ6qU|($tYZ$B)C4&P=2`qqV0hQFzF_XS|IvX!M zGug_#e`W_Vt)xL&2U?n7@TsbqfS?jw19uy~Jk`+n#V^dv9A-b)p=WI(Uu-81*g+Q8 zfGs%EuZ3M}!{pfKNXg3n&?>frMLnhmCS5%ey^$P9U}?i!&On(m{eIkrQMLMRM_VfX zXu_aO%b|%zGT0~7utb3=)9a`O;gc)K|JM>`e(~36-SEpp98MAyf)bqLH)RQ#S!7v9htgrv=@KQ?^9@k5ZBRxQ6|Qe?S0% znVDH%lih`XeD}vrPbfxYM>9!q-fN16$r2>`lpQ5H@+LCnxvUF*mRp(JT{xFf0P3A4 zlP$D3)|)HK$!2) zqE}VYxt5l0LLGyT19roqyoIWj6~T?^Za;`@jl#ndMN$U#K+ryWtdgna=TCj(36KY1 z+D+_9l_wR@5P@gZe6vNJA(E+}pkQElFf2OUES~O%?@-!SY47lTLFQNjayB&v6fd3| zUL0jSNZ<0rO5Rcw-bmaOi4(T(`*)_wuk=&7$2PRw8#jp95+dSXs9v-h7~-Frnj|hL zh~iX|lHXsNdGRSSJXA*RJ@|c8J-DO?a{5Arg=PSBV zZFqO(&m}mSF9XSCVI=7>61wBymb+T2P`jpfKJx6%Lc)`G0UspxJr0CtVsh5k38xFH z$FEh|b4Z-J%T@<*O8&18((1L10ni=u;JOQ<;K3ZajBjGurEwsM=(}{PpxMAz4*SZ} zcS#Z<>jR&zLds2*1Wl#6rzmt0mt9`-G00KQ)r8PT4&p?WmqXpiMmNO4NGENneDE{q zd0+Tj3S>W+p|>?0CN@k(eKn2^-xmp&@?7 zwRY9{omTqQ8x?N_#eXOFgr#o~SnJHs12B23_|W%LeDw3FChgh0fVq%Q?mM?v$L`FU z5o-sAXW84(W0tF*Xu^XWq2%Q3=J#B_kL%+Njs2`x_2}rxCE}3V7=8SW4GAFmkX(no z{g+?uY%bzhSy}x}Q$S4XU~heCd=5N7MzH6?%=)l3bDqd5>O&X%+xN!A;QXJ^5&3ef zkdPMMSw#78LhZT4*0#3mCVkA55aSWNyQYNq=ZO=(e)I z9X4i|5}#xjzgl$T9L~kxx%_JC*k7LV!k)L?CJ@fo)C$@Z0kET7^L zY!IQbjVBIVl0w;God?Go_-O|5vdz(aWaVAHiDPSxem#ecZA~+^35h@zRjXyEhz&aIczCpiPd2j`B zI2AiW6Wl*y85}j%Ad-6~#RdqniW6g8gim$q@GRSD7OZ{7tGhC!(yI9Y?@eBwa$lx) z-5)V*npQEsK_XR0XM_0XgwSeY>>OBP;8;*(DP~kLw}K24@JYXQb)e7(;veLv@T{hN z7_GsFcK!{ZcWAj7nHMjN0xXq!6#t#oM2q9?{rIxS>wA#w{ouxB1ONjq$-eW@At>Gh zEUoEc$hU?d zaRENk{5f1~G2^j8)kJs_PDB}}&1LMs`uSN{q>XKIyc*-VuIY1b24g$hh}->Heu`!& zjx=$Het+vsfULXFX#TAD&1Ca}Zh1>(p0xPqI=1bkbmg=4y#qr-`Ya~3u(^k&%0aja zYM0-SUqC>iy7DYPKR=})wROBUz1iiJP*S&XL^Ti4?15JoIvK#Y*77|cq@ffS8X9D z-_goSYtNMf2Tsk1z`6OI3w>f@z|J(a7<5>#Z5;1Odb+365unT)Kgu6Y%uI%CYW^jvR$LoQgW zMULjFJT>>3^I!EM>RBAvRd z5h6N&?b5=YGzBhjoc#_?=z#7GfORNLx*$2nb+nf}smrvzG}n!ND1YUBE*w9d0z>ut zV(k^M{h`JyXPL;L%EVx@=XQ6cWCg@c%ROiP{+tnVPuDk@tDW^T800%uC$dhEmNRDJ zDcJ7`(n1FYm`KTse1HJdjbZXEuWgfM)bUM;!j8F_1Qeg!Loa2>y8R-TuMzUKMag`F z*u1?CDd{<9EUGN2v;4Q%c1Z+YsK5{G6!#pf6G=wj%{a zJiy?-Vh3Hc{@I1O3_=-9IAdd&Cd9>1%mv9u;E&Q%p#BPk`SSARI02XLIAhLeKKH#V zfO{bxWrd1I{q4feR;|wTL0&!zwBq)=ZyuNNy4*r!f4k%RU(Ouka=vbq9CJA|2*7DN zK1VYH(O1qV#UF$YTLWZ{=cSR3F2Ez;{ZVW;Tb$t>yYG{<) zyq95arH!7LSrG1!4WrWIGL(rd6MOw*_x*|7$v4*l>ySw4{g%%6;x-yIX!eQYw0Ob(ZqqF zWHy+?3do3YRk`r|D4LmqH@$1}DrG7&PdRm3!GtX(P#1h`z#H^CviZs3L?7HjH6l}#GWA1^!9qB`+gJOp#ce@d-S zNoW4`d`@+Ks=pY~eXzdi%li}Xl|mpur$1lFGaL1W7d*AN*!UvVR!p`SC* za&K6(-S=efdD4g!##>4h;Tg=V_jO>=(YkekV`?KcjZ*mn1qB6QyGTUa-}K>6DAl7@ zhC~c;P+=d4?%xUToQDI&CWCkx&UAkDGkfApr|G_DciukQvvkjw`0{*S9gJ2m3(Q2q8)^W0Ow|eVepkv zb*d3d&v}uv)%sVBiLHcqjfKRM7*K5oae7b1?V#nkz&nHb#=}JMSB?%1P|*e66RO28 ztZH4{5t*!v@Aw|ks2BqDX^!Afb{D9XkkN{rPM`2!nu)RF89sB>yY;o#cyvi ziCKW|Tzly|JWZHUxQP6u$q=zfBFl&3_rK?P0W53-ld0K27GwG9B0>ltYas46MXuHH zEkKRWWqF;7l$CoFc}@6$1RarBf=2KR1Xv#V*%z)1JP~&lpb~ifU3O_lIpa#z`^ltB zmo80%UNQ^>UAD_!NLY@zk|Up2!h4*m%nFz zH?eC9adX3+mpH6^2#`LBA)RYa#9(hGW=$0)wi$i@zPPb|?rEAbV`rIX19-t6K;DS` zP4j+1)?Qe;lcnbbZEbAM-)3bE+9#Ohgv_24T59%FZp^-3 zKnlvg{Q68f;gq!kxf6+x_L-e|%BMuKsY*yO0`Ih`q&rXf2UC$kmFYu8aP1WN;7Q7N zB)u>%E zs%JLB*eWwqOGY+d?!+1s-pINjTLVmc0L1n%NHZomzP&&}tj2Im3m&-pMH_1`QZ0~y z1tXs>T?S@Fy#n4=zJdp7;vyhwGkxDD#0USk!VBN(NboPC=Ks6{MVq9*8O8tIqN+%F ztJpT6tB0;%9O69-pJ)TFtIhz9%8?wq+@6PaNta7VGY6Xm@)ZWZIx@Mym6*=dS3Z@G zi}ZYzgp_JInGfxrRtISYvQ_s|o+ff%#{! zB7ggTNO*G{-u$+S}UV1qB>2JwLhB*K0c5MV&68 zRu(_G08NuZ;VfR2W7+aiM``R^|>g?P6$YTv}fN{2oN#P}VM7F?~HCF$g}`_-$` z8{6gXNw{^d^~v zRA@=c=`S+SJaAg&g`|~E0Fa+N`IF(q3{B@7EpFH^V%6V7=B)6{x;!a&xBY9AR4 zaNYu!%WKJ!Qn&RL5n|X#Y}HqZj9f@vVIW-MrDtXB64|A174+mw&5yhviv=?v02OOV!TDrr%s00A|OJQv)`=PPG`hx{3#eUz;5u* zLktc`XC`GjpXJgbj%bQso@`J6nH^K(Pkc?0?h80%oNo#LM4|7HE3t33EwiiVIa3FC z#x-;s1#E2WeDf^-?1m%#>{%ufp~|?O!>P2<8AEaU9@@AXe_=7OH-IA+X-~3kdt9Nc zZUkKwcO>?q>*UN#EpSJh?49i85p3Fx;Duz_F>3>MhU{AVhp-0zTV4YKhb10@PV@+Z zqLQwvk*pe!Cg&)}1GQF;B>Tr|U0sOoa?zjR0*}#W15S1FJNF+%eIz~0XJaFpa(DCh z1?9^#AFg&hSRbpN&5LLoUSE!iG#xAp5*yTfj8wdithxKbjz@3`9E8hx1W&`0_k68<2zMSm`H1$;qP z@vQJP6=&g6kR$5>&5@JaC$=2a^#O%rw7R;Xp)r(L;<~z5Kre~tcyT}`l?D5qVvpj+ zZuWG!dd zzq<19)!#rM?r~sgwQ;aVB){$tw}r9h2Z3fF=*}5P%?Fxx0)vr-e5rt~x4VYN=UpZl z7C{oF;GqBh7m58~8U!{@4;I@~Kt=%Bf=c>J#F08hw3;d&)Yu}z6&W1w71#`Uqx$>k zmOalgO5kpO2VA?VKqVo;u(Nu+bWC2>0G^w_X;;mtF;hT~LGKRgdx))tRF9`>YJ8Z$ zgaO^B{7I=|E^PTq;Ix68(zYE+{8}|}cj;Hw+makMr6LgzkK_4Ka~x2ia?JIDYy_h9 zVupu?dV{I1-;jYAQ&8c@E+ws-0H<9K^*n_|+KX@cp|lJi4|K@xo3?-yG^PiEVA*xb zSY9~(;9-<3%;nWJu|`y=-rnKt=Ban9oGyr)^RnfI8P1Av#bUsfv4O#o&e}Rha1CVv`V6wn=o(t)! z(3V)Gwh=w?BpuAMWre^X0}~Vf`08NTsy;`3F&*O(WQYZQ9z+@YhlHT(JfS_F`9A}1 zpWpmnkxxjIW>T?y)Mi|+zB5SDr~cz}_GdxDRkRcYjV@*A^OLwGZ1*^YzGkU|dx@a^{vi4Z#*m60K{yh2svym1#I6JxOc|<*uHW5!N^hG$-i5HvV$RM(7s-M0}D1}@t!sBJE;bF zJhH6&`YK~EswmyLOe!3p(zzyo^h3gx{#1*>#zR-z`Sr(0ZF-0+(l|vkhlM7kb?tQ0 zpE^nJm>x-sh1#*_-xYWQ$hD1(rY0sDA!N4f;J~@r<%i6{G{>3)aM{lXHiN-3!X#ukQ<3kifMs zyBh}3z_gmFnujfCSU_#v^xek`K<6|ihWhXEB8eP9VxsMbszbigiL~I2%Y&g7xm!0j z<~`jIlI^x8XJtMZF``96M6~Z^;NUg3-M z{42$m3^Dj}eLeMnAb`)YvC^+zFGFpV z(I@}pD;!!u2tpe<%H!2ofgOek$$o$!6EJEV#))`rqdqy`F-MFtUYzyys+${XY@!`Qmto0^2DoG*;c+-T&^WoM@MtYf7(GJm&r|ycy>3 z^5@^Fji@Ce3!I_@zUiCuawE;@^5;}w)er%Q34$lX=TPqN%o5$-z^j&xeb`V_PPxRJ zL3jJ>wR~CwK4%+IK}Rbt>tTp-gata=b+WX6TQ zWE}=GX2)kE0vE^SunhG>28UM-SEy7%AU-HG${7rg2hfb<{>wUl_6-QW5PN@%=Rqil zJf4Sr8vB1l%FGeSDDHU%<3&-BgO+YUYzm5PE!kK)A89rC(=V z8MV~YG#JgxP}vODAV`-dXVol#<2Qt86WzZ+3Ic73oc5DnzS%}g^bi=ZQT6q-t4!T| zmi;I=n_Z}G6T%-sZ-Pr06E*zRD4@^xoo_Z&LE^&vz8GfD?{bFM_4KZSSTV>2J2wRh zOu8?O5V4O*qSs}}o^`#PluAxQAB;he>(J=O@Q|gTV&`#`54BYP>QO2P{4EkgWn-4t z+B;+j&Zbt>9u;hFv>Y6vZmUamG+rl;>VkEv!&r3wrARU{;!Mgv@|7$YFv;0${*{X1 zHGd4PG(<@{fQOG1kwOBx>z7PWyE^FO)s|IY7_UEUaY#nR?K1~6=`uaag(m0wxv%&A& zIyz&JfG^(fQ+S2kM53EB2O`&Jpl-3_uwH(RvNafOH0NQw`6?;r@rv>$w1I#$L$t=H zP+J4>Akaz!6A~@zfF^X`>k>pPqL5IPtl&ehjMfQz>QAKG+(rk}s;Q~TVxXw6th{Sp z3WT#!GW-@Jc?pnhLv}c)=${%{NDj$6KXx#)v%&uUc#e+mS~jRYV~qWIMuZbiu2fD;xD8N7qe_Lqdj#Zh{mxG?$?)#-6YNAa5r;1N^ZgtsM7X zmk_gc+P!^`FVM%I_|xalm#dOhb&^kogv>67(fNhso`QppW=aZOAUP>3A0(2@e3?Owz# zxBSm=V3@*^{5kf%ov|2=p}|ov^dvRuNGMLZ(0Yc9H9?~C%qXNUngb>Y!ekIxfp|Z- zIXr!0b@lOUWshKL;a2d9A=yNqY(5s!SN_@i(2;|v{3~`=M~yN&#ywB{xKibnGUG5# zbZk~M;Df0(Q(Iy#OT+qS6Ho71Wij4I)>_TUyokEy0TR5qN{?spTi| z=4OxS=@U#&-WJbtB3A*=(~cU$5{!xp%O!w}|D0T`pr{vYFr|275NGZcM4e;R^6F}@ zi{A1x7%0`N!uv@!_oppC!xA>`g(9kgb^wfpbDfiX*!f^k9flfkBI%odFMuv`@@SvS zeP_P`1Z^N;Yk%uEZqVFxN1!C3&J&$4n<)mD1AA4D#b5}fz;(Q;4C{*9A}47M3LtKN zliKx922FX1#v>)@ew*omc?6SDP`M9ni`Vf7$YTkMh-j{tUD~t6pn*3*pd*Oo0SL<3 z*?Gcj>!G!^NmdQqUS8fqHl5Z=_MC|L__jeV6Y1@xk-^+JQK!|M*X7SU5Z)G5=t^;{ zN&6BqltLBR1(}2FMEd(&_E7>PZes!qG1^NaIXSuSMR)qISb>WRPLY9JP!N`bv+$$5 z$l-f9A2s2|{$=|L^=F4W@kpF!PR_~4;YYCLXfo6%Gjo@M4_rRdt!P!_);P}wI zuUV^I1N@1g5}cXusvPqHJP*LD7ENpSs(#dQmD4y|3dA4)uC1SSZ0_L=qA4|&2@g0z zrP!tThHwDU`VBT#Ezj9jGi)9mat?$+!%L7=-UI0gA{Xc9^BwSTW7Ew2b{~AGwNO>m zNDxK$fI|wYIguE~ey%x=xmYn!je~s9B-_#!T#ddE*6-IL8VhF;vg;$Mg}Q5R;;YBX z-j_NEL&micsEY|N*afID&#cYNVm`b0F%07eYqNgG&8;}_9z?P0LL|=(_fuL>wNFm2 z>aoSf#s)OKwroJ1EXnf;@NX=(tgVCaCXiBONZ)qp`w%DeIvU(dV6?RD%S0)eTJy@s zuJf8JI~PUPR6fC>k>CF_LT`}Zc@;|kK+K5-b_(hp4d)`aPqC41gVrsB_9iUNXCRRQR{#527M=2l;P|H!wY;ZPB8p94<)ze#~ER@Z%~=Nq8ieGt9L=Q-7^ zq)YXmSWG5Y4kI>J`h-|>{oU1-**r)MHGXt@2=>;aqSseRP@dn^lJ4VQCn~w__`|Q| z6wZl&X$HZjNbv+xSx(WLr%r#;#Xs3`)CswQLBl7zLvA8CSewu5goS|oxXK zXe0Bnm1G0PqlccXTx%yAB|4%(D9z=%S^_xL?kX9X-bp2Z6Oir#CwJTKfKzDGc>$Py$z>FVx zqF!G=7atgj+Sycz*0rRRmEn*KMwz%RA;i7+aon@IY4Ad+bdL#@=vB}xa>5;wZ6mw{ zB-r33ZJ-&pr8V@sT_DZ0sj*RaD3xZj>+de&fp*8PM6zfJg&?TEwVf>3*4Ax!IlZc# zgm#a@;7E^%tt})EzD8w;laUef(d8%RCk*9ERff(_{PDxiMA;$fQueVRX(ov{&KnTA z&{uhfgX5~8&$q^LGINO3X-^Q;%&6o?W>Ys41A{+g-Mb&RkwbFX`b-*!`{qXE){-0X zTzfobX%LkI>6zW#it43~qy*$`NzesArziwjRZ_0vxQIY$teg&;6$59z#3Q&Jy|Z&< zyxGqa0$fc^P;C3WBfK@eyxa;X)19ySw>1l_Zi9Q-Qn27tXo8$SQ9Kg50|{FX^!H2w z|J!q@>zH-m+*upMrtO0)9m$(LhqoJ>y3RQN5DktE zp!NXgXf1~zqvtlHOKm^ZINpFH3hcmKFfdc>Q?2gN)8#m>FfDz@0rbA!k3eenjSM)W zYKQXE)8H3``#gcu9pd-xwPmZnXh3FYOb^>V)NNtm_)aE0XnzeLroPkq?1SS49GufF zsb`OsZ-WFkx&?+L160JDA{78zOfN3h@7LPnoX5ol!LEO`?rn|@A;?66IR3L=foMSd z8azDvsk-pJ;847jcB2s@ryv;^aWSnHyIrBOUX!_Sii72l)`0P{)Q`Ty@-PlLVafF2 zHBjo2&^92R>Q11#mSi*U^V8kbq|p3R^J@ye3}#S=D6cnpy&RnTbR7^(;7AaBOJDz_ zF$GXug^xY-I8BV?>+9=~+9DY!ZV zvma95aqfAa1X6RoWsU6fobKLUfV3{-&U43zBT$HE>x_7yt1q|tY2H90K=*uzigDz8 zcX!VKOm~w6&rl>sUo3zpLkG){=pjP-#@AQLeQ(1pSx3eQvTLIby2zn|3#=1upMxfY zdks0iWDo2EV3~<`8asG@iM<>tR6!^H=YTL`iROBm7XJ+-P?*g1Km`p+y9x2oEQP_>>o4b$KufH*m`D6ki@63?Zv2xoWCW4q1rCSw zfDnQMMqi0Tf(krPp$5$bQHsnEP#}7GM0@9sp1XhpJ<3xg5;UHC4x2^AGVm^2JauI1 zKAv%3A7cRSmKaI9-&xT#9bY9Hix&z9ydG&qKzue`jYnbisjmD0OkBS$amZnsVYv9Yqx#B> zEQl#`(baEhJdNSTTMstf4z`cYV}yXjN@5NX90tY3mD_mxsU9(rr!PdvRB{!3|i5Ztfo4Bccj6fKyK3$biR=FUf$oB^&bj0aB{Xy-tRx!%<#%v+)i) z4#+7NAW`7jY`PQK>kkVP@NiH&qc%JsqzkO3c4eJyfnBDxef7H3P1Qd-mM|EH-U7z< z4XZEd`Mvq;n_Kj}9flh>0}htG`Xi7_f|KB}3tK_N{xXQ985qOi5SO?%Ra3g|(}N{y<%2C`$9(EZI*f8vc};#^P` zB4rJ~-QMjEA>PHDHBP^FS)i_vb1I;k=$>vDQ6|El4U-o&1hbQdwc_l^|JJucfL~S1 z@Zqm&-2FK)Wr68%5<*w|)D@qn{fp1E%W|q}>iWQCBBz;55f?vNub!-xY9~(n^QV!y z&XHzlK>B~v@|K1=U?!I3Mt6v_jH?ZoSkAz9NdjmoV&uGSC7OCo?sI6Uo^~q>H+MMv z#;{1I?SUPLvnl$d_1fQB4%mM;ME#k$%jt1#1Y@5#DQ#9+%Aq1=$$vbS1<8Rx? zdR;j8QL)@rHc(vNQ@vu@x`hmh_2cLwL~y9s!Xxh5vPW`qM1a+4Z>xc2H8MyD!mEoc zf<6;8NqG(P)bWo6+2t3MAkm_c9`)Zv4#)E`P>R0)r4$JfsDP`tjfm9!P6D(tphH1f zkaW8ugLK!K7s=j{2a4|uB;VOhJrk0>Raga0ujt89n`;>7ocRA> z?XBaoYS*n%OjJrmx?V&%r6r^r3F(vu1pyHdk!}Gg0TGaHq`SMjyYpOA-xc55 zdw;+EJLm9+uM1fZ&ok#e@B6yO7}ppYxuT8Fi9#@d{8Egz_5^5Puy*!azxh@>VoA5U z3L{-V+dj+k{}IoH{)P@d{$y!BzKn3JdS2cEeWMTj!C`_P=F)mO551J2&+v26w(;S4 z8V3%)fTFj9uq-2Y=IU`tz68vByq5{++HHHS2&UDwV7~qcY_DjyY|Eq@+hJ!#ykO2y zkJK%fI0Mi5VQMrLDhTMJK$xZ{rCDIcnmj_x&(BZSg!fEbnj(N3)Yz@BUccTO7ID(0g2axV}bk4@47yx(3XiY zaQ#m|9D(3HF^{g&FZSSdgU>m0J(M=aoN-sH%6$^X`fxa`erVm=8ifgjv*5;iRGMGR z*GrHoHc&&(?Xpv;nCr|tiaLW+X$tP82dv}cwVp!7ui3&7XY3rdgDCCSFtHR0D!#{EDu0}%ALzX}=W^U7=L z&vxw?;7XpybP!w7v6RLkyS}4nINA-uMcY(ot7qmF3^Y=)q54b+u zw6oyrg*jwEzHE1#A-Mop!s^~$f1v6+mcN&Sc+z?dTuhOOBTy-3ve!ak3B)*%g$GBt zJlepPXBEcmwu~z}_H+Kk$5bgJTy^6}CCQfAmB|Ows~r34jX( z53K9HJBcEgx-bP|uk-?in|lO$;3=>LgAN9AByM|DZBbId7}rX)36NDSuMYK0z~tdB zN72H2<^Q$d5s=f?;ZX=FKyoPN8vvp1Y5S6^+PA!;e+3U zxU6l)OC!_az`o8Ko@l32{C4kda7*fu5XXTl*D1}@UTm9=pnr2aZ})jC)$R85tE$P6 zv|Gf5l1lg^%;gXPz6J4PjSbHX8oPuLvEp{m3k0pfT;Ul-_E^wo z&)wnN(j>*-xu#w+(r8}6Fpo?kfsRy~Z}%dI^;=Fj-AYL9_7I0`Fsid4Tg@%Tj>L}K$ta26T*4HRC$5Hm>I z2O)`GTn3bU^vX}7`bh901rhR!<|c%JoOawNuG|c&M@|4pq(!u_ko%xlhZh%)cP9%J z5!wO%cUkTs!^a?A9xUJsg%AjTuyO12_7<=5f4$1NwPehI@Cb!J%e}z~Be5Qx>i+%1 z9HDDybE`Z6q|#)S34*Eku9-NF`WyAXuTT?~*-6!sgZWtsphz&xCjLspI`I*t3JMBh zw8iqcNFHMV@7+2Y1I_asYO2{)_N_=sF|U73^xPRauuGN8M|6zv$bWvZsC6eNwXeZX-R|c&MqVX9Sr)2A4xf zyUCRbrFs7MPET}c^_)E<=(s<7HSDCK@$=UxXzc=x6&2ixbVNyV{(V&GKR+0yJJA)W zg*UghrT}<{W_Jn*G{)oMh&dSop@+op5D@`bI83K2$1$6qX-Yfnud%)X6KKZi<}}!t zpT=iytD9SZ5I%HRB|izeR}cqqxKO_J3DS6AyS=q^aRnJ9K+=*kt3GN-x6Unm=Tpkn z%CXIdJ?I1#w$UiF8P=#^^#7Z7%U?G4i+yHfAR^$Q@D7-RhZ%fxBmh|l0_Z*$7f1^V zE_M7{((+hedpnr{o&i%X(~Z?^LpC-ogC7MTwS#>DF^@qGe-NAKw~Z(R)c}^i{l%&8 z)lz)trHzo3!@s}YcHJ2n$hBh!vLIReS2B`)`L8&cmf~IG7T+_H_rn1mWjv=xW8z@x z0xwShVYU$E32?{7HzWXl!N?H^BapFqDAkZSWe6#phXF)5&~i9I*9!e>5M^m25<_Xo zG6kNspv{2EZOgUN*r}Tj8QJ=-|1J%XKdjQJS*yUUtj39~ytXsZyJ&vxx1>qEWULlW z9%OuD&I-s>Z4j#f?jF9;wOqR0CxY~rYx}v%kjDBu3bkI2?=NsrgUwBQFXIp)g~7KH z2Ka--ZN8-<#s*zUXlY<}nx*etpCV@<3#LQccrCMFFsOAKEL#hT*R{%&^SZDwvhdyO};lw~t%YwkQeCgu&c`!gKkk*Kjom~PDY@d+Wl~y!I zL?($)$bDKO^{7rM{1daA2aVAqdJEB#v2@XyE3egnuD$j`4Wr#jkJA@=6maHcYpb1(N$!l-`jfm z9|6jAocBgYc@8$p+Lc(`ifWAk!w1UJAiE;r=l@D6SAhq0{e*9O1p-MRo%6B@u;-$` zj{HT%#q-*V{i?LS2>U;Shrjg|+$k8{fC|Gm=Ug6&lQ_w!S|kt3AcXMmIt09-{wTZD zIY%3R)C*6}Yj!5Aj03p;7dLJ7$$7$1+Px7!Q!CZ<*QMN>lCcD*ASv(!o8x&9B)8bA ze2>Q4AK$+jz|GxKoI03yVj6O9d0jxXI1r|%kgvds6abtX=n$O!e;lcaY=Wucd zQdnVgS9%5`fTYM#zr3=%w>lEha(YIjkg4%1P=hXk6I_5{+`Rd288TK!9)LdY6W9&| zz2Z{0x>2uQxhe!_G(41GK97jP~)=+rQym)iZ{$kf|rLn78x*vxfh_7pnutg&KA zwr>M@^Rw+pRVYvI4kl4$|Y;kg}RhoLmaCjR+%8ZTLj~9*wH) z=Liies9nYBn44Q#nuwFmSel88tX@V&IJJj58Dk3GdMfX=LWk$-_Lt%s#RI}S3;U;z zJZ=_k4sF{b*7W;D`-i;q#GB(*P}Z&9(mil!#mzSxs*miA!ryH}eH`lWxVpEi>%(hP zO})j0UX#JXFpOn8CYPc9o*lO>0d4+k||tpw=`nz(qI=HupSA#2-VEE-(w zTb7DhQb|qat}y6;jc+f?z_TA6Ed6QTB|#&xb3!u__l(tuhiPe2!5-i3+~p(S=4Cr# zA=KCe1Xa5e@SuL<*@|?qSc%pxlqrkkJH}ek|COxS(AFf2TU(#Pl$@-uRINkt@LUD2L#MBC zTjdoWN~9aQU*qD2LX#5;Nfk>?K*4q=I%yKJ*^921eWuwz37&7|TM2SUWCr`S+atv| z$zf-O=k03He>UBVIXNqMAUMpsRu(iqFEZx1<-|8*8aI`pdW{@zT9k(XL9xx+)0m+P z#2j0A*5xscKG-6uawW(_eC@~xv78*U(NTZ=uyNUY>G!&wpB*wZD{ui!gjg~UZ||@i z6?m1}%F4dBhpG_=v}z+G@BRFqQ~KVni}$K!Ry9pqK9fAbOXDfszH_wD+IE6Yz!D9Llv}s0z?hRSCntxI zg=J>lcRpgXqOqp7mhs2=bI#ZH{x~#YKOB~`9FOyjkEzAolqz9B4GFdOxLV%WzU(@) zvltW}8F|}=?)kd?73f=uMm3geqsEX`Lx?=wEIZlDn^Q4bG}5}<`t0ET>g?!f{INg zG1<_`r(9}tA&Bq%23CNWGsh|OS-JfM6snXQi9;Pq0KX(ot?uR%a+$rm+?}SYcy))Y zX^$idoNwQ*os1Ljv0VUo@eq#;n-CZ2g#oftH!)p>_M*O~Cb;C5T{y2b6I&mf-|>bV zZ3`VrA(Y$Pn|xht~l{Z)s_H#Kbh$G06vlnuLUsdF+6gq*lQs zrn?**K4c2C`s?K}8(M^SrQ5~sQBp#nrq_i}7{!j1QsEL$%A%j#cw(_(D_q7d(eFj* zPqMg35FQb6(`J=AD8-duO^tY_JFE!#Q36ydv%^if*iLC&sy+HAS62nZteEtg9_yHx@Y^5I(W@Uug+=B6MI-L(BieSZJodWr zFmClCzE-MipaY+Wf0Qd&;^GuL#wAIUQth*jUMp&Y1iA}gZv}xE=#|wY?%<#KIVi~I zeW^!Xox*+v|Ao^K@xzMUulZMO;>gUt<89W=?-V z%3dg~>ZkeKM*rjebzKvaYJZ~s!}0#^YiMYvBDNKV#3q^VKT66|&NsuJ@FR*nr19|c zI8JT)@uqd66z}u<@m!(E0H8I72KX zKjh_MWUBm30)wy>t{+ix{h101 znnw6UM7m~XQqIn$Oya>eyF~8C?Z|X8F|t*)^!TNwJ}a{!D1rx7XeI748;a4f-d63# zJ-sd6v|ghYI$C?X7K`FN!}=o(zG=C}u>NE8%YQLZySGTt;o@?zJ6I16b7^U5y$Ni> zM?phFlaQ2H=uKqUo}-^!R^C2*)q54D2$BmlT}w-;13!IwGSSRV%BAWw*A^vN z5KDs3{Q4ev1wu@Tx;Y=aqTSxw_|tyURrs~4f+8ZFna1lEMetGV9S*g0bgDxtqjgVh z52WEbrN$UMU8=)~(oWBwUFZ~m=iZXy-eYNufUT{JuTiq%nF`%ys^(10dCr`#xJMmd zPoxtBW#{B1i_fn`^ICt-Ci{4oiOF5J9;-V^m8eb{|JT(0ZBZ#v{msvZ=!8Sw9Y1b@ zf!ec772AW=0vDV0-nVOIoEAqrmKsJUH{iBh(&~7l&0^9K&f}C1ub}ExzI)YfeJmNK zvgNbpvbgH4W}}tMtr*pd^MEwg)J|pknyEu~+n9(*za>(5UxQ>Y*A5kfkfo}!^378L zCuT!Kb2G2Y*v|{dzhm`@Ok#Z$G2`dgq6EoUD$n_Sr@w8@3Amc zM)%8WpJHbY0}@8uQ&QMrYWXFE$=pl1x4k$&ZNpy3mB0S(Z9I9LGiNAi8P~?I54Esg zB`%6%rL4;C>Cwx{o!Y9#_E5!ZlOrE^Vq*C+s%DBn%ACaU(zeLatL;9`^IhKToS$C?Z%~| zD=b14HCM%^g(YowdBx+nF{Gugj;S(=V6}0iTNJO$|^DbW?zY;?`OQ8v%@knc;LRI4_A+TPSbQ1 zh6MwLSz(|qV5Duo~pCLPat5 zu4W)T)jR~Lo0_z$2!tL2YCcuxzigPNqHw-*sfyh_O`(+xbopTIBBeIM1GXJcpoNFS z9({!`cqs2;L!0YkAvy5O?f1yaKCjde_9v}tQI->xkock);4McyTi?_~h-Js%F7Q1t zJRGI+XBK7Wynnxq^tomQsbE8^){4n0*jje3IxQ>Ur@Nk9$W&;C?FMi`Y}`3qmW**F zMPbBv1U`fMU$ZTPK{YjFiAEuW#fvT{#s@*4K2`bziQqW#efwO%@KKN0R?a9XIhpD8 z$b+j`%guwi9En07N%#b9YpYG; zG&QSo7cG8I2Ig9tg^DQMYpWf*^8$avISlmSzV_tF z69FBa1f~2FCs{c;aIw*A?!z!-W=>Pyo+NH-@1l}Ue4Xj26s`)*A*R_#A!entu_An! zZ?sK|%v3*m2N?HGulF=!zmz{S$4NFlHSVcSa_52`VRD}j6J_I=3>8LWu%PVS%#smT zbkiQlnVy)gKvPUc|36|6P#a3dxA=J9MiR3Ih zlN_nNM#XlkwJYbXx~&03hqj}ym-^BI-o7QL{^c!aCN%EbrTX$QHMM)j3N1_i;kckY zk5VBwHMK0esp!j>m+|PMllZUTA;l#uQ?oVF%Nk`T4Urg!X)CH%pd8~j8|z4V#X{(X zPS`eLj+?8$OX;dy;{RcdG!;GWyE)1dD$C0*1I=vb!S)Q*T>qz+#%gK?E>nbLo87Y0 z<9g@m$;%W;P7{~MAA1jAjh&w-{Q?a<`B?#Ee5Zwhas4Kf^Q@})+!l}ZVd7-ofuEO# z1}$@M@ngk#C8O-)C8d$~L@jB0al>z%6Bd9`-&xQ%zL z)ESv34^-PC*6}iWb{p%-B&(~dZ~M3YVr7U;l8*Jt3t?3rR1R>?7leyJgKBYBt?d5& z%GBztKnQB0X2ZN&`Xf_g17m46WkKO3EcTCne)pni;o-M^B|UuhI)5)bGJH!VjI=oa z6uPpd-pqisG=k93(Bd3v)xWntU2I*L`L?v8^^H;$VlzAQ#H#bx*&mCM-^=6&b9?Kp zn5G2TwD$q+5wh~v$ZOmL+=*bJ)bOfn9rjfDlv?$VJh&cdBe(WMh+R zo!Ri2dA0dCe|jtB$sXP8ch2~DcA(P*P4^buD~hO(j{-xIX1kKMi+?gE@+FwZy@jpu z^~z9P4+9@f&w~$Y4j%LlI6o~8HN9P_#G`~x-*{c_F@BSl7O~cNK(+aOMgW2o&34{| zgs?*491j^TH8p}TmMqMBxFX>0VI8aCMo2Pjr@e9v@$BC#p&?P)I3-5*UIMJ6qggbrU9sJd%uFB!K@*~I42f=E%sU4XdmZ&n6iUh;HpNvyq z|EWR;lfRwD<7LOMvyJ=v>RoYfz(Y257zT-15E}v-UgF1vVR3yKGfg4BCZok~nGK|6 zss=F_+Qn+9YJx(5kx|#zh6JGL=XLRd=3prf0T_Ir=~WvCzXph%?Ir97`b&1UJlMDg z8MyqxH+&d5x@89k_(pe_&pp39$0@5Hex4R|%4`aMx#P&VsRkV^)Jh9y`8hdtjcK$X zPlMH!{K7XsL#_N{dD$_x4c(`0yfz@ipT?-z`uLZmlx#lM-+7Enrxah%=N_Zp7Ssp! z{KYKy$;kM0bk-~n#o8o|pylD_Ddn)_ZWreQ_zF0uN2`0${o^>E~2p4sS)UVqY!y>Eh^ zH@>fom3XvM`p>7Z(iGY;+{kmNx)AGraNK_vB>HLHyn18q9KEx(p!27FK?g_Usg5xg4Nc^3BF;8s+MP zOSp01RL;m`F&W#UL5iYAIVuRX7K3(rlF@|#53fFktALT!p>VCvw~Gp8bCdC<5%XZ- zA)b0%hEm?UQK$UnWYHt`nz}ljud=hpg9%@=J8!x$sI0ruSDa^7|1>>VRfVx9$cg^e zj0z3i(U9QqhSOsLB~?}3^z7acW?6!Gg>+a{WX0lOXVp#VrYEwwYslY{3#V*On6#8l#*9PoFA67NwTfc|2sVOar{) zfr^1T5x|E@{W0=aZ*9!hY;+MW@z*GQ%Kc=A!!4XtrB3WT70HTzRGH4xPS5wvVRrfp z6O(WlTwG%PB5*8KQ&(%Xvp}vVgW^nmc$~t98qlTi(#(64IF}xqG9q_y`2z-PS<8#b$ z#_U~gnhx81QByV;W%O0i(YXjt^Htyh(V56A2&mH3R1>N$um0Zo+#;RE>AmYdaC7jd zR$p94)>B5t;ZD#)XEsaf-t@yn*|bzec4&me!6kKq(Iq0TdguBRejV<IqmQAX6i*V}4DE*02t$IB!p+Zc`$z*YC&i+Rtn#0eqN3;Lo$6l#jBISxgNKtI zw!*@~O3Er=&MfKZ$ocA38gyclGfJ53c33F1bab2B=^v7ka3%}PL7?zCMIQlqp2E@b zUY3G!?sb~d^OK5CpCkD@@}AVWvG{2AnN25!MOq&;Xws^dUwZ>JUCX&EeWPfjAL%Z+ zFYfoR+NX6O`;LIAtHq_kViyV`w(p6b?exkc%04~RY^fOMq%;e*99kwf2^f3|acGq1T%fKqh4YVEvAd#sru*Q|?uE2~cIBQxR zE`YJ+%foEz20N+QBj{ySr!B|D#R^%7KczN7fpTP z-g94ft?bUdjhHQE2~^Pd;u*G&t-kZ}+;AL!>dd-pY{L3FLoE-Tf&!;IxkYE&i^pcM z#{>5BjcI8d+2_jm zX=MP7Ym&?_%9Y`YC`naU8C-@>Insbdh6s_;*kzIm2wVbC2DyTh%c`E@Vdo0Ct%|Pa zs&^7h^Hk`-`f;u=^Eo_2jmR}NX?O;ky58E!pyP#LDw%S!U|aLCAKsR_RFKb9_gQZo z??9s^AjeFGX?LwRAWp$l3rq`5;3o()+ZzcmC{g;Yt4lia~W`iOg9T;Ipn`MC~ zWk^XOc$}Yg8;=OGDpP`Appn0OaP?~bYpKDe8c>hUB}Z9330A|@BYyw!g94@R#b-`9 z8kYGX@lDsPX`CFT2O1_NbBpW^%W@jfOdGyT{xlg3U1Tnw09YCJNNg+S@WR3qyaH<* z8xEa6UX8cAizx^v}`W`7QVmQ5=LOqSIziC3B*>8~`13<+c^ zAjhbYk&m51XYP7~djdz!p_MK0h z+gEY7k#k&66IIw2sUMeE&~UGixwOldli6>$Ev?Nxm5^wmh*OuQs3_LFgPE@&SWihE zw2h?o477UtcJoQeoPJ*zC`Y?=gf%JLfWc;RLSSxAHk9WQ5=CC+cYcp*AnB`Y8nFEB zX|hS2sBXi}5zHxwD2VlR8T|eAaT(|i&cFVA(6(-pVEBwI1hY$8DC<%G4cI1DR#tud zo84{bNRu-1tU(QR0G!oh zs$@pRLQMG2T?O6;1n5@nk1q+^H=g(T#@|C_2NV%D0T1EC$spw#gQ1~GiY z+M4Y!qTp;~vZ`@{E*rtiD?N%SUG{K7aYLOMXR*sFZC}Ypj}HoVe&VGj`5N~@L;E|< zxv&LASbRJ=ArZ#j9_C1q6O5|f)4OH=<4n6KXBN~wGYYY&uf&*(9;$AMl7%>Ti3o|i z6J4A^8;}dyqb{8?NgtUI_MY4>+^AQ%Zua1$zslcWm$nK64w3sJqL^mzZ2NCcgX`9a z=o!0lB>iZGFkPL?!NZEv@_=k3%iH#M@_;>X4`(pha7O z28-C7CGN`@YY`!H{h*SmfQttu-MgFoC*DZ6{eTty3GN-_TQ%4rG^(*CIb;qw%c4z> zA5SXPT{kz^1U+4Q6vfqz{`m1!%?d_=s{zmd^$K80hUbSK%)uMclk#IlkBmRhdK9RPK!Kc#*$MrH!!$}>qfk;(s+BnkWjTNU^hpbD*Crsp;&N&7N~*?%aSm}m zcjgVWEs?tcP$1WJGx*d0>p%&X!WiAyCwTb7O)pg^to6;KK6I_YZoh(S~VXVbUtBQFW3 zRRTq~Y?;=}g_Z8WzgPRKG@}C24?(J|eXR>=v|Cv~p~zBRhaYCh$T)s@|FsG=sb3+; zpB_Ln`oYKNAqcrf&@r^z3Ycx=q-Zpxw>))WjOVx9p3WSyOX(l4^0tcG~T%U3lV>D>v7 zK5TPEJs|87N%Gi{>!fMP<42^9|MtkI!z7r5`2FA4{++$qt2`BY_2Lcrw-|348m=LK zRlCCW_dmuyvk(;2Q17cyL z2W58zpB({ISpCDU8o8b@csK#4Yfdd6&*!)j3<4Il^>F_8UF3{&n0<-UVwmSNr0QXbRf@(NK@kQT~Nx$?i?XiIJ)C$4AQfIwY2z6Oc+BZl4!x|P+rK! zaKU?jU+wX?qmB*`%`vr7)D4vCO(Gg=W~Al+*LzQT;d8^R2g~rC_!WfAsC8ejm_6{J zfZ4tf*mLD7Ty+7GzJRFTtGhl!>6T;BsW!R?J3Zj1_ZcDNtuLdaS+&Fr2f{{1%B_8Q zj$c2(!ob4K`liuJ2Au^kyFP2`PVt?FHV*2Xb}4$k`Osd?em7(xJTdM`045q>@Q1mc zH-#F8;@z1<|8-HXZC-pRQ{{i74d)S)tmS?iiF%|$`u%$|SNjzD4vyrnR*sdU!|DUT zpc;-AbA~wXyqWc0%q*F{G-6b&H7Z8Nrx6%fO)xF?GFkGBY`ud0WB)Ox&RTRWI^hQ8 zxJzy@01Vr04UEn(O;r2@t+Mh=Kso<_iud#-H9Rajoz*W&IaW-|ial?htI4kXYQOq# z7p}%P9d66r#JdeGJv!Rj@nL4>>u=t^y&z1jivlO&BUZ+E#enjbsFHVC2CefcFNi=F z6*cBs1W-U%p^Ti__;m)09$|WBW;rvju`eR)iUjOu>VVIHvFgj#cAAC0+)K@h^mSF` z=vger7v2D2A{muGu@xe|v${{n<5^U<3yz)~O z&lB8WU%)jcw?Rh0`6ZMoP4;eggW2ZSI<(Cb;yMivXe9FDsS z;sB31+Ftx=Hi(Jp%@jbA7f8cO=RfW`9-xpuD>k8b`}S?%)L)LDjY3e2Lv&%GQd1}$ z)|;UgbX^KvCg$~D9)Xl{$&xdzlcz&^cH$NWr)`tn4lyXk2s2x5^9SpcIqgov{T|47;8SH= z(>t>h-`wv%A6f4#V~8SE6Ua9m%L=3V`w2W}yQIpMVxl*dYhh_k!NkNLaniHYYg*Yb zxvpcbdG$@rS3$_?<$qFk1Rfp~(5rnLx$*|7ftFUW9=mQ`JC9FIBW(QX6hDnR)!9PBL%q4+tP<8v22+&xU`F1%$G18CC4jjCg^?m`*n zoSzY(v#9fts~;?0RRrIPt)B1gAeXR4v(~eMe6u_%%Dq@7CU8jP3DHJ$++i*Q*VpoHdCa8x3;!MIx@ht zx|5}+pcJs*P%nb@Ld?5G1>j`HxgJMnwolX2)}KZos%gdA(YWujv3jtc_n=>kv5?AvP8=m}^c2KqZZxL**MU zj7TI;lFW^?C+YQSmxoH;5;EW17VC7<+5yMR)Z$`myg-HZ{F*5WFvQm?+eTHvpQsaN zG_9wmbZqN6oM)t^qPfN9P9h@<1S4cAe|{>EZUm$3=vk4$s2CTtQ~NeeF5*h?Rt!hKt3VVy&K!q2h@9zw zLgQYK$$rO+2z3!NwEIj-loIfOSBq)kk&%nvDS&XS z>aWLw%T$)%xcimuMXVe>{10d97l4AVP^?BQi`w1^jtfZ=0_yP=LA>3l+X&;fQve}R z)QpqAvln)tbrMpeE$3|h&g02>p{oX)dgwAjVH&iV;(80K60BZ zSm7%~wa$C^@D%~9Ts>`VQGRl_fj{fk8V#Ikj@!5YZQTOw)-yM^MUow!CQl6k=%Uin z|Gs7cAE2N}6wx1g0Ee>z-O$!xO7|nhsO@30V^E`r!_>~{5vE{NNMn0N224}L0P6%2 zr$_YaMbAu3&{5#P>exwAyjFtK1ZY&XM~XP=4iUeaGqG=I3kAjWrg^dfh8du@*6SK~ zpsKBH8y$X5Kq#B8ubz-__gbkVNBgZar+@2NK{8O6%s~*QY6+(q%;oW`cqZ4zjn=*l#1E2Xx{MN>(U8%;U~VduDKkewu+U?kt+q zB^n$%BH0`wn#x~1wpqX$otK3VM2b_Es*=R1txXPAm$G?A7$>L3)>AVwz{o;*?08S> z`6n+7&4dq{tT4sjvdT3H@1NPB%Lds>V3yIavlIg$&6%~);di4qYLncF$lP`~&d%}{ zI#+E0i)*G~C`fpbz6bK+MPc2YwZVW3m%MJ_+bi!6s&$Tfuw`;ttc^Sbg1#*^P#1C| zs1&m_?ruH3GY*UiHeUq4-Z=HjV1b8R%Ew%TaVck-LqM9211E%=aZMjA%YW2lKap_e zCk7S2))F2wf?2>59&ekz2ffRs@J$Gp^gLU7(Wk55FfywvC-35j<=96XvU+Z-4$ zM9>>a!U_pB6Izgr#4C5t;p5|XBn~ellS-jV*eHctAl5lrkRj8EJ!xCx$5!xi7M7*OIz-Td=>pMPA!TWW{uFhbYu(Q z!4}Ekw8rvaEV0aKKLvi(PxF0hQc?|M{{?w2EKOc~=C^?qV*s9p8TPTH#P0anT)ZUS zmnZ*z-Uq_9SBGrwad1R{7tCT;Zf*|Z{4j@$3xU!kZ$6R~e*zblK2xI2v>5?eo#@N# zV)0WaZImCpc4QX+I+fqKVV(JDqOL-~tSJIa1~34J4v?IzJ*rKSBe8;zaI z`kCO&VK7F-g9(@`ChTGxvb)O$hPp0~(C>u{Jvzqk; zzmn76T;tLO^!zbLNNsx-A$*__-$3$j{H5GB}ll^=BfA> zd0tunNFW7*5v7Vr1K=RG9OK@iU9AdT`Gb!F(sSMAi08L&BXp9_>i;9YK z?ana~?No{G*j-M}4`%94(~FCliu4Q&3}hf-D%_e#-q-Yo>Zj)2kOMBB`N$7~d_q-l z4-y1T1UtX`cF)EGUdAJ&)!=o-5xXyDN2{#iSczSyWehPo%7!g50EkI$vpSp+Kiuuh=~|lP2_cX?^B$pStkYEz7XO@%H;14y$tps2ph!zvF7~Y~vudu;N8n&y38bBmA@lIw1=4sn^bydij zq(ngaBwq!&#^JD5)xK>2X+mnDbqRmV6kqfINdVN=)f*HY-LgAjyu$Y*Oa^?WK=^zc z8yk_%?Oq~WB4K8rp)uwjDZ7SQl#E6xeQb2wWz60m?#D%oQ^%X+>>k;aORMeu7eKWTamR$V3x^Y%flYPxwDKdbZ{ED|0>VDqYP`)Tc>AoS4h}gdX1Gdwr+2+i19)Z%)wTEpFqGpDV|e#~(}!_VX&4VOB&Ke=?!IGMOye;nA=qcWRL_1jKI|vuCv9&=7x}Aavlm9`t zBVnlYKIel7RBrCTNRhLfFLbdGVt`KCV2#~ZIoA;zQ5gx@VU5bQoXacp{rV#7x@Fvb z33cyNY-nA0=d@ChGYP;4U1*%js)Nt-qnXDUlp5QO^Eb95>6}kG?*Tf{IWWT=c={FD zpkA8l2|z`v!R77c35EQ-ybynSx+oL%iMxDA`DxUlhmduVWbBO7>E`yC;#fUKc{!;! z6W)WFu=_8OvjmMYuam+l#bh@QZJfIY~5 z44;5t60}-Dbqu;DU(bmudwTpL&uka=R2ZhPt&;gQD_rT|9NSqKLxr=gYzttb4B_`zEr&RGCubJK8Luc0*=^F`>U9;0W15^uJ<}dnW(JnU87ug zb0)>TT?!iU<|OfX+gG~6Zi3^ymq5t3GLYvF(n*C>nL9-{RH)K&vdCcky;ugf=!|oR zOL>SEBvkjlXk3zzY_&0d#N%UkpA53yY$={1(A#6}8-S~T);ltDm~E@kfb2H0vwD$n zc4L;LbX=nYiq=}`AXIi!%hUA$jMsfam1DkGQ#Ud_QB_vFT3N*dwzwgQ^_Y0yK2pu% zg#psRduT%&=gRw$59`z`B#HHO9KRYbt{p%K6=k(+GVfq}V>Xb~uKYskytSw_M#>rt zZ`~`+hd`#2<0%5}O$kjeD21|R4gmvS=)$GO(5|2>KFWCk=$-7n`4@oV`G9sj+j##q z7?q}~&QIDDA-6)>2LoVXLD$>5Yg((%b41Jpy-~Nech*`+SI#7c+q+A!Nk~&O_Ojt3 zK%!sgsi~fxe~_Fql&SDINT%bOD#O}zaoVR^Q27g55X35zGjHiOk)5=ioLkF+C9TR2 ze)BTl5r=-rQL=p{29#e-&B*jtNc0;IKt5tg$D%o$K4(u0XD`(!MRU1b6>krp5u`q~omB;o%EVqb6}Fd`EMOo8F7DC@phN)hMHsk-1fTC6kQG?kGjI zfFJHoX&JRlygNBCp8H`Ydd`AyFZ--zh#SlsylN2+k05Oa>eU@|wpq%3GI zkR1YuCpu=V382&tFE=;2Y{2fpj!FxLVTdipv3G(237CoSLdYEg=-n6 zCOc!y;PtCCJiy&6DH9?l1d7FrSsMBP6yU>diFuZf1zvCPjvo4=k$>p;`7jrPo$tc6 zd<+#S$d2Kd##iOy0yy~ElV0jxC4dUYi1+fX?2sE;q^oNx00}}CK)xd)mFF$j02cJ| z^`)^}dxw1|czc+RoIDn!l0ng*C6rUP@Clpf*a6iy+Y+UD_ds3jtkVDd-TzzR%Z|%` z6~2&hXP?)Tq2h?NPA*MJ9a^=ip<#CUtNHr-lHX^I*qWtzo}EAiHJWP{RziZ4(Ciu{ zR=0Fi{et-+fNP$BI0NuwM5^ADfN~(eb)T143hz^6Qm+w*XF4bxQ?AkwIC6TjQn6A!~jS_LZ>09)A(TIVXW<0`~>!=4O~TWdzdcxRq?7XRF}Wi1@x zdBu|L-k*c$qzAb0!9U>eq{%mW!|4s09i&ncT7asdP~Jjsqq5+EW?MuuLm7Wotocm> z%dk^ay9*Y~JD_`Fgr><|D(iJ^=jP;mJmBb?+%jqMFmZ)swtYv{)N9u`wN=AFM}Ne` zRQ*g(5axHYEwRX&ih<#onR#hqVggWl&#*K+#+^YEUU15z%F4=JE5>a&2%y|-9x^T6 zk+p`g9bdg>yebdd_j7K1VKZM}3I`m05<*k#`r)bzrbsPb{>wJICZpwnAVQI8EMXdN z(P#)}(AP0FZJkO&d+d7moTwLiI6$B*?zdm_fE^2QwG2tZv7V=$3d7I(eq*Dbe<<=)JuhgvaEMj}Nq$Sq1ac1X-1kv##` z*Jb_xrUZE?Pa@rps{#)Ua1`}c+?3wXkB!j23reItD79Jid7H|8UGnYq+ojJ4pgetA-Nl;GY z?fUTw%Bw?da~LlU}=@! zR7}7j9gl|3WcV27a`le<7z%Mnh2i;rH-g?b`bic>AOE58P^V}ZZuZ{U*>UzjcfcUw zjy}5JAHm{KO`-RK8VB}vlmOy(5XHgdQl0;&WtgL|c6L4~j0=3)k>{Q=^G%NHjotX+ zo85}>-IfmRu+Fs3Gs#xBC3^U5gE_Nk zWhm>@L&2ynN>ziNs*~DRG@Q!HoMEcqvN~GJerc?Heb812X@9?T;tx~$cMlwk&g+4< z3plOlH)N5wcs;qcdNV;6Q5(R=xw|qasb^LGVam=E4xu=yXm=2oFT1IWiy7U3891M$ zB-U;N*Q!G_gOC#L1cQM7#olRKKR>^L(pg1h?1EO7`ahX=Pmo5v-rI9by#L`dRNu(P zWIb<23>ysJ+0G?1GaLf8m-k@e5J_9wUlWo6$OnkFs@Z0|2$-rHJ!{Gd47A%_LIpUZ zPFOclf?fuGAMBimyw54cu7c2FU1&Y=m|)*0fT36!U&2rF5i=_VRGkd!?nDguhZpy3 zzLwp{dOW<;IU)RqXx*!BA{u$@GWV6KWT1@I#1|MdqEI` zKsF)ip*W5H=D@89W4Z;Trk0%i(8*>x=G)FNrG9twoDx+v{Wj6a!npZ0k|A6D#+)m^ z(T}4G7z8{Uef8p16>@0q@X5RfZ zPVDJXMuB(6EAHq>h>MF0X($&hW*Rh!d0xKj#>Hoo)->Vx5wPhCz_w+44?Ki7l=lkL96X#F! zx$^20@VaF_V=ofC!gdfg42thq5tw8GE&}YXc+ro@cwUEd*{x5^soV+?OH$+o`d27U zB!d6ODN*v;xKos^XiolC}fk^e!%IT6}>JrQ@Er%E2m3tOh(gj ze~U0YN%N4F?T(jN5;Xskjw(kK6i)ya*48$A3*ybPozkH^hmdbCjDJ}7Dn5mkzd#)>?~hR zuc@uGnp=6O*NaqzZ;?0mo6v2?nBSs@j`}9f>CW5hzyyLJVg$&MGR|%Nf$boFhk|%p zf_OFCc9;@oVi3*Nn1d5~+N)P4BPVEz-__*TfKX4sZ-|6t8iBX-w=n3%7%O{|Ltn!5 z`zugtey62`-}l~4MpWJU7w~S2-H>n^Sm(4J(9ssxWX$u)k>t_{Gj%qq@b(+GvT|_0r34V6+OHHYS0jgi+U6 zXcTyJG++G}g~ENt!cFeaQ8@@W*hu9f{}Te&5zWVY*~X!#eWS>I5Ii#*D}}i?(u$^D zn^(XyPO6n(WEU`>A^Or`xB`-+1T_Z(4c8*Qw!1mIgxW7(`bpo10cbqVk9btKhpz!W1KgTse?i;bgieCw-o%LlZ84!$b0Cv>LWS6nwU2 z{EC(ZA*BhKGAm?dAM6Luu(EGifpWU1C-{r;+olXWSxZ*~Y$1Vv?N`q%rpL+I^~6Cq z@>}SJb7$n!tF(VS8ksO6dEMj>5VuME8A`8&9#Ov{IvYSZO^`)-ZzpL^OU zEDT-TKVN3E`p=swvOfKZKK>xy*@e1$efKF~#4q%Dm_acK#J)Urh(<9`t1gcFDN?H_ zWjk&O@SmfdwSbV2Jf>wnIbzczX#mIJ{|kYn!OG{6p9iG>@iyNb*oh*V73xO!De3nA zR;03Y1>?Vws4Vn`#f8!hcV@hTLD`mI<@S}t>^Mf#CKI4bvclFtUJnOMb&>PrI4}yO zHBGb22>Z;(AOIRI3Z(XlBPA zZ%{%*qs&$wzI7e;Nn91#A7k- zQj7RoWCR;1)u-Q!Fb9r56l74{k<|_4te{ry`KF8t+SW2AIG-kEt76KI?XoA1%{gGM z31Ed;m}cwA8pj8s0R?OTfBg741E@DlkSG?M{?K8BiMZV*`EM)B;3UQK_HEcsmv#HY zePZiblHM;M3dxc|g8@ELhYzR!e_2it%_ba^isivog zWxPN1xH!Z#Xj#w`=^)U z-?&aa?U)u_&n*S$z~=v9?ybYR-nO=1R0IJNQKUgcN?N)U1(Xnw5(Fe9M5K|F?i3{! z-JKHB-5}jacS(1i@zu4~cCY8z@AF>oIp;d(pLOlMmclRQcg{J+xbM%s8d9oBNE9&- z8VcF8>C%;>E|ZyZ^bKoX39DB4kpnt<#ES z;xrE1;0ysvDaOUp+Ts0N3@ohP@4JGNlJySr$vT=jRQ7rD6F0P9;-z{s7Uc9p<3-+g z^g7#@*Gd}Lu_XMV;}zp+oy@$X{#L%bfeJ3hJY9bnHKZ3}%NG(vAOr^4miNxiN)2Fx zO;6VY`Tzdmq@~u80W-WV#D?ojq@q#ROrh7dS$m9VJNkEIgHE#T0X*IT5-_w&HlL&V zj~f@dDZw;MF|Qasx{lce4`6XwpBLv?+cdmM7)Wl8mXJ)s@)Z)|s;|Eb(pDFVeWi5aT z9jSZ^ukhDZ51+LMFHx>doqAh1Z^CYIYilbLGxKdSvWNX_MVR{1>|I^VjI69=w>L6Z z!tK#NjGSkzluWq2X^Vz9ZWmc;Q6gVJ0kUa5Qq*vtnfWYmbU!1VK~S|tTlmRstkAEPGLbe4>kfAV|OQait4beYN)C{kqZivO|w(o402ml(Bz*PY41R(e6Y$J zP#|$vA|g3$?t2#Q8OFsjwPNOlg@piWX*3oVR&YsZw~t2bCo(8}eXx51cYzLF7I@vW zFn0pFxhV*5BKJbkcSwZho{gB!0Rtw+T3jID=0C*eKQ$+HtC&*R|2$n8nV72DMk5Cb zUuXtV3Dnou{}C2;orEOo8#aaWpSP7iOA(RvXiX3NA|~Wv$dHbL-sXB;fW$zF0VRCw z6A}KaOOaalmIJ5}!JcRmu~Ny++Po}2$e%SUEV5>VO*aQ6SGxFILI@c>&UexfoVtxw*ec#5mcc9g+TZ2 z1QYYJ<6)%{VDg|VTjx!UFd1AUA`&dfEHjIH3RBM+C#dt}&zksxIf);9I5F=d>*@&D z^;`i;0JmVM@*8|Uj`OhcG`Hk_(m$X?Mhg06P2YMp7UI_tVnCLbSbcNzf&V5$BP>h2 z!wD+bNI2dfF#;!{6YE|e?cBGGK(B?aj7z!YCzy`{$==;q@}&Bn_ipJjM-X*O!B}go z@ako;C{DcmkWl&1eAH--L;AdT-5xNudp2g9)d`CUA?!fcptC z_D6o;>dcj(1XC#DmRcAn_sR@c%(%vP7*sv`~layT!*IrDWSE0|CK3Y_>X!s=+} zJD=5-Z6IJ8OjzzaLl?`@#U&v#vh*00QKym-E}GvWdB4MJrh7DIg|s)iOSJh@~^q9AqBewsss@W(Ex)`UfRM@rs=LpKU$r6sL-$Ie zIG5!jhmp~)PIuxt&<8%qkYfP~k8VFEDfi(7jyU8EDP1YAhYL3ztJN(ya}lAd3hx2J zMjB<>1cXn0&4}0d$G0$2Kws)cr!>_8$3rov?PRbknUow_gHary^I z|32!>Yy8inPK~6N_AK$%9^E_zMP?S0zEHrjN{rs>h^P~tJ9qVJ2aJZOg6K{mJV^!_ zVCI;e8~P@u%U8I=n*zfP+ViOQ@9^CrX0$asf^Wv+|_o~1*LF|BXtpT=#grc`9?4_pnJ&m>Q?UR7KR3X(f2p3weDDX4EuMR+71EY~4lcL3{!)V5=*6mm##;tiA}9mjgUKL+ao$=An#ptA4OSqG zftjo!D0N^Dhl>>`jlWp6VxnDKYyuX50^?PRl?pZ+;b8q*@*J z?E5QW35a>qT*!AKEUTj5I@SVgrO*bv9%aiMh%rU^MQ4Hr>Hi}d)!SN<;6CRd4q?HZ zjI#Lu0juB^*Y9J`z>>!I;P=rV`h>{Yl{iFQFzI`?vL3+zWO$etL{&wS5;gMw)4)^4 zl~bDGSXyB}{m@_D_MO#uB{4vwZvn-XHaJTI{BTweDc{l(GzXc?9-gP&2bVu0b@$^B z1%3eqeptBb@#jU0=jEUB0|8O~)anNzz@eZ$-Y3UaoTry#=HPXNbd=H_1_Q*L=&kK= zt#?-WL_R(57BQ9Nj`WJovl(lud-r76Q|I2`^iVdNzNLNpt#=lt>3NwEb_Yh}k;E!M zYEnyUvRvg`VEwzQn;Z=MV_XQBOI<8ophN5u?H?FYe;qH7&|DNE^9Qwbb0D3c!^1Y4 zrMGehlRyDdDAr+x7O!WP#0*b9fAhC*0bu2r?>v;P_p!r;Id;icB8AOOOhi8ed%saO zLk(@KVx?12OBma`su|kg`R}W&$o>mP3n@^o(a3Gd$iaM^8LinFTVt3h4H=OJmdpxC zHU3Effo(D7G+L!}_v8ZK$@B-bOAF%AdD6)rwCX;fc5xlOLrr}xe=sht&sg?<9F1C!_oD#!tZbW>xS{0J6_2ML#r~ww+=mLx<^4NuXoDb%sQu~O zD;SsCEJaSoKE4Wz1me(y!Ijtl7>hovG1FAnSb?ju%ER=F}OJ4)vi4+BtUhzP!SMf83p{Jh5YTvGVTF$RdyJrG*A9K zE@A_K$x+*qhAmBb>L*^YqP3LxA^k{==-k1jx~`20(-hbmIG1q2-iq|yvu!E6lRf~< z-?sO$o`iyu1GBg#$K9DrQhofvp>H02V)oFIlL+@p&XdSAD`GtO>( z*8R*qg|8?tUs?;5Z93?urX0m5Caiy7J%l+kw1ULo&f)Lx4@Of0d-xKsvU^o>9k&E&7sGmgrl$6WnHeu&QsJ5*B3iK6E&lFCYUsW-<(0SDfTjHBvgRm zZe&YO&&4br@8aAN1a;#S` z^M&1y1Z&6mXc<+{tRI?%jL?-scor^_PsQR5#^^~Cd*7x0MS*#}(c@9dVnv1Eq^$Bo zQED3+KBlz3o|=7S+Rc{v7mA<~>OC0KczXI)4%G{-@v&$lN5I{R81~E`n@?Uwv*iNg{vnuYa zEmDNCzI`?)Z_+o$0;r`#J0hf9+H(f9L`VZbYk?yWExgMI-398j8?eeQ!YX@|*1K{1 z$?~zFAY=5HBr;Tbc+S-bj+alLjAw@uKT0R+j&b--{+V|mzB zAYpfpj@Y;O-)6>3bl%4t`}x$BhjIMs&GC2$76KBX%bhbKc-PlC$ zxe)##$c$uW7b z0bRY6mz4JL(|7t#N=wgI~C@%J4jPH5G`3*N(HU4HasBO)^9Y`xb)y{7R(vS+X zgkfdc=NXEZGL?z~43wdOtn2O$d*o(2*ESNK&;O_CfD_AOXg~*|j5v*qz8tM3=sQ6h^tYie?_ zZKB4G*=~Xz+)JQkeEedME>(UT>ARE;t+O@}&Gho9vhv+x87hvof;-IEX5U=MWD7y0pkhMby&=WoUplh=3`Ls)2Sppt_k5 zMf~dF8RQ+qq#YV!+8`@H1f&omm%Vmaq*NTfxgW8c%Sp}YK_6jtmCzV$Qs0xziBa%& zyWey~W1uYA?)x_;KheBq^WkW1Hw#ht1EMn?Trj|N&9&TQDBggtjngZXT}Pmwo_C?E z2z^jtFg_tMx>xIq$*vsOC7!l7R#phTQ_=5pyxIEQ5XwR5FM-@_f2!RH3TTbjdXJ}s z7}j+g`k{9)3%j15lCY$b0Wyv6$PVjCmio+=!PQYHKqR(tL)5f8TCia_&T1R~zHSF3nsfO>*e9TI;JD5; z+3mB*`hjEEif(!;ank!1iIspQAq)&1aF=myR-C#zJMRgU&91F6LYoo!cJg#OT?yDT zO%9(Gu5bthn9k}-KkqV5ws8WhSQKw;8&j@>ANAJfn<#iucDueP!x)Lh8FROgZ@GRdv2 zPenzgwQhI-VhqZzLYtY}0BfS)U!FLC4EiS?gq_U9=wpaAs$6nn~D1-gTjCwy;| zhlfqOAM<#n%BC`DZCSwV%XiQuajC1JoZkWd-FjV*hf)P`EeIRew%0WdP7@JHFA7Yx z)+f-T3=ftO+dDqYWi^fppMoF975XGgi;FOP{_*|2)_Rv^@dD=t{=dWuFyg+0GG<$L z!Cq?hk`uZ_w=J|D^_`Wp;TEx`df;Qd8|&`Xg7F$cFZ>{Wer;-zWT13gUip~9;SnBs zY+P($Q!L6aTeoI1bM81}@uiP1S7)qcpUo zR{13{_FGy?l9CML&y2G8W@`!O{^!69x;48g1)g`@Gs1D5syfkKKGRoY^9-}|Z*#Fp zg@iM}yQ!dvb0kw9-?k7aa}FApff?2jDrPMZ$*ZG&Jo1f&Ft z(b00)=3QEX88(_*=%6(CNW{&aYq4;4hCbohKj&$G``1pS2X3On@>kIx3J2-aR6Cf0 zdlxljHg;xyTw66_rTSR3skP8tTqOH?;G;jdSiTr`nm-mA?M+L|LlhFj!{K|BsA08s z!vAi2OR#XyuN4zD+i#|bjU&gnpz|06z0loJhw?iGE_w~VB%SA(Fh?{wOem3>UgwYz!8sZ@{-aMzAD86Uc7dG`n!D4cc^%h%hNb|Thn&Rr$<;6+d}L2PBz)& zYd`}i-Rh#Pt*r;PI1b3bJ_F^#5K67#kuoq+hNtWX0I*J~bHoeL{d)$ALLBVRnGg(f zdQ)dBc0R&fX)YMZdaSAa@$bI-4i}q!{($~oLtWhyt_?7UTVEGE96^Lf-PBCv>=ul3 zTge6dl_0BzsY6qbE+=@NwA%NduWAXwO>ALHmmM5AX9{tzx58G-fr!QNe1vMglaE49 zHwqxspcMw~gAjv?LlQ7S7aLphE;agq>aGjCJkZZS^W^DMwauVyL?kY6{*+82nCGuC zufeoXLh+B3UUfzoICqKKU7Oh*l*OOkwFC`I>=soMIlHm2aTI4TOAdE1V9XIzwC&*s z5&%FyGa%XUK3hUyBy4^e8uOgFxSt{dGY-WiL;orBsjJ{Lt^qhSjch85>Dq;^=h6t{ z7ODh4xNzzA;=`cO5uOER7=#pmz+^G50Sp&`j}LRvV`$3@Wys;`UV5}X1~idVS|^q)Y5v|8k{w7$uKaRL+ZrF zYjH&%xWo6c<^qPy6kc;h{LU8<`IaYR30leZ-8wA4OL~&+tN`)>_?(BY)(J<_TmJQVjWu4P zEivAT%=Vy|!vB2rgD3-NCV||Qb;oa5=U)VoO_+Aa#3AW`GQG`Tfl%;P~{*+9jV(0I@-zqR5LJu0!6Qn$u^|ZE4wnT`5sb{;^clJ9HxSlkKwJjhAT|FB??xD z(=&i=8`$N47}vQrQkn&`UiX|QDYE|rWYiH2!(fXXgzgZ(;E_=;#~=X?Q5;hjLD5;* zh_C(!9?&*9Ij;!8zXLCXJi-B4LWT(tw6DL|7w*E)g@39y%v;J+3NE$ct)cvLa4(!# z?4`Au+3eD}U%I=((aaH`HnD3Gm4@{C-5W$DBoKG3olp!P1r@E#ED6&$NdQ zD1eO2wXMO2hE@$&OV)O{A6cv(PbBdDOH%c-`_qoF15S>X%wf-7ulmCe_;^WB4duNV zaRAK*g0Q!b964N@^4vyH+{CDCqa?@I+S=&#hBjyc_6GB0H-x7F7JblxaeRVTg{uro zHE?bK(@6{&xX1p{^zU+))aW-UTod)r5E##Uru zCxdqOq?XPFFzCd*5mJh2;StEO65LX;J;&-WFJ=fB=S;zvgG#}Y2lO9Lf|X0e*_`|7`VT|H3eo| z3h~=Pa&`L=;y9NU;<_Flq|D!#RV1r|+?e42y1(ful7^2G6M#ve@|O_h0~F(;!Sqj5 z5jO~ORCxaswuSoKqoV(7aE>5Hgnx>UmfE(vnQeak(O-Wa_v5cWpI_z;%9o%24*AEV zAUP0`9;XD}GC_ZfuC1B#`+wu4{Q2Ls>6ZRY^&;T^Q~e;~Sr#XTeaiGI3Mf|}t^zj- zhznvsFM2@m#H(KvrFxrcSkLX40R+te0L&0&W78X>hooNjGprVDU;wIo}sdFO- zg*Es!h5`m*@u@H%EGMqKC1;cUYQNz(1LG8O^sgEKJAucnQ^*|F7EydnvfvEFw>75= zL&M}RSxd;a4D)`PYk#MfoWT()HNY*C6-u!DV{sy62 ztq_gGX}Wi%%oILGU@5oH(Bf`)ZGySv7N^a95^p>S2!0Jw%*eR_v;F{vxo`R7qmG0QvsAS|9Wc|GzIx0h2lCEy1MVD->4+pE$T@tzM(n zfYR^ejoT}tnTz(}o384uQx0C4pLh1Dzj^LrcIN=x4#f@bi0gl+?*4nY zM5ba&lRva!0z8iFPMs&uY&Y%`PgZE^t34AD@%#;daq$up8>{@?bCN$2MxB*81!Vp> zxwL?bB+cJ~!$h|)SrGgUmMKlNu#6(1#N{+Q-~jx<{dXJ8&>u3K?;rs_^u-7Nqq7{C z36UEg_jL!>C{p)iHNNk(g16Qef#*|-CkYqu0npzW>iUjEGhxIFGms&v1X+{_VH;3` z#3L%u-}qX(VN9!-uPXsNB7ie0o%-2TD;dw8WB5sgpeeS7zl;v`avclnL3xb#Vh~$+eA^44vV53azsDjEt1$h!!F zaWL9Fb@!9MJ11%@kCXLJvBYmBx5sVJgh8QVJAH;l${1LDKPhkt&*6%-)p&oB*%-ug zslS^1;-WL}w5ssi7nL$br$fH7M)t0=F#n2F^Ng&a1{Vqg6r-i}dyD0L*DAEfU?c>a(#`%y)ntW#LCK2}731 zojZ5t9VvNBcB|U@BB8kI&d^4$_a=G@+8vN&^nY(}?L|~!9r?oChc*|1=L61`R9l(Lu{EhRW2nath}khl^+8GBb>uh z=F4szw6Z5()Jw4^1i=9SFi32C{OVn=3YaZmgEM^4q+ETY2LmCS6s!i);+kcx7mV#* zyMgE7<3of30>`*9dt$MpBXTGiiQ|bV!|u^=;2xE;N~d*dy@AkTg~KU`pt00=V1AP! zBI_O$Q-7X7>jH?(Q~>A8U($%-cGBfO@sTmO5;!|^K=lINDnRk%ydD(D$<2Y1!~z*` z$Yl(fOwUKXe$7L8yXgNJoc@w9LXdx1$^F-en)A%rgkhJKxY*ks-rgvru+xK%_<4*Y z7JNFAP2X{W;|u;W`ku*I*gaJtK&P>l;G?#h*-Vj(i_4;r*K~8U_OWj%&7qvyQK5uF z@w{+f#$dDa`sZxMf(HrA&u{i}8meAdc=N^^25W&W{Y+{{@eOFfe}6P&D);|hc3+Gv zI54B{a0DLhS*l~jQ7xkU8q>Df%>TzZt@BuU!mupm{jIwYy`9`jtW3o%52aa7PM%V+ zsY)=L)|T+r50N|fnWW>Rz11bS+#}!L zb~8@x-@{tL1eFmq7}w%~p1crxHINO}2mu!#)BhlUz5s2-i+0weCUdQKsi>|3?S}7Q zjRj%`GXKk0A1fnz&*81U4ZiI$$$83W6b+ki_RJtRCnPj-Chc|mB^LE6U677r|L3lh5P;?`exz%A{Wjz3k9tc}EdL**}Vghx$7EGbm@kOdC zjtvEFWZ+p;1!IU=lr?FA1D@TeM!O0l%tB1u6TWP;oFF(_1Isqe=d7*@eJVYUqV zrE6=GmEa&YV|H}RR5w^f_;QdFR}Xg_H2zz3YyZWaDL#P%kZ=)QW_YR5Fld5bbF4!0 zSa8>~d4&4aXb3=YL0b!5J9`*zUn9V6>5Ov=5InP%GA(LjGfW#}8dMP0s^m?m@{zB0`g31umBTUxYYv#kLB-z=LQ9G zXFxv_1K2IQEn%^c`%VBtIU6li6P%r&OUcJ4R1o#oRzp_nCHAv`phI|umt9Iak9b6% zij#rsc#1!?76{DiU81c3o?-~1dxiP{=mY;}F2~6yk>q^Sv$MX4%5TFv{)w0vC^9br z3Y^Kj?KZM|0V>Uy{LTx5SN6cUsqZhq1n+)*ErvA64OBZPE%!46)u6s8%4xI03Z66D zIidzFTag_f#-44%zrO7My{c4xi^V~@2NHw*57%ITdH5X zsrMfk&>R4=hl3Immia;+K8n$x;uN&XOBo{c4-{PCD6H}*wNPd0&oW-=o zpXy+wML#4TH8nNW0692F?>gn-E94e%*oF>m9w1$xq<*u#i*QtdS*TI(`>lW%)-Uqo z6BGG%hKa%7=YiQqkMzgZ6jM5N81G9i2pLN@9z*$9F{%1i&{Qv$ne!E>xt&K!Q^eZ( z?T$;T!EIUNdNIi{mlh2T4awE8nRyO|7kPy|8Jd6e#QqJOZ1)*}?|>Z&$yBy_p6E>; zG9>1hsiO9yxEBoU&lO7l1S5yP@3+Be9) zc$o|KLFb%(U3h$Qd4Q0>y8^Z_CmnI5;P>Q-ysk>zzx5-WVLa3;+ ztDKmF>6IIIg=|#-SWSW)o?Z%Hg`1o7`VhT{g4K({$ zfbw&Pm)8k=<2Nj9Q&LjkUa;dax5EL3JBS6__`<#f_kgXl1USb0P=^ZwV>zNg*t;IY zHwi5_H-4DsK7oJI#XUa+z9Z-~u1^o+7i~_EJCWP7nN6KERIk z{FebNAbGqVAcRr{&ptrrQ7x`CpBgNGq}2k1ZRnnM1?GOuA-g?E4{Xt{ciivw$<`KY zsHM^~(gFBe<=|w!)l9_u9-^HtNF7krPouKyi44R}GJFD;AA~L~G*7ETmK5<_TecOF z^Y|Mg&z`B*pWa1!c|SX34AJ1zbMVP`C9zX%o6V@mfr|$aOfCdA+rxbXvFAHmJRJOe z)J-!N+3hQigfF36qr==<^3S&c$}h0$ucayZNGJKRe3*R=WVGrdm$9|)BN1n@|b*-vvP(u_HM3@_Eg zqb!L%q7h_OMJABglzC&DxDYxW>ytUz*&x3Rm`tZkwX_%t& zz`qJ!)ZrqNmkhjHS{Let>Mg8g&sGi%VS*40kfl)5SGQ*=mh&^GXS{>^Dr{BvVS;D< zS~u;ebZCN=Z{LEs`|hdV?ifMC(g$?dOx4jYS$tkCR}g`r01^UGzJFj1SXi^eOW;n> z^s<}mmPlk)JGyg|PN^=eX0$I2(26$L8e9CooQcr$`r8)SeWt#4xCSKrU{(Ct23O&M zXB(!HYVphv9{SYa*zYi87c``xUq?en7cPShLI9@>`}**OD;0uPLR_E)vswV5vbVQP zvWyVQA7L*cQ&Ft@ZdUg6AqfHpwLN*m0&0x}EaT}DMzAzAKqkVT?hv8ey_XFzAVP#h z@)e&#La4!$*Acgy=1p))50_vN!{yA*-9TjD&_0<`edP**ZInvTG9-$>gvbMmgB@!h z;<8sW(@h%iAOr(HAg~ue5f9bBDbwur$lv{`IK&AByC+x--93ZMe34iFt+o~iu2nFA zo1DT@S&{^Q;QDXQlmg*MLo0kJn;DY6Rkw~fnN_4~HMG$oSW5tPKu(Aw-Ai`3lb_Y? zO@HL4{{f@I#OoM+M^#<#8+)4oM~mM6S+(M3-k}}g(t8IZ}ID6_h+JS^m;Qq5f_)0 zdl}0SU_{DAqZo1zlk^vd*_DR;TgGx=6PLKPcy0BNgBgnzbuMzHmJ<7K;v)}|Drh4E zq2TFGY9-?(_t_mKi3w&0`zdrF{tOC@4Gw<0#?4RrS>(>Si;am-Y|nbC--fKo()r`* zKP){NaKB03JthB}tC_{FI60OG0VePiKSK8#-_oJ7QUO^@d&32R0jW=8eqJ za+J0m71PvHwh#pc*k2xFsK-0T=SjW~Ka>iQr2@AL=siA1`e%Nld9SJ0(vhr1`@AcB zyX#U;)#JDBMsn-E=8VkF1GP)(`x=qVOCi4j^sPKF^w(5zYOPmo-NW7rUc7j*vGEBK zg(02v9!Xl(ga^J^dA!ONjs-F(cfb@wooja2?&JnBap0cuf%Z=hX-Oq8o04~3tDIQ* zH_+Ho_$*E}V45iu#P<1RK{bcbBFD>uV-Y2#s%tiX8D{I+pfLaA!qXmE0Keqdy``qMov(-64GHw99)7-CDg8z+{7St0 z@5!Db0*2=*yKBMG~srk ze+xjFxw*Lo^wFd%1qjOi^;6Y;_C0-|HV13he+}x-!bnVSAO#T!3qSfH4`W@l!N&oKM%&xeu(c=*33Lj1d)&z2 z0tL~6{0z+f;!VU3;-W9t-S%xe&5MiceIlL!yT;3A+7zk|JBe;QK+V`4@4;Oh3+(dut(BHh(XM4$Ra+m)~SB$bY=)4-M#&!^m6$;|(>Wr&5W|$=w z4W=VyqV|U#-*YG^TIBDkE$#TgUbP7vVkAcJ&%q_2n6-xrtOF4+;C4%UfSa54MSXyo z2AGf9M#02lt#vpA(5dTfjk_t+KfqXX><1I@Ompwk(BGE`Eb(lG22WljI#9sfEwaI% z00pt8hCLEiMR>}fU9wdy`2-zxYOf%Xf6h;&o;wntKrAshOMHRygAjcZ**+7nJ1Xq9 z=z{G{6fTbbzgfRUY~Ue*GZ~aV_K?y6!p~1By~fbp{T8`N0qF|znP5iUveUSL@ADJo z{8euxntd8^;6e&Xb$886`F@~y@9CeUpY5-<2!a<66(X|y?%qvAfjT_fvc*a+OCct$ zB>p3Vs)X>+Py90G_2K#Bb)olkM32B9tr>(=U7l5&_`{7e&_hp2p@#cqph7}uQITaz z#JLl}-|~7zoK#Nq#Djy62&eAt*xK}dde~qqg z@vI_s_0`i%n7fLogB2N$Kw7Fowd7rS48(&4>JA>JTi5V!ZVXhSNl5kc17)blbm1&q zn5n)vTq29q#$Yl}9+!R<^0&Jaigt_3fsIHH#FBsiSRS{FdOyN* z0zKNR>so!lM**%+HNs|&t3)?4#BQGd_%l9%_EF%qS-G9&*S!C3re}V6BnsYa=`8(o z?^j12LdC1O!vZ7L05cllj{G!898^Z^-9+4`$gmZV$6^Li+Olwl1k&v1K$alrp92Od zy51^Vfq$nFLYd6oz@%)UD}@^%XrN_}e*7v5YjLar56l>lDw;J139m4audS%9>hqi* zcnsZeDElsySW1I(XkXc%AND10OLIbSWfvNe{{d30bBG5DsN&Fvx&W(TWvrqdCIU!? zI20HGz4L&C3q~ey@y{0$NVskPK=|Pu@kT78c>8C7RZ_+bMr*SM+$&})JwA|iq^7P{ zy>Y{95TsiuNCLo_V>IcndX^wEdHTd%d+Ddv^0|TwF@T&#@tDv+Z6!k^>u`v~E&2Z7 z)_C{M2~huxYuFInbQe4yS>cVHz-TYsp8XE^(%fGG)+kp_8idNXiF;FfEmBV@U|bva zXlynx_@%m5Vw*WXASn|i!kp65!bZ!RsGI&wIPVd)lY&vHn!37UL>VvSFg4#>kN%J< zyR8jARroquNbFAPhb?mvLjq8ZVBeC0(F5GiKpFz9*A|$xJrNOkE_dEu1CP>b$0Fip z>&v)ild>mIo~ZV(yh}eaqJ~)qlEn;KCa~l720n$E0VL2dn~&a84n+YfzUhyy&+xad z6A{(<@zc#gOnLT~uQ8UJY^6gnEIT`z9a?WNu*#Ye>6QlVRQ+=BiGIb_&%!jp(9DdI zmYa6$_@@~evQ(*XU~nX0i#_vl%MAA{b^O%a`46XjvP(y;`a*=ArP(NsMrz@GiExJ?2b$BkEFv9duH(wEY zSJ^sEJeg?c7kdw5nSM**4pe-%U!>B^l7o!Ook7v1okD-Gi^=oh@p}{q`%b|7LcoTAOELuXNlvcGb zO01p~XGkaMqoSi50mNK0-^yxtMZ(Fx{%E^@wU!d+h?z z=W)Y=7uFd7qW$SpP>fhxF!-e~*4Ke8-?Zu}TsE9eF;)Mpwy)1uEF)+-{?7ZAQOwG< zf>FdVdUVoYE0?ZReLBd!RG1vZ=6kA|LJ=%fEPYiHN2d1K@=9%~RqI>xrQWyZ<^bLj zad*G%dDc-xg#1Zv`0kZ~smL1od!D-oi#GgG`x@G_-#D*xZ}YT^J$=d)%DV0BAA>>6 zYg_ruv%aQ`^IPk^@zZ%e6=5M#u35TRU<6Ofa!gK+o&9MfZ&VG+fhqH36yA;2wk0PQGs_&1T=L+ z6B9R|K)My)wKOBXP421*Lq?;cC}3ludU|=0QfArD≶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�t_wg{>nx7`t<6o<|Aey5Ob0r>g^E8<@ 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 &WNIL@93?kAk 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…^*VPIC+fy|2;)At7$C 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 0.05 + for: 2m + labels: + severity: warning + component: api + annotations: + summary: "API 5xx ratio > 5% for 2m" + description: "Current 5xx ratio: {{ $value | humanizePercentage }}" + runbook: "infra/otel/runbooks/high-error-rate.md" + + - alert: HighLatency + expr: | + histogram_quantile( + 0.95, + sum(rate(http_request_duration_seconds_bucket[5m])) by (le) + ) > 2.0 + for: 5m + labels: + severity: warning + component: api + annotations: + summary: "API p95 latency > 2s for 5m" + description: "p95 latency: {{ $value | humanizeDuration }}" \ No newline at end of file diff --git a/infra/otel/prometheus/rules/worker-alerts.yml b/infra/otel/prometheus/rules/worker-alerts.yml new file mode 100644 index 0000000..1604f93 --- /dev/null +++ b/infra/otel/prometheus/rules/worker-alerts.yml @@ -0,0 +1,26 @@ +groups: + - name: worker + interval: 30s + rules: + - alert: QueueLagHigh + expr: | + jobs_oldest_pending_age_seconds > 60 + for: 2m + labels: + severity: critical + component: worker + annotations: + summary: "Oldest pending job age > 60s for 2m" + description: "Oldest pending job: {{ $value | humanizeDuration }}" + runbook: "infra/otel/runbooks/queue-lag.md" + + - alert: WorkerSaturated + expr: | + worker_in_flight >= worker_capacity + for: 5m + labels: + severity: warning + component: worker + annotations: + summary: "Worker at capacity for 5m" + description: "in_flight={{ $value }}" \ No newline at end of file diff --git a/infra/otel/runbooks/high-error-rate.md b/infra/otel/runbooks/high-error-rate.md new file mode 100644 index 0000000..bc9e324 --- /dev/null +++ b/infra/otel/runbooks/high-error-rate.md @@ -0,0 +1,20 @@ +# HighErrorRate runbook + +## Symptom +Prometheus alert `HighErrorRate`: 5xx ratio > 5% за 2 минуты. + +## Diagnose +1. Открой Grafana → Messenger / API Overview. Найди график `HTTP requests by status_class`. Посмотри, какая `route` даёт 5xx. +2. В Loki запроси: `{service_name="messenger-api"} | json | severity="ERROR"`. +3. Возьми `trace_id` из лога → открой в Tempo. Проверь span, где произошёл exception (`status.code = ERROR`). +4. Если в трейсе видно `db.query` со status ERROR и `PoolTimeout` → см. `db-pool-exhausted.md` (TODO). +5. Если `job.publish` со status ERROR и `broker unavailable` → проверь broker: `docker compose ps broker`. + +## Remediate +- Перезапустить API: `docker compose restart api` +- Если причина в БД: проверить `pg_stat_activity`, `docker compose logs postgres` +- Если причина в broker: `docker compose restart broker relay` + +## Prevent +- Настроить retry на DB pool (psycopg_pool `timeout`). +- Расширить pool (`max_size`). \ No newline at end of file diff --git a/infra/otel/runbooks/queue-lag.md b/infra/otel/runbooks/queue-lag.md new file mode 100644 index 0000000..471ab9c --- /dev/null +++ b/infra/otel/runbooks/queue-lag.md @@ -0,0 +1,20 @@ +# QueueLagHigh runbook + +## Symptom +Prometheus alert `QueueLagHigh`: `jobs_oldest_pending_age_seconds > 60` за 2 минуты. + +## Diagnose +1. Grafana → Messenger / Worker Pipeline. График `jobs_oldest_pending_age_seconds`. Смотрим, растёт ли — если растёт, worker не справляется. +2. Проверить `worker_in_flight` vs `worker_capacity`. Если `in_flight == capacity` долго — worker saturated. +3. Проверить `jobs_pending_count`, `jobs_processing_count`, `rabbitmq_queue_messages{queue="attachment.process.v1"}`. +4. Логи worker: `{service_name="messenger-worker"} | json | severity="ERROR"`. Если видишь `job attempt N failed` — смотрим exception. +5. Логи relay: `{service_name="messenger-relay"} | json`. Если `publish failed` — проблема с broker. + +## Remediate +- Если worker упал: `docker compose up -d worker`. Если упал и не поднимается — `docker compose logs worker`. +- Если relay не публикует: `docker compose logs relay`. +- Если broker переполнен: расширить `WORKER_CONCURRENCY` или добавить реплик worker. + +## Prevent +- Horizontal scaling worker. +- Более агрессивный `WORKER_CONCURRENCY`. \ No newline at end of file diff --git a/infra/otel/tempo/tempo-config.yaml b/infra/otel/tempo/tempo-config.yaml new file mode 100644 index 0000000..8ae51c2 --- /dev/null +++ b/infra/otel/tempo/tempo-config.yaml @@ -0,0 +1,24 @@ +server: + http_listen_port: 3200 + grpc_listen_port: 9095 + +distributor: + receivers: + otlp: + protocols: + http: + endpoint: 0.0.0.0:4318 + grpc: + endpoint: 0.0.0.0:4317 + +storage: + trace: + backend: local + local: + path: /var/tempo/traces + wal: + path: /var/tempo/wal + +compactor: + compaction: + block_retention: 24h \ No newline at end of file diff --git a/infra/s3-cleanup-policy.json b/infra/s3-cleanup-policy.json new file mode 100644 index 0000000..1e5a53a --- /dev/null +++ b/infra/s3-cleanup-policy.json @@ -0,0 +1,24 @@ +{ + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "s3:ListBucket" + ], + "Resource": [ + "arn:aws:s3:::messenger-attachments" + ] + }, + { + "Effect": "Allow", + "Action": [ + "s3:GetObject", + "s3:DeleteObject" + ], + "Resource": [ + "arn:aws:s3:::messenger-attachments/*" + ] + } + ] +} \ No newline at end of file diff --git a/infra/s3-policy.json b/infra/s3-policy.json new file mode 100644 index 0000000..2e130c9 --- /dev/null +++ b/infra/s3-policy.json @@ -0,0 +1,25 @@ +{ + "Version": "2012-10-17", + "Statement": [ + { + "Effect": "Allow", + "Action": [ + "s3:PutObject", + "s3:GetObject", + "s3:DeleteObject" + ], + "Resource": [ + "arn:aws:s3:::messenger-attachments/*" + ] + }, + { + "Effect": "Allow", + "Action": [ + "s3:HeadBucket" + ], + "Resource": [ + "arn:aws:s3:::messenger-attachments" + ] + } + ] +} \ No newline at end of file diff --git a/migrations/README b/migrations/README new file mode 100644 index 0000000..98e4f9c --- /dev/null +++ b/migrations/README @@ -0,0 +1 @@ +Generic single-database configuration. \ No newline at end of file diff --git a/migrations/env.py b/migrations/env.py new file mode 100644 index 0000000..c2a4c9e --- /dev/null +++ b/migrations/env.py @@ -0,0 +1,46 @@ +from __future__ import annotations + +import os +from logging.config import fileConfig + +from alembic import context + +config = context.config + +if config.config_file_name is not None: + fileConfig(config.config_file_name) + +database_url = os.environ.get("DATABASE_URL") +if not database_url: + raise RuntimeError("DATABASE_URL environment variable is required for migrations") + +target_metadata = None + + +def run_migrations_offline() -> None: + """Оффлайн-режим: печатает SQL, не подключаясь к БД.""" + context.configure( + url=database_url, + target_metadata=target_metadata, + literal_binds=True, + dialect_opts={"paramstyle": "named"}, + ) + with context.begin_transaction(): + context.run_migrations() + + +def run_migrations_online() -> None: + """Онлайн-режим: подключается к БД и применяет миграции.""" + from sqlalchemy import create_engine + + connectable = create_engine(database_url, pool_pre_ping=True) + with connectable.connect() as connection: + context.configure(connection=connection, target_metadata=target_metadata) + with context.begin_transaction(): + context.run_migrations() + + +if context.is_offline_mode(): + run_migrations_offline() +else: + run_migrations_online() \ No newline at end of file diff --git a/migrations/script.py.mako b/migrations/script.py.mako new file mode 100644 index 0000000..fbc4b07 --- /dev/null +++ b/migrations/script.py.mako @@ -0,0 +1,26 @@ +"""${message} + +Revision ID: ${up_revision} +Revises: ${down_revision | comma,n} +Create Date: ${create_date} + +""" +from typing import Sequence, Union + +from alembic import op +import sqlalchemy as sa +${imports if imports else ""} + +# revision identifiers, used by Alembic. +revision: str = ${repr(up_revision)} +down_revision: Union[str, None] = ${repr(down_revision)} +branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)} +depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)} + + +def upgrade() -> None: + ${upgrades if upgrades else "pass"} + + +def downgrade() -> None: + ${downgrades if downgrades else "pass"} diff --git a/migrations/versions/25c48b226c14_lab5_attachment_statuses_jobs_outbox.py b/migrations/versions/25c48b226c14_lab5_attachment_statuses_jobs_outbox.py new file mode 100644 index 0000000..c3162da --- /dev/null +++ b/migrations/versions/25c48b226c14_lab5_attachment_statuses_jobs_outbox.py @@ -0,0 +1,78 @@ +"""lab5: attachment statuses, jobs outbox + +Revision ID: <новый_hash> +Revises: c3f18af4ec56 +Create Date: <оставь> +""" +from __future__ import annotations + +from alembic import op + +revision = "25c48b226c14" +down_revision = "c3f18af4ec56" +branch_labels = None +depends_on = None + + +def upgrade() -> None: + op.execute(""" + ALTER TABLE attachments + DROP CONSTRAINT IF EXISTS attachments_status_check + """) + op.execute(""" + ALTER TABLE attachments + ADD CONSTRAINT attachments_status_check + CHECK (status IN ('queued', 'processing', 'ready', 'failed')) + """) + op.execute(""" + ALTER TABLE attachments + ALTER COLUMN status SET DEFAULT 'queued' + """) + + op.execute(""" + ALTER TABLE attachments + ADD COLUMN IF NOT EXISTS attempt INTEGER NOT NULL DEFAULT 0 + """) + + op.execute(""" + ALTER TABLE attachments + ADD COLUMN IF NOT EXISTS staging_key TEXT + """) + + op.execute(""" + CREATE TABLE IF NOT EXISTS jobs ( + job_id UUID PRIMARY KEY, + attachment_id UUID NOT NULL REFERENCES attachments(id) ON DELETE CASCADE, + pipeline_version INTEGER NOT NULL DEFAULT 1, + attempt INTEGER NOT NULL DEFAULT 1, + status TEXT NOT NULL DEFAULT 'pending', + created_at TIMESTAMPTZ NOT NULL, + published_at TIMESTAMPTZ, + CONSTRAINT jobs_status_check + CHECK (status IN ('pending', 'published', 'failed')) + ) + """) + op.execute(""" + CREATE INDEX IF NOT EXISTS jobs_pending_idx + ON jobs (status, created_at) + WHERE status = 'pending' + """) + op.execute(""" + CREATE INDEX IF NOT EXISTS jobs_attachment_idx + ON jobs (attachment_id) + """) + + +def downgrade() -> None: + op.execute("DROP TABLE IF EXISTS jobs") + op.execute("ALTER TABLE attachments DROP COLUMN IF EXISTS staging_key") + op.execute("ALTER TABLE attachments DROP COLUMN IF EXISTS attempt") + op.execute(""" + ALTER TABLE attachments + DROP CONSTRAINT IF EXISTS attachments_status_check + """) + op.execute(""" + ALTER TABLE attachments + ADD CONSTRAINT attachments_status_check + CHECK (status = 'ready') + """) \ No newline at end of file diff --git a/migrations/versions/2667e1880881_add_traceparent_tracestate_to_jobs.py b/migrations/versions/2667e1880881_add_traceparent_tracestate_to_jobs.py new file mode 100644 index 0000000..1857a5b --- /dev/null +++ b/migrations/versions/2667e1880881_add_traceparent_tracestate_to_jobs.py @@ -0,0 +1,33 @@ +"""add traceparent tracestate to jobs + +Revision ID: 2667e1880881 +Revises: 390b34423ded +Create Date: 2026-11-10 13:31:26.245215 + +""" +from typing import Sequence, Union + +from alembic import op +import sqlalchemy as sa + + +revision: str = '2667e1880881' +down_revision: Union[str, None] = '390b34423ded' +branch_labels: Union[str, Sequence[str], None] = None +depends_on: Union[str, Sequence[str], None] = None + + +def upgrade() -> None: + op.execute(""" + ALTER TABLE jobs + ADD COLUMN IF NOT EXISTS traceparent TEXT + """) + op.execute(""" + ALTER TABLE jobs + ADD COLUMN IF NOT EXISTS tracestate TEXT + """) + + +def downgrade() -> None: + op.execute("ALTER TABLE jobs DROP COLUMN IF EXISTS tracestate") + op.execute("ALTER TABLE jobs DROP COLUMN IF EXISTS traceparent") diff --git a/migrations/versions/2803f3a0e579_add_idempotency_keys_table.py b/migrations/versions/2803f3a0e579_add_idempotency_keys_table.py new file mode 100644 index 0000000..a1a0e0f --- /dev/null +++ b/migrations/versions/2803f3a0e579_add_idempotency_keys_table.py @@ -0,0 +1,33 @@ +from __future__ import annotations + +from alembic import op + +revision = "2803f3a0e579" +down_revision = "447472b8acec" +branch_labels = None +depends_on = None + + +def upgrade() -> None: + op.execute(""" + CREATE TABLE idempotency_keys ( + user_id UUID NOT NULL, + method TEXT NOT NULL, + path TEXT NOT NULL, + key TEXT NOT NULL, + request_hash TEXT NOT NULL, + response_status INTEGER NOT NULL, + response_body JSONB NOT NULL, + created_at TIMESTAMPTZ NOT NULL, + PRIMARY KEY (user_id, method, path, key) + ) + """) + op.execute(""" + CREATE INDEX idempotency_keys_created_at_idx + ON idempotency_keys (created_at) + """) + + +def downgrade() -> None: + op.execute("DROP INDEX IF EXISTS idempotency_keys_created_at_idx") + op.execute("DROP TABLE IF EXISTS idempotency_keys") \ No newline at end of file diff --git a/migrations/versions/390b34423ded_allow_processing_status_in_jobs.py b/migrations/versions/390b34423ded_allow_processing_status_in_jobs.py new file mode 100644 index 0000000..bca2bb2 --- /dev/null +++ b/migrations/versions/390b34423ded_allow_processing_status_in_jobs.py @@ -0,0 +1,34 @@ +"""allow processing status in jobs + +Revision ID: +Revises: +Create Date: +""" +from __future__ import annotations + +from alembic import op + +revision = "390b34423ded" +down_revision = "6980f998def1" +branch_labels = None +depends_on = None + + +def upgrade() -> None: + op.execute(""" + ALTER TABLE jobs DROP CONSTRAINT IF EXISTS jobs_status_check + """) + op.execute(""" + ALTER TABLE jobs + ADD CONSTRAINT jobs_status_check + CHECK (status IN ('pending', 'processing', 'published', 'failed')) + """) + + +def downgrade() -> None: + op.execute("ALTER TABLE jobs DROP CONSTRAINT IF EXISTS jobs_status_check") + op.execute(""" + ALTER TABLE jobs + ADD CONSTRAINT jobs_status_check + CHECK (status IN ('pending', 'published', 'failed')) + """) \ No newline at end of file diff --git a/migrations/versions/447472b8acec_create_initial_schema.py b/migrations/versions/447472b8acec_create_initial_schema.py new file mode 100644 index 0000000..0cf534f --- /dev/null +++ b/migrations/versions/447472b8acec_create_initial_schema.py @@ -0,0 +1,83 @@ +"""create initial schema + +Revision ID: <оставь тот, что сгенерировал alembic> +Revises: +Create Date: <оставь> +""" +from __future__ import annotations + +from alembic import op + +# revision identifiers, used by Alembic. +revision = "447472b8acec" +down_revision = None +branch_labels = None +depends_on = None + + +def upgrade() -> None: + op.execute(""" + CREATE TABLE users ( + id UUID PRIMARY KEY, + username TEXT NOT NULL UNIQUE, + display_name TEXT NOT NULL, + password_hash TEXT NOT NULL, + created_at TIMESTAMPTZ NOT NULL + ) + """) + + op.execute(""" + CREATE TABLE chats ( + id UUID PRIMARY KEY, + title TEXT NOT NULL, + created_at TIMESTAMPTZ NOT NULL + ) + """) + + op.execute(""" + CREATE TABLE chat_members ( + chat_id UUID NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE, + PRIMARY KEY (chat_id, user_id) + ) + """) + + op.execute(""" + CREATE INDEX chat_members_user_idx ON chat_members (user_id) + """) + + op.execute(""" + CREATE TABLE messages ( + id UUID PRIMARY KEY, + chat_id UUID NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + sender_id UUID NOT NULL REFERENCES users(id), + text TEXT NOT NULL, + created_at TIMESTAMPTZ NOT NULL + ) + """) + + op.execute(""" + CREATE INDEX messages_history_idx ON messages (chat_id, created_at, id) + """) + + op.execute(""" + CREATE TABLE sessions ( + token_hash TEXT PRIMARY KEY, + user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE, + expires_at TIMESTAMPTZ NOT NULL, + created_at TIMESTAMPTZ NOT NULL + ) + """) + + op.execute(""" + CREATE INDEX sessions_user_idx ON sessions (user_id) + """) + + +def downgrade() -> None: + op.execute("DROP TABLE IF EXISTS sessions") + op.execute("DROP TABLE IF EXISTS messages") + op.execute("DROP INDEX IF EXISTS chat_members_user_idx") + op.execute("DROP TABLE IF EXISTS chat_members") + op.execute("DROP TABLE IF EXISTS chats") + op.execute("DROP TABLE IF EXISTS users") \ No newline at end of file diff --git a/migrations/versions/6980f998def1_add_lease_until_to_jobs.py b/migrations/versions/6980f998def1_add_lease_until_to_jobs.py new file mode 100644 index 0000000..d383967 --- /dev/null +++ b/migrations/versions/6980f998def1_add_lease_until_to_jobs.py @@ -0,0 +1,31 @@ +"""add lease_until to jobs + +Revision ID: +Revises: d60dfc3e075a +Create Date: +""" +from __future__ import annotations + +from alembic import op + +revision = "6980f998def1" +down_revision = "d60dfc3e075a" +branch_labels = None +depends_on = None + + +def upgrade() -> None: + op.execute(""" + ALTER TABLE jobs + ADD COLUMN IF NOT EXISTS lease_until TIMESTAMPTZ + """) + op.execute(""" + CREATE INDEX IF NOT EXISTS jobs_processing_expired_idx + ON jobs (lease_until) + WHERE status = 'processing' + """) + + +def downgrade() -> None: + op.execute("DROP INDEX IF EXISTS jobs_processing_expired_idx") + op.execute("ALTER TABLE jobs DROP COLUMN IF EXISTS lease_until") \ No newline at end of file diff --git a/migrations/versions/c3f18af4ec56_add_attachments_table.py b/migrations/versions/c3f18af4ec56_add_attachments_table.py new file mode 100644 index 0000000..5d60c7f --- /dev/null +++ b/migrations/versions/c3f18af4ec56_add_attachments_table.py @@ -0,0 +1,57 @@ +"""add attachments table + +Revision ID: c3f18af4ec56 +Revises: 2803f3a0e579 +Create Date: <оставь> +""" +from __future__ import annotations + +from alembic import op + +revision = "c3f18af4ec56" +down_revision = "2803f3a0e579" +branch_labels = None +depends_on = None + + +def upgrade() -> None: + op.execute(""" + CREATE TABLE attachments ( + id UUID PRIMARY KEY, + chat_id UUID NOT NULL REFERENCES chats(id) ON DELETE CASCADE, + owner_id UUID NOT NULL REFERENCES users(id), + filename TEXT NOT NULL, + content_type TEXT NOT NULL CHECK (content_type IN ('image/png','image/jpeg')), + size_bytes INTEGER NOT NULL CHECK (size_bytes > 0 AND size_bytes <= 10485760), + sha256 TEXT NOT NULL CHECK (sha256 ~ '^[a-f0-9]{64}$'), + s3_key TEXT NOT NULL UNIQUE, + status TEXT NOT NULL DEFAULT 'ready', + error_code TEXT, + created_at TIMESTAMPTZ NOT NULL, + updated_at TIMESTAMPTZ NOT NULL + ) + """) + op.execute(""" + CREATE INDEX attachments_chat_idx ON attachments (chat_id) + """) + op.execute(""" + CREATE INDEX attachments_owner_idx ON attachments (owner_id) + """) + op.execute(""" + CREATE TABLE message_attachments ( + message_id UUID NOT NULL REFERENCES messages(id) ON DELETE CASCADE, + attachment_id UUID NOT NULL REFERENCES attachments(id) ON DELETE CASCADE, + position INTEGER NOT NULL, + PRIMARY KEY (message_id, attachment_id) + ) + """) + op.execute(""" + CREATE INDEX message_attachments_attachment_idx ON message_attachments (attachment_id) + """) + + +def downgrade() -> None: + op.execute("DROP TABLE IF EXISTS message_attachments") + op.execute("DROP INDEX IF EXISTS attachments_owner_idx") + op.execute("DROP INDEX IF EXISTS attachments_chat_idx") + op.execute("DROP TABLE IF EXISTS attachments") \ No newline at end of file diff --git a/migrations/versions/d60dfc3e075a_add_variants_column_to_attachments.py b/migrations/versions/d60dfc3e075a_add_variants_column_to_attachments.py new file mode 100644 index 0000000..6eefd9e --- /dev/null +++ b/migrations/versions/d60dfc3e075a_add_variants_column_to_attachments.py @@ -0,0 +1,25 @@ +"""add variants column to attachments + +Revision ID: +Revises: 25c48b226c14 +Create Date: +""" +from __future__ import annotations + +from alembic import op + +revision = "d60dfc3e075a" +down_revision = "25c48b226c14" +branch_labels = None +depends_on = None + + +def upgrade() -> None: + op.execute(""" + ALTER TABLE attachments + ADD COLUMN IF NOT EXISTS variants JSONB NOT NULL DEFAULT '[]'::jsonb + """) + + +def downgrade() -> None: + op.execute("ALTER TABLE attachments DROP COLUMN IF EXISTS variants") \ No newline at end of file diff --git a/requirements.txt b/requirements.txt new file mode 100755 index 0000000..4f35475 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,22 @@ +fastapi==0.115.0 +uvicorn[standard]==0.30.6 +pydantic==2.9.2 +psycopg[binary]==3.2.3 +alembic==1.13.3 +argon2-cffi==23.1.0 +psycopg-pool==3.2.3 +redis==5.1.1 +boto3==1.35.36 +Pillow==10.4.0 +filetype==1.2.0 +pika==1.3.2 +opentelemetry-api==1.28.2 +opentelemetry-sdk==1.28.2 +opentelemetry-exporter-otlp-proto-http==1.28.2 +opentelemetry-instrumentation-fastapi==0.49b2 +opentelemetry-instrumentation-starlette==0.49b2 +opentelemetry-instrumentation-logging==0.49b2 +opentelemetry-instrumentation-psycopg==0.49b2 +opentelemetry-instrumentation-redis==0.49b2 +opentelemetry-instrumentation-botocore==0.49b2 +prometheus-client==0.21.0 \ No newline at end of file diff --git a/scripts/cleanup_orphans.py b/scripts/cleanup_orphans.py new file mode 100644 index 0000000..de752e8 --- /dev/null +++ b/scripts/cleanup_orphans.py @@ -0,0 +1,85 @@ +from __future__ import annotations + +import logging +import os +import sys +from datetime import datetime, timedelta, timezone + +import boto3 +import psycopg +from botocore.client import Config +from botocore.exceptions import ClientError +from psycopg.rows import dict_row + +logging.basicConfig( + level=logging.INFO, format="%(asctime)s %(levelname)s %(message)s" +) +log = logging.getLogger("cleanup") + + +def _env(name: str, default: str | None = None) -> str: + value = os.environ.get(name, default) + if value is None: + raise RuntimeError(f"Environment variable {name} is required") + return value + + +def main() -> None: + grace_hours = int(os.environ.get("CLEANUP_GRACE_HOURS", "1")) + grace = timedelta(hours=grace_hours) + bucket = _env("S3_BUCKET", "messenger-attachments") + + s3 = boto3.client( + "s3", + endpoint_url=_env("S3_ENDPOINT"), + region_name=_env("S3_REGION", "us-east-1"), + aws_access_key_id=_env("S3_ACCESS_KEY_ID"), + aws_secret_access_key=_env("S3_SECRET_ACCESS_KEY"), + config=Config(signature_version="s3v4", s3={"addressing_style": "path"}), + ) + + s3_objects: dict[str, datetime] = {} + paginator = s3.get_paginator("list_objects_v2") + for page in paginator.paginate(Bucket=bucket): + for obj in page.get("Contents", []): + s3_objects[obj["Key"]] = obj["LastModified"] + + log.info("S3 objects: %d", len(s3_objects)) + + db_keys: set[str] = set() + with psycopg.connect(_env("DATABASE_URL"), row_factory=dict_row) as conn: + with conn.cursor() as cur: + cur.execute("SELECT s3_key FROM attachments") + for row in cur.fetchall(): + db_keys.add(row["s3_key"]) + + log.info("DB attachments: %d", len(db_keys)) + + orphans = set(s3_objects) - db_keys + log.info("Orphans: %d", len(orphans)) + + now = datetime.now(timezone.utc) + deleted = 0 + skipped = 0 + for key in orphans: + age = now - s3_objects[key] + if age < grace: + log.info("skip %s (age %s < grace %s)", key, age, grace) + skipped += 1 + continue + try: + s3.delete_object(Bucket=bucket, Key=key) + log.info("deleted orphan: %s (age %s)", key, age) + deleted += 1 + except ClientError as exc: + log.error("failed to delete %s: %s", key, exc) + + log.info("done: deleted=%d, skipped=%d", deleted, skipped) + + +if __name__ == "__main__": + try: + main() + except Exception as exc: + log.exception("cleanup failed") + sys.exit(1) \ No newline at end of file diff --git a/scripts/restart.sh b/scripts/restart.sh new file mode 100755 index 0000000..814bb90 --- /dev/null +++ b/scripts/restart.sh @@ -0,0 +1,29 @@ +#!/bin/sh +set -eu + +cd "$(dirname "$0")/.." + +docker compose --env-file .env restart postgres cache s3 broker + +i=0 +while [ $i -lt 120 ]; do + if docker compose --env-file .env exec -T broker rabbitmq-diagnostics -q ping > /dev/null 2>&1; then + break + fi + sleep 1 + i=$((i + 1)) +done + +docker compose --env-file .env restart api worker + +i=0 +while [ $i -lt 90 ]; do + if curl -sf http://localhost:8080/health/ready > /dev/null 2>&1; then + exit 0 + fi + sleep 1 + i=$((i + 1)) +done + +echo "stack did not become healthy in 90 seconds" >&2 +exit 1 \ No newline at end of file diff --git a/scripts/stop-one.sh b/scripts/stop-one.sh new file mode 100755 index 0000000..9d99ee6 --- /dev/null +++ b/scripts/stop-one.sh @@ -0,0 +1,25 @@ +#!/bin/sh +set -eu + +: "${TARGET_INSTANCE_ID:?TARGET_INSTANCE_ID environment variable is required}" + +echo "Looking for API container with instance_id=$TARGET_INSTANCE_ID" + +found="" +for container in $(docker ps --format '{{.Names}}' | grep -E '^mtusi.*-api-[0-9]+$'); do + if docker logs "$container" 2>&1 | grep -q "instance_id=$TARGET_INSTANCE_ID"; then + found="$container" + break + fi +done + +if [ -z "$found" ]; then + echo "ERROR: no container found with instance_id=$TARGET_INSTANCE_ID" >&2 + exit 1 +fi + +echo "Stopping container: $found" +docker stop "$found" + +echo "Container $found stopped. Other replicas continue serving." +exit 0 \ No newline at end of file diff --git a/src/__init__.py b/src/__init__.py new file mode 100755 index 0000000..e69de29 diff --git a/src/auth.py b/src/auth.py new file mode 100644 index 0000000..c89e0b3 --- /dev/null +++ b/src/auth.py @@ -0,0 +1,114 @@ +from __future__ import annotations + +import hashlib +import os +import secrets +from datetime import datetime, timedelta, timezone +from typing import Optional + +import psycopg +from argon2 import PasswordHasher +from argon2.exceptions import VerifyMismatchError, VerificationError, InvalidHashError + +from .db import transaction + +_hasher = PasswordHasher() + + +def hash_password(password: str) -> str: + return _hasher.hash(password) + + +def verify_password(password: str, password_hash: str) -> bool: + try: + _hasher.verify(password_hash, password) + return True + except (VerifyMismatchError, VerificationError, InvalidHashError): + return False + + +def _now() -> datetime: + return datetime.now(timezone.utc) + + +def _ttl_seconds() -> int: + return int(os.environ.get("SESSION_TTL_SECONDS", "3600")) + + +def _generate_token() -> str: + return secrets.token_urlsafe(32) + + +def _token_hash(token: str) -> str: + return hashlib.sha256(token.encode("utf-8")).hexdigest() + + +def create_session(user_id: str) -> dict: + token = _generate_token() + ttl = _ttl_seconds() + expires_at = _now() + timedelta(seconds=ttl) + token_hash = _token_hash(token) + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + """ + INSERT INTO sessions (token_hash, user_id, expires_at, created_at) + VALUES (%s, %s, %s, %s) + """, + (token_hash, user_id, expires_at, _now()), + ) + return {"token": token, "expires_at": expires_at} + + +def get_user_id_by_token(token: str) -> Optional[str]: + from . import cache + + token_hash = _token_hash(token) + + if cache.is_revoked(token_hash): + return None + + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + """ + SELECT user_id, expires_at + FROM sessions + WHERE token_hash = %s + """, + (token_hash,), + ) + row = cur.fetchone() + if row is None: + return None + if row["expires_at"] <= _now(): + return None + return str(row["user_id"]) + + +def revoke_session(token: str) -> bool: + from . import cache + + token_hash = _token_hash(token) + ttl = _ttl_seconds() + + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + "SELECT expires_at FROM sessions WHERE token_hash = %s", + (token_hash,), + ) + row = cur.fetchone() + if row is not None: + remaining = int((row["expires_at"] - _now()).total_seconds()) + if remaining > 0: + ttl = remaining + cur.execute( + "DELETE FROM sessions WHERE token_hash = %s", + (token_hash,), + ) + deleted = cur.rowcount > 0 + + if deleted: + cache.mark_revoked(token_hash, ttl) + return deleted \ No newline at end of file diff --git a/src/broker.py b/src/broker.py new file mode 100644 index 0000000..61fa1d1 --- /dev/null +++ b/src/broker.py @@ -0,0 +1,175 @@ +from __future__ import annotations + +import json +import logging +import os +import uuid +from typing import Callable, Optional + +import pika +from pika.exceptions import AMQPConnectionError + +from opentelemetry import trace +from opentelemetry.propagate import inject as otel_inject, extract as otel_extract +from opentelemetry.trace import SpanKind, Link + +_tracer = trace.get_tracer("messenger.broker") + +log = logging.getLogger("messenger.broker") + +QUEUE = "attachment.process.v1" +DLQ = "attachment.process.v1.dlq" + + +def _url() -> str: + url = os.environ.get("BROKER_URL") + if not url: + raise RuntimeError("BROKER_URL environment variable is required") + return url + + +def _connect() -> pika.BlockingConnection: + params = pika.URLParameters(_url()) + params.heartbeat = 30 + params.blocked_connection_timeout = 5 + return pika.BlockingConnection(params) + + +def _declare(channel: pika.channel.Channel) -> None: + # DLQ + channel.queue_declare(queue=DLQ, durable=True) + # Основная очередь с DLX на DLQ + channel.queue_declare( + queue=QUEUE, + durable=True, + arguments={ + "x-dead-letter-exchange": "", + "x-dead-letter-routing-key": DLQ, + "x-max-priority": 5, + }, + ) + + +def publish_job(job: dict) -> None: + body = json.dumps(job, ensure_ascii=False).encode("utf-8") + + parent_ctx = None + stored_tp = job.get("_traceparent") + stored_ts = job.get("_tracestate") + if stored_tp: + parent_ctx = otel_extract({"traceparent": stored_tp, + **({"tracestate": stored_ts} if stored_ts else {})}) + + with _tracer.start_as_current_span( + "job.publish", + context=parent_ctx, + kind=SpanKind.PRODUCER, + attributes={ + "messaging.system": "rabbitmq", + "messaging.destination.name": QUEUE, + "messaging.operation": "publish", + "messaging.message.id": job["job_id"], + "job.type": job.get("type", "attachment.process.v1"), + "job.attempt": job.get("attempt", 1), + "job.attachment_id": job.get("attachment_id", ""), + }, + ) as span: + headers: dict = {} + otel_inject(headers) + + try: + conn = _connect() + except AMQPConnectionError as exc: + span.record_exception(exc) + span.set_status(trace.Status(trace.StatusCode.ERROR, str(exc))) + raise RuntimeError(f"broker unavailable: {exc}") from exc + try: + ch = conn.channel() + _declare(ch) + ch.confirm_delivery() + clean_job = {k: v for k, v in job.items() if not k.startswith("_")} + clean_body = json.dumps(clean_job, ensure_ascii=False).encode("utf-8") + ch.basic_publish( + exchange="", + routing_key=QUEUE, + body=clean_body, + properties=pika.BasicProperties( + delivery_mode=2, + content_type="application/json", + message_id=job["job_id"], + headers=headers, + ), + mandatory=True, + ) + log.info("published job %s for attachment %s", + job["job_id"], job["attachment_id"]) + finally: + conn.close() + + +def consume(handler: Callable[[dict], None], prefetch: int = 2) -> None: + conn = _connect() + ch = conn.channel() + _declare(ch) + ch.basic_qos(prefetch_count=prefetch) + + def callback(ch_, method, properties, body): + try: + job = json.loads(body) + except Exception as exc: + log.error("invalid job payload: %s", exc) + ch_.basic_nack(method.delivery_tag, requeue=False) + return + + headers = properties.headers or {} + parent_ctx = otel_extract(headers) if headers.get("traceparent") else None + + try: + handler(job, parent_ctx=parent_ctx) + ch_.basic_ack(method.delivery_tag) + except Exception as exc: + log.exception("job failed: %s", exc) + ch_.basic_nack(method.delivery_tag, requeue=False) + + ch.basic_consume(queue=QUEUE, on_message_callback=callback) + log.info("worker started, queue=%s prefetch=%d", QUEUE, prefetch) + try: + ch.start_consuming() + except KeyboardInterrupt: + ch.stop_consuming() + finally: + conn.close() + +def publish_dlq(job: dict, error: str) -> None: + with _tracer.start_as_current_span( + "job.dlq_publish", + kind=SpanKind.PRODUCER, + attributes={ + "messaging.system": "rabbitmq", + "messaging.destination.name": DLQ, + "messaging.operation": "publish", + "messaging.message.id": job.get("job_id", ""), + }, + ): + body = json.dumps( + {"job": job, "error": error, "failed_at": job.get("created_at")}, + ensure_ascii=False, + ).encode("utf-8") + headers: dict = {} + otel_inject(headers) + conn = _connect() + try: + ch = conn.channel() + ch.queue_declare(queue=DLQ, durable=True) + ch.basic_publish( + exchange="", + routing_key=DLQ, + body=body, + properties=pika.BasicProperties( + delivery_mode=2, + content_type="application/json", + headers=headers, + ), + ) + finally: + conn.close() \ No newline at end of file diff --git a/src/cache.py b/src/cache.py new file mode 100644 index 0000000..2b10432 --- /dev/null +++ b/src/cache.py @@ -0,0 +1,104 @@ +from __future__ import annotations + +import logging +import os +from typing import Optional + +import redis + +log = logging.getLogger("messenger.cache") + +_client: Optional[redis.Redis] = None +_failures: int = 0 +_MAX_FAILURES_BEFORE_DISABLE: int = 3 + + +def _cache_url() -> Optional[str]: + return os.environ.get("CACHE_URL") + + +def init_cache() -> None: + global _client, _failures + url = _cache_url() + if not url: + log.warning("CACHE_URL not set; running without cache") + _client = None + return + try: + client = redis.Redis.from_url( + url, + decode_responses=True, + socket_connect_timeout=1.0, + socket_timeout=1.0, + ) + client.ping() + _client = client + _failures = 0 + log.info("cache connected") + except Exception as exc: + log.warning("cache unavailable at startup: %s; running in degraded mode", exc) + _client = None + + +def close_cache() -> None: + global _client + if _client is not None: + try: + _client.close() + except Exception: + pass + _client = None + + +def _note_failure() -> None: + global _client, _failures + _failures += 1 + if _failures >= _MAX_FAILURES_BEFORE_DISABLE and _client is not None: + log.warning( + "cache disabled after %d consecutive failures; running in degraded mode", + _failures, + ) + try: + _client.close() + except Exception: + pass + _client = None + + +def _note_success() -> None: + global _failures + _failures = 0 + + +def is_available() -> bool: + return _client is not None + + +def mark_revoked(token_hash: str, ttl_seconds: int) -> None: + if _client is None: + log.warning( + "cache unavailable; revocation not recorded in Redis " + "(Postgres is the source of truth, next request will 401)" + ) + return + if ttl_seconds <= 0: + return + try: + _client.setex(f"revoked:{token_hash}", ttl_seconds, "1") + _note_success() + except Exception as exc: + log.warning("mark_revoked failed: %s", exc) + _note_failure() + + +def is_revoked(token_hash: str) -> bool: + if _client is None: + return False + try: + exists = _client.exists(f"revoked:{token_hash}") + _note_success() + return exists == 1 + except Exception as exc: + log.warning("is_revoked failed: %s", exc) + _note_failure() + return False \ No newline at end of file diff --git a/src/db.py b/src/db.py new file mode 100644 index 0000000..d0455b6 --- /dev/null +++ b/src/db.py @@ -0,0 +1,72 @@ +from __future__ import annotations + +import os +from contextlib import contextmanager +from typing import Iterator + +import psycopg +from psycopg.rows import dict_row +from psycopg_pool import ConnectionPool + + +_pool: ConnectionPool | None = None + + +def _database_url() -> str: + url = os.environ.get("DATABASE_URL") + if not url: + raise RuntimeError("DATABASE_URL environment variable is required") + return url + + +from psycopg_pool import ConnectionPool + +def init_pool(min_size: int = 1, max_size: int = 10) -> None: + global _pool + if _pool is not None: + return + + dsn = _database_url() + sep = "&" if "?" in dsn else "?" + dsn_with_opts = ( + dsn + + sep + + "options=" + + "-c%20statement_timeout%3D5000" + + "%20-c%20lock_timeout%3D3000" + + "%20-c%20idle_in_transaction_session_timeout%3D10000" + ) + + _pool = ConnectionPool( + conninfo=dsn_with_opts, + min_size=min_size, + max_size=max_size, + kwargs={"row_factory": dict_row}, + open=True, + timeout=5.0, + check=ConnectionPool.check_connection, + max_lifetime=120, + max_idle=60, + ) + + +def close_pool() -> None: + global _pool + if _pool is not None: + _pool.close() + _pool = None + + +@contextmanager +def connection() -> Iterator[psycopg.Connection]: + if _pool is None: + raise RuntimeError("Connection pool is not initialized") + with _pool.connection() as conn: + yield conn + + +@contextmanager +def transaction() -> Iterator[psycopg.Connection]: + with connection() as conn: + with conn.transaction(): + yield conn \ No newline at end of file diff --git a/src/errors.py b/src/errors.py new file mode 100755 index 0000000..fbcf1f0 --- /dev/null +++ b/src/errors.py @@ -0,0 +1,81 @@ +from __future__ import annotations + +import uuid +from typing import Callable + +from fastapi import Request +from fastapi.responses import JSONResponse +from starlette.middleware.base import BaseHTTPMiddleware + +from .instance import INSTANCE_ID +from .store import ApiError + + +REQUEST_ID_HEADER = "X-Request-Id" + + +class RequestIdMiddleware(BaseHTTPMiddleware): + async def dispatch(self, request: Request, call_next): + rid = request.headers.get(REQUEST_ID_HEADER) or uuid.uuid4().hex + request.state.request_id = rid + response = await call_next(request) + response.headers[REQUEST_ID_HEADER] = rid + response.headers["X-Instance-Id"] = INSTANCE_ID + return response + + +def _envelope(code: str, message: str, request_id: str) -> dict: + return {"error": {"code": code, "message": message, "request_id": request_id}} + + +def _rid(request: Request) -> str: + return getattr(request.state, "request_id", None) or uuid.uuid4().hex + + +def _with_headers(response: JSONResponse, request: Request, status: int) -> JSONResponse: + rid = _rid(request) + response.headers[REQUEST_ID_HEADER] = rid + response.headers["X-Instance-Id"] = INSTANCE_ID + if status == 401: + scheme = "Bearer" + if request.url.path == "/api/v1/auth/sessions": + scheme = "Basic" + response.headers["WWW-Authenticate"] = f'{scheme} realm="messenger"' + return response + + +async def api_error_handler(request: Request, exc: Exception) -> JSONResponse: + assert isinstance(exc, ApiError) + response = JSONResponse( + status_code=exc.status, + content=_envelope(exc.code, exc.message, _rid(request)), + ) + return _with_headers(response, request, exc.status) + + +async def validation_handler(request: Request, exc: Exception) -> JSONResponse: + response = JSONResponse( + status_code=400, + content=_envelope("invalid_request", "Request validation failed", _rid(request)), + ) + return _with_headers(response, request, 400) + + +async def json_decode_handler(request: Request, exc: Exception) -> JSONResponse: + response = JSONResponse( + status_code=400, + content=_envelope("invalid_request", "Malformed JSON", _rid(request)), + ) + return _with_headers(response, request, 400) + + +async def unhandled_handler(request: Request, exc: Exception) -> JSONResponse: + import logging + logging.getLogger("messenger").exception( + "unhandled error on %s %s", request.method, request.url.path + ) + response = JSONResponse( + status_code=500, + content=_envelope("internal_error", "Internal error", _rid(request)), + ) + return _with_headers(response, request, 500) \ No newline at end of file diff --git a/src/instance.py b/src/instance.py new file mode 100644 index 0000000..701ad56 --- /dev/null +++ b/src/instance.py @@ -0,0 +1,11 @@ +from __future__ import annotations + +import os +import socket +import uuid + +INSTANCE_ID: str = ( + os.environ.get("INSTANCE_ID") + or socket.gethostname() + or uuid.uuid4().hex[:8] +) \ No newline at end of file diff --git a/src/logging_config.py b/src/logging_config.py new file mode 100644 index 0000000..fff85b1 --- /dev/null +++ b/src/logging_config.py @@ -0,0 +1,54 @@ +from __future__ import annotations + +import json +import logging +import sys +from typing import Any + +from opentelemetry import trace + + +class JsonFormatter(logging.Formatter): + def format(self, record: logging.LogRecord) -> str: + import datetime as _dt + ts = _dt.datetime.fromtimestamp(record.created, tz=_dt.timezone.utc) + payload: dict[str, Any] = { + "timestamp": ts.isoformat(timespec="milliseconds").replace("+00:00", "Z"), + "severity": record.levelname, + "logger": record.name, + "event": record.getMessage(), + } + + span = trace.get_current_span() + ctx = span.get_span_context() if span else None + if ctx is not None and ctx.is_valid: + payload["trace_id"] = format(ctx.trace_id, "032x") + payload["span_id"] = format(ctx.span_id, "016x") + + for key in ("request_id", "instance_id", "service_name", "attempt", + "job_id", "attachment_id", "event_kind"): + if hasattr(record, key): + payload[key] = getattr(record, key) + + if record.exc_info: + payload["exception"] = self.formatException(record.exc_info) + + return json.dumps(payload, ensure_ascii=False, default=str) + + +def configure_logging(service_name: str, level: int = logging.INFO) -> None: + root = logging.getLogger() + for handler in list(root.handlers): + root.removeHandler(handler) + + handler = logging.StreamHandler(stream=sys.stdout) + handler.setFormatter(JsonFormatter()) + root.addHandler(handler) + root.setLevel(level) + + for noisy in ("urllib3", "botocore", "boto3", "pika", "uvicorn.access"): + logging.getLogger(noisy).setLevel(logging.WARNING) + + logging.getLogger().info( + "logging configured", extra={"service_name": service_name} + ) \ No newline at end of file diff --git a/src/main.py b/src/main.py new file mode 100755 index 0000000..8500d1b --- /dev/null +++ b/src/main.py @@ -0,0 +1,560 @@ +from __future__ import annotations + +import logging +import os +import re +from contextlib import asynccontextmanager +from typing import Optional +import uuid +from uuid import UUID + +from fastapi import Depends, FastAPI, Header, Query, Request, Response +from fastapi.exceptions import RequestValidationError +from fastapi.responses import JSONResponse +from starlette.exceptions import HTTPException as StarletteHTTPException + +from . import auth +from .db import close_pool, init_pool +from . import storage +from . import broker, storage +from .errors import ( + RequestIdMiddleware, + _envelope, + _rid, + api_error_handler, + json_decode_handler, + unhandled_handler, + validation_handler, +) +from .schemas import ( + Chat, + ChatPage, + CreateChat, + CreateMessage, + CreateUser, + Health, + Message, + MessagePage, + Session, + User, + Attachment, +) +from .store import ( + ApiError, + BadRequest, + Conflict, + NotFound, + PayloadTooLarge, + Unavailable, + UnsupportedMediaType, + Unauthorized, + store, + iso, +) +from .cache import close_cache, init_cache + +from .instance import INSTANCE_ID + +from . import otel as otel_module +from .logging_config import configure_logging +import time as _time +from prometheus_client import ( + Counter as _PromCounter, + Histogram as _PromHistogram, + Gauge as _PromGauge, + CollectorRegistry as _PromRegistry, + generate_latest as _prom_generate, + CONTENT_TYPE_LATEST as _PROM_CONTENT_TYPE, +) + +configure_logging("messenger-api") +log = logging.getLogger("messenger") + + +_PROM_REGISTRY = _PromRegistry() +_HTTP_REQUESTS = _PromCounter( + "http_requests_total", + "HTTP requests by method, route template, status class", + ["method", "route", "status_class"], + registry=_PROM_REGISTRY, +) +_HTTP_DURATION = _PromHistogram( + "http_request_duration_seconds", + "HTTP request duration in seconds", + ["method", "route", "status_class"], + buckets=(0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.0, 2.5, 5.0, 10.0), + registry=_PROM_REGISTRY, +) +_PROM_GAUGE_POOL_USED = _PromGauge( + "db_pool_used", + "DB pool connections currently in use", + registry=_PROM_REGISTRY, +) +_PROM_GAUGE_POOL_AVAILABLE = _PromGauge( + "db_pool_available", + "DB pool connections currently available", + registry=_PROM_REGISTRY, +) +_PROM_GAUGE_POOL_WAITING = _PromGauge( + "db_pool_waiting", + "Requests waiting for a DB connection", + registry=_PROM_REGISTRY, +) + + +def _refresh_db_pool_metrics(): + from . import db as _db + pool = _db._pool + if pool is None: + return + try: + stats = pool.get_stats() + except Exception: + return + used = max(0, stats.get("pool_size", 0) - stats.get("pool_available", 0)) + _PROM_GAUGE_POOL_USED.set(used) + _PROM_GAUGE_POOL_AVAILABLE.set(stats.get("pool_available", 0)) + _PROM_GAUGE_POOL_WAITING.set(stats.get("requests_waiting", 0)) + + +@asynccontextmanager +async def lifespan(app: FastAPI): + otel_module.setup_otel("messenger-api") + otel_module.instrument_libraries(psycopg=True, redis=True, botocore=True) + init_pool() + init_cache() + storage.init_storage() + log.info("instance_id=%s", INSTANCE_ID) + log.info("db pool, cache, storage initialized") + try: + yield + finally: + close_cache() + close_pool() + log.info("db pool and cache closed") + + +app = FastAPI(title="MTUSI Messenger lab2", version="1.2.0", lifespan=lifespan) +app.add_middleware(RequestIdMiddleware) + +otel_module.instrument_fastapi(app) + +from starlette.middleware.base import BaseHTTPMiddleware + + +class MetricsMiddleware(BaseHTTPMiddleware): + + async def dispatch(self, request: Request, call_next): + if request.url.path in ("/health/live", "/health/ready", "/metrics"): + return await call_next(request) + + start = _time.monotonic() + response = await call_next(request) + elapsed = _time.monotonic() - start + + route = request.scope.get("route") + route_template = getattr(route, "path", None) or request.url.path + status_class = f"{response.status_code // 100}xx" + + _HTTP_REQUESTS.labels( + method=request.method, route=route_template, status_class=status_class + ).inc() + _HTTP_DURATION.labels( + method=request.method, route=route_template, status_class=status_class + ).observe(elapsed) + + return response + +app.add_middleware(MetricsMiddleware) + +app.add_exception_handler(ApiError, api_error_handler) +app.add_exception_handler(RequestValidationError, validation_handler) +app.add_exception_handler(Exception, unhandled_handler) + + +@app.exception_handler(StarletteHTTPException) +async def _http_exc(request: Request, exc: StarletteHTTPException): + code = "not_found" if exc.status_code == 404 else "invalid_request" + return JSONResponse( + status_code=exc.status_code, + content=_envelope(code, str(exc.detail), _rid(request)), + ) + +# ---------- утилиты валидации ---------- + +def valid_uuid(value: str, name: str = "id") -> str: + try: + UUID(value) + except (ValueError, TypeError, AttributeError): + raise BadRequest(f"Invalid {name}") + return value + +# ---------- зависимости ---------- + +def _parse_basic(header_value: str) -> tuple[str, str]: + import base64 + if not header_value.lower().startswith("basic "): + raise Unauthorized("Basic authentication required") + try: + raw = base64.b64decode(header_value.split(" ", 1)[1], validate=True) + decoded = raw.decode("utf-8") + username, _, password = decoded.partition(":") + if not username: + raise ValueError("empty username") + return username, password + except Exception: + raise Unauthorized("Invalid Basic credentials") from None + + +def _bearer_token(authorization: Optional[str]) -> str: + if not authorization: + raise Unauthorized("Missing Authorization header") + parts = authorization.split(" ", 1) + if len(parts) != 2 or parts[0].lower() != "bearer": + raise Unauthorized("Bearer token required") + token = parts[1].strip() + if not token: + raise Unauthorized("Empty bearer token") + return token + + +def current_user_id( + authorization: Optional[str] = Header(default=None), +) -> str: + token = _bearer_token(authorization) + user_id = auth.get_user_id_by_token(token) + if user_id is None: + raise Unauthorized("Invalid or expired token") + return user_id + + +# ---------- health ---------- + +@app.get("/health/live", response_model=Health) +def liveness(): + return {"status": "ok"} + + +@app.get("/health/ready", response_model=Health) +def readiness(request: Request): + try: + from .db import transaction + with transaction() as conn: + with conn.cursor() as cur: + cur.execute("SELECT 1") + except Exception: + rid = _rid(request) + response = JSONResponse( + status_code=503, + content=_envelope("unavailable", "Database unavailable", rid), + ) + response.headers["X-Request-Id"] = rid + response.headers["X-Instance-Id"] = INSTANCE_ID + return response + + try: + storage.check_bucket() + except Exception: + rid = _rid(request) + response = JSONResponse( + status_code=503, + content=_envelope("unavailable", "S3 unavailable", rid), + ) + response.headers["X-Request-Id"] = rid + response.headers["X-Instance-Id"] = INSTANCE_ID + return response + + return {"status": "ok"} + +@app.get("/metrics", include_in_schema=False) +def metrics_endpoint(): + _refresh_db_pool_metrics() + data = _prom_generate(_PROM_REGISTRY) + return Response(content=data, media_type=_PROM_CONTENT_TYPE) + +# ---------- users ---------- + +@app.post("/api/v1/users", status_code=201, response_model=User) +def register_user(body: CreateUser): + password_hash = auth.hash_password(body.password) + return store.create_user(body.username, body.display_name, password_hash) + + +@app.get("/api/v1/users/me", response_model=User) +def me(user_id: str = Depends(current_user_id)): + user = store.get_user(user_id) + if user is None: + raise Unauthorized("User not found") + return user + + +# ---------- auth ---------- + +@app.post("/api/v1/auth/sessions", status_code=201, response_model=Session) +def create_session(authorization: Optional[str] = Header(default=None)): + username, password = _parse_basic(authorization or "") + row = store.get_user_by_username(username) + if row is None or not auth.verify_password(password, row["password_hash"]): + raise Unauthorized("Invalid credentials") + session = auth.create_session(str(row["id"])) + user = store.get_user(str(row["id"])) + if user is None: + raise Unauthorized("User not found") + return { + "token": session["token"], + "token_type": "Bearer", + "expires_at": iso(session["expires_at"]), + "user": user, + } + + +@app.delete("/api/v1/auth/sessions/current", status_code=204) +def logout(authorization: Optional[str] = Header(default=None)): + token = _bearer_token(authorization) + user_id = auth.get_user_id_by_token(token) + if user_id is None: + raise Unauthorized("Invalid or expired token") + auth.revoke_session(token) + return Response(status_code=204) + + +# ---------- chats ---------- + +@app.post("/api/v1/chats", status_code=201, response_model=Chat) +def create_chat(body: CreateChat, user_id: str = Depends(current_user_id)): + return store.create_chat(body.title, body.member_ids, user_id) + + +@app.get("/api/v1/chats", response_model=ChatPage) +def list_chats( + limit: int = Query(default=50, ge=1, le=100), + cursor: Optional[str] = Query(default=None, min_length=1), + user_id: str = Depends(current_user_id), +): + items, next_cursor = store.list_chats(user_id, limit, cursor) + return {"items": items, "next_cursor": next_cursor} + + +@app.get("/api/v1/chats/{chat_id}", response_model=Chat) +def get_chat(chat_id: str, user_id: str = Depends(current_user_id)): + chat_id = valid_uuid(chat_id, "chat_id") + chat = store.get_chat(chat_id, user_id) + if chat is None: + raise NotFound() + return chat + + +# ---------- messages ---------- + +@app.post("/api/v1/chats/{chat_id}/messages", status_code=201, response_model=Message) +def create_message( + chat_id: str, + body: CreateMessage, + user_id: str = Depends(current_user_id), + idempotency_key: Optional[str] = Header(default=None, alias="Idempotency-Key"), +): + chat_id = valid_uuid(chat_id, "chat_id") + if not idempotency_key: + raise BadRequest("Idempotency-Key header is required") + if not re.match(r"^[A-Za-z0-9._:-]{1,128}$", idempotency_key): + raise BadRequest("Invalid Idempotency-Key format") + + message, status = store.add_message( + chat_id, user_id, body.text, idempotency_key, body.attachment_ids + ) + if status != 201: + raise Conflict(f"Idempotency error: {status}") + return message + +@app.get("/api/v1/chats/{chat_id}/messages", response_model=MessagePage) +def list_messages( + chat_id: str, + limit: int = Query(default=50, ge=1, le=100), + cursor: Optional[str] = Query(default=None, min_length=1), + user_id: str = Depends(current_user_id), +): + chat_id = valid_uuid(chat_id, "chat_id") + items, next_cursor = store.list_messages(chat_id, user_id, limit, cursor) + return {"items": items, "next_cursor": next_cursor} + + +# ---------- attachments (lab4) ---------- + +MAX_UPLOAD_BYTES = int(os.environ.get("MAX_UPLOAD_BYTES", "10485760")) +MAX_IMAGE_PIXELS = int(os.environ.get("MAX_IMAGE_PIXELS", "40000000")) +ALLOWED_MIMES = {"image/png", "image/jpeg"} + +from PIL import Image as _PILImage +_PILImage.MAX_IMAGE_PIXELS = MAX_IMAGE_PIXELS + + +import unicodedata + +def _validate_filename(filename: str) -> None: + if not filename: + raise BadRequest("filename is required") + if len(filename) > 255: + raise BadRequest("filename too long") + for ch in filename: + if ch in ("/", "\\"): + raise BadRequest("filename contains forbidden characters") + if unicodedata.category(ch) == "Cc": + raise BadRequest("filename contains control characters") + + +def _sniff_mime(data: bytes) -> str: + if data.startswith(b"\x89PNG\r\n\x1a\n"): + return "image/png" + if data.startswith(b"\xff\xd8\xff"): + return "image/jpeg" + raise UnsupportedMediaType("Only PNG and JPEG are supported") + + +def _validate_image(data: bytes) -> tuple[int, int]: + from PIL import Image + import io + try: + img = Image.open(io.BytesIO(data)) + w, h = img.size + if w * h > MAX_IMAGE_PIXELS: + raise PayloadTooLarge( + f"Image too large: {w*h} pixels (max {MAX_IMAGE_PIXELS})" + ) + img.load() + except PayloadTooLarge: + raise + except Image.DecompressionBombError: + raise PayloadTooLarge( + f"Image too large (decompression bomb protection)" + ) from None + except Exception: + raise UnsupportedMediaType("Image is corrupted or unsupported") from None + return w, h + + +@app.post( + "/api/v1/chats/{chat_id}/attachments", + status_code=202, + response_model=Attachment, +) +async def upload_attachment( + chat_id: str, + request: Request, + filename: str = Query(..., min_length=1, max_length=255), + user_id: str = Depends(current_user_id), +): + chat_id = valid_uuid(chat_id, "chat_id") + _validate_filename(filename) + + content_length = request.headers.get("content-length") + if content_length is not None: + try: + if int(content_length) > MAX_UPLOAD_BYTES: + raise PayloadTooLarge( + f"File too large: {content_length} bytes (max {MAX_UPLOAD_BYTES})" + ) + except ValueError: + raise BadRequest("Invalid Content-Length") from None + + client_ct = (request.headers.get("content-type") or "").split(";")[0].strip().lower() + if client_ct not in ALLOWED_MIMES: + raise UnsupportedMediaType( + f"Content-Type must be image/png or image/jpeg, got {client_ct!r}" + ) + + body = bytearray() + async for chunk in request.stream(): + body.extend(chunk) + if len(body) > MAX_UPLOAD_BYTES: + raise PayloadTooLarge( + f"File too large: > {MAX_UPLOAD_BYTES} bytes" + ) + data = bytes(body) + + real_mime = _sniff_mime(data) + + _validate_image(data) + + ext = "png" if real_mime == "image/png" else "jpg" + staging_key = f"staging/{uuid.uuid4().hex}.{ext}" + try: + sha256 = storage.put_object(staging_key, data, real_mime) + except Exception as exc: + import logging + logging.getLogger("messenger").warning("S3 staging upload failed: %s", exc) + raise Unavailable("S3 unavailable") from exc + + try: + attachment = store.create_attachment( + chat_id=chat_id, owner_id=user_id, filename=filename, + content_type=real_mime, size_bytes=len(data), + sha256=sha256, s3_key=staging_key, staging_key=staging_key, + status="queued", + ) + except Exception: + storage.delete_object(staging_key) + raise + + job = store.create_job(attachment["id"]) + log.info("job %s created (pending), relay will publish", job["job_id"]) + + return attachment + + +@app.get( + "/api/v1/attachments/{attachment_id}", + response_model=Attachment, +) +def get_attachment( + attachment_id: str, + user_id: str = Depends(current_user_id), +): + attachment_id = valid_uuid(attachment_id, "attachment_id") + att = store.get_attachment(attachment_id, user_id) + if att is None: + raise NotFound() + att.pop("s3_key", None) + return att + + +@app.get("/api/v1/attachments/{attachment_id}/content") +def download_attachment( + attachment_id: str, + variant: str = Query(default="original"), + user_id: str = Depends(current_user_id), +): + attachment_id = valid_uuid(attachment_id, "attachment_id") + att = store.get_attachment(attachment_id, user_id) + if att is None: + raise NotFound() + if att["status"] != "ready": + raise Conflict(f"Attachment not ready: {att['status']}") + variants_map = { + "thumbnail": ("thumbnails/{}.jpg", "image/jpeg"), + "crop": ("crops/{}.jpg", "image/jpeg"), + "optimized": ("optimized/{}.webp", "image/webp"), + } + if variant == "original": + s3_key = att["s3_key"] + media_type = att["content_type"] + elif variant in variants_map: + found = [v for v in att["variants"] if v["name"] == variant] + if not found: + raise NotFound() + pattern, media_type = variants_map[variant] + s3_key = pattern.format(attachment_id) + else: + raise NotFound() + data = storage.get_object(s3_key) + return Response(content=data, media_type=media_type) + +def main() -> None: + import uvicorn + + host = os.environ.get("APP_HOST", "0.0.0.0") + port = int(os.environ.get("APP_PORT", "8080")) + uvicorn.run("src.main:app", host=host, port=port, log_level="info") + + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/src/otel.py b/src/otel.py new file mode 100644 index 0000000..74eaf5a --- /dev/null +++ b/src/otel.py @@ -0,0 +1,198 @@ +from __future__ import annotations + +import atexit +import logging +import os +import socket +import uuid +from typing import Iterable + +from opentelemetry import metrics, trace +from opentelemetry.exporter.otlp.proto.http.metric_exporter import OTLPMetricExporter +from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter +from opentelemetry.sdk.metrics import MeterProvider +from opentelemetry.sdk.metrics.export import PeriodicExportingMetricReader +from opentelemetry.sdk.resources import ( + DEPLOYMENT_ENVIRONMENT, + SERVICE_INSTANCE_ID, + SERVICE_NAME, + SERVICE_VERSION, + Resource, +) +from opentelemetry.sdk.trace import TracerProvider +from opentelemetry.sdk.trace.export import BatchSpanProcessor +from opentelemetry.sdk.trace.sampling import ParentBased, TraceIdRatioBased +from opentelemetry.exporter.otlp.proto.http._log_exporter import OTLPLogExporter +from opentelemetry.sdk._logs import LoggerProvider, LoggingHandler +from opentelemetry.sdk._logs.export import BatchLogRecordProcessor +from opentelemetry import _logs as otel_logs + +_initialized = False +_tracer_provider: TracerProvider | None = None +_meter_provider: MeterProvider | None = None +_logger_provider: LoggerProvider | None = None + + +def _endpoint() -> str: + return os.environ.get("OTEL_EXPORTER_OTLP_ENDPOINT", "http://otel-collector:4318") + + +def _service_name() -> str: + return os.environ.get("OTEL_SERVICE_NAME", "messenger-api") + + +def _service_version() -> str: + return os.environ.get("SERVICE_VERSION", "1.6.0") + + +def _deployment_env() -> str: + return os.environ.get("OTEL_RESOURCE_ATTRIBUTES_DEPLOYMENT_ENV", "lab") + + +def _sampler_ratio() -> float: + try: + return float(os.environ.get("OTEL_TRACES_SAMPLER_ARG", "1.0")) + except ValueError: + return 1.0 + + +def _build_resource(service_name: str, extra: dict | None = None) -> Resource: + instance = os.environ.get("INSTANCE_ID") or socket.gethostname() or uuid.uuid4().hex[:8] + attrs = { + SERVICE_NAME: service_name, + SERVICE_VERSION: _service_version(), + SERVICE_INSTANCE_ID: instance, + DEPLOYMENT_ENVIRONMENT: _deployment_env(), + "service.namespace": "messenger", + } + if extra: + attrs.update(extra) + return Resource.create(attrs) + + +def setup_otel( + service_name: str | None = None, + extra_resource: dict | None = None, + *, + enable_traces: bool = True, + enable_metrics: bool = True, + enable_logs: bool = True, +) -> tuple[trace.Tracer, metrics.Meter]: + global _initialized, _tracer_provider, _meter_provider, _logger_provider + + if _initialized: + return ( + trace.get_tracer(_service_name()), + metrics.get_meter(_service_name()), + ) + + svc = service_name or _service_name() + resource = _build_resource(svc, extra_resource) + + if enable_traces: + tracer_provider = TracerProvider( + resource=resource, + sampler=ParentBased(TraceIdRatioBased(_sampler_ratio())), + ) + span_exporter = OTLPSpanExporter(endpoint=f"{_endpoint()}/v1/traces") + tracer_provider.add_span_processor( + BatchSpanProcessor( + span_exporter, + max_queue_size=2048, + max_export_batch_size=512, + schedule_delay_millis=5000, + export_timeout_millis=10000, + ) + ) + trace.set_tracer_provider(tracer_provider) + _tracer_provider = tracer_provider + + if enable_metrics: + metric_exporter = OTLPMetricExporter(endpoint=f"{_endpoint()}/v1/metrics") + reader = PeriodicExportingMetricReader( + metric_exporter, + export_interval_millis=10000, + export_timeout_millis=10000, + ) + meter_provider = MeterProvider(resource=resource, metric_readers=[reader]) + metrics.set_meter_provider(meter_provider) + _meter_provider = meter_provider + + if enable_logs: + logger_provider = LoggerProvider(resource=resource) + log_exporter = OTLPLogExporter(endpoint=f"{_endpoint()}/v1/logs") + logger_provider.add_log_record_processor( + BatchLogRecordProcessor( + log_exporter, + max_queue_size=2048, + max_export_batch_size=512, + schedule_delay_millis=5000, + export_timeout_millis=10000, + ) + ) + otel_logs.set_logger_provider(logger_provider) + _logger_provider = logger_provider + + root = logging.getLogger() + otel_handler = LoggingHandler(level=logging.INFO, logger_provider=logger_provider) + root.addHandler(otel_handler) + + _initialized = True + logging.getLogger(__name__).info( + "otel initialized", + extra={"service_name": svc, "event_kind": "otel_init"}, + ) + atexit.register(shutdown_otel) + return trace.get_tracer(svc), metrics.get_meter(svc) + + +def shutdown_otel() -> None: + global _initialized, _tracer_provider, _meter_provider, _logger_provider + if not _initialized: + return + try: + if _tracer_provider is not None: + _tracer_provider.shutdown() + if _meter_provider is not None: + _meter_provider.shutdown() + if _logger_provider is not None: + _logger_provider.shutdown() + except Exception: + pass + _initialized = False + + +def instrument_fastapi(app) -> None: + from opentelemetry.instrumentation.fastapi import FastAPIInstrumentor + + FastAPIInstrumentor.instrument_app( + app, + tracer_provider=trace.get_tracer_provider(), + excluded_urls="health/live,health/ready,metrics", # не засоряем трейсы + ) + + +def instrument_libraries( + *, + psycopg: bool = False, + redis: bool = False, + botocore: bool = False, +) -> None: + if psycopg: + try: + from opentelemetry.instrumentation.psycopg import PsycopgInstrumentor + PsycopgInstrumentor().instrument(tracer_provider=trace.get_tracer_provider()) + except Exception: + pass + if redis: + try: + from opentelemetry.instrumentation.redis import RedisInstrumentor + RedisInstrumentor().instrument(tracer_provider=trace.get_tracer_provider()) + except Exception: + pass + if botocore: + try: + from opentelemetry.instrumentation.botocore import BotocoreInstrumentor + BotocoreInstrumentor().instrument(tracer_provider=trace.get_tracer_provider()) + except Exception: + pass \ No newline at end of file diff --git a/src/relay.py b/src/relay.py new file mode 100644 index 0000000..b5d3f97 --- /dev/null +++ b/src/relay.py @@ -0,0 +1,171 @@ +from __future__ import annotations + +import logging +import time +import os + +from . import broker +from .db import close_pool, init_pool, transaction +from .store import iso + +from . import otel as otel_module +from .logging_config import configure_logging +from prometheus_client import ( + Gauge as _PromGauge, + CollectorRegistry as _PromRegistry, + generate_latest as _prom_generate, + CONTENT_TYPE_LATEST as _PROM_CONTENT_TYPE, +) + +configure_logging("messenger-relay") +log = logging.getLogger("messenger.relay") + +_PROM_REGISTRY = _PromRegistry() +_JOBS_OLDEST_AGE = _PromGauge( + "jobs_oldest_pending_age_seconds", + "Age of the oldest job in pending/processing state (seconds)", + registry=_PROM_REGISTRY, +) +_JOBS_PENDING = _PromGauge( + "jobs_pending_count", + "Number of jobs currently in 'pending' outbox state", + registry=_PROM_REGISTRY, +) +_JOBS_PROCESSING = _PromGauge( + "jobs_processing_count", + "Number of jobs currently in 'processing' state (leased)", + registry=_PROM_REGISTRY, +) + + +def _publish_pending() -> int: + published = 0 + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + """ + SELECT job_id, attachment_id, pipeline_version, attempt, + created_at, traceparent, tracestate + FROM jobs + WHERE status = 'pending' + ORDER BY created_at + LIMIT 10 + FOR UPDATE SKIP LOCKED + """ + ) + jobs = cur.fetchall() + for job in jobs: + job_dict = { + "schema_version": 1, + "job_id": str(job["job_id"]), + "type": "attachment.process.v1", + "attachment_id": str(job["attachment_id"]), + "pipeline_version": int(job["pipeline_version"]), + "attempt": int(job["attempt"]), + "created_at": iso(job["created_at"]), + "_traceparent": job["traceparent"], + "_tracestate": job["tracestate"], + } + try: + broker.publish_job(job_dict) + cur.execute( + "UPDATE jobs SET status='published', published_at=NOW() WHERE job_id=%s", + (job["job_id"],), + ) + published += 1 + except Exception as exc: + log.warning("publish failed for %s: %s", job["job_id"], exc) + return published + + +def _reclaim_expired() -> int: + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + """ + UPDATE jobs + SET status = 'pending', lease_until = NULL + WHERE status = 'processing' + AND lease_until < NOW() + RETURNING job_id + """ + ) + rows = cur.fetchall() + return len(rows) + + +def _refresh_gauges() -> None: + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + """ + SELECT + COALESCE(EXTRACT(EPOCH FROM NOW() - MIN(created_at)), 0) + FROM jobs WHERE status IN ('pending', 'processing') + """ + ) + age = float(cur.fetchone()[0] if cur.rowcount else 0.0) + cur.execute("SELECT COUNT(*) FROM jobs WHERE status='pending'") + pending = int(cur.fetchone()[0]) + cur.execute("SELECT COUNT(*) FROM jobs WHERE status='processing'") + processing = int(cur.fetchone()[0]) + _JOBS_OLDEST_AGE.set(max(0.0, age)) + _JOBS_PENDING.set(pending) + _JOBS_PROCESSING.set(processing) + + +def main() -> None: + otel_module.setup_otel("messenger-relay") + otel_module.instrument_libraries(psycopg=True) + + init_pool() + + import threading + from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer + + class MetricsHandler(BaseHTTPRequestHandler): + def do_GET(self): + if self.path == "/metrics": + data = _prom_generate(_PROM_REGISTRY) + self.send_response(200) + self.send_header("Content-Type", _PROM_CONTENT_TYPE) + self.send_header("Content-Length", str(len(data))) + self.end_headers() + self.wfile.write(data) + elif self.path == "/health/live": + self.send_response(200) + self.send_header("Content-Type", "application/json") + self.end_headers() + self.wfile.write(b'{"status":"ok"}') + else: + self.send_response(404) + self.end_headers() + + def log_message(self, *args): + pass + + metrics_port = int(os.environ.get("RELAY_METRICS_PORT", "9101")) + httpd = ThreadingHTTPServer(("0.0.0.0", metrics_port), MetricsHandler) + threading.Thread(target=httpd.serve_forever, daemon=True, name="metrics-http").start() + log.info("relay metrics on :%d/metrics", metrics_port) + + log.info("relay started") + try: + while True: + try: + n = _publish_pending() + if n: + log.info("published %d pending jobs", n) + _refresh_gauges() + except Exception as exc: + log.exception("relay iteration failed: %s", exc) + time.sleep(1) + except KeyboardInterrupt: + pass + finally: + otel_module.shutdown_otel() + close_pool() + + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/src/schemas.py b/src/schemas.py new file mode 100755 index 0000000..c2d9911 --- /dev/null +++ b/src/schemas.py @@ -0,0 +1,181 @@ +from __future__ import annotations + +import re +import uuid +from typing import List, Optional + +from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator + +USERNAME_RE = re.compile(r"^[a-z0-9_]{3,32}$") + + +class StrictModel(BaseModel): + model_config = ConfigDict(extra="forbid", str_strip_whitespace=False) + + +# ---------- Users ---------- + +class CreateUser(StrictModel): + username: str = Field(min_length=3, max_length=32) + display_name: str = Field(min_length=1, max_length=100) + password: str = Field(min_length=12, max_length=128) + + @field_validator("username") + @classmethod + def _username(cls, v: str) -> str: + if not USERNAME_RE.match(v): + raise ValueError("username must match [a-z0-9_]{3,32}") + return v + + @field_validator("display_name") + @classmethod + def _display_name(cls, v: str) -> str: + if not v.strip(): + raise ValueError("display_name must not be blank") + if len(v) > 100: + raise ValueError("display_name too long") + return v + + +class User(StrictModel): + id: str + username: str + display_name: str + created_at: str + + +# ---------- Chats ---------- + +class CreateChat(StrictModel): + title: str = Field(min_length=1, max_length=100) + member_ids: List[str] = Field(min_length=1, max_length=100) + + @field_validator("title") + @classmethod + def _title(cls, v: str) -> str: + if not v.strip(): + raise ValueError("title must not be blank") + return v + + @field_validator("member_ids") + @classmethod + def _members(cls, v: List[str]) -> List[str]: + if len(set(v)) != len(v): + raise ValueError("member_ids must be unique") + for item in v: + try: + uuid.UUID(item) + except ValueError as exc: + raise ValueError("member_ids must be UUIDs") from exc + return v + + +class Chat(StrictModel): + id: str + title: str + member_ids: List[str] + created_at: str + + +class ChatPage(StrictModel): + items: List[Chat] + next_cursor: Optional[str] = None + + +# ---------- Attachments (lab4) ---------- + +class Variant(StrictModel): + name: str + content_type: str + size_bytes: int = Field(ge=1) + width: int = Field(ge=1) + height: int = Field(ge=1) + sha256: str = Field(pattern=r"^[a-f0-9]{64}$") + + +class Attachment(StrictModel): + id: str + chat_id: str + owner_id: str + filename: str = Field(min_length=1, max_length=255) + content_type: str # image/png или image/jpeg + size_bytes: int = Field(ge=1, le=10485760) + sha256: str = Field(pattern=r"^[a-f0-9]{64}$") + status: str # 'ready' в lab4 + variants: List[Variant] = Field(default_factory=list) + error_code: Optional[str] = None + created_at: str + updated_at: str + + +# ---------- Messages ---------- + +class CreateMessage(StrictModel): + text: str = Field(default="", max_length=4000) + attachment_ids: List[str] = Field(default_factory=list, max_length=10) + + @field_validator("text") + @classmethod + def _text(cls, v: str) -> str: + if len(v) > 4000: + raise ValueError("text too long") + return v + + @field_validator("attachment_ids") + @classmethod + def _attachments(cls, v: List[str]) -> List[str]: + if len(set(v)) != len(v): + raise ValueError("attachment_ids must be unique") + for item in v: + try: + uuid.UUID(item) + except ValueError as exc: + raise ValueError("attachment_ids must be UUIDs") from exc + return v + + @model_validator(mode="after") + def _text_or_attachment(self) -> "CreateMessage": + has_text = bool(self.text and self.text.strip()) + has_attachment = bool(self.attachment_ids) + if not has_text and not has_attachment: + raise ValueError("text must be non-blank or attachment_ids must be non-empty") + return self + + +class Message(StrictModel): + id: str + chat_id: str + sender_id: str + text: str + created_at: str + attachment_ids: List[str] = Field(default_factory=list) + + +class MessagePage(StrictModel): + items: List[Message] + next_cursor: Optional[str] = None + + +# ---------- Sessions ---------- + +class Session(StrictModel): + token: str = Field(min_length=32) + token_type: str = Field(default="Bearer") + expires_at: str + user: User + + +# ---------- Misc ---------- + +class Health(StrictModel): + status: str = "ok" + + +class ErrorBody(StrictModel): + code: str + message: str + request_id: str + + +class ErrorEnvelope(StrictModel): + error: ErrorBody \ No newline at end of file diff --git a/src/storage.py b/src/storage.py new file mode 100644 index 0000000..24eff09 --- /dev/null +++ b/src/storage.py @@ -0,0 +1,101 @@ +from __future__ import annotations + +import hashlib +import io +import logging +import os +import uuid +from typing import Optional + +import boto3 +from botocore.client import Config +from botocore.exceptions import ClientError + +log = logging.getLogger("messenger.storage") + +_client = None + + +def _env(name: str, default: Optional[str] = None) -> str: + value = os.environ.get(name, default) + if value is None: + raise RuntimeError(f"Environment variable {name} is required") + return value + + +def init_storage() -> None: + global _client + if _client is not None: + return + _client = boto3.client( + "s3", + endpoint_url=_env("S3_ENDPOINT"), + region_name=_env("S3_REGION", "us-east-1"), + aws_access_key_id=_env("S3_ACCESS_KEY_ID"), + aws_secret_access_key=_env("S3_SECRET_ACCESS_KEY"), + config=Config( + signature_version="s3v4", + s3={"addressing_style": "path"}, + connect_timeout=1.0, + read_timeout=2.0, + retries={"max_attempts": 1, "mode": "standard"}, + ), + ) + log.info("storage client initialized") + + +def _bucket() -> str: + return _env("S3_BUCKET", "messenger-attachments") + + +def new_object_key(content_type: str) -> str: + ext = "png" if content_type == "image/png" else "jpg" + return f"attachments/{uuid.uuid4().hex}.{ext}" + + +def put_object(key: str, body: bytes, content_type: str) -> str: + if _client is None: + raise RuntimeError("storage not initialized") + sha256 = hashlib.sha256(body).hexdigest() + _client.put_object( + Bucket=_bucket(), + Key=key, + Body=body, + ContentType=content_type, + Metadata={"sha256": sha256}, + ) + return sha256 + + +def get_object(key: str) -> bytes: + if _client is None: + raise RuntimeError("storage not initialized") + response = _client.get_object(Bucket=_bucket(), Key=key) + return response["Body"].read() + + +def delete_object(key: str) -> None: + if _client is None: + return + try: + _client.delete_object(Bucket=_bucket(), Key=key) + except ClientError as exc: + log.warning("failed to delete object %s: %s", key, exc) + + +def object_exists(key: str) -> bool: + if _client is None: + return False + try: + _client.head_object(Bucket=_bucket(), Key=key) + return True + except ClientError as exc: + if exc.response["Error"]["Code"] in ("404", "NoSuchKey"): + return False + raisev + + +def check_bucket() -> None: + if _client is None: + raise RuntimeError("storage not initialized") + _client.head_bucket(Bucket=_bucket()) \ No newline at end of file diff --git a/src/store.py b/src/store.py new file mode 100755 index 0000000..32fc957 --- /dev/null +++ b/src/store.py @@ -0,0 +1,592 @@ +from __future__ import annotations + +import base64 +import hashlib +import json +import uuid +from datetime import datetime, timezone +from typing import List, Optional, Tuple + +import psycopg +from psycopg.errors import UniqueViolation + +from .db import transaction + +from opentelemetry.propagate import inject as otel_inject +from opentelemetry.trace.propagation.tracecontext import TraceContextTextMapPropagator + + +# ---------- ошибки ---------- + +class ApiError(Exception): + status = 500 + code = "internal_error" + + def __init__(self, message: str = "Internal error") -> None: + super().__init__(message) + self.message = message + + +class BadRequest(ApiError): + status = 400 + code = "invalid_request" + + +class Unauthorized(ApiError): + status = 401 + code = "unauthorized" + + +class NotFound(ApiError): + status = 404 + code = "not_found" + + +class Conflict(ApiError): + status = 409 + code = "conflict" + + +class PayloadTooLarge(ApiError): + status = 413 + code = "payload_too_large" + + +class UnsupportedMediaType(ApiError): + status = 415 + code = "unsupported_media_type" + + +class Unavailable(ApiError): + status = 503 + code = "unavailable" + + +# ---------- утилиты ---------- + +def _now() -> datetime: + return datetime.now(timezone.utc) + + +def iso(dt: datetime) -> str: + return dt.astimezone(timezone.utc).strftime("%Y-%m-%dT%H:%M:%S.%fZ") + + +def _user_dict(row: dict) -> dict: + return { + "id": str(row["id"]), + "username": row["username"], + "display_name": row["display_name"], + "created_at": iso(row["created_at"]), + } + + +def _chat_dict(row: dict, member_ids: List[str]) -> dict: + return { + "id": str(row["id"]), + "title": row["title"], + "member_ids": member_ids, + "created_at": iso(row["created_at"]), + } + + +def _message_dict(row: dict, attachment_ids: List[str]) -> dict: + return { + "id": str(row["id"]), + "chat_id": str(row["chat_id"]), + "sender_id": str(row["sender_id"]), + "text": row["text"], + "created_at": iso(row["created_at"]), + "attachment_ids": attachment_ids, + } + + +# ---------- курсор ---------- + +def _encode_cursor(scope: str, created_at: str, item_id: str) -> str: + payload = json.dumps( + {"s": scope, "t": created_at, "i": item_id}, separators=(",", ":") + ).encode() + return base64.urlsafe_b64encode(payload).decode().rstrip("=") + + +def _decode_cursor(scope: str, cursor: str) -> Tuple[str, str]: + pad = "=" * (-len(cursor) % 4) + try: + raw = base64.urlsafe_b64decode(cursor + pad) + data = json.loads(raw) + if data.get("s") != scope: + raise ValueError("scope mismatch") + t = data.get("t") + i = data.get("i") + if not isinstance(t, str) or not isinstance(i, str): + raise ValueError("invalid cursor fields") + from datetime import datetime + from uuid import UUID + try: + datetime.fromisoformat(t.replace("Z", "+00:00")) + except (ValueError, TypeError): + raise ValueError("invalid timestamp in cursor") from None + try: + UUID(i) + except (ValueError, TypeError): + raise ValueError("invalid uuid in cursor") from None + return t, i + except Exception as exc: + raise BadRequest("invalid cursor") from exc + +# ---------- Store ---------- + +class Store: + + # ---- users ---- + + def create_user( + self, username: str, display_name: str, password_hash: str + ) -> dict: + uid = str(uuid.uuid4()) + now = _now() + try: + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + """ + INSERT INTO users (id, username, display_name, password_hash, created_at) + VALUES (%s, %s, %s, %s, %s) + """, + (uid, username, display_name, password_hash, now), + ) + except UniqueViolation: + raise Conflict("username already taken") from None + return { + "id": uid, + "username": username, + "display_name": display_name, + "created_at": iso(now), + } + + def get_user(self, user_id: str) -> Optional[dict]: + with transaction() as conn: + with conn.cursor() as cur: + cur.execute("SELECT * FROM users WHERE id = %s", (user_id,)) + row = cur.fetchone() + return _user_dict(row) if row else None + + def get_user_by_username(self, username: str) -> Optional[dict]: + with transaction() as conn: + with conn.cursor() as cur: + cur.execute("SELECT * FROM users WHERE username = %s", (username,)) + row = cur.fetchone() + return row + + # ---- chats ---- + + def create_chat( + self, title: str, member_ids: List[str], creator_id: str + ) -> dict: + if creator_id not in member_ids: + raise BadRequest("creator must be in member_ids") + + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + "SELECT id FROM users WHERE id = ANY(%s)", + (member_ids,), + ) + found = {str(r["id"]) for r in cur.fetchall()} + missing = set(member_ids) - found + if missing: + raise BadRequest("unknown member_id") + + cid = str(uuid.uuid4()) + now = _now() + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + "INSERT INTO chats (id, title, created_at) VALUES (%s, %s, %s)", + (cid, title, now), + ) + cur.executemany( + "INSERT INTO chat_members (chat_id, user_id) VALUES (%s, %s)", + [(cid, uid) for uid in member_ids], + ) + return { + "id": cid, + "title": title, + "member_ids": list(member_ids), + "created_at": iso(now), + } + + def get_chat(self, chat_id: str, viewer_id: str) -> Optional[dict]: + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + """ + SELECT c.* FROM chats c + JOIN chat_members m ON m.chat_id = c.id + WHERE c.id = %s AND m.user_id = %s + """, + (chat_id, viewer_id), + ) + row = cur.fetchone() + if row is None: + return None + cur.execute( + "SELECT user_id FROM chat_members WHERE chat_id = %s ORDER BY user_id", + (chat_id,), + ) + members = [str(r["user_id"]) for r in cur.fetchall()] + return _chat_dict(row, members) + + def list_chats( + self, viewer_id: str, limit: int, cursor: Optional[str] + ) -> Tuple[List[dict], Optional[str]]: + scope = "chats:" + viewer_id + params: list = [viewer_id] + where_cursor = "" + if cursor: + t, i = _decode_cursor(scope, cursor) + where_cursor = "AND (c.created_at, c.id) > (%s, %s)" + params.extend([t, i]) + params.append(limit + 1) + + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + f""" + SELECT c.id, c.title, c.created_at + FROM chats c + JOIN chat_members m ON m.chat_id = c.id + WHERE m.user_id = %s {where_cursor} + ORDER BY c.created_at, c.id + LIMIT %s + """, + params, + ) + rows = cur.fetchall() + + has_more = len(rows) > limit + page = rows[:limit] + + result = [] + for row in page: + cur.execute( + "SELECT user_id FROM chat_members WHERE chat_id = %s ORDER BY user_id", + (row["id"],), + ) + members = [str(r["user_id"]) for r in cur.fetchall()] + result.append(_chat_dict(row, members)) + + next_cursor = None + if has_more and page: + last = page[-1] + next_cursor = _encode_cursor(scope, iso(last["created_at"]), str(last["id"])) + return result, next_cursor + + # ---- messages ---- + + def add_message( + self, + chat_id: str, + sender_id: str, + text: str, + idempotency_key: str, + attachment_ids: Optional[List[str]] = None, + ) -> tuple[dict, int]: + attachment_ids = attachment_ids or [] + request_hash = hashlib.sha256( + json.dumps( + {"text": text, "attachment_ids": attachment_ids}, + ensure_ascii=False, + sort_keys=True, + ).encode("utf-8") + ).hexdigest() + + path = f"/api/v1/chats/{chat_id}/messages" + method = "POST" + + import time as _time + for attempt in range(5): + try: + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + "SELECT 1 FROM chat_members WHERE chat_id = %s AND user_id = %s", + (chat_id, sender_id), + ) + if cur.fetchone() is None: + raise NotFound() + + cur.execute( + """ + SELECT request_hash, response_status, response_body + FROM idempotency_keys + WHERE user_id = %s AND method = %s AND path = %s AND key = %s + """, + (sender_id, method, path, idempotency_key), + ) + row = cur.fetchone() + if row is not None: + if row["request_hash"] != request_hash: + raise Conflict( + "idempotency key reused with different body" + ) + return row["response_body"], row["response_status"] + + if attachment_ids: + cur.execute( + """ + SELECT id FROM attachments + WHERE id = ANY(%s) AND chat_id = %s + """, + (attachment_ids, chat_id), + ) + found = {str(r["id"]) for r in cur.fetchall()} + missing = set(attachment_ids) - found + if missing: + raise NotFound() + + mid = str(uuid.uuid4()) + now = _now() + cur.execute( + """ + INSERT INTO messages (id, chat_id, sender_id, text, created_at) + VALUES (%s, %s, %s, %s, %s) + """, + (mid, chat_id, sender_id, text, now), + ) + + if attachment_ids: + cur.executemany( + """ + INSERT INTO message_attachments + (message_id, attachment_id, position) + VALUES (%s, %s, %s) + """, + [(mid, aid, pos) for pos, aid in enumerate(attachment_ids)], + ) + + message = { + "id": mid, + "chat_id": chat_id, + "sender_id": sender_id, + "text": text, + "created_at": iso(now), + "attachment_ids": list(attachment_ids), + } + + cur.execute( + """ + INSERT INTO idempotency_keys + (user_id, method, path, key, request_hash, + response_status, response_body, created_at) + VALUES (%s, %s, %s, %s, %s, 201, %s, %s) + """, + ( + sender_id, method, path, idempotency_key, + request_hash, + json.dumps(message, ensure_ascii=False), + now, + ), + ) + return message, 201 + except UniqueViolation: + _time.sleep(0.05) + continue + + raise Conflict("idempotency key in progress, please retry") + + def list_messages( + self, + chat_id: str, + viewer_id: str, + limit: int, + cursor: Optional[str], + ) -> Tuple[List[dict], Optional[str]]: + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + "SELECT 1 FROM chat_members WHERE chat_id = %s AND user_id = %s", + (chat_id, viewer_id), + ) + if cur.fetchone() is None: + raise NotFound() + + scope = "chat:" + chat_id + params: list = [chat_id] + where_cursor = "" + if cursor: + t, i = _decode_cursor(scope, cursor) + where_cursor = "AND (created_at, id) > (%s, %s)" + params.extend([t, i]) + params.append(limit + 1) + + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + f""" + SELECT id, chat_id, sender_id, text, created_at + FROM messages + WHERE chat_id = %s {where_cursor} + ORDER BY created_at, id + LIMIT %s + """, + params, + ) + rows = cur.fetchall() + + message_ids = [str(r["id"]) for r in rows] + attachments_by_message: dict = {} + if message_ids: + cur.execute( + """ + SELECT message_id, attachment_id + FROM message_attachments + WHERE message_id = ANY(%s) + ORDER BY position + """, + (message_ids,), + ) + for r in cur.fetchall(): + attachments_by_message.setdefault( + str(r["message_id"]), [] + ).append(str(r["attachment_id"])) + + has_more = len(rows) > limit + page = rows[:limit] + result = [] + for r in page: + result.append(_message_dict( + r, attachments_by_message.get(str(r["id"]), []) + )) + + next_cursor = None + if has_more and page: + last = page[-1] + next_cursor = _encode_cursor(scope, iso(last["created_at"]), str(last["id"])) + return result, next_cursor + + # ---- attachments ---- + + def create_attachment( + self, + chat_id: str, + owner_id: str, + filename: str, + content_type: str, + size_bytes: int, + sha256: str, + s3_key: str, + staging_key: Optional[str] = None, + status: str = "queued", + ) -> dict: + aid = str(uuid.uuid4()) + now = _now() + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + "SELECT 1 FROM chat_members WHERE chat_id = %s AND user_id = %s", + (chat_id, owner_id), + ) + if cur.fetchone() is None: + raise NotFound() + cur.execute( + """ + INSERT INTO attachments + (id, chat_id, owner_id, filename, content_type, + size_bytes, sha256, s3_key, staging_key, + status, error_code, attempt, created_at, updated_at) + VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, NULL, 0, %s, %s) + """, + (aid, chat_id, owner_id, filename, content_type, + size_bytes, sha256, s3_key, staging_key, + status, now, now), + ) + return { + "id": aid, + "chat_id": chat_id, + "owner_id": owner_id, + "filename": filename, + "content_type": content_type, + "size_bytes": size_bytes, + "sha256": sha256, + "status": status, + "variants": [], + "error_code": None, + "created_at": iso(now), + "updated_at": iso(now), + } + + def create_job(self, attachment_id: str, pipeline_version: int = 1) -> dict: + jid = str(uuid.uuid4()) + now = _now() + carrier: dict = {} + otel_inject(carrier) + traceparent = carrier.get("traceparent") + tracestate = carrier.get("tracestate") + + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + """ + INSERT INTO jobs + (job_id, attachment_id, pipeline_version, + attempt, status, created_at, traceparent, tracestate) + VALUES (%s, %s, %s, 1, 'pending', %s, %s, %s) + """, + (jid, attachment_id, pipeline_version, now, traceparent, tracestate), + ) + return { + "schema_version": 1, + "job_id": jid, + "type": "attachment.process.v1", + "attachment_id": attachment_id, + "pipeline_version": pipeline_version, + "attempt": 1, + "created_at": iso(now), + } + + def mark_job_published(self, job_id: str) -> None: + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + "UPDATE jobs SET status='published', published_at=NOW() " + "WHERE job_id=%s", + (job_id,), + ) + + def get_attachment( + self, attachment_id: str, viewer_id: str + ) -> Optional[dict]: + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + """ + SELECT a.* + FROM attachments a + JOIN chat_members m ON m.chat_id = a.chat_id + WHERE a.id = %s AND m.user_id = %s + """, + (attachment_id, viewer_id), + ) + row = cur.fetchone() + if row is None: + return None + return { + "id": str(row["id"]), + "chat_id": str(row["chat_id"]), + "owner_id": str(row["owner_id"]), + "filename": row["filename"], + "content_type": row["content_type"], + "size_bytes": row["size_bytes"], + "sha256": row["sha256"], + "s3_key": row["s3_key"], + "status": row["status"], + "variants": row["variants"] if row.get("variants") else [], + "error_code": row["error_code"], + "created_at": iso(row["created_at"]), + "updated_at": iso(row["updated_at"]), + } + + +store = Store() \ No newline at end of file diff --git a/src/worker.py b/src/worker.py new file mode 100644 index 0000000..073a0de --- /dev/null +++ b/src/worker.py @@ -0,0 +1,377 @@ +from __future__ import annotations + +import io +import logging +import os +import time +import random + +from PIL import Image, ImageOps + +from . import broker, storage +from .db import init_pool, close_pool, transaction +from .store import store, iso + +from opentelemetry import trace, metrics +from opentelemetry.trace import SpanKind + +from . import otel as otel_module +from .logging_config import configure_logging +from prometheus_client import ( + Counter as _PromCounter, + Histogram as _PromHistogram, + Gauge as _PromGauge, + CollectorRegistry as _PromRegistry, + generate_latest as _prom_generate, + CONTENT_TYPE_LATEST as _PROM_CONTENT_TYPE, +) + +configure_logging("messenger-worker") +log = logging.getLogger("messenger.worker") + +THUMB_SIZE = (256, 256) +MAX_ATTEMPTS = int(os.environ.get("JOB_MAX_ATTEMPTS", "5")) +_PROM_REGISTRY = _PromRegistry() +_JOBS_PROCESSED = _PromCounter( + "jobs_processed_total", + "Jobs processed by outcome", + ["job_type", "outcome"], + registry=_PROM_REGISTRY, +) +_JOB_DURATION = _PromHistogram( + "job_processing_duration_seconds", + "Job processing duration in seconds", + ["job_type", "outcome"], + buckets=(0.05, 0.1, 0.25, 0.5, 1.0, 2.5, 5.0, 10.0, 30.0), + registry=_PROM_REGISTRY, +) +_WORKER_IN_FLIGHT = _PromGauge( + "worker_in_flight", + "Jobs currently being processed by this worker", + registry=_PROM_REGISTRY, +) +_WORKER_CAPACITY = _PromGauge( + "worker_capacity", + "Worker prefetch capacity (WORKER_CONCURRENCY)", + registry=_PROM_REGISTRY, +) + +_tracer = trace.get_tracer("messenger.worker") + + +def _load_original(staging_key: str) -> bytes: + return storage.get_object(staging_key) + + +def _make_thumbnail(data: bytes) -> tuple[bytes, int, int]: + img = Image.open(io.BytesIO(data)) + img = ImageOps.exif_transpose(img) + if img.mode in ("RGBA", "LA", "P"): + background = Image.new("RGB", img.size, (255, 255, 255)) + rgba = img.convert("RGBA") + background.paste(rgba, mask=rgba.split()[-1]) + img = background + else: + img = img.convert("RGB") + img.thumbnail(THUMB_SIZE, Image.LANCZOS) + w, h = img.size + buf = io.BytesIO() + img.save(buf, format="JPEG", quality=85, optimize=True) + return buf.getvalue(), w, h + +def _make_crop(data: bytes, size: int = 128) -> tuple[bytes, int, int]: + img = Image.open(io.BytesIO(data)) + img = ImageOps.exif_transpose(img) + if img.mode in ("RGBA", "LA", "P"): + background = Image.new("RGB", img.size, (255, 255, 255)) + rgba = img.convert("RGBA") + background.paste(rgba, mask=rgba.split()[-1]) + img = background + else: + img = img.convert("RGB") + w, h = img.size + side = min(w, h) + left = (w - side) // 2 + top = (h - side) // 2 + img = img.crop((left, top, left + side, top + side)) + img = img.resize((size, size), Image.LANCZOS) + buf = io.BytesIO() + img.save(buf, format="JPEG", quality=85, optimize=True) + return buf.getvalue(), size, size + + +def _make_optimized(data: bytes, max_side: int = 1280) -> tuple[bytes, int, int]: + img = Image.open(io.BytesIO(data)) + img = ImageOps.exif_transpose(img) + if img.mode in ("RGBA", "LA", "P"): + background = Image.new("RGB", img.size, (255, 255, 255)) + rgba = img.convert("RGBA") + background.paste(rgba, mask=rgba.split()[-1]) + img = background + else: + img = img.convert("RGB") + img.thumbnail((max_side, max_side), Image.LANCZOS) + w, h = img.size + buf = io.BytesIO() + img.save(buf, format="WEBP", quality=80, method=4) + return buf.getvalue(), w, h + +def _handle(job: dict, parent_ctx=None) -> None: + attachment_id = job["attachment_id"] + job_type = job.get("type", "attachment.process.v1") + attempt = int(job.get("attempt", 1)) + + with _tracer.start_as_current_span( + "job.process", + context=parent_ctx, + kind=SpanKind.CONSUMER, + attributes={ + "messaging.system": "rabbitmq", + "messaging.destination.name": "attachment.process.v1", + "messaging.operation": "process", + "messaging.message.id": job["job_id"], + "job.type": job_type, + "job.attempt": attempt, + "job.attachment_id": attachment_id, + }, + ) as span: + _WORKER_IN_FLIGHT.inc() + import time as _t + _start = _t.monotonic() + outcome = "success" + try: + _handle_inner(job) + except Exception as exc: + outcome = "failure" + span.record_exception(exc) + span.set_status(trace.Status(trace.StatusCode.ERROR, str(exc))) + raise + finally: + elapsed = _t.monotonic() - _start + _JOB_DURATION.labels(job_type=job_type, outcome=outcome).observe(elapsed) + _JOBS_PROCESSED.labels(job_type=job_type, outcome=outcome).inc() + _WORKER_IN_FLIGHT.dec() + + +def _handle_inner(job: dict) -> None: + attachment_id = job["attachment_id"] + attempt = int(job.get("attempt", 1)) + job_id = job["job_id"] + log.info("processing attachment %s attempt %d (job %s)", attachment_id, attempt, job_id) + + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + """ + UPDATE jobs + SET status = 'processing', + lease_until = NOW() + INTERVAL '60 seconds' + WHERE job_id = %s AND status IN ('published', 'pending') + RETURNING job_id + """, + (job_id,), + ) + acquired = cur.fetchone() + if acquired is None: + log.info("job %s already acquired or done, skip", job_id) + return + + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + "UPDATE attachments SET status='processing', updated_at=NOW() " + "WHERE id=%s AND status='queued'", + (attachment_id,), + ) + cur.execute( + "SELECT id, chat_id, owner_id, filename, content_type, " + "size_bytes, sha256, s3_key, staging_key, status " + "FROM attachments WHERE id = %s", + (attachment_id,), + ) + row = cur.fetchone() + if row is None: + log.error("attachment %s not found, skip", attachment_id) + return + if row["status"] == "ready": + log.info("attachment %s already ready, no-op", attachment_id) + return + + staging_key = row.get("staging_key") or row["s3_key"] + + data = _load_original(staging_key) + + thumb_bytes, tw, th = _make_thumbnail(data) + crop_bytes, cw, ch = _make_crop(data, 128) + opt_bytes, ow, oh = _make_optimized(data, 1280) + + ext = row["content_type"].split("/")[-1] + final_key = f"originals/{attachment_id}.{ext}" + if staging_key != final_key: + storage.put_object(final_key, data, row["content_type"]) + + thumb_key = f"thumbnails/{attachment_id}.jpg" + thumb_sha = storage.put_object(thumb_key, thumb_bytes, "image/jpeg") + + crop_key = f"crops/{attachment_id}.jpg" + crop_sha = storage.put_object(crop_key, crop_bytes, "image/jpeg") + + opt_key = f"optimized/{attachment_id}.webp" + opt_sha = storage.put_object(opt_key, opt_bytes, "image/webp") + + import json + variants = [ + { + "name": "thumbnail", + "content_type": "image/jpeg", + "size_bytes": len(thumb_bytes), + "width": tw, + "height": th, + "sha256": thumb_sha, + }, + { + "name": "crop", + "content_type": "image/jpeg", + "size_bytes": len(crop_bytes), + "width": cw, + "height": ch, + "sha256": crop_sha, + }, + { + "name": "optimized", + "content_type": "image/webp", + "size_bytes": len(opt_bytes), + "width": ow, + "height": oh, + "sha256": opt_sha, + }, + ] + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + """ + UPDATE attachments + SET status = 'ready', + s3_key = %s, + variants = %s::jsonb, + error_code = NULL, + updated_at = NOW() + WHERE id = %s + """, + (final_key, json.dumps(variants), attachment_id), + ) + cur.execute( + "UPDATE jobs SET status='published', lease_until=NULL, published_at=NOW() " + "WHERE job_id=%s", + (job_id,), + ) + + if staging_key and staging_key != final_key: + try: + storage.delete_object(staging_key) + except Exception as exc: + log.warning("staging cleanup failed: %s", exc) + + log.info( + "attachment %s ready: thumbnail %dx%d, crop %dx%d, optimized %dx%d", + attachment_id, tw, th, cw, ch, ow, oh, + ) + + +PERMANENT_ERRORS = ("invalid_image", "unsupported_media_type", "payload_too_large") + + +def _is_permanent(exc: Exception) -> bool: + name = type(exc).__name__.lower() + msg = str(exc).lower() + return any(p in name or p in msg for p in PERMANENT_ERRORS) + + +def _handler_with_retry(job: dict, parent_ctx=None) -> None: + attempt = int(job.get("attempt", 1)) + try: + _handle(job, parent_ctx=parent_ctx) + except Exception as exc: + log.exception("job %s attempt %d failed: %s", job.get("job_id"), attempt, exc) + permanent = _is_permanent(exc) + if permanent or attempt >= MAX_ATTEMPTS: + try: + broker.publish_dlq(job, str(exc)) + except Exception as dlq_exc: + log.warning("DLQ publish failed: %s", dlq_exc) + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + "UPDATE attachments SET status='failed', " + "error_code=%s, updated_at=NOW() WHERE id=%s", + ("invalid_image" if permanent else "processing_failed", + job["attachment_id"]), + ) + cur.execute( + "UPDATE jobs SET status='failed', lease_until=NULL " + "WHERE job_id=%s", + (job["job_id"],), + ) + log.error( + "attachment %s failed (permanent=%s) after %d attempts", + job["attachment_id"], permanent, attempt, + ) + return + delay = min(60, 2 ** attempt) + random.uniform(0, 1) + log.info("retry in %.1fs (attempt %d -> %d)", delay, attempt, attempt + 1) + with transaction() as conn: + with conn.cursor() as cur: + cur.execute( + "UPDATE jobs SET status='pending', lease_until=NULL, attempt=%s " + "WHERE job_id=%s", + (attempt + 1, job["job_id"]), + ) + + +def main() -> None: + otel_module.setup_otel("messenger-worker") + otel_module.instrument_libraries(psycopg=True, botocore=True, redis=False) + + init_pool() + storage.init_storage() + _WORKER_CAPACITY.set(int(os.environ.get("WORKER_CONCURRENCY", "2"))) + + import threading + from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer + + class MetricsHandler(BaseHTTPRequestHandler): + def do_GET(self): + if self.path == "/metrics": + data = _prom_generate(_PROM_REGISTRY) + self.send_response(200) + self.send_header("Content-Type", _PROM_CONTENT_TYPE) + self.send_header("Content-Length", str(len(data))) + self.end_headers() + self.wfile.write(data) + elif self.path == "/health/live": + self.send_response(200) + self.send_header("Content-Type", "application/json") + self.end_headers() + self.wfile.write(b'{"status":"ok"}') + else: + self.send_response(404) + self.end_headers() + + def log_message(self, *args): + pass + + metrics_port = int(os.environ.get("WORKER_METRICS_PORT", "9100")) + httpd = ThreadingHTTPServer(("0.0.0.0", metrics_port), MetricsHandler) + threading.Thread(target=httpd.serve_forever, daemon=True, name="metrics-http").start() + log.info("worker metrics on :%d/metrics", metrics_port) + + log.info("worker starting, max_attempts=%d", MAX_ATTEMPTS) + try: + broker.consume(_handler_with_retry, prefetch=int(os.environ.get("WORKER_CONCURRENCY", "2"))) + finally: + otel_module.shutdown_otel() + close_pool() + + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/student_tests/seed_messages.py b/student_tests/seed_messages.py new file mode 100644 index 0000000..401e304 --- /dev/null +++ b/student_tests/seed_messages.py @@ -0,0 +1,89 @@ +"""Генерация тестовых сообщений для EXPLAIN. + +Создаёт пользователя, чат и N сообщений. N по умолчанию 10 000. +Запуск: + python3 seed_messages.py --base-url http://localhost:8080 --count 10000 +""" +from __future__ import annotations + +import argparse +import base64 +import json +import time +import urllib.error +import urllib.request +import uuid + + +def call(base: str, method: str, path: str, headers: dict | None = None, body: dict | None = None) -> tuple[int, dict | None]: + data = None + h = dict(headers or {}) + if body is not None: + data = json.dumps(body, ensure_ascii=False).encode("utf-8") + h["Content-Type"] = "application/json" + req = urllib.request.Request(base + path, data=data, headers=h, method=method) + try: + resp = urllib.request.urlopen(req, timeout=30) + raw = resp.read() + return resp.code, json.loads(raw) if raw else None + except urllib.error.HTTPError as e: + raw = e.read() + try: + return e.code, json.loads(raw) if raw else None + except Exception: + return e.code, None + + +def main() -> None: + p = argparse.ArgumentParser() + p.add_argument("--base-url", default="http://localhost:8080") + p.add_argument("--count", type=int, default=10000) + p.add_argument("--batch", type=int, default=500, help="Сообщений между progress-логами") + args = p.parse_args() + base = args.base_url.rstrip("/") + + username = "seed_" + uuid.uuid4().hex[:12] + password = "seed-pass-1234567890" + + # Регистрация + code, user = call(base, "POST", "/api/v1/users", body={ + "username": username, "display_name": "Seed User", "password": password, + }) + assert code == 201, f"register failed: {code} {user}" + + # Логин + cred = base64.b64encode(f"{username}:{password}".encode()).decode() + code, session = call(base, "POST", "/api/v1/auth/sessions", headers={"Authorization": "Basic " + cred}) + assert code == 201, f"login failed: {code} {session}" + token = session["token"] + user_id = session["user"]["id"] + + # Чат + code, chat = call(base, "POST", "/api/v1/chats", headers={"Authorization": "Bearer " + token}, body={ + "title": "Seed chat", "member_ids": [user_id], + }) + assert code == 201, f"chat failed: {code} {chat}" + chat_id = chat["id"] + print(f"chat_id: {chat_id}") + print(f"seeding {args.count} messages...") + + started = time.monotonic() + for i in range(args.count): + code, msg = call( + base, "POST", f"/api/v1/chats/{chat_id}/messages", + headers={"Authorization": "Bearer " + token}, + body={"text": f"seed-{i:06d}-{uuid.uuid4().hex[:8]}"}, + ) + assert code == 201, f"message {i} failed: {code} {msg}" + if (i + 1) % args.batch == 0: + elapsed = time.monotonic() - started + rps = (i + 1) / elapsed + print(f" {i + 1}/{args.count} ({rps:.0f} msg/s)") + + elapsed = time.monotonic() - started + print(f"done: {args.count} messages in {elapsed:.1f}s ({args.count / elapsed:.0f} msg/s)") + print(f"chat_id: {chat_id}") + + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/student_tests/test_attachments_negative.py b/student_tests/test_attachments_negative.py new file mode 100644 index 0000000..d6e1959 --- /dev/null +++ b/student_tests/test_attachments_negative.py @@ -0,0 +1,292 @@ +"""Негативные тесты для вложений (lab4 grade 4). + +Запуск: + python3 test_attachments_negative.py --base-url http://localhost:8080 +""" +from __future__ import annotations + +import base64 +import io +import json +import sys +import urllib.error +import urllib.request +import uuid +import time + +BASE = ( + sys.argv[sys.argv.index("--base-url") + 1] + if "--base-url" in sys.argv + else "http://localhost:8080" +) + + +def call(method, path, headers=None, body=None, raw=None): + data = None + h = dict(headers or {}) + if body is not None: + data = json.dumps(body, ensure_ascii=False).encode("utf-8") + h["Content-Type"] = "application/json" + elif raw is not None: + data = raw + req = urllib.request.Request(BASE + path, data=data, headers=h, method=method) + try: + resp = urllib.request.urlopen(req, timeout=30) + payload = resp.read() + return resp.status, json.loads(payload) if payload else None, dict(resp.headers) + except urllib.error.HTTPError as e: + payload = e.read() + try: + return e.code, json.loads(payload) if payload else None, dict(e.headers) + except Exception: + return e.code, None, dict(e.headers) + + +def make_user(label): + username = f"att_{label}_{uuid.uuid4().hex[:10]}" + password = "negative-pass-1234567890" + code, user, _ = call("POST", "/api/v1/users", body={ + "username": username, "display_name": f"Att {label}", "password": password, + }) + assert code == 201, f"register {label} failed: {code} {user}" + cred = base64.b64encode(f"{username}:{password}".encode()).decode() + code, session, _ = call("POST", "/api/v1/auth/sessions", + headers={"Authorization": "Basic " + cred}) + assert code == 201, f"login {label} failed: {code}" + return { + "id": user["id"], + "token": session["token"], + } + + +def make_chat(owner, member_ids=None): + if member_ids is None: + member_ids = [owner["id"]] + code, chat, _ = call("POST", "/api/v1/chats", + headers={"Authorization": "Bearer " + owner["token"]}, + body={"title": "Negative", "member_ids": member_ids}) + assert code == 201, f"chat failed: {code} {chat}" + return chat["id"] + + +def upload(token, chat_id, filename, data, content_type): + return call( + "POST", + f"/api/v1/chats/{chat_id}/attachments?filename={filename}", + headers={"Authorization": "Bearer " + token, "Content-Type": content_type}, + raw=data, + ) + + +def test_decompression_bomb(): + """PNG 8200x5000 (41M пикселей) — маленький по размеру, но огромный по пикселям.""" + from PIL import Image + import io as _io + alice = make_user("bomb") + chat = make_chat(alice) + + img = Image.new("RGB", (8200, 5000), color=(255, 0, 0)) + buf = _io.BytesIO() + img.save(buf, format="PNG", compress_level=9) + data = buf.getvalue() + assert len(data) < 500 * 1024, f"expected small compressed, got {len(data)}" + + started = time.monotonic() + code, _, _ = upload(alice["token"], chat, "bomb.png", data, "image/png") + elapsed = time.monotonic() - started + + assert code == 413, f"expected 413, got {code}" + assert elapsed < 2.0, f"expected fast rejection (<2s), got {elapsed:.2f}s" + print(f"PASS: decompression bomb -> 413 ({len(data)} bytes, {elapsed:.2f}s)") + + +def test_invalid_cursor(): + """Cursor с невалидным timestamp или UUID -> 400.""" + import base64 as _b64 + alice = make_user("cursor") + chat = make_chat(alice) + chat_id = chat + + # Невалидный timestamp + bad_t = _b64.urlsafe_b64encode( + json.dumps({ + "s": f"chat:{chat_id}", + "t": "not-a-time", + "i": "00000000-0000-4000-8000-000000000000", + }).encode() + ).decode().rstrip("=") + code, _, _ = call( + "GET", f"/api/v1/chats/{chat_id}/messages?cursor={bad_t}", + headers={"Authorization": "Bearer " + alice["token"]}, + ) + assert code == 400, f"invalid timestamp: expected 400, got {code}" + + # Невалидный UUID + bad_i = _b64.urlsafe_b64encode( + json.dumps({ + "s": f"chat:{chat_id}", + "t": "2026-01-01T00:00:00.000000Z", + "i": "not-a-uuid", + }).encode() + ).decode().rstrip("=") + code, _, _ = call( + "GET", f"/api/v1/chats/{chat_id}/messages?cursor={bad_i}", + headers={"Authorization": "Bearer " + alice["token"]}, + ) + assert code == 400, f"invalid uuid: expected 400, got {code}" + + print("PASS: invalid cursor -> 400 (timestamp and uuid)") + + +def test_filename_c1(): + """Filename с C1 control (U+0085) -> 400.""" + from pathlib import Path + fixture = Path(__file__).resolve().parent.parent / "tests/fixtures/sample.png" + png = fixture.read_bytes() + alice = make_user("c1") + chat = make_chat(alice) + + # filename = "c1\u0085.png" — C1 control U+0085 + code, _, _ = call( + "POST", + f"/api/v1/chats/{chat}/attachments?filename=c1%C2%85.png", + headers={ + "Authorization": "Bearer " + alice["token"], + "Content-Type": "image/png", + }, + raw=png, + ) + assert code == 400, f"expected 400 for C1 filename, got {code}" + print("PASS: C1 filename -> 400") + + +def test_s3_unavailable(): + """S3 down: readiness 503, upload 503.""" + import subprocess + from pathlib import Path + + alice = make_user("s3down") + chat = make_chat(alice) + + # 1. Baseline: readiness 200 + code, _, _ = call("GET", "/health/ready") + assert code == 200, f"readiness should be 200 before stop, got {code}" + + # 2. Останавливаем S3 + try: + subprocess.run( + ["docker", "compose", "--env-file", ".env", "stop", "s3"], + check=True, capture_output=True, text=True, + cwd=str(Path(__file__).resolve().parent.parent), + timeout=30, + ) + except subprocess.CalledProcessError as e: + raise SystemExit(f"failed to stop s3: {e.stderr}") + + import time as _t + _t.sleep(3) + + try: + # 3. Readiness должен быть 503 + code, body, _ = call("GET", "/health/ready") + assert code == 503, f"readiness should be 503 with S3 down, got {code}" + assert body and body["error"]["code"] == "unavailable", \ + f"expected unavailable, got {body}" + + # 4. Upload должен быть 503 + fixture = Path(__file__).resolve().parent.parent / "tests/fixtures/sample.png" + png = fixture.read_bytes() + code, body, _ = upload(alice["token"], chat, "s3down.png", png, "image/png") + assert code == 503, f"upload should be 503 with S3 down, got {code}" + assert body and body["error"]["code"] == "unavailable", \ + f"expected unavailable, got {body}" + + print("PASS: S3 down -> readiness 503, upload 503") + finally: + # 5. Возвращаем S3 + subprocess.run( + ["docker", "compose", "--env-file", ".env", "start", "s3"], + check=False, capture_output=True, text=True, + cwd=str(Path(__file__).resolve().parent.parent), + timeout=30, + ) + # Ждём готовности + deadline = _t.monotonic() + 30 + while _t.monotonic() < deadline: + code, _, _ = call("GET", "/health/ready") + if code == 200: + break + _t.sleep(1) + + +def main(): + alice = make_user("alice") + bob = make_user("bob") + eve = make_user("eve") + chat_ab = make_chat(alice, [alice["id"], bob["id"]]) + chat_alice = make_chat(alice) + + # 1. Oversize: > 10 MiB + big = b"\x89PNG\r\n\x1a\n" + b"\x00" * (10 * 1024 * 1024 + 1) + code, _, _ = upload(alice["token"], chat_ab, "big.png", big, "image/png") + assert code == 413, f"oversize: expected 413, got {code}" + print("PASS: oversize -> 413") + + # 2. Corrupted: валидная сигнатура, битые данные + corrupted = b"\x89PNG\r\n\x1a\n" + b"\xff" * 100 + code, _, _ = upload(alice["token"], chat_ab, "corrupted.png", corrupted, "image/png") + assert code == 415, f"corrupted: expected 415, got {code}" + print("PASS: corrupted -> 415") + + # 3. MIME-spoofing: image/png, но текст + spoofed = b"this is definitely not an image" + code, _, _ = upload(alice["token"], chat_ab, "spoof.png", spoofed, "image/png") + assert code == 415, f"mime spoof: expected 415, got {code}" + print("PASS: mime spoofing -> 415") + + # 4. Чужой attachment_id: eve скачивает вложение из chat_ab + # Сначала загрузим настоящий PNG (тестовый fixture) + from pathlib import Path + fixture = Path(__file__).resolve().parent.parent / "tests/fixtures/sample.png" + if not fixture.exists(): + raise SystemExit(f"fixture not found: {fixture}") + png = fixture.read_bytes() + code, att, _ = upload(alice["token"], chat_ab, "sample.png", png, "image/png") + assert code == 201, f"upload fixture failed: {code} {att}" + att_id = att["id"] + + code, _, _ = call("GET", f"/api/v1/attachments/{att_id}", + headers={"Authorization": "Bearer " + eve["token"]}) + assert code == 404, f"outsider metadata: expected 404, got {code}" + code, _, _ = call("GET", f"/api/v1/attachments/{att_id}/content", + headers={"Authorization": "Bearer " + eve["token"]}) + assert code == 404, f"outsider content: expected 404, got {code}" + print("PASS: outsider attachment -> 404") + + # 5. Вложение из другого чата + # Загружаем в chat_alice, прикрепляем к сообщению в chat_ab + code, att2, _ = upload(alice["token"], chat_alice, "other.png", png, "image/png") + assert code == 201, f"upload to chat_alice failed: {code} {att2}" + other_id = att2["id"] + + code, _, _ = call( + "POST", f"/api/v1/chats/{chat_ab}/messages", + headers={ + "Authorization": "Bearer " + alice["token"], + "Idempotency-Key": uuid.uuid4().hex, + }, + body={"text": "cross-chat", "attachment_ids": [other_id]}, + ) + assert code == 404, f"cross-chat attachment: expected 404, got {code}" + print("PASS: cross-chat attachment -> 404") + + print("\nNew tests from reviewer feedback") + test_decompression_bomb() + test_invalid_cursor() + test_filename_c1() + + print("\nS3 unavailable") + test_s3_unavailable() + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/student_tests/test_cache_failure.py b/student_tests/test_cache_failure.py new file mode 100755 index 0000000..00ab135 --- /dev/null +++ b/student_tests/test_cache_failure.py @@ -0,0 +1,100 @@ +"""Проверка отказа Valkey и корректности logout при недоступном кэше.""" +from __future__ import annotations +import base64, json, subprocess, sys, time, urllib.error, urllib.request, uuid + +BASE = "http://localhost:8080" +COMPOSE = ["docker", "compose", "--env-file", ".env"] + +def call(method, path, headers=None, body=None): + data = None + h = dict(headers or {}) + if body is not None: + data = json.dumps(body).encode() + h["Content-Type"] = "application/json" + req = urllib.request.Request(BASE + path, data=data, headers=h, method=method) + try: + r = urllib.request.urlopen(req, timeout=10) + raw = r.read() + return r.code, json.loads(raw) if raw else None + except urllib.error.HTTPError as e: + raw = e.read() + try: + return e.code, json.loads(raw) if raw else None + except Exception: + return e.code, None + +def stop_cache(): + subprocess.run(COMPOSE + ["stop", "cache"], check=True) + +def start_cache(): + subprocess.run(COMPOSE + ["start", "cache"], check=True) + +def restart_api(): + subprocess.run(COMPOSE + ["restart", "api"], check=True) + +def wait_ready(deadline=60): + end = time.monotonic() + deadline + while time.monotonic() < end: + try: + code, _ = call("GET", "/health/ready") + if code == 200: + return + except Exception: + pass + time.sleep(1) + raise SystemExit("API did not become ready") + +def main(): + username = "cf_" + uuid.uuid4().hex[:10] + password = "cache-fail-pass-1234567890" + code, _ = call("POST", "/api/v1/users", body={ + "username": username, "display_name": "Cache Fail", "password": password, + }) + assert code == 201, code + + cred = base64.b64encode(f"{username}:{password}".encode()).decode() + code, session = call("POST", "/api/v1/auth/sessions", + headers={"Authorization": "Basic " + cred}) + assert code == 201, code + token = session["token"] + + # Токен работает + code, _ = call("GET", "/api/v1/users/me", + headers={"Authorization": "Bearer " + token}) + assert code == 200, code + + # Останавливаем Valkey + stop_cache() + time.sleep(2) + + # API должно работать в degraded mode + code, _ = call("GET", "/api/v1/users/me", + headers={"Authorization": "Bearer " + token}) + assert code == 200, f"degraded mode failed: {code}" + print("PASS: API works with Valkey down (degraded mode)") + + # Logout при недоступном Valkey должен вернуть 204 + code, _ = call("DELETE", "/api/v1/auth/sessions/current", + headers={"Authorization": "Bearer " + token}) + assert code == 204, f"logout with cache down returned {code}" + print("PASS: logout with cache down returned 204") + + # Токен немедленно недействителен (проверка через БД) + code, _ = call("GET", "/api/v1/users/me", + headers={"Authorization": "Bearer " + token}) + assert code == 401, f"revoked token still works with cache down: {code}" + print("PASS: revoked token rejected while cache down") + + # Поднимаем Valkey, рестартуем API — критический регресс-тест + start_cache() + time.sleep(2) + restart_api() + wait_ready() + + code, _ = call("GET", "/api/v1/users/me", + headers={"Authorization": "Bearer " + token}) + assert code == 401, f"REGRESSION: revoked token resurrected after cache restart: {code}" + print("PASS: revoked token still 401 after cache restart (regression fixed)") + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/student_tests/test_concurrent_uploads.py b/student_tests/test_concurrent_uploads.py new file mode 100644 index 0000000..701f9d6 --- /dev/null +++ b/student_tests/test_concurrent_uploads.py @@ -0,0 +1,179 @@ +"""10 одновременных загрузок 10 MiB: все 202, все ready, RAM API. + +Запуск: + python3 student_tests/test_concurrent_uploads.py --base-url http://localhost:8080 +""" +from __future__ import annotations + +import base64 +import io +import json +import subprocess +import sys +import threading +import time +import urllib.error +import urllib.request +import uuid +from concurrent.futures import ThreadPoolExecutor + +BASE = ( + sys.argv[sys.argv.index("--base-url") + 1] + if "--base-url" in sys.argv + else "http://localhost:8080" +) +CONCURRENCY = 10 +SIZE_MB = 10 +API_CONTAINER = "mtusi2026lab5-api-1" + + +def call(method, path, headers=None, body=None, raw=None, timeout=120): + data = None + h = dict(headers or {}) + if body is not None: + data = json.dumps(body, ensure_ascii=False).encode("utf-8") + h["Content-Type"] = "application/json" + elif raw is not None: + data = raw + req = urllib.request.Request(BASE + path, data=data, headers=h, method=method) + try: + resp = urllib.request.urlopen(req, timeout=timeout) + payload = resp.read() + return resp.status, json.loads(payload) if payload else None + except urllib.error.HTTPError as e: + payload = e.read() + try: + return e.code, json.loads(payload) if payload else None + except Exception: + return e.code, None + + +def make_user(label): + username = f"conc_{label}_{uuid.uuid4().hex[:10]}" + password = "conc-pass-1234567890" + code, user = call("POST", "/api/v1/users", body={ + "username": username, "display_name": f"Conc {label}", "password": password, + }) + assert code == 201, f"register failed: {code} {user}" + cred = base64.b64encode(f"{username}:{password}".encode()).decode() + code, session = call("POST", "/api/v1/auth/sessions", + headers={"Authorization": "Basic " + cred}) + assert code == 201, f"login failed: {code}" + code, chat = call("POST", "/api/v1/chats", + headers={"Authorization": "Bearer " + session["token"]}, + body={"title": "Conc", "member_ids": [user["id"]]}) + assert code == 201, f"chat failed: {code}" + return {"token": session["token"], "chat_id": chat["id"]} + + +def measure_ram_mb(container): + try: + result = subprocess.run( + ["docker", "stats", "--no-stream", "--format", "{{.MemUsage}}", container], + capture_output=True, text=True, timeout=5, + ) + if result.returncode != 0: + return None + mem = result.stdout.strip().split("/")[0].strip() + if "MiB" in mem: + return float(mem.replace("MiB", "").strip()) + if "GiB" in mem: + return float(mem.replace("GiB", "").strip()) * 1024 + if "KiB" in mem: + return float(mem.replace("KiB", "").strip()) / 1024 + return None + except Exception: + return None + + +def make_png_of_size(size_bytes): + from PIL import Image + side = int((size_bytes / 3) ** 0.5) + img = Image.new("RGB", (side, side), color=(200, 100, 50)) + buf = io.BytesIO() + img.save(buf, format="PNG", compress_level=0) + return buf.getvalue() + + +def main(): + print(f"=== concurrent uploads: {CONCURRENCY} × {SIZE_MB} MiB ===") + user = make_user("user") + png = make_png_of_size(SIZE_MB * 1024 * 1024) + print(f"fixture size: {len(png)} bytes ({len(png) / 1024 / 1024:.2f} MiB)") + + baseline = measure_ram_mb(API_CONTAINER) + print(f"baseline RAM: {baseline:.1f} MiB" if baseline else "baseline RAM: unknown") + + peak = baseline or 0.0 + stop = threading.Event() + + def monitor(): + nonlocal peak + while not stop.is_set(): + ram = measure_ram_mb(API_CONTAINER) + if ram is not None: + peak = max(peak, ram) + time.sleep(0.2) + + t = threading.Thread(target=monitor, daemon=True) + t.start() + + results = [] + lock = threading.Lock() + barrier = threading.Barrier(CONCURRENCY) + + def worker(i): + barrier.wait() + code, body = call( + "POST", + f"/api/v1/chats/{user['chat_id']}/attachments?filename=conc-{i}.png", + headers={ + "Authorization": "Bearer " + user["token"], + "Content-Type": "image/png", + }, + raw=png, + ) + with lock: + results.append((i, code, body)) + + started = time.monotonic() + with ThreadPoolExecutor(max_workers=CONCURRENCY) as pool: + list(pool.map(worker, range(CONCURRENCY))) + elapsed = time.monotonic() - started + stop.set() + t.join(timeout=2) + + codes = {} + for _, code, _ in results: + codes[code] = codes.get(code, 0) + 1 + + print(f"\nUpload results:") + print(f" duration: {elapsed:.2f}s") + print(f" status codes: {codes}") + print(f" peak RAM: {peak:.1f} MiB (baseline {baseline:.1f} MiB)") + assert all(c == 202 for _, c, _ in results), f"not all 202: {codes}" + + # Ждём все ready + att_ids = [body["id"] for _, _, body in results] + deadline = time.monotonic() + 120 + ready_count = 0 + while time.monotonic() < deadline: + ready_count = 0 + for att_id in att_ids: + code, att = call("GET", f"/api/v1/attachments/{att_id}", + headers={"Authorization": "Bearer " + user["token"]}) + if code == 200 and att["status"] == "ready": + ready_count += 1 + elif code == 200 and att["status"] == "failed": + raise AssertionError(f"att {att_id} failed: {att.get('error_code')}") + if ready_count == len(att_ids): + break + time.sleep(1) + + assert ready_count == len(att_ids), f"only {ready_count}/{len(att_ids)} ready" + print(f" all {len(att_ids)} ready in {time.monotonic() - (deadline - 120):.1f}s") + print(f"\nPASS: {CONCURRENCY} concurrent uploads 202→ready, peak RAM {peak:.1f} MiB") + + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/student_tests/test_db_failure.py b/student_tests/test_db_failure.py new file mode 100755 index 0000000..4dfe26d --- /dev/null +++ b/student_tests/test_db_failure.py @@ -0,0 +1,127 @@ +"""Проверка отказа PostgreSQL: таймаут запроса и восстановление.""" +from __future__ import annotations +import base64, json, subprocess, sys, time, urllib.error, urllib.request, uuid + +BASE = "http://localhost:8080" +COMPOSE = ["docker", "compose", "--env-file", ".env"] + + +def call(method, path, headers=None, body=None, timeout=10): + data = None + h = dict(headers or {}) + if body is not None: + data = json.dumps(body).encode() + h["Content-Type"] = "application/json" + req = urllib.request.Request(BASE + path, data=data, headers=h, method=method) + try: + r = urllib.request.urlopen(req, timeout=timeout) + raw = r.read() + return r.code, json.loads(raw) if raw else None + except urllib.error.HTTPError as e: + raw = e.read() + try: + return e.code, json.loads(raw) if raw else None + except Exception: + return e.code, None + + +def stop_db(): + """Останавливает контейнер Postgres. TCP-соединения рвутся, psycopg + получает ошибку мгновенно — это честный сценарий 'БД упала'.""" + subprocess.run(COMPOSE + ["stop", "postgres"], check=True) + + +def start_db(): + """Поднимает Postgres. Не падает, если уже запущен.""" + subprocess.run(COMPOSE + ["start", "postgres"], + capture_output=True, check=False) + time.sleep(3) + + +def restart_api(): + """Пересоздаёт API, чтобы пул соединений не держал мёртвые сессии.""" + subprocess.run(COMPOSE + ["restart", "api"], + capture_output=True, check=False) + + +def wait_ready(deadline=60): + end = time.monotonic() + deadline + while time.monotonic() < end: + try: + code, _ = call("GET", "/health/ready", timeout=5) + if code == 200: + return + except Exception: + pass + time.sleep(1) + raise SystemExit("API did not become ready") + + +def ensure_clean_state(): + """Возвращает стек в рабочее состояние, если предыдущий запуск оставил + Postgres остановленным или пул API в плохом состоянии.""" + subprocess.run(COMPOSE + ["start", "postgres"], + capture_output=True, check=False) + time.sleep(3) + # API перезапускаем, потому что после stop Postgres пул мог забиться + # мёртвыми соединениями, и первый запрос упадёт по PoolTimeout. + restart_api() + wait_ready() + + +def main(): + ensure_clean_state() + + # Регистрация и логин — до всякого stop, чтобы тест не падал на подготовке + username = "dbf_" + uuid.uuid4().hex[:10] + password = "db-fail-pass-1234567890" + + code, _ = call("POST", "/api/v1/users", body={ + "username": username, "display_name": "DB Fail", "password": password, + }) + assert code == 201, f"failed to create user before stop: {code}" + + cred = base64.b64encode(f"{username}:{password}".encode()).decode() + code, session = call("POST", "/api/v1/auth/sessions", + headers={"Authorization": "Basic " + cred}) + assert code == 201, f"failed to login before stop: {code}" + token = session["token"] + + stop_db() + try: + time.sleep(0.5) + + # Запрос к БД должен упасть быстро (TCP порван, psycopg сразу + # получает ошибку соединения). Проверяем < 8 секунд. + start = time.monotonic() + try: + code, _ = call("GET", "/api/v1/users/me", + headers={"Authorization": "Bearer " + token}, timeout=15) + except Exception as exc: + elapsed = time.monotonic() - start + raise SystemExit(f"request hung: {elapsed:.1f}s, {type(exc).__name__}") + elapsed = time.monotonic() - start + assert elapsed < 8, f"request took {elapsed:.1f}s (>8s), DB down not handled fast enough" + assert code in (500, 503), f"expected 500/503 during DB down, got {code}" + print(f"PASS: DB down returned {code} in {elapsed:.1f}s (<8s)") + + # health/ready должен вернуть 503, пока БД недоступна + code, _ = call("GET", "/health/ready", timeout=15) + assert code == 503, f"expected 503 from ready, got {code}" + print("PASS: /health/ready returned 503 during DB down") + finally: + # Гарантированно поднимаем Postgres даже при падении выше. + start_db() + # Перезапускаем API, чтобы пул пересоздал соединения с вернувшейся БД. + restart_api() + wait_ready() + + # Проверяем, что данные и сессия сохранены после восстановления. + code, _ = call("GET", "/api/v1/users/me", + headers={"Authorization": "Bearer " + token}) + assert code == 200, f"session lost after DB recovery: {code}" + print("PASS: session and data preserved after DB recovery") + + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/student_tests/test_expiry.py b/student_tests/test_expiry.py new file mode 100644 index 0000000..68d553c --- /dev/null +++ b/student_tests/test_expiry.py @@ -0,0 +1,72 @@ +"""Тест expiry: сессия истекает через SESSION_TTL_SECONDS. + +Запуск: + SESSION_TTL_SECONDS=2 docker compose up -d --build api + python3 test_expiry.py --base-url http://localhost:8080 + +Тест создаёт пользователя, логинится, ждёт TTL+1 секунду, проверяет 401. +""" +from __future__ import annotations + +import base64 +import json +import sys +import time +import urllib.error +import urllib.request +import uuid + +BASE = sys.argv[sys.argv.index("--base-url") + 1] if "--base-url" in sys.argv else "http://localhost:8080" + + +def call(method: str, path: str, headers: dict | None = None, body: dict | None = None) -> tuple[int, dict | None]: + data = None + h = dict(headers or {}) + if body is not None: + data = json.dumps(body, ensure_ascii=False).encode("utf-8") + h["Content-Type"] = "application/json" + req = urllib.request.Request(BASE + path, data=data, headers=h, method=method) + try: + resp = urllib.request.urlopen(req, timeout=10) + raw = resp.read() + return resp.code, json.loads(raw) if raw else None + except urllib.error.HTTPError as e: + raw = e.read() + try: + return e.code, json.loads(raw) if raw else None + except Exception: + return e.code, None + + +def main() -> None: + username = "exp_" + uuid.uuid4().hex[:12] + password = "expiry-pass-1234567890" + + # Регистрация + code, user = call("POST", "/api/v1/users", body={ + "username": username, "display_name": "Expiry Test", "password": password, + }) + assert code == 201, f"register failed: {code} {user}" + + # Логин + cred = base64.b64encode(f"{username}:{password}".encode()).decode() + code, session = call("POST", "/api/v1/auth/sessions", headers={"Authorization": "Basic " + cred}) + assert code == 201, f"login failed: {code} {session}" + token = session["token"] + print(f"session expires_at: {session['expires_at']}") + + # Сразу после логина — токен работает + code, me = call("GET", "/api/v1/users/me", headers={"Authorization": "Bearer " + token}) + assert code == 200, f"token should work immediately, got {code}" + print("immediately after login: 200 OK") + + # Ждём истечения + time.sleep(3) + code, err = call("GET", "/api/v1/users/me", headers={"Authorization": "Bearer " + token}) + assert code == 401, f"expired token must give 401, got {code}" + print(f"after TTL: {code} (expected 401)") + print("PASS: expiry — token invalidated after SESSION_TTL_SECONDS") + + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/student_tests/test_idempotent_replay.py b/student_tests/test_idempotent_replay.py new file mode 100644 index 0000000..c6f63e3 --- /dev/null +++ b/student_tests/test_idempotent_replay.py @@ -0,0 +1,154 @@ +"""Повторная доставка ready-задачи: no-op, не создаёт дубли. + +Создаёт attachment, ждёт ready, публикует тот же job повторно, +проверяет, что variants не изменились и объекты в S3 не задублированы. +""" +from __future__ import annotations + +import base64 +import io +import json +import sys +import time +import urllib.error +import urllib.request +import uuid + +BASE = ( + sys.argv[sys.argv.index("--base-url") + 1] + if "--base-url" in sys.argv + else "http://localhost:8080" +) + + +def call(method, path, headers=None, body=None, raw=None, timeout=30): + data = None + h = dict(headers or {}) + if body is not None: + data = json.dumps(body, ensure_ascii=False).encode("utf-8") + h["Content-Type"] = "application/json" + elif raw is not None: + data = raw + req = urllib.request.Request(BASE + path, data=data, headers=h, method=method) + try: + resp = urllib.request.urlopen(req, timeout=timeout) + payload = resp.read() + return resp.status, json.loads(payload) if payload else None + except urllib.error.HTTPError as e: + payload = e.read() + try: + return e.code, json.loads(payload) if payload else None + except Exception: + return e.code, None + + +def main(): + # 1. Регистрация, логин, чат + username = "replay_" + uuid.uuid4().hex[:10] + password = "replay-pass-1234567890" + code, user = call("POST", "/api/v1/users", body={ + "username": username, "display_name": "Replay", "password": password, + }) + assert code == 201, f"register failed: {code} {user}" + cred = base64.b64encode(f"{username}:{password}".encode()).decode() + code, session = call("POST", "/api/v1/auth/sessions", + headers={"Authorization": "Basic " + cred}) + assert code == 201, f"login failed: {code}" + token = session["token"] + code, chat = call("POST", "/api/v1/chats", + headers={"Authorization": "Bearer " + token}, + body={"title": "Replay", "member_ids": [user["id"]]}) + assert code == 201, f"chat failed: {code}" + chat_id = chat["id"] + + # 2. Upload + fixture = (Path(__file__).resolve().parent.parent / "tests/fixtures/sample.png").read_bytes() + code, att = call( + "POST", + f"/api/v1/chats/{chat_id}/attachments?filename=sample.png", + headers={"Authorization": "Bearer " + token, "Content-Type": "image/png"}, + raw=fixture, + ) + assert code == 202, f"upload failed: {code}" + att_id = att["id"] + print(f"upload: 202 queued ({att_id})") + + # 3. Ждём ready + deadline = time.monotonic() + 60 + while time.monotonic() < deadline: + code, att = call("GET", f"/api/v1/attachments/{att_id}", + headers={"Authorization": "Bearer " + token}) + if code == 200 and att["status"] == "ready": + break + if code == 200 and att["status"] == "failed": + raise AssertionError(f"failed: {att.get('error_code')}") + time.sleep(0.5) + else: + raise AssertionError("not ready in 60s") + + variants_before = att["variants"] + print(f"ready: {len(variants_before)} variants") + + # 4. Повторная доставка: publish тот же job в broker + import subprocess + # job_id из БД + result = subprocess.run( + ["docker", "compose", "--env-file", ".env", "exec", "-T", "postgres", + "psql", "-U", "messenger", "-d", "messenger", "-t", "-A", + "-c", f"SELECT job_id FROM jobs WHERE attachment_id = '{att_id}' LIMIT 1"], + capture_output=True, text=True, cwd="/home/user/projects/lab5/mtusi2026lab5", + ) + job_id = result.stdout.strip() + assert job_id, f"job_id not found: {result.stderr}" + print(f"job_id: {job_id}") + + # Опубликовать тот же job через worker (pika) + pub_result = subprocess.run( + ["docker", "compose", "--env-file", ".env", "exec", "-T", "worker", + "python3", "-c", f""" +import os, json, pika +params = pika.URLParameters(os.environ['BROKER_URL']) +conn = pika.BlockingConnection(params) +ch = conn.channel() +ch.basic_publish('', 'attachment.process.v1', json.dumps({{ + 'schema_version': 1, 'job_id': '{job_id}', 'type': 'attachment.process.v1', + 'attachment_id': '{att_id}', 'pipeline_version': 1, 'attempt': 1, + 'created_at': '2026-01-01T00:00:00Z' +}})) +conn.close() +print('published') +"""], + capture_output=True, text=True, cwd="/home/user/projects/lab5/mtusi2026lab5", + ) + print(f"replay publish: {pub_result.stdout.strip() or pub_result.stderr.strip()}") + + # 5. Ждём 10 сек, проверяем variants + time.sleep(10) + code, att_after = call("GET", f"/api/v1/attachments/{att_id}", + headers={"Authorization": "Bearer " + token}) + assert code == 200, f"get after failed: {code}" + variants_after = att_after["variants"] + assert variants_after == variants_before, \ + f"variants changed: {len(variants_before)} -> {len(variants_after)}" + print(f"after replay: {len(variants_after)} variants (unchanged)") + + # 6. Проверяем S3 — количество объектов не изменилось (root, mc ls) + for prefix, ext in (("originals", "png"), ("thumbnails", "jpg"), + ("crops", "jpg"), ("optimized", "webp")): + result = subprocess.run( + ["docker", "compose", "--env-file", ".env", "run", "--rm", + "--entrypoint", "sh", "s3-init", "-c", + f"mc alias set local http://s3:9000 $MINIO_ROOT_USER $MINIO_ROOT_PASSWORD >/dev/null && " + f"mc stat local/messenger-attachments/{prefix}/{att_id}.{ext} 2>&1 | head -1"], + capture_output=True, text=True, cwd="/home/user/projects/lab5/mtusi2026lab5", + ) + out = (result.stdout + result.stderr).strip() + assert "Name" in out or "Size" in out, f"missing {prefix}: {out}" + print(f" {prefix}/{att_id}.{ext} exists") + + print("PASS: idempotent replay — variants unchanged, no duplicates") + + +if __name__ == "__main__": + from pathlib import Path + main() \ No newline at end of file diff --git a/student_tests/test_parallel_idempotency.py b/student_tests/test_parallel_idempotency.py new file mode 100644 index 0000000..0a5b714 --- /dev/null +++ b/student_tests/test_parallel_idempotency.py @@ -0,0 +1,115 @@ +"""Параллельная идемпотентность: N потоков посылают один POST с одним ключом. + +Ожидаем: ровно одно сообщение создано, все ответы — одинаковые, +дубликатов в истории нет. +""" +from __future__ import annotations + +import base64 +import json +import sys +import threading +import urllib.error +import urllib.request +import uuid +from concurrent.futures import ThreadPoolExecutor + +BASE = sys.argv[sys.argv.index("--base-url") + 1] if "--base-url" in sys.argv else "http://localhost:8080" +THREADS = 10 + + +def call(method, path, headers=None, body=None): + data = None + h = dict(headers or {}) + if body is not None: + data = json.dumps(body, ensure_ascii=False).encode("utf-8") + h["Content-Type"] = "application/json" + req = urllib.request.Request(BASE + path, data=data, headers=h, method=method) + try: + resp = urllib.request.urlopen(req, timeout=15) + raw = resp.read() + return resp.status, json.loads(raw) if raw else None, dict(resp.headers) + except urllib.error.HTTPError as e: + raw = e.read() + try: + return e.code, json.loads(raw) if raw else None, dict(e.headers) + except Exception: + return e.code, None, dict(e.headers) + + +def main(): + username = "pario_" + uuid.uuid4().hex[:10] + password = "parallel-pass-1234567890" + + # Регистрация + code, user, _ = call("POST", "/api/v1/users", body={ + "username": username, "display_name": "Parallel", "password": password, + }) + assert code == 201, f"register failed: {code} {user}" + user_id = user["id"] + + # Логин + cred = base64.b64encode(f"{username}:{password}".encode()).decode() + code, session, _ = call("POST", "/api/v1/auth/sessions", + headers={"Authorization": "Basic " + cred}) + assert code == 201, f"login failed: {code}" + token = session["token"] + + # Чат + code, chat, _ = call("POST", "/api/v1/chats", + headers={"Authorization": "Bearer " + token}, + body={"title": "Parallel test", "member_ids": [user_id]}) + assert code == 201, f"chat failed: {code}" + chat_id = chat["id"] + + # Параллельный POST с одним ключом + idem_key = "parallel-" + uuid.uuid4().hex + barrier = threading.Barrier(THREADS) + results = [] + results_lock = threading.Lock() + + def worker(i): + barrier.wait() # стартуют одновременно + code, body, headers = call( + "POST", f"/api/v1/chats/{chat_id}/messages", + headers={ + "Authorization": "Bearer " + token, + "Idempotency-Key": idem_key, + }, + body={"text": "parallel-message-same"}, # ← ОДИНАКОВЫЙ текст! + ) + with results_lock: + results.append((code, body)) + + with ThreadPoolExecutor(max_workers=THREADS) as pool: + list(pool.map(worker, range(THREADS))) + + # Анализ + print(f"Results: {len(results)} responses") + codes = {} + for code, _ in results: + codes[code] = codes.get(code, 0) + 1 + print(f"Status codes: {codes}") + + # Проверка: ровно одно сообщение создано + code, page, _ = call("GET", f"/api/v1/chats/{chat_id}/messages?limit=100", + headers={"Authorization": "Bearer " + token}) + assert code == 200, f"history failed: {code}" + messages = page["items"] + print(f"Messages in history: {len(messages)}") + + assert len(messages) == 1, f"expected exactly 1 message, got {len(messages)}" + print("PASS: parallel idempotency — exactly one message created") + + # Проверка: все ответы должны быть одинаковыми + codes = [c for c, _ in results] + bodies = [json.dumps(b, sort_keys=True) for _, b in results if b is not None] + unique_bodies = set(bodies) + print(f"Status codes: {dict((c, codes.count(c)) for c in set(codes))}") + print(f"Unique response bodies: {len(unique_bodies)}") + assert codes.count(201) == THREADS, f"expected all {THREADS} to be 201, got {codes.count(201)}" + assert len(unique_bodies) == 1, f"expected same response body, got {len(unique_bodies)}" + + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/student_tests/test_races.py b/student_tests/test_races.py new file mode 100644 index 0000000..6087556 --- /dev/null +++ b/student_tests/test_races.py @@ -0,0 +1,116 @@ +"""Тест гонки регистрации: два параллельных POST /users с одним username. + +Ожидаем: один 201, второй 409, в БД ровно один пользователь. +Гонка гарантируется через threading.Barrier — оба запроса стартуют одновременно. +""" +from __future__ import annotations + +import json +import sys +import threading +import urllib.error +import urllib.request +import uuid +from concurrent.futures import ThreadPoolExecutor + +BASE = sys.argv[sys.argv.index("--base-url") + 1] if "--base-url" in sys.argv else "http://localhost:8080" + + +def post_user(username: str, display_name: str, password: str) -> int: + """Отправляет POST /users, возвращает HTTP-код.""" + body = json.dumps( + {"username": username, "display_name": display_name, "password": password}, + ensure_ascii=False, + ).encode("utf-8") + req = urllib.request.Request( + BASE + "/api/v1/users", + data=body, + headers={"Content-Type": "application/json"}, + method="POST", + ) + try: + resp = urllib.request.urlopen(req, timeout=10) + return resp.code + except urllib.error.HTTPError as e: + return e.code + + +def main() -> None: + username = "race_" + uuid.uuid4().hex[:12] + password = "race-pass-1234567890" + barrier = threading.Barrier(2) + + def worker(display_name: str) -> int: + barrier.wait() # старт одновременно + return post_user(username, display_name, password) + + with ThreadPoolExecutor(max_workers=2) as pool: + results = list(pool.map(worker, ["Первый", "Второй"])) + + results.sort() + print(f"HTTP codes: {results}") + + assert results == [201, 409], f"expected [201, 409], got {results}" + print(f"PASS: race — one 201, one 409 for username={username}") + +def test_chat_rollback() -> None: + """Попытка создать чат с несуществующим участником → 400, чат не создан.""" + import base64 + + # Создаём пользователя + username = "rollback_" + uuid.uuid4().hex[:8] + password = "rollback-pass-1234567890" + code = post_user(username, "Rollback", password) + assert code == 201, f"failed to create user: {code}" + + # Логинимся + cred = base64.b64encode(f"{username}:{password}".encode()).decode() + req = urllib.request.Request( + BASE + "/api/v1/auth/sessions", + headers={"Authorization": "Basic " + cred}, + method="POST", + ) + resp = urllib.request.urlopen(req) + session = json.loads(resp.read()) + token = session["token"] + user_id = session["user"]["id"] + + # Пытаемся создать чат с несуществующим UUID + fake_user = "00000000-0000-4000-8000-000000000000" + body = json.dumps( + {"title": "Bad chat", "member_ids": [user_id, fake_user]}, + ensure_ascii=False, + ).encode("utf-8") + req = urllib.request.Request( + BASE + "/api/v1/chats", + data=body, + headers={ + "Content-Type": "application/json", + "Authorization": "Bearer " + token, + }, + method="POST", + ) + try: + urllib.request.urlopen(req, timeout=10) + code = 200 + except urllib.error.HTTPError as e: + code = e.code + + assert code == 400, f"expected 400 for unknown member, got {code}" + + # Проверяем, что чат не создан — list chats не должен его содержать + req = urllib.request.Request( + BASE + "/api/v1/chats?limit=100", + headers={"Authorization": "Bearer " + token}, + ) + resp = urllib.request.urlopen(req) + page = json.loads(resp.read()) + titles = [c["title"] for c in page["items"]] + assert "Bad chat" not in titles, f"chat was created despite failure: {titles}" + + print("PASS: rollback — chat not created when member is unknown") + + +if __name__ == "__main__": + main() + test_chat_rollback() \ No newline at end of file diff --git a/student_tests/test_variants.py b/student_tests/test_variants.py new file mode 100644 index 0000000..0b178bc --- /dev/null +++ b/student_tests/test_variants.py @@ -0,0 +1,171 @@ +"""Проверка crop 128×128 и optimized WebP 1280×1280 (lab5 grade 4). + +Запуск: + python3 student_tests/test_variants.py --base-url http://localhost:8080 +""" +from __future__ import annotations + +import base64 +import json +import sys +import time +import urllib.error +import urllib.request +import uuid +from pathlib import Path + +BASE = ( + sys.argv[sys.argv.index("--base-url") + 1] + if "--base-url" in sys.argv + else "http://localhost:8080" +) +ROOT = Path(__file__).resolve().parent.parent + + +def call(method, path, headers=None, body=None, raw=None, timeout=30): + data = None + h = dict(headers or {}) + if body is not None: + data = json.dumps(body, ensure_ascii=False).encode("utf-8") + h["Content-Type"] = "application/json" + elif raw is not None: + data = raw + req = urllib.request.Request(BASE + path, data=data, headers=h, method=method) + try: + resp = urllib.request.urlopen(req, timeout=timeout) + payload = resp.read() + return resp.status, payload, dict(resp.headers) + except urllib.error.HTTPError as e: + payload = e.read() + return e.code, payload, dict(e.headers) + + +def jpeg_size(data: bytes) -> tuple[int, int]: + assert data[:2] == b"\xff\xd8", "not a JPEG" + i = 2 + sof = {0xc0, 0xc1, 0xc2, 0xc3, 0xc5, 0xc6, 0xc7, 0xc9, 0xca, 0xcb, 0xcd, 0xce, 0xcf} + while i < len(data): + while i < len(data) and data[i] == 0xff: + i += 1 + marker = data[i] + i += 1 + if marker in {0xd9, 0xda}: + break + if marker in {0x01, 0xd8} or 0xd0 <= marker <= 0xd7: + continue + length = int.from_bytes(data[i:i+2], "big") + if marker in sof: + return (int.from_bytes(data[i+5:i+7], "big"), + int.from_bytes(data[i+3:i+5], "big")) + i += length + raise AssertionError("JPEG SOF not found") + + +def webp_size(data: bytes) -> tuple[int, int]: + assert data[:4] == b"RIFF" and data[8:12] == b"WEBP", "not a WebP" + # VP8L (lossless) или VP8 (lossy) + chunk = data[12:16] + if chunk == b"VP8 ": + i = data.index(b"\x9d\x01\x2a", 20) + w = int.from_bytes(data[i+3:i+5], "little") & 0x3fff + h = int.from_bytes(data[i+5:i+7], "little") & 0x3fff + return w, h + if chunk == b"VP8L": + b = data[21:25] + bits = int.from_bytes(b, "little") + w = (bits & 0x3FFF) + 1 + h = ((bits >> 14) & 0x3FFF) + 1 + return w, h + raise AssertionError("unknown WebP chunk") + + +def main(): + username = "variants_" + uuid.uuid4().hex[:10] + password = "variants-pass-1234567890" + code, _, _ = call("POST", "/api/v1/users", body={ + "username": username, "display_name": "Variants", "password": password, + }) + assert code == 201, f"register failed: {code}" + cred = base64.b64encode(f"{username}:{password}".encode()).decode() + code, payload, _ = call("POST", "/api/v1/auth/sessions", + headers={"Authorization": "Basic " + cred}) + assert code == 201, f"login failed: {code}" + session = json.loads(payload) + token = session["token"] + user_id = session["user"]["id"] + + code, payload, _ = call("POST", "/api/v1/chats", + headers={"Authorization": "Bearer " + token}, + body={"title": "Variants", "member_ids": [user_id]}) + assert code == 201, f"chat failed: {code}" + chat_id = json.loads(payload)["id"] + + fixture = (ROOT / "tests/fixtures/sample.png").read_bytes() + code, payload, _ = call( + "POST", + f"/api/v1/chats/{chat_id}/attachments?filename=sample.png", + headers={"Authorization": "Bearer " + token, "Content-Type": "image/png"}, + raw=fixture, + ) + assert code == 202, f"upload failed: {code}" + att_id = json.loads(payload)["id"] + print(f"upload: 202 queued ({att_id})") + + # Ждём ready + deadline = time.monotonic() + 60 + att = None + while time.monotonic() < deadline: + code, payload, _ = call("GET", f"/api/v1/attachments/{att_id}", + headers={"Authorization": "Bearer " + token}) + if code == 200: + att = json.loads(payload) + if att["status"] == "ready": + break + time.sleep(0.5) + assert att and att["status"] == "ready", f"not ready: {att}" + + variants = {v["name"]: v for v in att["variants"]} + print(f"variants: {list(variants.keys())}") + + # --- thumbnail --- + assert "thumbnail" in variants, "missing thumbnail" + code, thumb_bytes, headers = call( + "GET", f"/api/v1/attachments/{att_id}/content?variant=thumbnail", + headers={"Authorization": "Bearer " + token}, + ) + assert code == 200, f"thumbnail download: {code}" + assert headers.get("content-type", "").startswith("image/jpeg") + w, h = jpeg_size(thumb_bytes) + assert (w, h) == (256, 160), f"thumbnail {w}x{h}, expected 256x160" + print(f"PASS: thumbnail 256x160 ({len(thumb_bytes)} bytes)") + + # --- crop --- + assert "crop" in variants, "missing crop" + code, crop_bytes, headers = call( + "GET", f"/api/v1/attachments/{att_id}/content?variant=crop", + headers={"Authorization": "Bearer " + token}, + ) + assert code == 200, f"crop download: {code}" + assert headers.get("content-type", "").startswith("image/jpeg") + w, h = jpeg_size(crop_bytes) + assert (w, h) == (128, 128), f"crop {w}x{h}, expected 128x128" + print(f"PASS: crop 128x128 ({len(crop_bytes)} bytes)") + + # --- optimized --- + assert "optimized" in variants, "missing optimized" + code, opt_bytes, headers = call( + "GET", f"/api/v1/attachments/{att_id}/content?variant=optimized", + headers={"Authorization": "Bearer " + token}, + ) + assert code == 200, f"optimized download: {code}" + assert headers.get("content-type", "").startswith("image/webp") + w, h = webp_size(opt_bytes) + # fixture 320x200 → вписан в 1280×1280 без увеличения → 320×200 + assert (w, h) == (320, 200), f"optimized {w}x{h}, expected 320x200 (no upscale)" + print(f"PASS: optimized WebP {w}x{h} ({len(opt_bytes)} bytes)") + + print("\nPASS: all variants — thumbnail, crop, optimized") + + +if __name__ == "__main__": + main() \ No newline at end of file diff --git a/student_tests/test_worker_lifecycle.py b/student_tests/test_worker_lifecycle.py new file mode 100644 index 0000000..4522c08 --- /dev/null +++ b/student_tests/test_worker_lifecycle.py @@ -0,0 +1,145 @@ +"""Демонстрация: worker остановлен → 202 queued → worker запущен → ready. + +Требует docker compose. Запуск: + python3 student_tests/test_worker_lifecycle.py --base-url http://localhost:8080 +""" +from __future__ import annotations + +import base64 +import json +import subprocess +import sys +import time +import urllib.error +import urllib.request +import uuid +from pathlib import Path + +BASE = ( + sys.argv[sys.argv.index("--base-url") + 1] + if "--base-url" in sys.argv + else "http://localhost:8080" +) +ROOT = Path(__file__).resolve().parent.parent + + +def call(method, path, headers=None, body=None, raw=None): + data = None + h = dict(headers or {}) + if body is not None: + data = json.dumps(body, ensure_ascii=False).encode("utf-8") + h["Content-Type"] = "application/json" + elif raw is not None: + data = raw + req = urllib.request.Request(BASE + path, data=data, headers=h, method=method) + try: + resp = urllib.request.urlopen(req, timeout=30) + payload = resp.read() + return resp.status, json.loads(payload) if payload else None, dict(resp.headers) + except urllib.error.HTTPError as e: + payload = e.read() + try: + return e.code, json.loads(payload) if payload else None, dict(e.headers) + except Exception: + return e.code, None, dict(e.headers) + + +def compose(*args, check=True): + return subprocess.run( + ["docker", "compose", "--env-file", ".env", *args], + check=check, capture_output=True, text=True, cwd=str(ROOT), + ) + + +def main(): + # 1. Регистрация, логин, чат + username = "lifecycle_" + uuid.uuid4().hex[:10] + password = "lifecycle-pass-1234567890" + code, user, _ = call("POST", "/api/v1/users", body={ + "username": username, "display_name": "Lifecycle", "password": password, + }) + assert code == 201, f"register failed: {code} {user}" + cred = base64.b64encode(f"{username}:{password}".encode()).decode() + code, session, _ = call("POST", "/api/v1/auth/sessions", + headers={"Authorization": "Basic " + cred}) + assert code == 201, f"login failed: {code}" + token = session["token"] + code, chat, _ = call("POST", "/api/v1/chats", + headers={"Authorization": "Bearer " + token}, + body={"title": "Lifecycle", "member_ids": [user["id"]]}) + assert code == 201, f"chat failed: {code}" + chat_id = chat["id"] + + # 2. Остановить worker + compose("stop", "worker") + print("worker stopped") + + try: + # 3. Upload — 202 queued + fixture = (ROOT / "tests/fixtures/sample.png").read_bytes() + code, att, _ = call( + "POST", + f"/api/v1/chats/{chat_id}/attachments?filename=sample.png", + headers={"Authorization": "Bearer " + token, "Content-Type": "image/png"}, + raw=fixture, + ) + assert code == 202, f"upload expected 202, got {code}" + assert att["status"] == "queued", f"expected queued, got {att['status']}" + att_id = att["id"] + print(f"upload: 202 queued ({att_id})") + + # 4. Через 3 секунды — всё ещё queued + time.sleep(3) + code, att, _ = call("GET", f"/api/v1/attachments/{att_id}", + headers={"Authorization": "Bearer " + token}) + assert code == 200, f"get failed: {code}" + assert att["status"] == "queued", f"expected queued, got {att['status']}" + print(f"after 3s: still queued") + + # 5. Запустить worker + try: + compose("up", "-d", "--no-deps", "worker") + except subprocess.CalledProcessError as exc: + print(f"START FAILED: {exc.stderr}", file=sys.stderr) + raise + + # 6. Ждём ready (до 60 сек) + deadline = time.monotonic() + 60 + while time.monotonic() < deadline: + code, att, _ = call("GET", f"/api/v1/attachments/{att_id}", + headers={"Authorization": "Bearer " + token}) + if code == 200 and att["status"] == "ready": + break + if code == 200 and att["status"] == "failed": + raise AssertionError(f"attachment failed: {att['error_code']}") + time.sleep(0.5) + else: + raise AssertionError("attachment did not become ready in 60s") + + # 7. Проверяем variants + variants = [v for v in att["variants"] if v["name"] == "thumbnail"] + assert len(variants) == 1, f"expected 1 thumbnail, got {len(variants)}" + v = variants[0] + assert (v["width"], v["height"]) == (256, 160), \ + f"thumbnail dimensions wrong: {v['width']}x{v['height']}" + print(f"after worker start: ready, thumbnail {v['width']}x{v['height']}") + + # 8. Скачиваем thumbnail (бинарный ответ) + req = urllib.request.Request( + BASE + f"/api/v1/attachments/{att_id}/content?variant=thumbnail", + headers={"Authorization": "Bearer " + token}, + ) + try: + resp = urllib.request.urlopen(req, timeout=30) + except urllib.error.HTTPError as e: + raise AssertionError(f"thumbnail download failed: {e.code}") + thumb_bytes = resp.read() + assert thumb_bytes[:2] == b"\xff\xd8", "not a JPEG" + print(f"thumbnail downloaded: {len(thumb_bytes)} bytes, JPEG") + finally: + # 9. Гарантированно вернуть worker + compose("up", "-d", "--no-deps", "worker", check=False) + + +if __name__ == "__main__": + main() \ No newline at end of file -- 2.54.0