From 0d8afa0f0122cc333e92426a0ea924827b5682f4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EC=A3=BC=EC=88=98=ED=98=84?= Date: Wed, 30 Jul 2025 10:52:51 +0900 Subject: [PATCH] =?UTF-8?q?docs=20=EC=82=AD=EC=A0=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/DOC-000-CHANGELOG-VER2.md | 61 --------- docs/DOC-002-FILE_UPLOAD.md | 93 ------------- docs/DOC-004-HANDLE_EXCEPTION.md | 69 ---------- docs/Logging.md | 43 ------ docs/Menu.md | 37 ----- docs/arch/ADR-001-AUTHENTICATION_POLICY.md | 39 ------ docs/arch/ADR-002-FILE_UPLOAD_POLICY.md | 66 --------- docs/arch/ADR-003-AWS_S3_UPLOAD_STRATEGY.md | 41 ------ .../DIY-001-ADD_JAR_TO_SPRINGBOOT_MAVEN.md | 71 ---------- docs/img/port-adapter.jpg | Bin 14711 -> 0 bytes docs/img/validation.png | Bin 62922 -> 0 bytes docs/validation.md | 127 ------------------ 12 files changed, 647 deletions(-) delete mode 100644 docs/DOC-000-CHANGELOG-VER2.md delete mode 100644 docs/DOC-002-FILE_UPLOAD.md delete mode 100644 docs/DOC-004-HANDLE_EXCEPTION.md delete mode 100644 docs/Logging.md delete mode 100644 docs/Menu.md delete mode 100644 docs/arch/ADR-001-AUTHENTICATION_POLICY.md delete mode 100644 docs/arch/ADR-002-FILE_UPLOAD_POLICY.md delete mode 100644 docs/arch/ADR-003-AWS_S3_UPLOAD_STRATEGY.md delete mode 100644 docs/diy/DIY-001-ADD_JAR_TO_SPRINGBOOT_MAVEN.md delete mode 100644 docs/img/port-adapter.jpg delete mode 100644 docs/img/validation.png delete mode 100644 docs/validation.md diff --git a/docs/DOC-000-CHANGELOG-VER2.md b/docs/DOC-000-CHANGELOG-VER2.md deleted file mode 100644 index 6725f170..00000000 --- a/docs/DOC-000-CHANGELOG-VER2.md +++ /dev/null @@ -1,61 +0,0 @@ -# Recycle 2 버전의 가장 큰 변화 - -## model mapper 에서 생성자 패턴으로의 전환 - -> "자바를 보다 더 컴파일 언어스럽게" - -컴파일 언어의 가장 큰 장점은 compile 시점에 발생할 수 있는 모든 오류를 작성자에게 알려주어 runtime 시 사용자가 마주하게 되는 버그를 최소화 시켜 준다는 점입니다. -엔티티 속성이 변경되거나 추가될 때 이를 사용하는 모든 곳에서 컴파일 에러가 발생한다면 코드 수정자의 입장에서 가장 이상적인 환경이됩니다. - -model mapper 는 이러한 변경의 파급효과를 runtime 시점으로 미뤄버리기에 수정 및 리펙토링 환경에서 매우 해로운 기술입니다. JPA 관점에서도 연관 엔티티간의 조회 및 참조에서 원치않은 동작을 -유발시키며 이를 제어하기는 무척 까다롭습니다. - -새로운 프레임워크 버전 부터 **model mapper 가 제거**되었고, 생성자 패턴을 이용해 엔티티 및 인자, 결과 객체를 교환합니다. 생성자 패턴 적용예는 **예제 게시판**에서 확인 가능합니다. - -## JPA Metamodel 도입 - -JPA 를 이용할 때 엔터티 클래스의 속성을 문자열로 참조해야 하는 경우가 발생합니다 (예: mappedBy="속성명"). -프로젝트 진행 과정에서 해당 속성이 변경(혹은 삭제)되는 경우, 컴파일러는 이를 인지하지 못합니다. 즉, type safe 하지 않습니다. - -이름이 사용되는 곳을 찾아 수작업으로 변경해주어야 하며, 이를 놓친 경우 runtime 과정에서 예상치 못한 에러를 만나게 됩니다. - -JPA 메타모델은 이러한 단점을 피하고 관리되는 엔터티 클래스의 메타데이터에 대한 정적 액세스를 제공하기 위해 도입되었습니다. - -`hibernate-jpamodelgen` maven 모듈을 통해 `target/generated-sources/annotations` 로 정적 JPA Metamodel 클래스들이 생성됩니다. - -``` -$ tree core/target/generated-sources/annotations/ -core/target/generated-sources/annotations/ -`-- app - `-- module - `-- core - `-- config - `-- adapter - `-- persistence - `-- entity - |-- ExBoardAttachment_.java - |-- ExBoard_.java - |-- FrontUser_.java - |-- LoggedInUserEmbeddable_.java - ... -``` - -JPA 사양에 따라 생성된 클래스는 해당 엔티티 클래스와 동일한 패키지에 상주하며 끝에 "_"(언더스코어)가 추가된 동일한 이름을 갖습니다. - -이제 Metamodel 클래스를 이용해 type safe 프로그래밍을 해봅시다. - -```java -// Metamodel 적용 전 -@OneToMany(mappedBy = "exBoard", ...}) -private Set attachments; - -// Metamodel 적용 후 -@OneToMany(mappedBy = ExBoardAttachment_.EX_BOARD, ...}) -private Set attachments; -``` - -정적 Metamodel 클래스는 maven compile 단계에서 생성되며 IDE 에서 어플리케이션 구동 시 빌드과정에서 자동으로 수행됩니다. - -생성된 모델을 참조하기 위해서는 `target/generated-sources` 경로가 IDE 의 **classpath** 에 추가되어야 합니다. - -인텔리제이의 경우, File > Project Structure > Modules > target\generated-sources 우클릭 후 Sources 체크 해주면 됩니다. diff --git a/docs/DOC-002-FILE_UPLOAD.md b/docs/DOC-002-FILE_UPLOAD.md deleted file mode 100644 index 2cae7807..00000000 --- a/docs/DOC-002-FILE_UPLOAD.md +++ /dev/null @@ -1,93 +0,0 @@ -# DOC-002: 파일 업로드 - -## Introduction - -파일을 업로드하는데 `LOCAL`과 `S3` 두가지 전략이 있다. `LOCAL`은 WAS 가 접근가능한 저장공간을 제어하는 정책(기본)이며, -`S3`는 AWS의 저장 스토리지를 다루는 전략이다. -어떤 전략을 취하든 우리는 동일한 인터페이스를 이용하면 된다. - -## Interface - -**SaveToStorageService** 의 operate 메서드를 호출해 파일 업로드를 수행한다. - -|Arguments|Description -|---|--- -|FileUploadType| 파일 타입과 업로드 전략 등 파일 업로드에 필요한 정보를 담은 enum 객체 -|MultipartFile| 업로드 Multipart File -* FileUploadType 에 정의한 FileStorageType 설정값(`Local` or `S3`) 을 통해 업로드 공간이 결정된다. - -|반환 타입|설명 -|---|--- -|Optional\| ... - - -## Set up - -파일 업로드에 관한 공통 설정은 `core.properties` 에 선언했다. - -```properties -spring.servlet.multipart.max-file-size=10MB -spring.servlet.multipart.max-request-size=50MB -spring.servlet.multipart.file-size-threshold=1MB -``` - -스프링 profile 별로 차별화된 설정은 `core-${spring.profiles.active}.properties` 에 기술한다. - -(예) core-local.properties -```properties -# `Public` 업로드 경로 -path.upload.public=${user.home}/upload/public - -# file-size-threshold 용량이 넘는 파일 업로드시 사용할 임시 디렉토리 -path.upload.tmpdir=${user.home}/upload/tmpdir -spring.servlet.multipart.location=${path.upload.tmpdir} -``` - -* `path.upload.tmpdir`는 multipart 용량이 `file-size-threshold`을 초과할 때 - 임시적으로 파일을 저장 할 수 있는 공간이다. - - -## How to use - -파일 업로드는 `SaveToStorageService` 를 이용한다. -```java -// 예제 게시판 업로드 -SaveToStorageService.operate(FileUploadType.EXAMPLE_PUBLIC, multipartFile); -``` - -* `FileUploadType` 은 파일 업로드 타입과 저장 경로, 그리고 외부 공개여부에 대한 정보를 정의한 enum 객체이다. - -* `multipartFile` 사용자가 선택한 파일 객체. - -FileUploadType 객체는 파일 업로드와 관한 필수 정보를 담고 있다. -**추후 새로운 파일 업로드 기능이 추가 될때 마다 이곳에 관련 정보를 기술**해야합니다. - -```java -// FileUploadType.EXAMPLE_PUBLIC 에 정의된 정보 -... -EXAMPLE_PUBLIC( - FileStorageType.LOCAL, // fileStorageType - "/exampleBoard", // sub 디렉토리 - Set.of( // 허용 타입 - AcceptableFileType.IMAGE, - AcceptableFileType.EXCEL, - AcceptableFileType.PPT, - AcceptableFileType.HWP, - AcceptableFileType.WORD, - AcceptableFileType.CSV, - AcceptableFileType.TXT, - AcceptableFileType.PDF, - AcceptableFileType.ZIP)), -``` - -* `fileStorageType`은 파일이 저장될 공간. `LOCAL`과 `S3`가 제공된다. -* `subPath`는 게시판에 따른 분류 등으로 사용할 때 이용. 공지사항 게시물의 업로드 파일이기에 /exampleBoard 서브 경로에 담도록 지정했다. -* `acceptableFileTypes` 에 허용할 파일 타입을 명시. 지정된 파일 타입과 다른 파일이 업로드 될때 `UnAcceptableFileExceoption` 이 발생한다. - - -### acceptableFileTypes -`SaveToStorageService`는 `acceptableFileTypes` 에 기술된 -FileType 을 기준으로 검증작업을 수행한다. multipartFile 을 inputstream 으로 읽어 MIME Type 적합성 여부를 판단한다. - -## References -[파일 업로드 시 MIME 타입 확인](https://github.com/devheedoo/TIW/blob/master/%5BJava%5D%20%ED%8C%8C%EC%9D%BC%20%EC%97%85%EB%A1%9C%EB%93%9C%20%EC%8B%9C%20MIME%20%ED%83%80%EC%9E%85%20%ED%99%95%EC%9D%B8.md) diff --git a/docs/DOC-004-HANDLE_EXCEPTION.md b/docs/DOC-004-HANDLE_EXCEPTION.md deleted file mode 100644 index a3f37ada..00000000 --- a/docs/DOC-004-HANDLE_EXCEPTION.md +++ /dev/null @@ -1,69 +0,0 @@ -# DOC-004: 예외처리 가이드 - -## Introduction - -예외를 처리하는데 공통되고 일관된 처리 방식이 필요하다. - -프로그램 수행 중 발생하는 모든 예외처리는 @ControllerAdvice 객체인 `GlobalControllerAdvice.java` 가 담당합니다. - -@ControllerAdvice 는 @Controller 에서 발생된 모든 예외를 처리하지만, -Interceptor 에서 발생한 예외(스프링 시큐리티 권한체크 포함)는 처리하지 못한다는 점에 유의하세요. -이에 대한 예외 또한 커스터마이징 하고 싶다면 ErrorController 를 구현해주면 됩니다. 아래 문서를 참고하세요. - -[Spring Boot 에서 에러 페이지 처리하기](https://eblo.tistory.com/50) -[스프링부트 커스텀 error](https://juyoungkim223.github.io/springboot/error/ErrorController/) - -## Runtime 예외처리 - -프로그램 수행 중 발생하는 모든 예외처리는 @ControllerAdvice 객체인 `GlobalControllerAdvice.java` 가 담당합니다. - -코드 실행 시 발생하는 예측불가한 에러뿐 아니라 코드 작성자가 발생시키는 Runtime 예외 또한 해당 Advice 객체가 처리합니다. - -프레임워크는 사용자에게 정확한 정보전달을 위해 명시적으로 예외를 발생시키는 방식을 **적극적으로 권장**합니다. - -아래 예제는 잘못된 adminId 전달 시 이를 사용자에게 알리는 예외처리 코드입니다. -```java -public Admin getItem(String adminId) { - return adminRepository - .findById(adminId) - .orElseThrow( - () -> new NoSuchElementException(String.format("%s 는 존재하지 않는 아이디입니다.", adminId))); - } -``` -발생된 예외는 `GlobalControllerAdvice.java` 에 의해 일반 요청인지 Ajax 요청인지를 판단 후 적절한 형식으로 반환합니다. - -* 일반 요청: 에러 정보를 model 객체에 담은 뒤 에러 페이지 전달 -* AJAX 요청: 에러 정보를 JSON 응답 형식으로 전달 - -사용자는 에러 메세지를 통해 에러 발생 원인을 파악해 볼 수 있습니다. - -코드 작성자가 이용할 수 있는 예외 객체로 NoSuchElementException, IllegalArgumentException 등 자바 혹은 사용중인 모듈에서 -제공하는 기본 RuntimeException 예외객체를 이용하는걸 추천합니다. 물론 코드 작성자가 임의로 만든 커스텀 예외객체를 이용해도 됩니다. - - -### AJAX(비동기) 예외 처리 시 권장사항 - -Ajax 요청에 대한 예외처리시 `GlobalControllerAdvice.java` 는 HTTP 상태코드로 400 (HttpStatus.BAD_REQUEST) 을 전달합니다. - -jQuery 를 이용한 ajax 호출 방식에서 응답 status code 에 따른 처리를 선언하는 것을 **적극적으로 권장**합니다. -```javascript -$.ajax({ - type: 'GET', - url: '/api/uri/get/' + f.appType.value + '/' + data.id, - statusCode: { - // 400 - BAD_REQUEST - 400: function (response) { - alert(response.responseJSON.message); - } - }, -``` - -응답을 처리하는 Javascript 는 message 속성을 alert 로 보여주는 등의 방식으로 사용자에게 에러 내용을 보여줄 수 있습니다. - -$.ajax 의 fail 콜백함수를 사용해도 되지만, -예외 처리 이외에도 validation 실패 시 422 를 전달하는 등 다른 부가기능들도 프레임워크가 제공하기에 -statusCode 선언을 통한 처리방식이 효율적입니다. - -## 참고문서 -[Spring 의 다양한 예외 처리 방법](https://mangkyu.tistory.com/204) -[DispatcherServlet 의 예외처리 전략 (Interceptor 예외처리 전략)](https://velog.io/@gillog/Java-HandlerInterceptor%EB%8B%A8-Exception-Handling%ED%95%98%EA%B8%B0HandlerExceptionResolver-ExceptionHandler) diff --git a/docs/Logging.md b/docs/Logging.md deleted file mode 100644 index 030dd5e1..00000000 --- a/docs/Logging.md +++ /dev/null @@ -1,43 +0,0 @@ -# Logging (logback) 가이드 - -로깅 설정은 구동중인 인스턴스의 `logback-spring.xml`과 `application-${spring.profiles.active}.properties` 에 기술되어 있습니다. - -logback-spring.xml -```xml - - ... - - ... - -``` - -application-local.properties -```properties -# -# █████╗ ██████╗ ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗███╗ ██╗ ██████╗ -# ██╔══██╗██╔══██╗██╔══██╗ ██║ ██╔═══██╗██╔════╝ ██╔════╝ ██║████╗ ██║██╔════╝ -# ███████║██████╔╝██████╔╝ ██║ ██║ ██║██║ ███╗██║ ███╗██║██╔██╗ ██║██║ ███╗ -# ██╔══██║██╔═══╝ ██╔═══╝ ██║ ██║ ██║██║ ██║██║ ██║██║██║╚██╗██║██║ ██║ -# ██║ ██║██║ ██║ ███████╗╚██████╔╝╚██████╔╝╚██████╔╝██║██║ ╚████║╚██████╔╝ -# ╚═╝ ╚═╝╚═╝ ╚═╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝╚═╝ ╚═══╝ ╚═════╝ -logging.file.path=${user.home}/logs -# -# application 의 기본 패키지(app.module) 와 로깅 레벨(DEBUG) 설정 -# 기본 패키지 변경 시 app.module 부분을 반드시 치환해 주어야 application 로그가 출력되니 유의 -logging.level.app.module=DEBUG -``` - -* `logging.file.path` 로그파일이 생성될 위치 -* `logging.level`.app.module 여러분의 어플리케이션 기본 패키지. 해당 패키지 하부의 로그 출력 Level을 설정합니다. - -### 생성 로그 파일 -`logging.file.path` 경로에 두가지 파일이 생성됩니다. - -|로그파일|설명| -|---|---| -|`APP_LOG_FILE`.log| 전체 로그 파일| -|`APP_LOG_FILE`-ERROR.log| 에러 로그 파일| - -에러 로그 파일에는 전체 로그 파일에서 ERROR 부분을 필터링해 별도로 생성한 파일입니다. 이는 운영관점에서 큰 이점을 가져다줍니다. - -로그 보관 주기나 파일 Rolling 정책 등은 /src/main/resources/`logback-spring.xml` 을 확인하세요. diff --git a/docs/Menu.md b/docs/Menu.md deleted file mode 100644 index 806ebe16..00000000 --- a/docs/Menu.md +++ /dev/null @@ -1,37 +0,0 @@ -# Menu 관리 - -Menu 는 관리자 - Settings - Menu 관리 화면을 통해 관리됩니다. - -Tree View UI 를 통해 부모/자식 노드 관계를 유용하게 적용할 수 있습니다. - -### SEO (검색엔진 최적화) - -ogTitle, ogDesc, ogKeywords, ogImage 등 속성값 입력을 통해 현재 메뉴의 meta 및 og 정보가 화면에 노출됩니다. - -```thymeleafexpressions - - - - - - - - - - -``` - -경우에 따라 특정 페이지에서 SEO 관련 정보를 변경하고 싶을 때가 있습니다. -예를들어, 제품 상세 페이지는 해당 상품의 고유값에 따라 동적으로 정보가 생성됩니다. -각 제품별로 SEO 정보를 다르게 보여주고 싶다면 Controller 단에서 변경작업을 해주면 됩니다. - -```java - // title, seo 속성 변경 예제 - Menu currentURI = ((Menu) request.getAttribute("currentURI")).toBuilder().build(); - currentURI.setOgTitle("modified - exBoardEntity title"); - currentURI.setOgKeywords("modified - exBoardEntity keywords"); - currentURI.setOgDesc("modified - description"); - model.addAttribute("currentURI", currentURI); -``` - -request 에서 조회된 currentURI 를 기반으로 새로운 Menu 를 생성(toBuilder)한 후 속성을 갱신해 model 에 넣어주면 됩니다. diff --git a/docs/arch/ADR-001-AUTHENTICATION_POLICY.md b/docs/arch/ADR-001-AUTHENTICATION_POLICY.md deleted file mode 100644 index 53d66588..00000000 --- a/docs/arch/ADR-001-AUTHENTICATION_POLICY.md +++ /dev/null @@ -1,39 +0,0 @@ -# **ADR-001:** 사용자 인증 및 정보 보안 정책 - -## Context - -스프링 시큐리티를 이용하는 것만으로도 실제 업계에서 요구하는 주요 보안점검 항목들이 상당부분 충족된다. -보안을 중시하는 기업형 어플리케이션을 제작하는데 필요한 몇가지 추가 요구조건들을 구현해 놓으면, 추후 프로젝트를 수행하는데 큰 도움이 된다. - -## Decision - -스프링 시큐리티의 기본 정책 이외에 필드에서 요구되는 주요한 요구 항목을 아래와 같이 정의한다. - -* 패스워드 유효기간은 사용자 설정을 따른다. -* 패스워드 만료 몇일전 부터 안내 메시지를 보여줄지는 사용자 설정을 따른다. -* 관리자는 disabled 필드를 이용해 특정 사용자의 비활성화 여부를 관리한다. -* 패스워드 5회 이상 오류 시 locked 필드를 이용해 사용자는 잠김처리 된다. -* 중복 로그인 허용 횟수는 사용자 설정을 따른다. -* 로그인 세션 유지 기간은 사용자 설정을 따른다. - -## Status -`Accepted` - -## Consequence - -현재 구현된 항목은 아래와 같다. - -* 패스워드 유효기간 설정 (90일) - - `app.admin.password.validity.period.days=90` - - -1 을 줄 경우 유효기간 체크를 하지 않는다. -* 패스워드 유효기간 만료 7일전 부터 안내 메시지 보이기 - - `app.admin.password.change.notice.period.days=7` -* 관리자는 disabled 필드를 이용해 특정 사용자의 비활성화 여부를 관리한다. -* 패스워드 5회 이상 오류 시 locked 필드를 이용해 사용자는 잠김처리 된다. - - `app.admin.auth.fail.permit=5` - - 잠김 처리 시 사용자가 패스워드를 초기화하는 기능은 아직 구현되지 않았다. 현재는 관리자에게 문의하라는 메세지를 보여준다. -* 중복 로그인 허용 횟수는 유동적으로 조절이 가능하다. - - `app.admin.session.maximum.num=1` - - max 가 1인 경우 중복 로그인이 발생하면 이전 세션을 차단하고 로그인 한다는 메세지가 사용자에게 보여진다. -* 로그인 세션 유지 기간 설정이 가능하다. - - `app.admin.session.validity.period.seconds=3600` diff --git a/docs/arch/ADR-002-FILE_UPLOAD_POLICY.md b/docs/arch/ADR-002-FILE_UPLOAD_POLICY.md deleted file mode 100644 index e92a9ceb..00000000 --- a/docs/arch/ADR-002-FILE_UPLOAD_POLICY.md +++ /dev/null @@ -1,66 +0,0 @@ -# **ADR-002:** 파일 업로드 및 참조 정책 - -## Context - -사용자가 업로드한 파일은 전체 공개(public)를 목적으로 한다. 업로드한 파일을 참조하는데 두가지 방식이 있다. 파일 참조 시 -브라우저 기본 기능이나 연결 프로그램을 통해 파일이 오픈되는 `INLINE` 방식과 -외부 간섭없이 다이렉트 파일 다운로드를 수행하는 `ATTACHMENT` 방식이다. - -## Decision - -`path.upload.public` 설정을 통해 업로드 경로를 지정한다. -```properties -path.upload.public=${user.home}/upload/public -``` - -INLINE 파일 참조 URL 은 아래 형식으로 구성된다. -``` -/content-disposition/inline/파일경로/파일명.확장자 -``` - -ATTACHMENT 파일 참조 URL 은 아래 형식으로 구성된다. -``` -/content-disposition/attachment/파일아이디 -``` - -## Status -`Accepted` - -## Consequence - -### WAS 의 `Public` `INLINE` 참조 방식 설정 -`Public` 공개 범위의 `INLINE` 업로드 경로를 리소스 핸들러로 지정했다. - -```java - @Override - public void addResourceHandlers(ResourceHandlerRegistry registry) { - registry - .addResourceHandler("/content-disposition/inline/**") - .addResourceLocations("file:///" + publicPath + "/") - .setCachePeriod(20); - } -``` -* 위 경로에 업로드된 파일은 스프링 @Controller 를 거치지 않고, URL 로 직접 참조가 가능하다. -* 웹서버가 없는 로컬 개발환경에서 테스트하기 적합하다. - -### 웹서버의 `Public` `INLINE` 참조 방식 설정 -웹서버의 경우, 가상 호스트 설정에서 Alias 를 이용해 `/content-disposition/inline` 경로와 `Public` 업로드 경로를 -연결해주면 된다. `` 선언을 추가해서 웹서버가 해당 디렉토리로 접근할 수 있는 권한을 부여한다. - -``` -JkUnMount /content-disposition/inline/* [워커 이름] -Alias /content-disposition/inline "[Public 업로드 경로]" - - - Options FollowSymLinks - AllowOverride All - Require all granted - Allow from all - -``` -* `JkUnMount` 를 지정해 해당 경로의 자원을 WAS 가 아닌 웹서버가 전달하도록 설정한다. - -### WAS 의 `ATTACHMENT` 참조 방식 설정 - -`ATTACHMENT` 참조 방식은 웹서버가 아닌 WAS 에서만 처리 가능하다. -`GetAttachmentController` 가 해당 역할을 담당한다. \ No newline at end of file diff --git a/docs/arch/ADR-003-AWS_S3_UPLOAD_STRATEGY.md b/docs/arch/ADR-003-AWS_S3_UPLOAD_STRATEGY.md deleted file mode 100644 index 63d14fcb..00000000 --- a/docs/arch/ADR-003-AWS_S3_UPLOAD_STRATEGY.md +++ /dev/null @@ -1,41 +0,0 @@ -# **ADR-003:** AWS S3 파일 업로드 전략 - -## Context - -로컬 스토리지를 이용해 파일을 업로드하는 기본 전략 (참고: [ADR-002-FILE_UPLOAD_POLICY.md](./ADR-002-FILE_UPLOAD_POLICY.md)) 이외에 AWS S3 로 -파일을 올리고 CloudFront 를 통해 파일이 제공되는 새로운 전략이 필요했다. - -## Decision - -AWS S3 파일 업로드 기능 제공을 위해 새로운 전략을 구현한다. -새로운 전략은 기존과 동일한 파일 업로드 서비스 인터페이스를 이용하며, -`Public`, `Private` 공개범위를 가진다. - -공개범위에 따른 `INLINE`, `ATTACHMENT` 응답 해더는 구현 가능한 범위 내에서 한정적으로 제공한다. - -## Status -`Accepted` - -## Consequence - -`aws` maven 서브 모듈이 추가되었다. S3 파일 업로드 전략과 CloudFront 도메인으로 파일을 참조하는 전략을 담고 있다. -(훗날 새로운 AWS 기능이 필요하면 이 모듈에 추가될 것이다.) - -S3 업로드가 필요하다면 `aws` 모듈을 종속성에 추가해주면 된다. -```xml - - app.module - aws - 0.0.1-SNAPSHOT - -``` - -`aws` 모듈의 `aws.properties` 와 `aws-{spring.active.profile}.properties` 에 -S3와 CloudFront 를 이용하기 위한 설정 정보를 기입해야 한다. - -`Content-Disposition` 은 `INLINE` 참조 방식만 제공한다. - -| 공개 범위 | Content-Disposition | URL | -|---|---|---| -| `Public` | `INLINE` | ${app.aws.s3.domain}/파일경로/파일명.확장자 -| | `ATTACHMENT` | /content-disposition/attachment/{파일아이디} diff --git a/docs/diy/DIY-001-ADD_JAR_TO_SPRINGBOOT_MAVEN.md b/docs/diy/DIY-001-ADD_JAR_TO_SPRINGBOOT_MAVEN.md deleted file mode 100644 index 7c85a42c..00000000 --- a/docs/diy/DIY-001-ADD_JAR_TO_SPRINGBOOT_MAVEN.md +++ /dev/null @@ -1,71 +0,0 @@ -# DIY-001: 스프링부트 Maven 프로젝트에 jar 라이브러리 추가하기 - -## Introduction - -Maven 기반 스프링부트 프로젝트 구성에는 WEB-INF/lib 디렉토리가 없다. -외부 경로를 통해 얻은 jar 를 프로젝트에 포함시키려면 아래 작업이 필요하다. - -이 예제는 front 모듈에 외부 jar 파일(INIpaySample_v1.3.jar)을 인식시키는 과정을 예로 든다. - -## webapp/WEB-INF/lib 디렉토리 생성 - -src/main 밑에 `webapp/WEB-INF/lib` 디렉토리를 생성한다. - -```shell -. -|-- pom.xml -|-- src -| |-- main -| | |-- java -| | |-- resources -| | `-- webapp -| | `-- WEB-INF -| | `-- lib -| | `-- INIpaySample_v1.3.jar -``` - -이 경로에 담긴 jar 파일은 패키징(`war` or `jar`) 결과물의 WEB-INF/lib 경로에 자동 포함된다. - -물론 패키징 결과물을 만들기 위해서 빌드(`compile`)과정이 성공해야 한다. -이를 위해 spring-boot-maven-plugin 이 필요하다 - -## spring-boot-maven-plugin 플러그인 - - -front/pom.xml 에 아래 내용을 추가한다. - -```xml - - ... - ${basedir}/src/main/webapp/WEB-INF/lib - - - - ... - - external - external - 1.0 - system - ${webapp.lib}/INIpaySample_v1.3.jar - - - - - - - org.springframework.boot - spring-boot-maven-plugin - 2.6.3 - - true - - - - -``` - -**중요** -위 예제에서 인클루드된 jar 파일은 `system` 스코프를 가진다. `system`은 `provided`와 동일하게 -runtime 실행 시 JDK 혹은 외부 Container 에서 제공된다는 의미기에 최종 빌드과정에서는 포함되지 않는다. -하지만 src/main/webapp 이라는 maven 규약 경로에 WEB-INF/lib 을 만들 었기에 최종 빌드 결과물의 WEB-INF/lib 에 담기게 된다. diff --git a/docs/img/port-adapter.jpg b/docs/img/port-adapter.jpg deleted file mode 100644 index ca1d9f760e343f89d7082a406878b26c7d3fc0bc..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 14711 zcmb7rcT`i`*6&VFs5|t|CLl%*C3Hf~hR_r+Xt1JE0@7>f3MmK?TLc6I%N7-ZqX>9V zKvAgzDh36WqZ~y=BL}gef*?H3{qFtVdt-d#jqz6g*?X-uf3xg4=c-wLy8IFV*LwMS z0VoszpjLjs@&usanHe1k0KUE^01^1#WqAT~FpA4faWA3SI9ZjF*80XK7tzxWyZ%Pq&jB0Q2qt(xbpl@wFL$GR~K%q3kCj%E40O*1$iW< zL_l`tG_!CT%?`4sn_Jr1*xOp0LRK^@OADHng{7^TrKO{-m7}FK^zTAh;g-UQblkx7 z`ZuqYHy6skmCDG-Fwd|yPfXcuVM(Xc|G}`bGF$0kmYS8o4b3!5NHzQq0y82tJS94b z8=aT{{eu`9mYBwMp{z*yUn;~W`TPGj@c(G7`1pVH`d9B%?uLl}Eyn-YJC&W46k)L; zA~i8BB|KuKyWxL`S8VtHX7o?T6=@vTr$n!Ol+ZY4Vt877L;}~B=|Wj)G3P{c9IZp? zHV$^yVP=+Lkv3*F;gJqzVYDy@vj`e3l5S;VOS5vY{twRoMDGAwdwICqS~|dX?v|FG z?sQ8}J9itJHO<4`&K9<}{|~KiLMk^jAw1$gyrWlm|C^Tf|D<*FNQnsLCZ@0x6XX8l z1+1t9Iuqbc<5hdc8vZXM6k5B zx3#ig(VR}Rw>Pt)hp(s~YQ-@NcZjg2JJ{NVSz1R>{!P#MKg{=EZn{#lqDInxq;a&d zbFiav!tBi~ZNlu#EbVRV%^bqR>1H%qXqZEISg57FEuCVqBBI4Vp7Vcr(toN}-1DEu z|Bj25m;a8eh=i4JN?D1U z1%0K(nEX%EKk)y+{;Qz=1&vj*3Qbmq1CKU!4ln-+$YECGA!EpZ8?b~-Jk9X*a~@jP zj<1Dg`1M2yG!(T3lH`c>xvGEOs+Vb_bXbmJ*I#8}PaO$)3==GNYZB3aZPy(GZZ{@K!M*a`!lR?!b4de$86o>oiYi`?L`L1hSU_s#XiT)5UdgIQ!}pst+_$>!9(% z*FlnHKothG4%3NR3BSbfCr#YQ6OQbraS8BpS3Wsu+xUzi^u84fyWv}RDenHlG(YwF z4+g)*r;BJWMax_ix-peiWYv?WdCevd_V{NCYMs+v=Y+@)MUT4O3&c8e9M;`+A1VI*%*5c-TOpFGtMt_d8&0<&Yd9KBvNaAA%Cc1}4$^0M3W z$tulq1sOwYab2V<2b1_=UK7~oNQE8C`#Y$&;7EL;UybTmXeT-y(3QlV|ANNdN)VbW z^nA=$#|uZXI!m=mq)WfGh&i@eCqbuEJxJB3aXv$>l}ijicpVa{XK=}ybQra5SE>Be zUU5*b#B;_2Iu2w%;ehS9K34J>`i#%|)K5OBCtA|=nX+;G_)A>b#Anr{)77M_ z-v^*yFa*Pl*< zw!4fHcbi6+s<+FuCD4%LQ(F(4^Ak*j#=K!PK`M-|Y?1i8Tess*>;+9zLwSPNV-VwA zJL_t{F&j(BO9TAnosj$5hr~e_J_v{|^rRkfbbq zmDtt&afpztxF#0rggSOK@=WL9O)J&}J?|^F%e~orlNF`2I|&TX{M=3w-fG8RpM`DL zIep?86m*XU%D$@>?v$bztmHaCO24_(c*u@1f4JYFXy@~Kuzw{CXEelkR>1bzcH*;A zjQZ1jEp+K1?&2iw{UEMNS4Dld8&lPvWwzF-3X;gh@KJ|i=9;l`?Ib}+^sNZ5eRWfU ziR;MziBfW!m(QN9u;^qhOZ~wH!LMeS{4atxS}DSF*sS0ljR<@v@6XlFL1=@NF5>=I z>YLqH-8U|#Oi1~2%JO_>PJr|_nQ6+hT!Yp-!t#Rf0JbC9f7IuR2NvjIx^O>-e5 zcM!WPAD~pcL?pEXI#l!IL99$hE*Paqi_P`1fw5c|V4N45n)AQBbE?T#P8L~%VD+-CbZ+rcRSS@-p;MnW=ldQ2=SK6 zHJV8kdp_}eR*AC}Djg1m^T=Y|VDO>Z#kWo(Wqd)I;;(^ySF1yA9V?v)tMIvVyacy+ zwQ3oN|H2GZl9EmQY?Tng*-;n?Et~}GI&q)Z|LVukR=M&k|U8R>%}%@a*bM z_G$QlI($HlVZMf=s2!4<8)9+pizb6LzZS=^$)XwFDm=+tsN|Y?0QrtKeWI=bgWEc$ zc=ou$94jn4!OBxYFyv3KcISA>W;XfEvF0QrYkE8t?_H~|ZYlG^|<7XLcEg(Ld zs+>Y;R4Q#Cvvk>zT-=Ux}L{Te($tSg0?9dIt;qNZboPdm@?%qTwKykwV7 zGtpo4NnqKN!n4$sgp?Eu$;zcV15|Vt!(EB9@a+%do%Mm9 z>+2|XwE0YGyC9PB;s+Z~WhoZEZztmIQadC}#bIoM*lj(N3}aQnRE1f#$E{V^x0m0C z2qw|?I5GR_TP*(ZiQH~Y?*v_dwv-k<27@Q6fzFP^& z`vGTjHFBl4%?i9?VF)6j+9`XpJh0k8@nGjun5iks@?>}315<=2BE%{6K>n~X=~y)@ zK#){vupQ0X%m5n>9>d15w#8(%PY~+%+q887cJjX@_}M?DvesK0%mwyOOVv!IMx8EM zuWHE&DFUgW!G-0uSW2E{K)(-TW(2Sci%KUiIk0z-U_DpSZ_7YA3}nKfMN$IGCS+n? z#W;SS|D|oCG(TAu;R4lSeRHLWdKACK>Jl-PZ1l|lR%=mU?U^fFs4H9s$bYS57sGsQ zBDhvT+@snlEpwg*j4Em4w48{jYSde=J0Zf>qgaRBwZu;15?{)LWKmLK{#cT?&l%mg zjfCRJgMS4lcKYdMB1JOZr2LsUMC)+vz5a<~*p0?a0|EG%8RwQeMHtY)JeWL2R(x}~ zN#Rm>AGmY-jX7`M_1~zLDy?BRFR#-jyv#cqeP3VXpS-HXUMEpQAbq2y!2x;`qQ&hpi0X4K5Tbh(B}8NUpGY2;;n=#Gl=QpJ>DAU|BGMLkEx_Q8ickqIMK|2F-??A}WZc4au_YGW+mE4OmDVl&c7k zMTki~4o{H@y~D)6Ni^jaac1?yfbzPz;V#1h7TynXAeU#p(mt47>*jQ6$#huy?cwak zRefn2eXY*-YI|B;{E&lu_jx>bxEgXRIZ9DJezc-`mT39Pu_OI3sbtl?M~n0%jn|^v zJ?vBzxAb^axu^g8!NIE?k8!uCyY zwQ%*M$)V^9_v9c#j({a+%A?2b5CD(&wL=#{_WM!nh#Lp|d$>VxZAxI@!m@3;z*P0r z#eEw?4U*9BWcH6J$+j!7vlmSCMCgnL%p@A$ccKV+l=pmMN&^zo6-*L9^Em$wR)BVb zUJ+62`b|39iMIN@cvT-}AC`!Eo@PU|^2pcoz3^*f*PkF(hRbFIsu`h>N%G{Ve--K2 z>Hq`By3ZO$q9s=6tHTzHp{h=j2*QQ#o(|X2wa0Y&Ulverja2TWAB{8|X^TZMsyjZd zH#9lo*Wpcd0oSMJvAqK|iux(Kct0xM0Bz5pIn02Wwo9amQ>$x_){aWg-5=?P22O=W z7yo4b_8k`8pg54M!oCVO743uPPrud(f4B_DWj;?`)r%^G9SY@^0Uq)>ue*a*IA`JB z$BSoAThi^N9-%-PQ4yh~iq(x&h%blK3QG>utJ75&mLHqt6}BuueBfFV zKgFvPlf&NniC2qU(1sdFsN2(^&Fr5=_}etY6UYH=!WdfP>B*<#gyN`pcJOTwyJ0{M z%@6Xif^Afdh6#n<8b^Yx+1{0!kG#q@DR$;BSu6vAZc*;S_nvaCyZw|9rAg5(IiOWW zqy)x!xhqKgp+hBs?*)77g~M_$x79j|@_p9XR(sJ^PMmvb9dl}wiU zF6z%M1+Nh*-znQ&PAf1h)j3~ot?>EUS!fIv{I#L>eT_cv8!J8Z=NF+-hwi?*QgyWn zyw00crgC8u7hIh@hFgg62t$J7nMyLXlzG^G8ga~qR#u2RriAM~QL_wWvh175zWe;k z2rL_3R}auS^sX|VvT1+L2zNca_k3K;93H5d1eTsql{^HgamI(Tw=xLkN#D3yaUBk@ z(zcqXZSdPuZqN0niB{gjDpm;9VJh;ZYZ-SUE9KR}GywVPQ)YDc(-`z{OPOP_&O&ju z>rwrwdrOl+R-{s5mthzMOcO+_`|DL0-`wckz?KXJ>BXnF!sKJ-#-^V=k9H}RsC<&G zI588$N-}Tp8w>Uvo%#qTjM2ZMm(RhyQ)!lAKtc&;bjNn6CX5_cr9XvHhHgD&TN|Bv?#WP zX;Pk(TfOWLrm}DzDnixs{S_mUi0T^&&g@6WmX4l=Up z%d|y0T)m~^YB(D>E1TRU4Eo)ERLpr?roH8NAzT>P@d&LSliJM32A)8b>P3HCynpNc zk$SmeDbikzB9!;Q2fEWjBK^42fjSX=h9|2<>SRw-fmz5oeU@OgAHMM3j!||$9!97Y z`%8&Q!lWJ#=-c4I#>v3>51VSJ-%|J6AI#VBdjz&u(*2IhwI%x<*AN5)y()ofE2}lf zzv~`Y$A2&Rv5r%<*D(Lmp1Mb8ibGDDP&=)boJ)WT!mrB<5z;S<`sH_ezXUhuOqRRR zKg_4ResCwlCF15Y>pZP*oBkf0{(vk4Pr6TctAaU9k07_f-zaQGuNviG2={>vJmo4y z*WSxp!{R>LM3^LOxLs~Hs1Vn8?+4>a!?s@BW07KqfYdv{LD`0K<$;X)R)bs>Qt}>1 z{`)(k-me|_T~`7FGiC%_*-_X8D~n8e47`m2gJ7m!YU z&!9LSM^hxr)Khl1Cm!L~2p^oOn)n)g?;(@ZvtxhZ&#)Oy_nX%QYm3(B`yA6rzE`9S ze(l?7xFLV9TF^#_QB8>eP;eudz3M<3J2z}^nsVMvi#iqnef>L3z}`kLsfa!^g0VCF z(zRvYFF31;?>RH4`D9m}b6(KfcV9o+yUx9yymGqi+lQOCzUKb<-j!;*@r|#5V;x>@ zr}>pqU}4{lnhKbF%9-6bvAB1S+mTxq8z;-F?v0f_`@WF#V&b&L#(@{kcdw?IJ@|9| zukWYtUJuOtEKOW*_td8N2ZDg4IYt%%@nj7)~>3#On> zCn8Wwmb&_~lgVnAX0iX;HO#4eDx|86)j85IS<8Yx!!rUX_{A!0mR<{oNJx)K;!zsB z(>bz1N7~wnd@(T&O9J%LDF^wO!!rDA+dI|OXONCMhLABrs}~;pl1szA7>r5e>I~LD z;1Zc(Mw{<^c5xotc;>Ub(G@#R>z*s;WQUI3Sz?V|Q!pP4oL$u8UfR6RXJp{OeUm6l z80=3GJ|EmChA74`a9$fl$i#(C)h^!n^Fh_GcQXj18gA6kLK7i@j_Tfsu^A#%K+5$^ zg3Y&>L*+n$KBMKu-X9qQqt`yBoyvN5yx7-O(tJ1IFFm&x`b!Qs2Ni3*O>V28;EIbI z4*!|FB<>P&l%jAALi@AAA(rkGxXYtd)9h`mcB79m+iTWD>3 zKcICRIrT@&PsBqfy}5!soyB&)+Ph{Gj6_ZF=^1GR%{Pl%Jo0=w8g|q5%|K}W8h~Q0 zq!3t$Q+>vCZr_44_YE0M5k5rA`Bxb;X}ykdZSK^Ga?){)e2oWpiF;1Smg-grdcbrW zsxiw?Bq2I6OdRXoEHsvZZM%Qy*RkScOl)u<3>wL>O zsoVR&-4y)RyIWKVkB_m`xXgfS-Tz7n>%0EE$v;xuwZyxu|a}vK=tEMpbCo zr3tIyFa8M6m)~WV-bDln_x*T$1^?f8e00y~MbMNG7(b#Dxw2vbHhwA@$7}CB#xeyj zQ7l2CCFq&*~%p0*zV@PT!i0;#{|PR)yNyYw&Mi4zw{vS=wDS)+L@b0opq&>DBDL&$Ky#4NvW^qBfBi$xfM9O zmHk$XEZ{oBG>Ys74_4J%YiF$${vmeewPeE82G}Zxn^LrwVq7!2;v3Z@0`NUQWy%Xr zPUK3CZmT(XO=m1H@mf8xS@!x(a7P!vtCaw|afmBZF8mG133>ypdRi1Ive}gl$vbVQ zs{byVAjs&qOTi!&m_p}qv@f=VAKWa{5G*$DCR+K}H~l`2=R1J`-xx(#p6rH^ZDmHm z<7>efj{=jwc}Y+E>_XQ#_#@Du`>&)q##s$pmP=@|gV2&2g`9?TUHb zk^26l_LA-+DfiLa-t(iLDyiq^bLFI=1vD(Dz#uGG*=L6SZ7j`qbvXA__$8 zjPfMmm&ee6FK2hoKm*+gj>Q(tVLZM zozg)PS!N|kf;R;1d@V)BlNo_VxVr$bU1!%hhVwd~+KxKWhLRX6@cEEU-7Oi12}^JK>6dr)ZT2S7 zE%G;?^^mKzNtt*wIJW_aPNJLA=}y%yA(TJR@@NlBgL;h?w%*ny&9fszg17;2e&YCN z5-LC0I@cm$)4O!P$ggHkF1DG+tQ|yDbP-jVBLfFY2H?MlJ%(JpLn_CY46Uq)({)a?{ zgQmi9Sq~LMpj~+PC458H$MVhUWk8Dj#Eu45R1LEA_A~c@q_fa)l5F5Ufm~DAwiAfS zP>d8UKaE#HP1Rm6>4(wdd)eU4LDATqda>7W_U>o(*ad_tfO8<80luOmjvqR8PSxJz zu))6gLE^MYdLyiTz@c#x-Fu>H!z`mks$Ut1{xv_2CB?RlV|{=@4 zYZ5yleURWzI{Y|B1}kUeN-!0cK3R&?S_a^s$f3RDt<_|-9jrAx_C@qn313>J>-)9$ zR`AaN9|#ha&2N^0bKj_kQw?cd z+oY~XK0P?_p7LpIn+8#kesba@>fFv0-__TVUmyi~*)C7Kw`#nK>imfNr_Wo>8Wi^F zo$^;6@``MI<=*@k@(*JS4~nYiyeE3)t3^xX8TZokM?PBqMu+T|Mp{E>&_)N0OcvC)MJE9*u!wdP1KP|{E3ju@MWq-6IxlTCz$@+H)T)b%48CWs}Lazox zqNayWaL|Z0Ky4o3fqZ8J~aOxE=lo_ByGx?VI>pJ;bS2m4Y8UrSH zDr0Ek_`(Ph{m2MC%W#^g(uPjp&ue1+_t!aOLnIs98qVliHtNbzxST^MhbVBgdFjoBs`G!aL8NF5sue9UN_=Sgbp=mf^&t1K93JM zC*J|BjQ4C!k`YyFAH3ECzZ7YNLC;lHj75v*2{l`y!>h5^9nx=8tw#JYC7T(L&~1{V zn&U`xm6|No3l?+MpaP1D=4;*~4Q4H3i)S?;dn$X>Pknk?@P4}1v$B>VND@}4-2L24 z1m0*ZKv{AmJJ|B>(Gw8w%<{^qDJrZdMG!J7XC>Gz_h6bov)&IOy|C9t0BtvQD%f>u zjA$>P@Y^ih7oSEsG^aR`S0bIg?9YS=pRDBBB`;EFp}3c% z%|4^=2gVgih<1W{5*ZO*nAQK_#@sv!$cg5ctY2-oq2C?$c&J>bADh%UnJ)@H<&S>i z{8xjQ<5a5ME%i&wz<#YLR6+1bmF8rttmEqEQ00k|lBub@hFzBvAKhOD^iMoq2J~WW zDO8({H%er)!i0VX`FTH6E`HAZc=h4DbIId@Bcpkk%**?|kx~ES7mwS&1`P{B$nFVd zA+1@v?>_ckufDk<{Z{nE!xpPEWj3IA&wY&|<8rKRUH?Rx?eLEqZg*Y^dki1O@Js4M z?jZ$^%7mrWzt_9o`(@J+rX*i6Du2Xd*3yCfkVDh z^za!nFdK)oIqd*^uDrMcwKi!(9YazRK?a?T@0>zJ@`2qZgr{y?z}#enQI@@cG_ln= zU<(+q421Cie$T-mC!kI`_7@R$*I-F9s7le>FkD&seEiORD8D02*{!`S&pz3|YK`5F zcaivZGlHab!Kb-k%^iCNUzisrOsb?e^+_F8j5UfnQm`b2Tt)N(5!#exI)M+%Pt%6x z`xH$B2aFp>Qc2BP5=u3IwxJ?}&Gp?+Ja02-N+0KtnyIgLq0 zBah~SjP8sm*56$pm(*>wwcLsr&U+3{;QwfEJEaR2aFV@ij8K{vS;^|}ri3$o<-hGP zLT`igH1>7X&MTk4V@y4NPad2#Q2h(c)o~&p1AJ63jN!N58O1GFa8Wr9J_=MfTc-KU zd4fXisnPF@TlFZhR~rL!_Y?mo;y4U3bkkv(kHc8%7FEpA1XaZ(;n56yep}dDVj#a^ z2l^#j>0J>dirF&F?>KZFsvU|lpTvbm>fm9Hi`E#G;`^d*kSMqpKU&LI7(vFdD4Up- zY%ibUm?X@9wDcw~6h`gr#WU)$V&N*)$&r5RGk9XYa>zwXZLYI^EHc+VR(zn-(ZD3m z&4yfNSTkif;cds+U+p3{Ch?-AL=0FG3wqRuO+OXomY~BH-F1)dJrdvcRKKhKd?i(# z-Yyry2D5_no`#bNIMsFvC`@+iIe8vwz55)1~_;7xgqD>OJ)@4a| zF2ajWbQuzy1sPC5m=4H)7(@9qFYXFky`GF#T6cVRc;85n_vc4D`lBtg$&?D~1LrhVjSx;|I~5mH8twNOa6WD`Ii{ z+E<4KPQl+&K=*<>ZLsntb6US~%zW&$K-F%KD+^M-usT$%3V6~$nm=3unePb^#?9vQ;2r(W9HbOnYSK^=Kl$rmh+$UsOS*G zWUhXsS99=7E!sPL(Uc2A0CGh~_UV83oTXmA2RNTam`q3$1;SlX=sz|RerLcXnw|Uk z@D!IwrG(Osf_NnjVHlXb$7vJyYc4i<{*0TEw_(B=f@HLx-2FL3UnIj9*M4#^81HNb zDpLglhn!jhP_MMb6{OSxZ;ijS{(y77!D;P4@!JLh(QtI=RXtGYB%Ec?(-YIY3TC9B zI{+*oj~?xnuwnWnfkqOE^%Y|H_W`p;uB_sY`=GwrUFDF3{@*0rX+g>|U|rI!+U4zhRu{r&l1Sk^6JfweI<{pU@}=j+ecp_7p}DXY zKHSDo(R7tsxyyN>h|X6c1hep~s#S2$UCyR_J6L+uk&ew;*PXYf*>F1And#}i<$#c@ z?-OHiIGDjC(Zr4`i=4c-6R7iW0N1|t;$C4!}6Su;PE$) z++Xe)uJlmcQ0e--?u$*cL8)Ofv17jz(v$m}v33yQl$+-6FZp^~7I(%)@Mqx;^RwF> zxu(Rzd$Qu&l-J*LH7{9*7O^FdLd-zhnWOlI&D|BR-xOVHK6`KR=MEc-wa><3oadod z#;%ffYzl8^0_%e%B*+g|V*dWY#$2hvvK<8&$OQbA$#^yk@8+tHVmN3ycN{M~yHpGJ zAtZJ?q}!UDLS?ONZ(D3`Ck?GTb+8{=_{o9}SZlea@SdK|L1O&9Yx<#SS*LUqh7pA_ zeschkF*k_lDCEdmeh*HwARaJq*kgKAwI@6<|ZtIhCR=&_S=xsL%I(@l9Y95 z-!taI0kYczUi8v&2%47P%Sv@F)i8o&fKrsmR+4%+4itO_ioV<*87%mW^)8CM$ugBa zruz2CPX9Ah2hU3t!CAZ+p_>{voqS3lI@VM(awl_pSlFOK<6PX+%NlAnL>F+5Z9c4V z_+{y~*}I?SSyx~Z6es$&?vW^F{P>FHRI!#=2cjd%|BgC*24g=gHao&0%5$^;e)bML zum7gh@?0g?@r=nsQ&hdUiq zL9$>xiI06#e*FX%wBHSd3`Duu?j7+_IihT7Oxyvg*=%{F#Ye)fiS_W+N%ZkjrR~sc;I(nzlP3z#TG9|hV zD=Yl-*5R_RJl_!9TCF=hqXDJ{6}t*NwiSBTAFcsV1N#TH{wC}TaI@*#19Zw~hkV-4 z$hENXE}kGug|G?G1>ox6RdpL$GLIg1vXb`Q|} z06*S*c>YV|b$u~sDESLB*ut*^9wY%oZ2q$fX-J+!UPe9M%N41)eGWYPnL$# zD#jKsoC5dkA}<+`E6zz{NwyW3;>?ZSclC!JxEVd1xAA7Ig)lp8Xf zpu=&TWJW;z<>>=C28y zgv(Wa#6{VjxoOHX9)lgYWM`#*dc{!HMtr@Nhcavv+L+t#dhe;h$ou!{NkRHXtwvi8 z+>{aAujLup#WoX5-iGgi9-Uk{sbh5Pq8ePU*~e;S>_a8q52R;Dph3TWBb`va&3Ka% zcu*cq1WqC9DD2xm4F1k8C5C!qizmhY&BT$W-slkC0R74||MzM8m8q89-gy|Wg1arx z)l!&E!Dqqf4L{nT5hB~BK+wbhr9l`J|AZ`g85F(E{iEYpXt$rSQm6ir|RobxR~bRuE4SN*XL-) z->H@<>mp*_+BCfCx0g@PYgRy7aG+tK4w8_%Ln=7?m&jzpwK43rvLu1Uj3AG}%l_KR z&^KlEP!#1Dq5`Rlt7=`5#@UDd`(KsyDVHdKi93wC^?Oh~n>FA!$x@+3Rf-__3c`14 zn^@UBvy*~?^v(DNyN#ZK^Cs#l@a`FY>KLw6iPWVKRIB0?iWjy}tw8)Wb$b<#Y*~m! zIqYBuP4r51*YTp{L8kak869Y4TuY3E>DiK>Dxd?Zc>y}HMeRLT3tLpwaUA>RdSvMt zDjIj9Ma)!A0<=T%M0JaA92MH=`!NYuzW8O(K3}+|DP|fp5XO(870(Q!ZYN=8`mNS~ zs1@SB>3%}qGRE*e&ND)Jsbw>9K?RqxCY(*QT@=SDjWl)1%im&ZeHfPDzC<^|XcHQX zQTVHosuXa0FDqguMYyV0)*7P5==On;p+&^d5r!V;f~mEFyJCxpLs}&RPF8^m;4iQ9 zJ2eZS;6UJIzGm3eA=GA8l#!MK%M|DDz$nh#D^W22C1y+q$veHIYMEe$CFa@C=~5j} zss=xO9A9^5q*>-3px6Y{(}%!SWA}Tti9qc4E}|L|-VETg>2DAiVs|7&Gl}ULaW`3v zf-{#J+J1upE1{2V$lN%z^QjDfW>EIZ7oNcoo$<`&n5=p` zPO@oHyhEIIxWP*_HPHPF}rVhJrP0fg3X=7sHY<7ixIQfzDo4!`+{XiEI71R-<4 z1a{=kjz>&fv{c9_A7HcsOOU=%GpR4Ok-A#(8j%v5lmQFhezjEju?edy*%gG3yd61+ zMn5uejoy8FlrSoZ34I*xQ7GzyHCLvj)VozG*ll-`glbes$e7{VA?X8+48iNX2+xG< zaX?m!^>Yn>XaVQ(gK;Z@7PL4twI9dSIU)S&?lbT^bizgF4Np@Hch1K|=^f;UhnTG$ z!;=j5!A>Diuxrmt6=M3`NRb+)MRAjX7+to1|I#@kuGw=t1o0-XnNRaEp?TFryxR9L z7Ckm2g&#ZG)=p~O{he{5%;I_(5ySFTxStdyID37gJeSx9yj^jx?8<2t{yPWf1Reiy zxS!_Xxhn>d_rxg!S=Z`$5Gp1F=_b76kmYV)nKl<1FV+y1(_J2+H75JUU$^@|2H5(Ww^IE}J{#1j zRx4JLV62w@BsR14|Ns6}9X z>sFC4L=%f~;XNP2`h++Sea}%rk+Uk^w4GHFGODagw#h&|Y{^k~FOX^d@{J>Eped%% z^d++6m2v)wEzna_4G&TSE3#V6Ry8GREvZ&Vl8yMD*B=(hsTnEV&n~0dzU#Dgu!FCe z_DI5ss}(mp$u^S?G#PYA4E_?ur({fFXOe)wRB*N9BuS&xC|(20-n0@O#=vq@kVp&s~}7UG#A zNcDp}&{HxF1}9C{L<&qlG{GM~bp&rb*K59ev7b~x&Dx~kczl;kbm*MFw~PX%ALPeG zU>G`W6W9ee8PVI9GlG~Tz5-w29)AKWfO}~8mvP@%!mda8D3t<4&?wv0k@ANS7+Th`M*tg}OqpI;{m10nL)9i#e| z9qs~L!^(h#!}B?q>0g={uR5+^B2eKOjUgPwZqLVorb6+D7JpWNZhe5y893=&v*lIE9J{iau}uu8el5!Y?>c!50T?l)KoRQULQgFxZq81{R(zW~@) z#z>pyS#U67@M?XiN8gg{rX`JuH*KAqb@E+9M2Y>4?+bAO@D#c_ z#nYG)?t08S@D^77&X@#DW#n}rV3BG)PsOAtDRBPSQN-%~svx4Rd?aLeZCWZpM zqP#pjJOWoPU%JV|vkS(<^ZUi!JAuFWUgH}8e*Ff!X?TIBs8xIlIQZT9{I&BuJSA~_ zEXWSvc#rqx+rSmaG`RnMQ?){d@bJ*US1z5u6=XlV@ifi$UWNvn!%lSmWOp8?s47_5 ztomg4fyZy;_x>(^hi8ZQ4q@+oVXr0jf9^P`V&pB3zwdJH()l1Ot&9Zs7w}^*1THtc z6MAK$g+XBQ^YijeEd3Si%qRT1XZ-Dud{xum&*tQrSgyl{{K*p>5r7=-&sTAX;?}2g zJNLkT+xn<-Ihk+k(~I+X+pSOc`43RGZGF7^0`&9pqmLeAw*JO*_fAf<#1*U%whhl-xX?l)>A& zyf~+LwJdH;6VQHW=7a$3atS`PbEfqj`eE@|@) zJcH+x`MzKKX>sjm@wRU~f05I=pR&zg=+~3Qf# zO2FHTQF|kZVDdrxpc17nE)(TyFaBKox<15HWE!ce5w<{(lH+SGwepb~#X4Q7nRlyU zyJc@=%+ktHVBw+gP%n1M`+r>ZY}m@xDslXq^$Xc%52at4wDA~Y_w_4@vIjO`{P%nK zw*33w6kkYx<+@40Jsg4n2S1&~|NFrff4Gk6t-xLht%CuqIWNetaWww_mi(SGBaxihkT<8RI0;8(gQ&!_%GxNa>GV zf|C3wdGLNLVzdQwr{dUaJZ)5Qf_80UQEx`0(M~C~TE7 ziBXbGcR z@_C4rJGW&nOyG1ROaSXq9*FkuNosA`Q8#x8X_h^gV+Urgn-9;S=@j~bO$y(H?uJ!g zuZf%yLWHQWCX1?7?YP=uqVD52_i7a)kb;m>?!+8iJbQU z_Z82+eQM>KLmfQh>c}Kf3`^fAo!FOS5lgI`dtE7*Ff?iyPG_p7(x z`+k|C2q4T)Ur8&!9FqMpz(dZGar(BfIsbbQha6N&=w$obg?P@|?LNIPZge$R*@d4L zvcd~oJQ-)IbNkSVdaW7biO7~T^jMM$N`&bYB^bWucyA!iOtB$1DfGcl=Q1e__}A+- zLsUQxC;1LK!hZ^4+@Q6B(B6JM84!izLy{HOBVGv>7;)OY70K^&$vUypmSUrPE5=L_ zyxuM6`_?lb->nFP>Ne9{h?=)hO4Xl6FLA z3loNn6>H_2gMMgW7BqGi`P}j)OrUwSFi=ZDr?AQMb!I#(;jyw=_&aM}KH4Q1X_<)HO~x%!d~(2^ z@873~gshFjal9xTHrM$gY1`i@Xy2*q9YbueTkHIbqz2>sCpRMhT>cjS{ZSRL)o6<)+h$BWC)kGxGq(zxG8YyL0?ybx z?eyyNlEB}2j*0=6q5DTTp$fzsIG;Q5*wVR~{}Hq&>d~&fW85_24e?7RXf?9L@OiDn z>=8$*%WFlRbLxN_2sy{H@IUs|E_^g&8#j}$f5JV1??KUiAbL#!sm02D{P%Aqr+~!n z{^G%HgT2PvcwQ(%6wf6^n>p5<&@oB6cZpjdlz$m20gabVCH}_KDbu`T(zgkPlOf)3 zn2`cf#B;h1f+=akQ{JX~c+Q0Yq}qATe|N>~4D)VTXDI+zgRs39DNey!Br{-jN$%=1 z%r93kJ4pwdfN#Ict-dHpdaf%2Py{4Aewf~{2B6fqZ!jqf+)b8yw^T3SywtbI-+3-0 zK_YLOT(Q7yT_VE|@EnEXZSO1QFo0?R)DL$n5i#zWHH9lSXJ{!j>ofl%Ax7I05~I60DP06g13MiIn-E^z4oCvfzb#3; zQ5{k9=F_!uRlu%&D_+DQM0Q%Dnv`xU4oOnun#@DOY`sKz2X^rs)%}++U2wwsYmgGo z>F=-PiuMkO$bVD1fvgM*v-P#}*~qZyRo|rTX4l)|<6$#)Q~}P+*TASYvW`At#)?^? zC)ye|5$fAyj>;l5jG6Z|z`4?AvTu?^R zzN421o<4~)Eh_7h_TwAau}P4dn@6&C#n48FDxpwNe)o0>UVm_A@D0!E367sD`_QB( zS2^#mJ|%utSg|Vs9+W(rmWD%@21$@;^w!;8ES$(P`qm+0e9e1LS=3vb-V*g7w{jESzugqI%Ybn52MXg`&r)x$;FQKSpJ3<)Fz)ccD!gsl6sytl{>)yh?y6|5G&(1zowhxhoAX%F}aNU(M?&e>rVyM9NL z$!8hKbXMTAp-X%lRImKeN(z|I&`?1we};QS+(T@5RIY>D_Tub1Q|B%ux^S)8+KZa# zQ5P=P1IW9TtctBmvNvC?T!ZP3tQ$*-pvj&Q9zSpG|3`C-eehc8$nHVYaK`6iX$139 zGrO@7L#tb_mexODQaeUj_@v88WHR!qr9@S`mxBYVV-*Jtmj!?lAY_ILf79z#*N?q( zgPpmkCPt~JCFv=8;s$vKwrvS~`c`tNcM!aC;(6B6=jo1N**0n;xvM59W=H`l5`km2 zAtLjYbalhlK6Lz0?|Eq`A@**K&t-}@*7&cI-dUMQ30B>CM zfEOBH!NYSo4wRItB}_5!V$&iW+Cw`15dzF*H2ND`!t^n0nYk7#ZLN`^dN*Zrt@2l9 z@7jWb`{QiM;zWoHDq~UUhxeD4vXN697+7;kg4%d(qNdx$_NRfCSLiY?ln|e(RfgEHGy8is91Qv#N84!6 z22R0edz>@d$X${Vb39wJ_g87wJ!mh8OAhe!l%Q&kkP>6lGj!o@p0%=IIuUemHNu&y zr9fZ)NNCILmcD*!Yt)w2X@zL%|0yq^IA>pUJYHWbfB1@^roYO7Gj|x zCB#&1e`|Kn`f&m&1_wWmFoln-^2Wt5J52tAe640X&Cywh_$^P z%x7)7p2DZkn=@RJp?86(?X{nB(@X=XQ=7K9ruGs_!PW*t7fVV;+G4z0Y1s%M|YY`KF6i%K4+x}vxX{JWIuJ?!Xj>Ek_% zSV7W33(1qXdWCk)O=4ygG$&p;;L6uVN znit@BuPypWYd@WeHb{BPvs(oZ4Ay1JS?Cg5?UD|6h#`t( zf(uET9#-%t1wxSdh0MC)RG}ec=xnu~H)L%YYA}8wf77$|JGwB>Z3a&2Gnx~b#Hvk@ zI82f_WXFmjl`i5ICjd8^P^9mvAlGog&7s-| z!FJv)qWaFvGy?7)x|*YBsoEa1cUH8S1NQgP^?_&4kXgORWqJh|lC~M+jjzq|!@%%G z5y*6dfuztQQZ>?pL$iNF+@cOjv+IhkwR}6B;v1~fn492OH|KW~QvLJNLVlRwe4lVd zf!#q#MvEZ654m>7v(HLOn~}Qkg;(15t;AN`K#%OwmtO@(So_v>LjcoY$V>|*#l;yH z$ra(ccn5a=e5w=8h3HtlRlGM{DluY^z)0Xx*v#D~pBqX0Idanj(&d5A-7`zZiP7i= z=BRIiBzbB-W=F)__MdSF@IBL`Igwqh)het74a9Eap800|11_?g$~W-^I=L#PU)~!n zBWJ%o5XeFy>^_lkc3RB|PuCVk^OQubf#*$#{-(S6l}Bnp0r_kSIlLgn+MlV5p}os3 zR{BSNG}T*u&&CQt-46MDHtAq!+2UzM5#aHf9^%8dqSCpfE^cUkr?m5<4Ki5Iy^`~p zq~<;PbzqImP1Xl8;m1^e^E|b2oafv+H$yhzYUerCeAD#_V0f%}RYK;dM&U9Zv!&Ia5D z&tdTFF-N5%p+-DBoj?QeR}F&Ga&-D1fA6J7)L8PEHfvMvRspV8s~b}ON2RfHA4oFP zmSU#GsLf>Va3kU882|xxKqe|#3}fVRE4OD`^%BqVI{T7+WA$7r0Z{`j&vxmN?^Y4# zG)$6&QHV2@PPKP{zU-T*x~*bN{%WCks9~4fcAmSBfT|_xi1H4PI8# zFA{7Bk+*TX`HD1^R^aPp!*!0Pnzm;6^kv);3mukUFJ|U?c;mOd5i$^VNkl`&KFY>G z*6%F3h zVH@v89A&Lzu=?>Ehp)f}w)#3Q3V_YUUEZnFa?AAzvFOu>lpn?R1M8lGa0acX=oDme zWe4OWr}t)z9(^!6+`4pVJ>PoYiDr)i(Y^rdhRbr<7>})%)5kZ)$BM`8MjNd<9YT-ZK1Blt`pqsKLCHr0DLnOioz51PL z(lZ5?umKbLVW1f2vNi#z<6Mli@ucmc>v&S>jX3FU1SO8}DRZ4r^KSSpVMd{kh!JV# zuU@9dB=FPTM-nX(4MXOF=5MH6k2!Cpdp-?>wpAT4Vg7T${Ov8ny3qu@YtBI;F_83n zgfr2D7;gq8AKtJ+p)Ch310=r7;H*<|Ii+)Obdrbmk;~=l7?F2JC>8y8`Cwgo2Biln zCU^fXFhQf8iemPsrOd5n*dG!eP-4yFB7&VWtV&x>LFz`+@X)6lllt`71%vHx?aybw z@Y5+z^csgLC6t2#T^dr0SBIq{c37s1I3cYLtV#riB*WMmgrz9t?(OD7agB#4@8Qq4 zI;;1MxcwNHfi7aw4#k;?93jg5K#5LG*bFYwBY)r6p^CM2Dbx`d=M{K0>hoLHHvh|^ z-|wlc<)iaWOuq!>+`T(_`Pv>n zuVhK}6%=pi>X=Bu$fqJ_vs%gNFa8!eFZ2|zW2dwJ zWSZ#6)u_PkX}$nsN%IR!bYlYg6lTKql##eCyQy@4>PF6n{Or}|T5}Xo;2jgjlP>J2 zq5u>rC)gYnwUbcsr=aZndPOq%f52R7E&*BJ^3AzZ2jGQ7%!h4 zo4+_*xbuDcAP(wi1t)9N|4x7@1|6L>`rR#iRXn^kd)R?o;v6w9sKj5rbZmT~{ao(~ z3-Op;N;BC5wHFtIUOUt5ar{S~>_HE^WbK0%q!8c6s+>sw<-l>Om>eUuz5^4wOuvQ& zX$=08Cyj4Bt|o`Jy&i#gKg=-Lp5+qMHd5@}FM_Y}8Wiu*!xX%o89E^$D#<%=sD;y34s zMP%F+R|)AsQHsUs-+(j(=#X(Ug6-DYojzmhZ(?>D+%AFlJ#W{itXGeB2a-M(`}X8L zJ7)KN5{A@~hF!D@Cc3b^`;tMxfSm6_?&}ZEp?$u1(MdXlkhFdS*Si zk@)2lQlokOPb=@bV3{s8(><_Oj+52mLKkGBXwi_NzD|-oK(TnmZ!{3xLh6&Pprm5r zPc_GA{nHrU080I=fn1;sGEyYYyBQWIeRr`+Y~0Wk6TCEIJK1t9FaQ!{62NhCqR07lZCN4ZDpsPVOPGck9%6n+aX~jwxvy54NdAMbLX_Bf&Rt$u*8#)n zA|!35crp?dd3FM6x4K@J3O5qJ&1zZr_M9Bmf^y%>lzVU(UKr9;@p7snViTg#ZVgC3Ri)!xS?XAbwlKxyohW=BkmF!@5ZD<} z#dxFC!-7f*REzEQD-#92b=#FEBnab^zN;-k!3NE~UYPED`Nn3;KNNC1zz_pUEL^hX z77&|CA7d8#Yc`%9MRQ2h$7-gEeAr(A{1r}2d!p@gwt6Pir+M0*D3z1>gRT#}FLqOT@vS8+0G zoaQe9O(WfdJMo?Q-wdCruZqeTrkV(#3JW-kLLEh*z*2GPc$wxwdO!7B?5LHob3rqC z69IFHOPBh~;yk;@nDT64N)eK5m0Z0hhbKLqzo>e`IJuhE2yIG?>7F73-D_aDt;Mx1 zA&NSk6nd;V=4zRIv&Z*Kh7@&Qk9*wjCwFicOyti$VI4hh{{jqK?&O8Z-ULj&er^R3 zvQqn`8!;bOT) z9_|nH1c09pfcI`EJjOU8FRFGILOc%|_O_b*UKIn#by})pfEQ0{{0Su(<@WtSkon$; z_N)G|WU;wHbtU<#>F9fHn9OPI#fMyfQj8*GDMb7PMob<8lqdPFmIUPx|D2UjPuse` zl^?;90GOB}-<(5>-o5_e0o;+qYn*GnE8i%^`q`&oUHqzL=eG1^@E4ST=fCkpJpZQy zsdOh>Cf4ywGhTaOIVOB?q~@ubpxHgYYMPK@2h+o$gkI@-`~5uk-2tb(@*<okY9!=Z*eJf#5i1t_633iz_TCo)4!g8b{7K|r~u8T8{^_#Qx~L$1y4ar8PI z`lVN{K2v!$)?f;#g1EKRE^aOLkTk9_bm|k}t?xYNo=~!HQuHm~R=q5E5-7gXe1SC% zn;vVAsXY$#od5)zA4XHn!W}>AciUhLNN%qi&r0x_DW-WI*{b*y(X4eFUxA<+_I}{X z@6xL;Fh?@?(qI4T1yD>f5}}`V5ewQj>&4M%-MgNNIfVZhU13erUqe4#E8z!<`&tLV zBcYAG|C)J4w*<-qtGYb?FE_UOPouj|bYN3OF)d|+5XqF{&!?tJS`3Dp&f`$6$w#=I z=y`TQ$3HtEQ%`=ITMw1m&DV-~*P9k&>4T{Zvv@f8Z|xVq9$+$3%pGBDSg8sd&e#9v zPEJOdYft=J&RTArz5MMmeHw;4o&^CtU0+U&zNNLI1;^P$FinaH3vbD=>;-DetzN@s z*RAyl@sq;JoosG%lTgoL+a0#8Rm9!J1clbbCt!%>1dV(R?j-}GPE_dErmi(>-CeIRR1lt&DkE1jDIB-0uL z&$rZP!l(z#t%hXX%#R{mph3_mr#2avU0Rtrrsl65EHH>y|7~kZF}(-YG&AYls)iG^ ziCUI>Bg+k_nmS5>?%0_pUXR&0#)0!{Tdm2%{d)V>g@8uwonO;@4bittXof-3t-7vle zN@#55sRG{*=GmLd`UNL{T8q0J9rN{wVQJKt~P|7go*g3v$O7iNZs zqV=u${n~J_aG=W^H`JL6qE`vlD%Ehd2kwS7yxm;1w$`RXm|19LTvVxrXj?l34l(Z= z9ciOInNfn8uUkc8W>!Vr5Em0xjG^E z7-|}dSo=ERwU^GJ>>8dm4J!`9DIIveCHA4sA+Sxf5>^EP^#E$h8zhrqpMUh_RUz~J zQA%==ZbZG0Y6!X7cM@IlxY}h}@nl2;zE%US8n&n^B`4_^vEJ+aKEi8gt!be;2fQ~e zaK1^Ock^MOGC5X76V{j=`SUE-%^{MJy*7H#OhKe#`%ex68P@{s&tVPRTKHO$nZC#n z61+-{WnEsI%}t7^mbBitGjf@)$NSD5yPzdp`1OiR={PO*P1V-li*lX;Do<5G0V*Gq zqJIDwm$DZ6;^JbbS(DBt0+wNc2FV%7R`i|W=RmheTmqOnviAa07jbL`(zD7>^oNmA zlI~O$&Z4$;fm?*nqHqG1;E<3$Hg+aUHd4uUy%w~b+YJenK-px!Q7Z~%I|e>pHeF+m zgyicsY~S8QXs*TzwM;|poV7W+tDAeR7cisRHbHfb``7p@bq|a?T2{WxY?U4dx&o7m`}C zn8nVF+F_|BdIqN}n_(k2Q0DH}7bvk9)6PLpzxAC8@d~N&on=l(<93_rt82A*mxs^| zTLo0t>p4!IDlWQbSRp}^(`NMrQ1@gTrdr$s7EZtTG=Ig}W(g~A=e05IA&FQ{|D$1j z6o*L|&{bsBQ0G{+ueWrp2k_|ftJYl4$||I#0LD@`CoCyO&&uHaHKugaX_nv@v|W5l zS~3)8FhJ02!AF_R9#Xnt_u%<5y3rp3^Z|}QxE4?gxv5?@PF%5mqFmf+^2t5Tj-VW*WqYWn56FS(j7|^ZK z4D_xcekI((<;p2CRw#2&M--nJ`(}gLMwYT~BilF5PMP^O3A@!mcZnFVP7p@-GxwsP z*2*mQWFvVuF4)b#7whbY8(ASJv50|$MaINIaQuu^-wRw|K_`g*It|Q^Y8IEcVrLD= zZ4xRuBb75K?$k116*lObl`g_kmwF*3p~&ed^x%Wh1$878by#}h!C#JGMxib|XPRTOu8uxwtPIPZia>JO z1_-2A_dmYs>&l@>O67N6?yg1Y9X1JRxO{!B9E|!#wno8+P01WGrU6UePK?@7-9S$A z&5A1&uZh(>Xz^H#)5e4~rE^eHUlkD63B>v9L2}KNckg~1GeQw(Ol{5hecM<)R6@_Q z;ngSGwI?E>CP4_#z6V9t+Ff_9viG;4`r*>qv*oIX3A@Wi8%uH2k9(M0+zSGrkt{7!wNKaI9oKrjI8|C|xbM$BC82V;IFHooaXa zh-2`E{S)ds2g+6$R~et988$QY9+<|2q*#9c>#w0i-NSktu`fHS+w|7ENu}KeOM9uI z$5=Mu2yE)^_fhngrX7Wg*pQ3gD(5b=!|}w--GJ9lIxPTm>=x~?u9D(-uWt;Oi!zmK zoPCsU#dd!Kq4)Klc(gVQk0#KN5`C09eY@#(jLffD?n{i204xS*Fia`{L%uv=O8u!A zbU}vDJdOr_)+LQw{$NIc!x2qN9hDa$@Ji?D8yJ5$3n|6lDEH|Qo)nbvofD2>faqQ3 z_|`@7UWQ-gQK`oke2>6v)XPuG_Lk^5teZP*+BQI88}nGuox7e#w!HbZu~dwg z*N}CXd%+q^+E!JB=M8!{EI0QIs~~4Y&4p8iExE6D%0xE|2y_!Y^h{|_-uwfq#~N~@ z_y)9@ySj5&h3`N+e8b%NwWXjzU_;a%)>~8d@dDG?fk~`XMm5EKYV~x?n1Zd12BxTU zDv3;gkcR)Zoo2dAw-@0&@6%mzTa@xM$B04CbEnqQZRnR9Cm;7N`T!c_x{39AQ(mFB z9QH2&!}^yQN~`W1sd%~-N%6`xC7DbGpn<%Sow<6_eb>*SZ6=7Gg*>ZfyEu3Rvf7`) zFzlwzJ+OlecAg!^+~x?+uXPj-%S~JpKyIvEesU!LX0naeoL7NkYvoziy(=5i5BQ{= z9VL9mo(>P_Qvsk$w^ZUGgJuiSYc|P$RGnE1+YHvSInNa(9;5@%pQ#yp*Sx94*OBGm zN|^f#>kvft%eL%PiALKh0f=YSPo)RaV(uV+6u|+aMJNy?JT>MGwS|90&Re3C^3$(F z9T}s;@AI(-^}@cp9JMVx9f9eHy+@C1lhD;N_bzZW#i_6;x!r1p(~_d$x;lQeQ}^O@ zmp(WW#x>gbjltwJa9&mCjU3{M_e_Q7qKX1{_=tViV%;SKbPNp^6Z3?>#^&^d_FQh) zTA@g#@!pHT^!-ecc1+mboJAi3hus4Z77`@15(hzx9ysN$`gin<+r8vam$gFB%zIT| z;**$}Xj)0zRX)qXAm>UZFt3Fx)rhML%<@*R*6PilY1*+XplCO)ij9mWPAlB1aiR)J zT3ui6&qZO^qPw^e|b<%G^I>6kqOX{HS*ruJjn8 z&9bgteu9desEG4KuP~nP{449TSN2r2F`<1KQFR7@#qFxMNF3vxJl+b(9Uy5_@$1;ah4xJplq$G zZv1G+%L-}fU_MkskaUzttEM)(IY|1k+^NUks2iVX5Z4jwnj4N;PKL;dmxk&4C2hc_ zAgmH=ipkNYC$CqW*WQG__B(eK$VS603;K}jwk_v0w2Gl14x+n`#zm4KmK_nT~;Ph)O8oGMXu4g{f7Jn-b5X;!c zC=~Hhj9n>I`!nDpHvt8Zfw!?k9_@NtW#MK*LpA>p^4?a`)Yom?%11ln)~`a=EFVw$ zm8aZaGZoQ2Tw$^21bT&2EWg`bz1eOJ={zpUX_dx`W)2MX^6s4tJ{C5fA>GEPsg~RI zSBFb)h+pN{5~4)`(XWZR0XZ|jNQ5hC7@;#yy#b$PC0}?ELP3XvY5vhhIZ5pHMUANO zYB_zX0fE%%t*u9dO7*|MITyUu0PnWU1hAMLO6dt{237w-yUpSwsY6WE1qIB=bTJo| zbb$7>si8rJC`=@~MtJt>9uFgQ2kITPx2jT}74J>L`G3jOFd&+p3KH*MZ}4W|!j)J7J@{hJ zrdE*E(!xao6Q8;RC|A;#IO7$%_D4k%qSB?+hCYnq{eAhGdIA+l@Zl62Qw2RrmMlV= z8v-EA%#K}HpnO{xA)upjrNs8QkeM%0kNyyCE>-lIM8{ z^Ox`BgE{^{|3UKY`AW0Q@7|MCccVJ%m}@qOo-&}PMe%9e1ZlE29+*46|6Nf)r6C`u z&!B+3Y+Bxx2iXl+`BaUwaWNw7SX)bUF)Ju5sA-NbS_-Qt^7@dZO(EO0zjinwW0V@G z3i13%@79lOG7Tapdn8&6`$Gf7K5ik%U?XaNOl}LJ?iJAE(EeA4=bF6``XeQbvJz`A zt&v+S^^0VFSk^_tBS;?@A&m7MnpnzmCQA&_I)n%!N*I~uR1IJM{?7fV1U%^?!7E}% z+=gZ4dS@5GS)cuxnrC^EPdWsn# z2~|~ADMfoijEW(Ci;3f`Y~_-c%Uqv^4)j}VTpk5$Yfk;ZYHp)9M1iYwhY5zltIWxT z#Zz5)4X?1H&Gyx*xUsbp2R_DP5n0TAVETVltKp(95YK=uLH#$J37Bteq2K?v0;>KS z&h%dZ&h(D*6Ew6iQX)H+M@^Q)CwfFJ(Qp3nPfg|yi?IPE>NS2KgkXGMyI5RQpA2=T z1`&FuCIcr}dSY(0Ttt6YT5wCC(z5|B~jGy;2= z_0as|$U7@l+3leU&DSzn?(dB*zB9?Zu5(6bpSmsr!G$2arFKcbbtn7eL}4t$WD7z) z&3kP|56|>~&>i%T{mi5YkVcEp_uGPJh#Tt#r8K2bZ#X;i>C6hut8R6D6D$S>%RPK! zaGKE{2rce>hP&b*Jd__0<<;1>W+2Dd@$@Ont`tG62hct?1d=QGq@Eu8+Q)^+DGcuE z^w|q}a6O{0OVCMon=^7XD|5?)Ss@@*d)#fDa}LZt4VQ=qU}76~OY8CayUU=g zYiBsADUgZGMMMMeTyf518>Pq{T_&fvH~Wc;t2>9uKt95gmd3?$$DEB)ITqV^&H=cL zZ7anRGsrzkWPiJ4Gp*C3m0i)&=5iSUDbFGEtAFYXz-0!cQ0r|hpTi$~mrDEM-)EFQ>232p z)DUytHPK*2A#+!zP_9L71B$blT1s1$uw2TN2(_@%M-U%xAAB0Vw_+*C^~4+3iN%nU zuj8K0Yg6h$FE|=SZw8T%ZiqrW^Zm7&GbVl7C&@CQ>N-{xVXO^XW$5kRczyew8m)YM zN{SpNs0haSI_P+d8CGz^zeA*t{b>R0f}khF9fSu{)=RQM1!q-Xju8>Npyfdy`m^V)6(>{*ab;4Q*9yjVd zF^vSZFGWYhHcN zj-VrhC*tg@bu4Nm-D|=bdADJC_VMLu1ky#w(HhoZC#ZbsD{)wN9EXE9*zQv|$LO3Z zZ<{dMNg>(Ws#}z&Tz@4UH3433C{^n1UOwCVO^L^EJ!tb4DqJ{a$XB)mfCTm5i77b| znyjt!U4)XLLuPm7MJZM%aY|?J2I&kZ=*)eeyi)RRY?Mzer`}&?=B!WOB=+^Um}#y2 zdfLo%kXP!SRME2-;_PB)tI)G3JQUIqku6(`;vHC$_KjbquE8di`r?dauh_u+w=xUdhXhrM8&PQ@0(Degyg0HM3z} zyHT}E7G|jKOPpGl@x@mFRC1J%lsMN`x{EkLJ(6Hh-1$}ArUVfcsS%kZRAzJw^$iS~ zq<}OSUhP4M(BqGYTNqATfIB6T_-8hzinpC7j4`5R}x^zJ_* ztwvv(g3PQdKu#jIoz8qmE(!Ov3h7Fcg(p`#_q9Eni8Y_Qd-rwvdzGEI>Lt4HnUI?W zx5|mQ>!T6pY3Y@K-As&yTINm%d(~r+g+LM+N!4!; zuBdo3d8C+np;YMAcl!(6lY`F>4iv10+M^b+?#lLc^di3#5o4ig1y9+n*+(dzR5?MH z2Bx^4W{qaE5<`VVGIo|^9~93YqASpAjC(Ygl~Pf-nB{6@O~BlAjsYk2!$jGgzYvIb z!8+wjhh0~wJr?06*^AuhK6sUju?Ua{@{O-uK}+x{RH8-l-hl7k8M1v@n!Ev?^>|VX zLSFw!{neoTlMBaN|=g5=Go{>0lov$?#6OE%Vs9x^!o!E@*420yqV+!lyrnykm_P^ z+UsnP#*t^;%Z!1dQMI!Vedl+SUqoAF?6!FIz*d_;8k-zrs{+c6{djCvjv?*L$t;9) zEpuL0e*f~Fz*JjDpVx@Oj1RB(A`nJ(N^cZu^H$2{8#& z_i=hCld!$-gLSwsgV;g_zYV)|ry%GL50*=ra-)zJ;2}gS+$A|<*43t86LvY5n;tJ@ z(k5yCa&yL6vUR-bde-3=v@{K06| zu5TziYs~w{f9i*vp3PnOlN)a1)tUkD>@_Q255{CcXYOOPRJeVk(!HxI{l%lM{%>wm zov(ytj)QlK?(re&q2IopSf~6IMR>@k2d>D(Pe2rI^TLcdg-^`eL@fJ#YU*9@80Tcg zpvI?j>g}VojijxBxnCMfr90?!c!zU3PJhTKa#7|y1Yl{mo^k#aN!4<<8vhfxweKz; ztg6D8oD)X$zqx>OD!efsQKa-Pr?TKcSlaW+%(>Cn;T_@eT}#($=JCp<_m1wz z3!c1^4Tx{j2s{wTI(1*pT>N&G_I`Z%@)s!3gIaX^>+R*-;kSj5mgm$H5Bt}uboT{N z9+4j63gO3_uUyp@M+q?9*wOn7Ut0i^O(kTr-b^QHH`QY%t$N<$^MF^~{xN-CK1KG0 zzKP+xFZe^Ift(DPn~?XC9PI)fX*#yyY=Kh@6a8#dTjuzDL!+pqZES49sjxwo9L*rI zO4i0J#+=RbITAD7K*CG(ubJp(11RLtTp(99lKHWN=l(jNW+CT%SMCg7G86Z&U}btm z_2oQI_nrb^tRRj};Fy84x^KuhH`%!37M#2v+PXvVvEAt7BLMVOOrYQTtV-ZOI+H-+ z?Rr+e?@HwREH(B@3hj3xp|dYv_WTPLLN#g-ZT zE058QH1nBg8CsZL4>NSXGu+D8oUuao`M43(fY3(Z@?F)NGhpoP5D)@fTW>phMnfxn zgs5348wS0!q>Ak@3UBRZ23`S%cr@eXzuVZ-<8P%YI6=PF)5sI0H|yf{y73JUgGQWd zu2*tC4nz}^uDa3pV8$9h$>8Lro?4wg@{ERDEqn3&i|E-?79lZ>nm2vBk?P-tch>E% zT~=Ik3WB#x_5j+GrsH}$f8^_^METxgg0D2L;jBH3soqMPebs=FGnG7%15(Pc_bFI{ zTFMf>f9Qy>4As!F3V0re+t}ALWEo!A)~TfV5l|ZQWSbE2iluk3Y;X6~r%96RS`XGb z+Q+W(RB8iXUs=Jrh=0FXc0=8ziztKq%u#K|j<JoWVu$Q>0{p@Xjo2AoEfCM8n>$9~jFZ8AkKKq7MXQYT*P%l)$fsp- zOrNy@O=MwXTV}UujATZ}TH47Lt_|9L2Bs}npL1V9A!8a+H?2Q2TZ+s#=RXRRB^zVL z**wQh2CG(y6N!TsQ|swB0Cz7TZlA6h9OT%&;7wlwCq_6dKDJy+(FnOIzq4u?l`c7y z{sT7M1JbbY%_Eo8?-cR5)CP4d5@w9%fkj;=_SBV7uhC|1P|1rE?ch?W1d~_lAqO-V zsYKBu>FK_;XLO*>z40`VhUie4rhNKpL@~FJ&86hqQ7eWo(KQP>Z2F6y|FAzljGJuj$ZH>NVyRpl#4O}iL5`-@bwc_Hrnu+2 zxwe|hR<6hI*_x^t&Rx2kBL39MRe$eZCDZg5NKtjH%Ia-^eeNp8fc*`nJqq24{}KBc z^jb3ogJ}Elwfr(l8&`?F5F=7-h?2p-!{2(p*n8U=lGW=DozCKnTb4tS;B zeE?GU&axcJtb@K&s1EQG?X^mH-=lp-=deY0GR0?BEjZ_KT^F;-K*8@1AexW%fiy~_ zjQ3IvhrbNWw=CoFUv7o?j5%lLx`_exR^~;*Ma=!>@#-QzSew35vx%*98MU&DkWN4= zRnhbbk!*8_sjl;k%}Iu>&GOJKQFHb3=}Br#Tq3glTIBJBZHWw`j_6LI^KR9qCu28M zKJ9`0EM#l!nE~>GO;}FbJvtr9C@U_zut1u;LJBY`BYh)YNgha--;qkY9EppmX)A1x zr8~J0Ym||yjY{sv2|1eO>~+RC@pk6d#VQ0bwRo(5N$JrSYrjASE_ZZl%tt%(W4PB$ z_aMZRH82}^uc-m|G_mEdfOMdHkcxbAfKlT{6!C29$}rHFlFMC@DPY5>y9dLF0 z1w90y&bD>|i0mT{Km#HmmAkWQ6D3dEDnzv3mb!${;?Fihx1BJ3GDj}gl&|_rhxJ^x zNG|5mvo8K5dkvMI^k}N0i8kpeFxsmP_b3$gsv6>^9tR99Wl%Y{!PoW}hcj;VVq|fD zsRJ5mQLE8Nt2fI05p5=q)p2qoa5tVg8t$u85@^2i`|yVI&^~+cS2HdP z2JocK9gbfnn$lr%8)7Be1q=r6wSwi^NPA{jZ~yF~wX2jvtsfIMJg4=DbW*Ot!y1Ra zO`M&16=ti8NIH%S1KG#WHEwWqFx3c*&$CZ3+#5LU)$q^&>6q&@gtQ2Inp2!%fJWM4 zJ5FzG`+$)9jpt1{x4^$Mh-xw%jnNQ>s`#A(a4;uR`3vg#;{K9oLY!SyZm<&@3WDCv zBbj8p$Pc(s^UgjK;Mn)mBeV^wM2 ziW5ar;yBw9hn~_Amw8Rzu%`6T1|U1nQQFNkJk;nqG4tIeSuDSJ!%em`9@rqM0iWZC zHLydK1IFxThSCnV+S^tXS&i}+Rrlx72zsv*J z`gvs4`L+F)NA@BX?9Y^(-=V+jYT5kSk^mg~i5(4^zc47&c_F@n{kSr_=O=aS%)M6< zT5E^J=B+_0j{iyHWqUoOX+?pzj(xUEEg2}z=X(nL59)O4rq9GL$tq zir)N6NtfdEL146pzwA{PO2!C96w|UB$BW8APoPuv%viT`Meg*(Q+%v*z|@1#G#$<@ zh;f*!D-XkVS6>MUVWqi^3Ut>sCV6lx#Z5uPswpkXB{ZoTfoyg@n)Q$a`wLo}yABAc zN^_M@mvzn^OY$xmn<-Y{W`4>Gp#ULU4k+E0@3D0_66;2n-!4nSe)rkgeJ!zoeZYiu z!~|be`X$?eGdUjTXbkl0QF$C~#(C5`+vJn+=d+hntAYRbeiy9joqs~(Wg|@x#gd+H zdAm0$q@Z*-ZOyJAV}V%+dtNBBEnN<(mp>6$zcRdk+X71E9h+Mz0=EbE>WnO*B1D58=9f+w2UaBg*L)iCm zPCy{|IKkL1>O<#VkLJg>c(^=JwmJdJKSqd|pZw%Do?ZK~4AF2(E%qeRiIFgxxwHF( zVigW(>xK`2*Q6}@&=TR7dU~ih0Vj8{p4Jw;ZFUXjVk?f z`qdAyJw33hvg?(0X%kBx@SdQd_xmX{%hlrdeq}jhBR}nBRK5`g0s8U;<#HrQ%fy6G z_zB1H5|>ze2B%%)(cgg3An|1HL}`7*>Ou~eART^RyFf^DH*O#0C`OnR(=87|_Kltf z1&D?Guz$?CIBR{m0D|KniL*J>(U;ZA29V|60+fs|vOmLZ+ptL^qW-hf)q8#Ssy#_?Ow6i~N{L^K;9)RF=kyrA zERB7x-w;H_$fs%k1r5CFSwXs#HnqK^}Rz6&^bZqGV;8JM3VX=m!TI*cdK!+5aq^^4hYdY)Db zYbR{7vDc4Ye{={$6bB=gCm>c+rGv^#f5tb(raNlco^fc%KPF1Y3|*H$Hv|mNSK5Km zePDld-&&V={>W^5cDmq*SfY!CD3EKLr}dd~dFqhE&{lH_2YQ!>_InG0dZ#>s6bLbn z{aBYqc-?ILi{k3kJ>3pK{&*{kD>@P+NjnaW8c8=#b<{EruU#y>GyQdW zibsI6hw>~*xt#ecEEJpnj5U;Uej|qE0{)&iRtm%Z5*`*_E8dFc-$(-ma{?Xw9fQU+ zPdc7JcUf`UY$rHgj0dB#Om-mUW&SMhA{o*==r zhvF{{h?L8F;_*6rkMj_&9rC=tw(zmis;HmC4U--_x`F}mU@Dx!?wMy-F@=8?Um&m2l zBiRPxcDkz%>(pckTHG{;hB}k*^h&|Wq`cWH7JDet)&b-l4#RjovElZSzLK|&__H%elfAwv{ zuLeGM*@+8g`Tgl5!}~o z*_nJi;5n!zH|9L?%Jz#cxt2;2*;jSzxeo zvZ%xUxgz~rP@JBeJSxDUztnYtGy3v=;S_`WoAuE!KOS`7nukX}lT4b`KML}08_D;h z&dF&MNPI~9UdEm?<0L4j_)uW<&J7COO_SB}@O|T#;E7Pg;^2EPGrm?am3?NzK2`(T z=Ip7q$mi*ANPIP$L%2SG+v}yqp8y^uxPK!T9sGML$m|)HDQnC*9Wer^;IbbV>;>RX7|mR~8d^$=vpV2L zvskf6hWAFulAiA|)2%*U^{hXR=PY@v?wS_9vGYRHbx($wKK+^{A1wSkK%SS5cUX;( zb>L;=wWuf+dDL2j@|8(;@@)s`VAG>briu-Z>OmQZIa_{tk3?z%GA_y1y4G@z=Rn!c z-=Pjsyp$z`uEcN#$z&`2LZyAXZ&*3k`yU1DgGI$4^_AAb3l~g>p7E9 zy@;#bhM@4ki6@S}(*o$d?R{I@bt=p1aqsQqN_b!6x4{IwfRgP>!X(%JAPn*2eiObNTDyq?&Bi-PYG2u|EA; zNl3t3Aa_1j->PK3zPMIS#XM{)W3qKlPzi-s4M~d+ZcltwUo(l97k@c`8YI@X*T3zC z3c|Kip2lec=7FxlRqW!&kN`L3+t$l>96e?i+3Ej2xvS8CLiuPwZjy`AFAcEIH3ZpR z|7O!{ktFGN`^WV64SU?&ImE7159^^LoGvNrQvcjuTX6P;nFn!{Y9pq&%F7gUzSS1W zNnaBb5_o7#Y31)1AGc*bUv3lo#w_p@A~zR2Ri#+$GX0 zHBciHfN@3dZ*%gLf3Wc(7F4_pn=ACYt13qVB`L_4jW|SL_O?09CA5lF(7d`{j=n7P z>dY%#?)47mT(1@>yImmpt9Q_PP+IY{@kiQ-<$JwhSefo|b+P@< z7oIN$*5%nh1p3_kr0vpEWh%=%OjyW3(w`=Vdg=|x4h}m&Wt(4=r1ufh5ssb(DLN^& z}thS1+uP1!x3jBW#z7P}U44@ZJtPD`Ie$J!=AUeF&VKSfkbnc9v z@VQBvBG$!6#-YIJh~h}PL%|mw+tmgG%&F_s0?|MF?d5|du{_+73apszvXW6t3m2lu1yNLGg5Nwc68cwPCXs#FVrk-iA*|_3vinmy zO^jcsmneWC!z>4!92FQnU03Emm^naUruz?(3Y4rqe`iV9WY?%A7ZG2lOy9B)X?X1C zzr74k>vK&sAj-{1JBXiKUQN_3n@<+6`*?-ZuI_1?tYsPZq9cGxu^PZKw`B_s5HawmAzm{_nms9(ZyW=KtPTg|aXBGx+?+61ecw!d{x;aME^V-T z4pe}(LQY!Nk`Wko!K`L%>D|T_7LIq5Qy_uz)nV_B+`&JRt*xybXzPraP;3VQE6A6*+2=;0EZ9`!vAjTE%YLkrGQaGfL%7Oqb+Ie3Iyt(H z*=n*yI{y@aOI&{Q5S!=~v|iSMawMDgZJI0_1WkbbV^vG_I$+l@^m#Zpd-es%tqq^W z*^SFTNJ!V+ROre)ay`J<5sMIPy8-f(ox@&BwXbrkEmoh;ysO@;^ed1jJDJ+LgV&Pf zHg63DJqYey$m#|N3tj;aJI_A+4~-BtaKvWccPRGGUeA)OW~Vs}ERQ@i=8?QyPd%y8 zrmVu_BLSa|@02Itpa0!5=l}1$g8rN1{l7Wh|BqSb4`?Cc{;4+` zq!8$U81m^6VZbFzZ>z>Kg5{$6YHU&S(cc=m!4Q;@vyWc0=d}N#Sj9iFRy$w`pk`Wd zbtHw=T;@|uorOZqGsf5_5V%)3^2w9 zs3jIFAD4eSby9Z9xLEhY%_D@BYGtWS*xCkLKT$Y0<6Rfn@aY;f+n{V!8q93gmJ&aESlB9>}PkJ;=)E_cip zI^4V^ID@d37I3Xz(iiG$4>=49xjaPMqb{s{ zyZX9Mfs@@TRA5R-Y{Aa#Vwjv=Ub^6$LvswE-qNE z+r*veRdHU|!MV(r-&TaGH6+;0X|?e~E87Q`H%V+fy#OaNU^D;d&V7R{Y{wY{#_C&K`DVRHundLp~oQXcgazEr;%)W3R5 z1F{+PzY!74{R)fIo&Nfbw$WX|JkaCI=>YL0_HttRLphTGd(G(tjfa7x6LGp5T=@eQ z8hUog9|QBK+@)3J^4jIL%xO#WR1iHejtf(XLz+M*7BQl+Rmkn(ec{3FnkUL}d;lU0 z7vHym^0M*-N@8DdKEu`iDHs-Lka0p^-He6Z{coK5gS#n>+Vix9(@izsJ_<{pP!vDc zJ-jpv>dT$xMi$O$($i&L2bxsSFb*irs>|o%f)bv0pjx7*Rph-j3K`G$F-~)FX|&wP z#vtkHCO1VY;FOFA!y1C9-ZE(CrY3u)-^x^>N?trAxcKVT39t)yrus_y%dPd$Awj&&Rjg!I-AQD%T z?Xot6aDIf13Vp84Iw~$k7zKUk`PWlRWe5oFcG|DG9zPd6;G@YGEU{9rgHBK>Bl{0D zGXW7n4wkkcvC}&=SV=dC?3amXvvGU4$#DO_PZps1(5pwa70p_F@NzxT>)g{YY@hxO zrgcu}w~{By^#3Q`fbCHvVM>?4rl2bQpMd*6dpXd=Tcw3GY*#YBjlMSQ)wA0Ho7%QH z<<@uFWgC#53k~KJ@BEP(1apyVj{lHet3JL;%Ks+@9J&K0B!Cxo8M_6gn z2H?pJDhkkaQ$c$^!O)e_jCbcuZOxAmoKOB+la!fF<*lRqK}Wt~O&sey4qDcXM*yXZ zBHNLn$M%(NHZJ=7S-=6RH|kll*?;48Kq&U^)(vgTckut6Z+~bPg@#zE zxznX%Xh`C8{~;8XZ@P^No#HwG-W|g-OE23e%1O;L?Ghx}IO$TfWnW?Yh|TkT)z z`!Lo%OjL}m>*N=D{cAKr7zJSPjEMHZ8_QiD%8IX2=J_1x&-_Lg&^Ehza_Xd^yUmJOCOR!JM9_02-CdrF>$I+W6Pv}*5%lPvB)vd?lgn)ziyIWh* zpvmI3-!g8;V(neWBQr0hBhd7dd6Nc2TU9YMU9;rirj*@jQ!OC%?b{^RbDc! zKZ8y4$Hs^)&ycp)wvcFwt4?j7b4c^e`Nxby5u2S+zITW^-!!a1s{OAtav?S%`&Ku5 zNqp~DbPxe~F|~tR*$UWgteyiZ|M~miC2aK*@9XHG z*mt1&*p|1)S7VF9qj9%pk8e5`FSg59FXue*zA+Nuy3q&Vt^DQ{-zguL@9_vI0WsqZ z{<|?9fGqOh@zu!CgBrY1{zde^JG=43&lNruc>(O#V4%NLf`RJEfA7%d;4#^+lWGSj zA~)Kw9YN++fL3VV8TyYW=Jl(HJprtfl00hHeRu~PYu&n*{H{ClwO``*i&pHucLY!s z6Www!crz08|7`?ljav>s2KDXnd&T7@dA@q}kIt(dyTf%J@xS=_^c{Nn_UL4c2c&t@M=UMIkf*ctfx zf8oNLpQmVpyVIz;`-}>(niM1@I$-oocU=3L#hqpi$GLH0eKmUs>zOqZD_pephBbFN z?hpGk&`w9u^V}p6PCJH@VEQJR`mV(sbF!nY%PgoZ9&jhjz@WeBQg8JVka}<)v*?zN zUm>FR!uU<|JdQ~8I?;0uK)8fzrb!w$`*N%wYEa^wZ~5`Q=_}?^7n6pHkHDKd_S2F{ zk~)qJeFoMa=5A&W(_P=746PXbjvI+V)ud!T<%>_ZXBcK_jtQ75^X}?FCC@jJ$!tO0 zaVN%Bqp>@*vW95{ZF|y?{at*iN#?Gjz}H#P_0QFpY5UyLB(j;Z#Max~yZTD^o9fBB z-LR1%?rnMb9pU9o86{R`*=I=TM~u+ANh#b&f?~8FEaDSFaw(dub8tOooVrRE2&8QL{aO58^!2g zJ2@w4aZE`vX_|QcnIr9{l=Tm<{c`ckdqzW-Y3Nql3^$h!awRRo;_hh5A8}gxz50xx z+s8?BG*xIv_BpN+&)yL==fJ42LDkztq@ z$a>d*9nfpJL&|&5yEo6pc^S$-qEG9fQ?Bi?QCEN(6XwX3N9`(>xX*OW^d~6NJ~PtZ z({M&4x-D*NIL!R*@44o-&%*Im+1GxRi%V>a#SYnScN~9ho^;!2@_=+Ja=Gv8Z`NvF z&IQS7(VNu|4>q2#HUEUX;K{_(R<9xS4o;tAYd1bt)O(Fy>$RjZPmmk$No4XJ((s)d9Ql2+d@ta0f#8$3Mz5tGz!+H~md$N<->YH?|1J#_S!Bz-Yv>z`Id zv9F0(O~rP-salJrwXS}2)KlAVdi@NMdxVlio?o-zp62GM^(R}Ke94iGR96D;SPIWD zy*skkX?%>0ZC#f`87K5$!+n!ts**{A#7CQ}@dk{|@a1AhuM%Zgr}~a%X5n>j<%@Uy zFvOl&=BuqrRW0Z7?a`rnkBKfwEBaCEmM!un8T3VCG^L^XXWj zqm-=ULYZd*+sT2h>eT00nd6kBVay*6^1Z7s1|aac1n*vn=oXB|XO(>p7#mzso-UX0Wtpol=zl=HDHR}&ga*h ze=BZ7uw95s#0F2PJcVd<4wW9WV=#JT0il0mQx}Q5e|zL<=xIX!{11cJ5_Ur;tRkpK z3`Vup)Dp4r^{EP=;)ky# zNraR?X*OuQ=>)~8&=W@Da9Fz453&pbDfecEt55_f5*6;C0(y%4DTj4sC>N{O)0e;TjUw>3(gcdS~ z`1;8^IyUZUa@zAWIMVV{y1^8wh%;qcMuZrQ0* z{S3`==U>g?-2N$FPFny0PYhmGPA)m`AIZcg3O zbL;~(2}rrlYJH3NMf1pBx>zDcHGRLeT>*Rb0ptb*{wBoG@FEc2iw3gj@mpr?0b20m zJZs`H?ryLEf8A7I_pF&t}MCgP}ILKy_u=IzbmT zmkhe;c1KiDUFA;f?p()_;jLi9&PolU4z5D2_UF#yawgQ9`CZ?L=OpVS?}l~bI0U*Q zC#AVe+jYZM*$__Pjkz$lTZ3wpqw&IJOD%swam8y{gXYWX50Z6!H@Cu-bYRp(Mqt_K zGcw)n5DgzU>MINXI((8Y)yjpIlGNA=>-~eOj49g(YuGUQ+(f|-qm}CBtlj3F=_U?hGWlGd~~0=cNE;}?kBQYBS9X_9(d^&2w*pCehwVj zRQ#Z>^zpx{`!+`fW^Wsqz5gpNRCdJaQ^R=nDPJ+8K?Z9SW(LoD)Nm~QY5@7WRVsdB zlIYhq+XqX!0pGAmJLjHlT9lp*Ge56rewgLdQdLr{@R(`8JEZp(OJ5XS7BAX`fYTu>-N`hCK*zG03&8qd=mRfM*e3;;qbt@zL!Ia!{1d}9ip#6&Z z@j-PlSZ;V?rq7om+7qZg%&5uokouQ{^?}W(27-+>WYzU+!J+} zNxFm*(NfgiAP7i57d?xzMWJgO=KMiEo&|Ptj}uhS!FdR+el9b3FRX!lu|jbEQ6CyD znM)3MtT?VklWjs>G>{B&lDE@wV z5uzB)?1}Xr*N{9`L(5LN$yDj%;(;+IjD2SJH$yZmf5)v4dpEH7n15RAIh{1J6dnMx zc5Ud-(0C4^r?Y3AOa)NCJyvg)7RpP77z`IcrhAt%1eeA5k5Zm_H{Eo7(FARze5SN|3t{`prDt5;>lkVKCL(|31k2(C~)c-Ohj#TG_0*^o1f$=$OK7784`lj+q)X zz@=1{__VPOSk4m*YeE!T@dp2#$$MA7<_nnAzv3gxGi3c31pJrYevZ}TP38B%tPGf} zxggtTd#6FK$f>&^;Fze{@Kk_;x*lgJ+4^oe_L%K{Ou_6d?(}X5+zm*B@NF2~0KZZH zsf7B~%uY+$dxGYKp-PG?1b^g{nmQk5&3$%m|C*mLtlQhZmEU|*c469Bd`OAl6IJCv zs-IaPriUiAM?b)}?ukKidmQQU(n-4hL^e8zXN`Pdif)|F)N{bfa~AYMy`p@(F_*Ls z6g$uwL3}IT8G$`>04CHZM@JUjNxOeEP(SgqkFErSe!ef& zLc3^LNQPpv?w^MWa-SUtJg9wLoz}tGS_JQYZ=o@6&}!zqs*i^I_T`=>7~>HNDmD;! zYo4b^^$0Kua-kfX(F&M>)^WR$&vdpL5XpV><+4t(#(ka2+{e@a}or&^( z+Io>7ndcIsz9fc_IwK65iMf~NYG<{uUV3&m$gYxBu(gP>kaiJ@mI%Gssm9G-_QcNP z468lg?}Ke$+Vndg|H3;r?|I4v3BfJLQm>h*Nk#j??XURaN?^amzDc(B{w&A&1vz-) z1JLC-sv5_yYAxT$ad@ENszV46%yLE3_wN%WNzpgWkkZXni+%Uwo!FS`j1zs}O-pWt zI@$$pNk>7~r6oQyt2Is&ylhnT(*hl7ABpAkxI1UdANu!Rmjz;oO zu1h^DUifXIONcy<9p`gUbXP0dlcBnYU>D44LDCca*QR_|sxJqNgy1J203_txaIa*P zDk@?N519_Onr99_%IKl(H5$pTk#Gr|qNBwj;g(W){;}9Ifyt947lNy8!-eYar_VUG zE)_dXrjJAh9yc(dqz9h4ZHqU6N7-4UIne3RBx**Wd)`{7l2dCGrv5%|`%bF33Gl9f zblrRdiDCAw3omSaTkT(|z%5bR$1}O|v3wdr(^u;9W3iLrmdGi1ns3r_QfQt0yq!Oa z&^83mFaEl2sV8^3)jnbIokntIL(6c=esR$x!xy|a!su!iO>oMqY_y(N;b>G@OlPEh z9>KONyO-E>Q+D1w6BgI2!gthEKM7WpS5ID?+duo6IUxV6G?|3WyuA{TxO6uOg;%P& zOX);^M67dJ5^K+~l4;W7UvR*Mm}hv7#+_=x6{8S&sa8Rs*o&5Trd}7}Yv(q!_B{&E zS&3Mzt0@S|^X<6wv_M{58dD(8mR-HlME1DuO;E6R*9EPe%=zUiDbET7jjiu%KLu8j zdVN>?l2}}vutAzMb5&X~@0zh-Qblmv^Y?X`v2ig=LTXyTT{4$?{xry-`3B#Oh;@CL zV8=;;2J{n>lSxZXZ9U?r-bJ?a$nhYJGj;(nd13pSd zkexi9DpZskMmi=qXCnm+Bt^O<7dC$gQTY{KO#T_!uEkY5z((xz4+1S5vqm#qjQ5 zT9A`VT(jVOj7L%--l`OTxFl{!U~eq4x4H`!Fp-~YufVFxHTUJvBwI6LO?i%{eSkmF z-z;i!!=gI11njQYXK@a>y1q~CQMVe%NAiH9Dl2EXJ$0dIQB;l@nph8eI+cFM1QtfJ=wR7-ze}w#M?>C z?+mJf*9jcZHDocLH@T{_^vm-XSMKvW6O8Y|aUx0rcRq~WqGV`m*<}Jgu*(B7smbnD~=3rl)- zo3MGky2_2Ga`q`{52G&1eQ6=Krr4CT)Q+R?JJD(aye?1eoV*oDq^|ddHLd?LbR;8x zZNT2izLOD}#y$YTUWwSrFd2$ju*voyfx$z(Fhr2sGE4rg@8!O#m$BHu?d1wlYC^+% z_>R)^doK$HR((tLZmQ5S$}MOY*))T1-rdVPP*42Z$z%49%`5UcE$F>jp#tF>vuH(3 zsRV%xV*^)OjaSrIgXg-mi25A)gQPV_BI;sUF`R<*y;fCLLGSpyf-p2})Pl91>AYex z=y{Z~dcmw(u`-WKRW``wQdc5TPoL~BNVdi-((^Osa%4}b!@BgPe^}D`N+voc^bfp^ zeMq-7vjL;e6IHAY1sVvevMd=p35j>2-4p<;uxwyH_c5WK@W7VMlTiCk$4b~q8C@H@ z-2)r*pL=AEMEZ5EG||syvnsF5&)f(a?v7X(oNk$?l4g*0i(>g}4J~9@MA+C;Ck+CB zam7rY4+1x81|7zg*wf}kg>F3ozQZ$ZN;INvr2z!~EnyYWQviW~;E40Qohz4sX(7A5 zy~k*LrLRk7NGF&pu@r^8pT64qty2OPUI(-mr|`PbC1IG1HXOGrDvI;%;Epm<`3lG9;v%AWEUXLd z05idzw6n$HM_em=vj2*vD(P0<4sL8>T}W_h&NqnW`9H(9J?1pC>rxflbV_lTx5rg$ z*k8gS29E&14(-{bp%Ee9wZ;BHO+DGHA2;pFMj}nu`DbmrxfRX(&`Key_2e3)^geFh zb7r%rBeQ*(dvu>?BmECfu_g%Z&C6H$0>yb6_k)4{)~OZkv@o&wtA#cY|D|JrNB4q- z6*SZ%;!^w-lco6D-*Kul+iG)ByD;W~N^mi?C4_`^#pU(3jP~Rfsy^N2}U0G=Gmqs8P!Y35DTNBNi$fL^FfH6OOv=i~c3A*6E z<%gl1*x^FTK)rGGqms$frC45=8N=|eT3pW2ydnGeNSMlv=v5F{*?QM+U=%ZhUMN~^ z?mE*c_{J2XG2hWXSp?jm#60~B_$W`KD2>Pb)Gqvd7mR7b@KpA7gf1e!S>;t>=WRYj zdFM#^F2%pl!BAaoxOEU$1&S28Oukn)z(_us#dtM0ZR>>&p}}uYqlQQBM}JOEvp=M> z5k11@(zPOa9{DMejmZC-CcqcoCFByOzN!CjtR{~;P33bXtT^k~Hmo~v)$O`%^9fmTMR!~&~OtkWW_G_eN#^sFfhPOR5bI`=_=p`9T}UW7K}rN zTXH5cfkYo923sSOC%^lHVS{eb*gCev_S}qQQf!zCCChlR*p<}YQ*?LiqZ};i0p+F{ zB@*E4k5RG;2<(|OtPwAeBL+gy9gqDZv2DpO`S`=f6Sp5r)Efqpdj{3i+k-J|8m^P2 zwqL3>X&UYuTcNr(b$PZQuN6XSDNzMV-zX2YD42WUcSMnofmz20WxR2HF(y3Wm_1nK(c6>vg2KxH8VO+ ztyrT+;$G_S1h3om4g0@6y+T5A?+`qoaaS*@)!B?~!7ET1lkzrLSV}7A)sJ#Bq zX0*~^!2$%;wQ=B_nzGjMaSi0gjhNNO2~qy@Nch#^N_U66bRTnhEM+Vi1zOP-9g;?h zAYfK`X-k)8hkLbVcZ$I-}Kbf?HGKjyv zC+^OOrGeI$9omkHr_!u7eSC?6Yxh^ueC@%54;poy_7KUU{$_HH4yriZBq5?N+S=Gj z#MRk*I`t>PP1G|tACfZr&wCj8S10g(o5uTXBj?DLQ#0U1d9}9#`FpC2cYQSb!j^lz z;HV5fPxl6)(A!3Q?=1H-6TmQmKq}GF83FG$@J!@dvGOXY;IRT0og2)*8r<}~g2EdY zhgr~avLu7|zO%ftCZTH>f0bS7RGyh?5R;_OuNF^64y%he#c&1M!h6> zTi*bgi%7N)4FKDfz7 z1U2A)gx=G5mzFFnS~b5_j}Bk*hEG&mrEN8$O=E3Oc8mH=R_~Na`}f6+-{GjpFZu85 znW@8-%Zpn13@tN%fLWyJRBP(f^tyO_a&8D~t?tqn_RB(R zc=cW`WR$Eq`LMc4GMIG%!uje%=5%;FErcPko_)0W5uKM*q`tC?N1o@My-Nnn>69Q; zLC?&2YOlp&J!Y&?ju@q)zcN}oeiYM(6}6W(V9dq$cUm%b2(41x7O3OT-J@Xkb4uKG z^VDHt$HZFWTwG(7*zkxUhpFCy>dt9nnrN!%qb9u;X0&o02LBl~Cxx68USS!?4)-jh(hLjNdGCr~-2M7I@d z%F=aVNGugySf~W0F;L4Ba**-VhFCl;5(UIYDH4%e_o0oKplnT;) zdh$M_r6()2)f?G;&u@INegA5C+Fb=qqQ=-MSK7sMl2c@9l7{@Fb2OH3$nqMC80xc- z$P{g=5d&bk1F*D(aQO$FAUOclW4;dU`%>$f-2`Hhxv!U3a+a4uz<4wJ3D@5coi6XYYQ&C&{F^4Y8_)Vyi%!+34TQ{AKOTnfPg@BO7~omO2c z`%}PTNyEZr+WU)xvXr9+uU$hJ^%-;fRaOZBcW57T6B7DnMCtAAcL@q*K@`)4YO*@J z+uh(%Y54lcO<;=_>7BF3B#e+My`(j170Kn5H9~v0Y>~0zi5FhR3rMGv6R8Ja;Z|~v zv?m3B=-pojc;+aEH$zsxO(Wh3`pT(idF?EX`M!(z_^i*Bgq8?TbX?;VbYRKU6 z0W2v_r@|`@mh{FmDYQa|>{pn#CL@=&C2W5N;4=O+rl8+auI-5E>*5y_AB%!NWMg5&0 z%kP*|7n6Mr=P!OKa%zv$nvvt`dL$(?XNM4S@o5V%r8G!6ymAp8M;u-(N6KNWK~6xi z5;I-))0PenPl|)O5uR*KI;6qN4g8k_mBGAtRLh*Qw!^$ZGOj%~sa%Lf;+TQh)D6jC zvJlv(^`GLf2!k^x*wNzpVoXC!{iwrAduARurymGxxS()p}(u;1BP z?DDsXAUFZq^}Jwj=nIf~;z{u{1)B9YtbA0HUldUyj{6LL7`Fe@9PP8vkjA;qI4(A$P;6sE6i=ms&%d`JC%DoksHg_6s(Aka7-vrK7QFOa;3{L1wi`?*g`X_1|X1 zTmlfgIaU|F=sd6_m29J_IvL?Qv=1MQM9k8@GV?i4+Sx^jx<3QHkkCpt^KX_=d&DCP zuHSy^L<7!u@@B~y%cp0$r$?Z)qdSf1n*5SAIA;}m>vFf zU?QPi%o-h~Q}iu> zp|vn_v`GWXwPX=hlp4wq=~(OE$H6W|_%t?z&c|W&DzxZ5`sXS{gprLQUq8HCSgd@& z-TKI?-Cr2O=V_0G~X1Up`fopWHpD%2q0-5+LPUrf(o^s5xXFY_a@=PJ}2a8!E1 z&nE5Ntop3p5JAw4BcG@7d9_BsV90zoJX~%tJa}C@n9h=^e#WPO#^-8*Sa_KTl3`1{ z_&#J`&ax&b+-q&CoX@LuvRfV!-R2iyab5)+V_(i7OWJ|;T{M_ijtM8VX`l64P)APl z#Wl2(`=UyX2*!E(6_SjAbOJ;=ZC{)&dNptRvxem0H=bUX^v3%$X3T@~t@pxoKm(-9 zU$M}WNfK=DH(X$tL|^{#Am7vOy`+?P&x^7TU0gW);%Z2LPY`m-P6E-@E?_BfsLQ1g z|3xWD$TZuQX~CjDjiXB(Uai4`8p=@0{s;*D%WBNR1R|-i2qc{10DpkU+$AOdhLQ4~ zF?+qpxZkcE7b&|AMvBPcGMc!4izREVKmiq8P0MQ_(+ctzTE&Tqx4TP^=lbrgI{>S! z)OI3;QODbjI9lbl<74sj9EDYW;>fO_0AbJH1|3=Fz97MUx5KCRA&hScyTH9>F_36u z#+olVZZ~J<-SHbIGgzyy-gE-z7^ z?y!3=0o$JHbIewRPOvjwQJ$XL1@laI(ZgR9oVT#px1ULQ+H4RJD84#bU}_8ezCA|t z+avpl`W$w0fFq|^T~QI2yLgB(!>~DeeGZ`E5t5=@|3G$)#Fl%j2|ODT1X_6}sA}6y zGqoOZSk%@f4P-Z0A~kUzhJd3F#FEXK{OYGapRhcx&W;@3bv4AIjpgvdAZQR#Mlzpw&LWm@-`My2l8R#Woo=9fFzX4Dv}Ehns`<4YKGa!rSotLl zG6YWOR~ZjBF&jC$Ws70lk2}*Hxaa;&1B^+(|#53gX>O zQuGIh;;@#Q1YayKBe@nKy&P51%(#mxf3-OJrFai)1XY`|z>xEfNa-h&(Z2w zvV5J-T=2K?K5vpyVm?tndj&teL_MvVJ;)EcjIwNbX zY8ZXsOGW94;l{D0U{OzcGEY0oWu$QOAgSMRA@^`j`pX?9`puEL)|2SrBh ziavtjBrG(fZ37Vv>jw5jGo9Xj-5`mH%#*5&6sqJrNtll^HvTmj6#Sa6fhnr&dNAe| zfeoCm0s-+qrXUd7#Ji%^E8Jtlgyi66Hqh5|-bb3qXU&^leOP!Zw4xtAUJw;{{9F{E zz*#>3gBVTC8dR!{5{k0%65Ao>nUQ?$y<=WimFsNN*z`|kRgu_|*G~?>WQOO~&V{h+ zaN*jQYeyq@hFjBO^L^$SO>`S?LO;y0eZA&fXQqnc36}hM9lXC|Ndxc6iyx+zhtJd; zOIYOyb0xfvME0&T_D?}Hie|9xp$1|fzE&z}l22~=_}hjX_16(F&UJ(y*5dyfe+((C zVHarkeBqstD9w9z;aJ0_{?->yqw}*!NJx^uDhPBQmTrj0=Czz?OG5SpOHJQWtj=Cs z@#vIH8yk+m`DkikR$89+WJh%FhwZgSf2jUug<5@vU*UV)Fz;QOSPBkUB=Qb)5?u$5 zbQG7AEK#wpp%fEM1nym1(%+9Ja(71Ji$j#ISVLceURSAlRz_##p1ZTjOL7Gj2v?$t zk0n%i{-%(nb(Ph7tNl_S>b7+|5*s&qglpst5qU7UZ%K}>6#HOnm5_Hn)7VD2fDT)jYL$+X+-ieQ2Z`O`t$Tx^2?WtB1*n^| z7O}jC{bR5lu^@LRg){AZ=@u8!O2dRGlHhcOIGvpitI3*_hkRosq4rp{GmQ(pjC1RYursj-f?dd3%pS5@4lt{nO|-PK}nU2UCb-T^YJq6(37 zwCQL)l1Ah8ZoF{zq~i=T7QG8^u?$#(rs4~cGXseEx*e{zqIlMfT#=`}D@_bX#|1CF z5144@{#LbJTFc8S@129QM`Z&UuEW`FPfVw4F(f#Y%u%i`Fa@>$HqEJ$u&q#`0R2?!xfQ6xmh$QXt|BtU{d5*b2( z44h|!R%`p7-&yB7=UcyTt&e}n%HG-gexB#Pulu^L8@p)6AbFNqy$Cs-@79)5eh4+` zxHxV_IjG{uRLYCvRzKu#!=p7Co@QJOMux~S$ zT$XghL0rQA^1wj7towHaCu!x*d;bpNZ1@3rY4qveaU9w6+mNXS(P_(14>7fozhCOV zp3a@`dbJoZi=0VPSmy=@(-@{!w&nMjN5}UXGAAVU=vHw0d z+T7oUV#V0_ybu_Ezw9xkA*w1nXFVCCh* zS_1J*1dQB06yL!Qv_FmU_2R_!`@c`}1Xt!}d%D{NwL`%#m3)}Qbn9oPjS`>t6DfNln&62Ps3sxWO$Triv+HT+$GFpLW2)4c>_YAu&E#ZsAh~W~ znhI0os`THS_>jh$b$uUr{MGe3oc4@ZC!kzd-fd=kYnJ zF({x?>reydVW?&;4c$Aa0jET*Wl2^a)(xt``f#sl;A4^nLmKgnh&(gy;&P+g;*eW& zgu65k;a1WV+=fe!N9V&CbAU9b;=j!>s5y>akHVJko03zEobSDaNvX&zRhm zIby=_CR0YE-3|L_Yhhsb&mJGKo(uhG+F~%>6Xx6h%v$sLaH7XxTaeW0DZ&|5R?;`1&-2;W z&m{{uwQh`#kcGpGwY^>HF7mfhsF;VW8JFylKhYTbAM>iC*&C6w1AnwAx1o2IulMx< zRG=pvXdxpi5?!0oqJ*+oUh}(c`RuRM{tD5ZA*0`M??I6e9|?&qmY>CKaEoe;qZ8T> z$;rdS_^Ix#f9ZNW|3))MB@H!KiWjPCJp@sH^q3BDA{pX>+5hPYyZJfvfj5Jr(%mJd}LM#yfzDoQoG&BI8p;jZKn%i+mTPDX4 z+w;u&nP$y1d23&*?ao>%3Y*t9o|?{w@=Lb4Ipdj64c7!K{)leKfiUFpD>O4|1hkCi zc*2x8fl!q6K|)$EX0$)FY{<|@13om!&DC#-+e$(XsHF}X9$ z?u;I*6nb=@!lqCtb|s^SP0dI#vUl$!4}=uezB>!>c%gx;j8nx`*L=E_s4;?&?QVmq zfy%d+_A9lDNgoTl+Zi#b7@Y< z16FXOz2IFXjf#dE;B56zDwQw#X)Cq7BJs)herCk^+(XHN;JYzeog$yGE|Ab8ct zCq3Hr)njN8)Q?i=2?{%nOuzU_{`{`yx@gdey807%TR%T50MrL?ppo+fWMGBgV? z1sKZd#% zfmWVx7?x7dQL=oLZ)h6Tkeu4PRL={gE zEe6{dF!wEbOktq2IXqJtS_fL6ZEvIR!OSd_(v^*m_ZC#D8q&vC^9V%sQFbuGcK9s5 zyYAhUXu`>BY43)H`0ActKL%UdZT^Nd;=ta6O%D?m4aos;(CUtjA z-s01QM~8mXk}Zjl+M$2;N2tDE@UFFFN&Azx9W+-A=j{@#erj-wa$ZlE_;z~<<@d~!^c+H>gnd=ZBl2MjqIII^O^%VUxGb1 zRjMdYWjv8y+c7d4-IHury);|iC+e&OKcbxX@WLTUnzQ7+7Bb+Jesr`Rov?95~ZG9?8`8 zRK({r^nb@HR&}&V{i@HTR)B}Hx~CB@^)@$n%3z;)SJ@u*)~l!ObTtfMnZe)o7!itq z7O53i@4visKf|+d&hQo?TNW3qH_}%{VG}&3yGqj0i8PA^Y!H2VlXJh96$$j|q&DJ~ z&Um(Ok@#&wk~_3X9mmb66Ze9SGQdI?*&xgGhkD;hW$9eNz1~>vYPNW6`xP*LXAId_ zTjdo*JNK_ra=nJK{r7aNcR+q$wYsFt*9CY!J2qM+GYVZhjbrrE{Ns%}hdx%`u_=l$ zb{^ETg)iRJamKYj7=`+Lr5L!rmdMV>7C~~`_%GbK;qPm~F7Tq7>>wY>XfO{R3BtM$ zw&8n3yLM&v3JiB@avnA_jER_XI{z232s1yeNS1b6HXn>#BXI;*L>$QtL}P}??HI1ftn6_y25(13hagL^$Zblh*L%#8GcMpZd!DPQO$6jXRMX#rfF zl6b6O1g5pUt!80qVK|G@@JPp9uf@9RToahmeZVhTI+LcJRhc#0WdDik)pj{HAsMgwr#aKdOm% z*xbMZxrutplKrK`*~~J!=+dQS6_`pPK_fujCb833|R)5(F%VNJ@9CDP&uZla_c3r@vg%V6UJ<$wG@ztfMz>(#e*Rxz`k$gs7 z*nbd;)mgJt>t60D*L#0dO{AKiDkL(?x!E@XjRhbQ}~l@^4fkZ%(`&Qo)9$2sU(h;HxfHRFZC~X1lTJFscmk{=X$B9n9o(@kV)&W zjTmX3LZk}ypc80j;9sD30ea8x=`%=Au+P=i_Eay62sA4XhQBzgl|m~H_TJN? zGH=Ex_^-JF(n-MM{_QcWT(pu)x9g?ahP00nih5l6ahF2}cE$gPi*9fQ{srq+xRdWW zGxrGJAlqnoJbO1yJ7tu<5+d{y;MoH0*@tK2L8fP_PkAUIp*3LQ9-pRz0TUqEuUFgipUSU;0goi-eQwfSvBJ>c>EXeZ&}2B1c#ZG7;W_0 z@qQy;K2(i1Yk_$>Um~ic=&;mU9PV-k*Q|y2 zNmF_DI*au8PYieFV{C$#vOb;4(szKue`r}u`|THIbDhe9&fKkweo^Q46H6 zW#FO>9x+yW6H$M5@=+{AU$TST=6ZF-r87eE@5qrmo0b$%EA4`;SRa8AF`5MRRK&7rXz#C0{S_VDO1T zY{(cR+@~SO&^|C~h#%q`GBR&GLQ!#weCa@tTi?;6T&S+!K;q}OV9E^3s?E5t;g$tq z0-jXF%8xM6LZDUosUc@5hnMvFx0ShOjZpQ23;xprQEM%YFxkn3E{2i0k;wXvxiRiwI?UAqN_N&|*)&hvqxSAxuz zoVF@0Eb)qW5n!SjDeH!Dgq^!K&y$*zb#pj%;qmb4<4Js>*N4ahyx%`l2pKZ%)TJ3V z#tuHcNvffKli&e&t5s`64WT*j?L_Yuz7z8Na6n^ILtaj66iIIA)|zyJioE|rB<>ph z=}!uT*=7LF&fdRfA2KE;X@xeqHqiJngni-?_OG10mtObSfoOVa@q|}4mppnkawMHL z*6oL4N9dYUV)ZK|Pm@n(usloi!uYmB%RA%+XpVqF6!?TJ(qWE) z3h#?lxVK977ZO`!!%*DtBqGY}67JePh?D?MPC!KY^W;>H6c(-?UA94LA}3! zezYEFVQvpdUv5n)#?qe`gYv+`728nnyeF$i) zc=3y)fYKm?-yn2OSo_AzNo;NO3u*}C#-oYhESfC6@);_WlT&n88hGGPpJec_QsSyW zR(M4G+=oi49!$ve+QG$@)GgjEUCw0%G=_{myIRb=cMteXS%j5yqrmYIt>h&1y+q&V zxf+0&PXo{l$g1-1DrCM2&5I|_S(Ca6gT*SYfVFgV^sYWTv{LeGdszjt{9t)2!K5P^ z7}3%$5Y{U$E7sU3o`vvmI};#yhskNPlUQ?YXT0h_R8K-xZnq z>{d;L!8{L`XKu4^GW`+e%A1{=2P!8SJ`mywD@eEbomQ<+w%9a-oy-$6@u+Uz(HA#n zbXaFZRKza>mVK$8)r7s7`%XQz=0x=a5`@CPJ60Ef*g@SUV-coA1_ zwmVSmvY@kT)=>U!|Aj+oAn4SnQGDXUwua25I(V@r-yd)-J_nO@nY&m;2D+$L>*>V5&y~F z7qtuDQ}C@E;@*nH1k#v0F7q%%>e)?O2FM+36s0+|JVSldPWc&Z*a@FBwIw_eI~!;> zK=Uyk;(0P3^pYueH%A6MvU;+@n>}-Yb@1)}(z35gfNtRf_lE4W9AfqgL+OnrQ5EcM zG|q1(5^unq5Jj9`=}z^$%Vl0}!nb2}Cp9tq1St++N`tleT6L$AVYT$dW_ROkSO$Ma-4n12S zCr-2%10$P5U6zOS1AN|@wiOE}rPmmD_0w~FroEEPB8k~lPV?fdn-=lToHyO2@{LV2aFWEz;Im%|3IW&Bup6D^Dnzw+h+K zEcL?NpSb_Wrm|{7Xsf29XS!*s?ogKd$ES1w2~V|V4ZLuFGgJsEb2IMfseAYajwv?W zz0qy*7HFa2v4R(WkZG3271zs0KK3JUKT2ZK>zmOTY@GJ+@GZi!`q&=>B8)xkhlYHrC7oLta$r~vd|yvF{G0U-Ps zRKW;Kf1@4JX|2RXmrr?oV1L{Qh@~DRz<04S-zFCk80g)H2?Z*#stzkbOb-Bz43-Nc zzNpb#vaG4awfJi+7rY>Df4>lmk|?L5Cucc&d90Ze%uOtVjUwt6e(o6W?F!`CAxD6D z)BH8Oe(SCccdcF~Wp*RO#`gnW^!geo(flM7G?^!=2c}~emcr0h@EE-y_x#7+6=R%U zS$+l%!1E1J2FlEQ#Z~@dhQNe5T=|ghc*GAN33HCQf zGE%wRXqMt(gnP9Ru`F|M0VB8D-LeBPnjbl}3l3XF)N!XUdv}c)nvJoz1tgHOa|xaY z@U3T-{kr)}JAD>65d_<0=wi$mW#Qt`vVjR_@39dm&zgF=S4QIEvCn{B(1n_wXxtfN zaX1R$vtUxlZw;e%OZzo@!Cnss8zWl=m%2Hy~U(7q<_nq0NO`%`Am#x!$#`6ZGX8&}U;c@P?L+ z&!lel*h_-}dW!L9?KlPGCQ?|TJZh%P+HTmpf~4XR{}Z|q<+1Ko7;0bCfZCM71+Rkb zfzKLf5QwGrDzu)jh_cbIDwv5^-!Mw9e{0oxizoO7TMT+++G0UN={kJgkN>WMd(hBW z?qc-&w$u)<`s>L-gT}#}tPb5Exu8s@!Tw?|L5}Jfk$yLt_@`8W$>G1u8I+9-&|Vl` zBk_~@UjrF*EKDu0&dXQMCj+aZCRPc^1!gL;zITlcho7nVsaEu6%DObjX`9-2|NfLm z^CQFBcQ;+njd-`}gn!l^U`pWMz-jexc0Kp&X~(><%{A!&0|MLC<#Wl9?81llETuT` zrJNF%d^={9+C18(PBxC^)*v?a5Pg>!hpe~1LaijVgI+trtlLa1Wm$N2wtizYsNhyG zbiG()w$U-FFVTw|q}j6%dq5%W{8DAe@S~Jz+ps@C_eAZpUuN8*TH~;hD6Y=-y#Rdp zzK>KO8nhiQ<}an1c!P>Yyma=Y%(5XT)z>slYq&JjBD-;g zDa#>I$x@0KZS5ML-Kfa^=<;NA9ntib`k=Q}i_M&EV?=-OPA<881BE=7OTV>lSDM|k zj=AK(6Ddv!)mO5%v?U%Pz&g*@uNCWCy!xQXm2#e-e0 z;Lhi~nt^zLB1y1UdMlrSKmR8*T>te={x=bu{Wrf+s58(eU&{D5AM=x#+6&*?hHk*_ zYfJXFpiPfY1qPu}oW$t9vP-`RXYO^gh;_2)&9G%L>6}-Cl|kPO#rRC;PO}=cmKRHtOUKI&(GsdIeLYzG zGgLP`qM1$a=C~uxhT)0_|H{dna5Q=mjE$|llvr>^xrYJzXr(v6l z4X7A;a!~`aDi60sHi**cy7Zt!XZvzczFQMFYwO)I`LYn4g;>8!S*1u`Vt?hQ@{%K| za^V{Iz__Pqo&geWmd+mSmQjd^6py`xpdRH6e{cT&f>R#o z^-V`bs?!c?I!-@%fdFq=)y93{dS^GRx-$@ zuJ;yHnDdGNl|J$(hIv_+Y583|q^pR`4BWpfqgMt)sc^UKDj6!tgTraK){~(FN-Ew( z8QPkg0m)I)k6Gx~^+9E_x)oE5?|u+%9X8d3b5=EcmIkttz%*+|P(it8pdnVsqsY{a zB^SFj@H0ZRP|@ehj+Gb2I81lIu=3P2k(mM2gt^IWP{u>b0;`cX$X&_Ar1*~7$<)~u zNeq`gm~lPJ+pQ&IroC=nc@|<(M{fwIWq<+SNeX#yXEQ)67p{5GL(ldH-~!wKg+$hh zQ1iW#3Szr#0gd9riDc6pzCxY$w*_nD4e@z!PnypqCwsl+R86?3_WEQ?m7pi_t2d3E zo5^~F=Dk}@HSoQwDwN_`5!qog1u?liIvIX#(7_JABwbT<`9RVj@c`;1Zp|RKTF|za zMmeJ5qOzwp_PU|h`%I-7FJ$3(LN2-?Lzd{+-izMDoCnG3Z|%GO+VzD}q!~ws5HPq8_qcrYMT~{~!4d{i2%K(xmIz1*llKWQCX)^j6 z>D-(V*)%$dZi@S5Z6!TM3zL~(md5{e3h16JNi3phrTj>+s0#-qYr)~2tR_+OO(M|w zu)OCB)YmVNC9c-f3_-7PfB#?iY&k&p{#F|wGHPT%g}Juev9{g*)HB)Ng05?>j@uV- z(EIT~VcVF-SkzE*QkuGd+fvgdnoCoeX9U0Gx5~GbTeBuho&QDyGBL2{j7NjM;CL+G z9%h4Cdi?;8bmE$uxtI(Q*ER5Jd$=%8Nnn88m`rJpK-E##E@aE-Dao28>yUCL9hq>3M0kb?(kimV0(Q@!vD0ntApY6me*hTaVV4t*XVMBOCmg!$B1z<;V z-IaDSiDXa;dhmO53_QbrykGY*`l>PPk!330Udw^si02uwkmKfrb-w z%vsmu%*zyI1X_hujJUI2m>R+s6B^c}kCY!0Vu4)ZycBUTk9)QSPEJ!ayY|Gh8~E6P z4%6Ra#0Hed=N^6#Ci$>O+(i3(w&g1bfIF!I5P{y*XS$BtU5g*y(V1h z$M9M37}m}PUAwvZ5b~V#Brf`WR!)9^Wsa3Xo6y81cfFoD`7?aYHTHN*(t!1zCuQ&! z&z^v;jeYYVe!llxQGFFRhS{9?kr;bb7~g-2Ud<4QUp4YzFbyl{ zF(iFf$7?Wm4Nn1*(j=j6Sym5fP3U?g7?+xw-qL`yMYkF=i7Eyg!wCu9vVE46DZ3v+ z`b2Ar91CDWJbBI`ParLy=o@ggGRt{?P`U9a6&2jY7@C2_e^?KH5|hNkLuWN1ozjE4 z;l%d^CgGfi?gfNuVq3*ymN*XZtLFZt%(S%haM9~1%Y8Sb6f0tV0feba^DW*0K520OQ@js}K;4YYJs${=<&gKs#o5V3)b)nCmpSoB`~r(qJ(l zUG~atfd$g;SO@K{;oJhhcT->7OI4Osyus`3Wpd#thxEwra6g^}QD;Xj{ zc22iY!NjyD3sT=0V%v5YFIzxu#drgJ-dGvv!Tr;Q45T`%A_MX~P{V&B7EN2cTM;j4n*w7E{r2YW!H%w3^}ty5@Y>0xx2SMa3@#zcKnr zv46ojWETocU)7xUZv))J;n}$|V;#_XIrGnZ07Tv;`S7}$-7MDItGA8YrK5XPae0*; zC23=mj;bp2%^(nMW?E&ykSlyIP0`;jhA6{ zVc|VHtiWC6*d}MhWu9?)+kzk+1Ss|Z)zVtjf2DddruN=nI(zT1Fp>82}F5{kUTU?y8C|xo*k-KJkTnn7?2nftjaoj3gslE4ZtF`;*Fqj7%ExgHt5r}x? z@sW6x*ihA^sdk1aRGwy(_nVwCl<3wRd$C9H++@oAf1R-jCpe@xk2IJYb|I^FW*8pg zvuR2--^g&6>aJlS>^BK`_~s_x5wvIp1DFDm1L`BPDHu&>gn>C1-u1vj1D~-6*5z;M z`1f6q3drj#WTWJ`a^F&Wl$BflCq$#omTz_;g*m(GS2pI5xxU`HhWh|^2U~@9@^~dL zH}$(PE%EqOKB?gWN4p{!Jy#2)exSb?@~&b}aY@~9lr2kEvr}W>j>W2hwK*E zrvKAv@jrKRF-_g7>3Z;T2S?BIA25P~gI9gZflmwN)Tgc~RR&tVwS&S#bY)UVA|N+_ zt{m`4`StG}DT5hb9lA?$`xY2zbR30DRy_Wr$x6?GtL@sJ9SFPTe=={G1m-P_lU1e# zpWem?GZ};U%|7ubs}KhN^v{~ksXtQx$pI(&w5Ac_z(3f%{9iG=`9Fw3AeYBV4fN>7 zLl_;tG>~?d?1ajwI838U=EnDgJR0CPpaY&u<BWbt~0BeBhYxmHd#`rjmrT zG$a1=CDS^9_Z^7@9JI}`FM;E~%MHkBe<#i&9X49>-VbVvxnZMWmNcM-^#Sw5sH2Te z)71Vbp`hVwiC4h(8axN^_kZ2YYV|Vz&;7_w z+<9+S2YF$kT{+4{;cUGsWKvw<*wAz+RXL?qU7^w8fL|s2_&&q8Q4jcIQA zvBn1*|7c1%$b#qxCwa9Ai2m~imzjYKzKE9p9{dA<=ej9Z1LM{$x`Gc^~)nDZtF z3m*)|Za!A> zo7vv*{E!oS8+}_a9>7?Ac_B9V=Y{H06IkACTLx{@ORB#3!c=g9=0wnsD@i9HB^pCs z;&^m-R5H$$tIiJlIjTnvIXj$X0cHu!D?4Km31dezA#YSc`5c&5r9$}?_yR0Ntxs~T zr=_oZME*CjO^uLw-BtY1i~MMDz&+xFyZ`GL$f;}sa^3IlQcn;aC4$2KCppF1r!I2Z zs+?%)f?EV*N%dHz%Xz9vSU1b5!2$Gg7{4%93zbysI;##m>`ipj5Sm9FSo6z!f;NDm zR!tF?p7x$4(OdzxrsDx#-vMwc43_P%!~rW)d=V;9Om!N0BN0}h@Ev5xy0mJSegw$2 zC9+yxcs4upYOE53bwsYr{7X4x72GVp`u?F;JW>;|EtWT<+gH$C5{IVkx3xL+urB6T z3H}{7Ss?061p|K$?&zwSUr11jjc+j_4&14FRx%t#I9W~m1LlH2grW{K65ulSGtn6@ z$2hs~#8LIhsb!Q`N4^P;vc=zTPfo2iQ}IeZ>pLKGMpn@TvB>SMTHsZJmU$()JF#v6X0%JPb7`|iGV z3%dqN+yGw{B4D3;px0C1u`W-M;RjrksKbQfr@Obb!1y`EFjSv68BEsM*sL~b=cCJy z*Qsx#xi|ZAr$opWii3K}GYRe9v((Zr{haA+FfOWV0FE-|vFsG?HRTL>p6mo-4{gI> z{|ONvc#KXN%lVLgon&xQl#w)i<8lZdWM25 z8`&L}yRFP?H!hK~GDWrugp65PmK*1!i~`1S5vKgM`xQTKWlbK@gtq@018jc~z=V5ItC@z);mLl&4J68vDKhZSs4)1t%Ao(mF-6zt( zd(&%fU&ZzX+2+an20Vr%mb(+7saHM6jg2|q8T-o{ey^8gpb*(qUUf(f3^Gg2ruIJ!#wi`r;F zOoPqVWgw5$&NIq09-mV<1)M_?VFA7iZy2`@0E?03I7JzbX3F)SU$wbCx?@k&FF7bX z5umzf1EI0{Akv)pJhi2R+Y*7<6K0PXef_jdCH5UO4XdL&igZ{TX1QeO2veD9#6Bd^ zzz#HFzJyIMCd_m<0J8=uc~Ofru4vy``&;e(38=x&;<>xXQ=B4}_GMPGX?58!zxYjy`1WN^t`1qQD%dIPzC()K^vocM z51Sqr@#Ph&?14L1sRGh&aci#eVt}OU4C`yeKIS9&I6;3ev|ifKRnU5AL)(c;6R9@y zv)N0Nw)7^NZ3h06u(Jjj4QeVpNsK&t^2c8-+iK#g^u55U&ua_2t54~;*sW)>JXs_y zwL#D(<`uh7Bz;FUZOg4%B-I+pOZkJb7k;yC*V=TUJ27t3MFJu1>_FF*7E=M%%rR04 zFGO8)5V`wJ!R$8%NU>qxd*ufmwxs!%&%C?YLQno@$v%SL88?{;2t<@ z!=O~A>}MuI0Ka-|+~!;*ei?509mdGN4WOKm`!0h7=7d;V|I$x?5%?AcvwF5chny-f z!Qam~i@GA%bo>`oNPb%J!NV%Q)0}Hmg4JU;s88+v*4aoN8GnR7lkT)HD9ZLxNVboG z20pQ(tL5Z6ivnR(S5}G!YACm+$OuRvzzncIPl6{RAEUc2#{>HnPhLo!fkpg!3yL+` z$5`8dYEg|&Y>eWDZ@3DkpM&KmVB^MF)u?%~E|XOVNN2z2>2xU-wK7x?kp)@`|1O7o zal$!;2GdOx6Duvt442EJz>?f1O71E&^6$2#?CF-)fw}Q)CH}d|{IqFbBl;#U&qGTF zT8m(8!@f)x|HV8N0gfB~SguyJCrRJ!=_dGWdjTSOPdz(J+t(fov5@r?Yy!NwmTk zUa|0IM+F#A1myxvvE31nrpt7n>bf=)qNd6`)7gbJq*eT6%DZ^=@c#Cf*7g1;|L9+} zymi}GIm*C(vCn3)^36CkiMI5z_ubr+UMD|}?Om0;%-h%R;9wg9WNlLHJd&@uuJ`Q7EzJE`}tn8=3w6m!F<@%zmWT$70 zvhtIX9{QRATz3xICekIF^GH{UTw+I*U8hEPOfOebQID6d%5xKLFE1#p{`o+232$p| zE9kY{z(h|*=Z4R)yO-D@n*JRSrx}DjuU0KfWdnFPk0R>|p_{ zss{{S6SP@Q-X7N+oOFMc(*D^W#lF>jSw(*`osi?WwWy#_p*3~vb=&dcshc>n!5DW< zev8S-nC|3*(zeIY1QvZ>EzD*i3P?fNHAS~KBB_RbXlo9LgJzCR2lD-USjk~}fmg?x zR7I0;;}JNoC27Q)bGZB20p_mCD#`kCmf~AonJF4=Z_B9u(?89^4;~5GcI{aI!n=oc zo@n5CTm@!gAUo#+tETohHC{@V;$T$4gY(|EZ(S5Hk=Gr1?A_My+E+6rPPQ63)qM&~ z2Ww)Po#~uNPQAi&b2+57QL8zeP-cb=odU=7=(g8kF+&iVvzj+Q->u!Hf~5Dq6Ih=; zbj+K*U8j8_SD_!s3*S^1OQG}FZz|=pCEp|0dH@TsMSkZ+H(;doq74M5@VmYf z&c2$fhuuoi1Z^6dxKmCF&4mPg?dqp_%(F>bS~c+SZZklc;g^TcBtIKXBp!3)l(-Ho zybD!|O~{|h^AGhbd4NK+d$O=I^S$OCY{iGe>vI#H!CT~~nqCLH-FrO{kvwo36cb<$ zRcsPRNHm~=MOF4PAP@ze8110#x`hO$NN9suacIu_tf<==9IQz+?BkV98`P6EGL2oE zQk&?_GH33B8FL8J{Ef&-ISo``R1`=<9K|mPN&~vwF1wLdQJ;XY9(?nD0P;d(Z-o|JxFd%_o;0=gImBu zRrI~VKfglmwzi>uuJ^zYm=VKSG@7D4GdK*!xahk0qo~7&D)?o+GjlJCy=VHA@TsT? zc5xMa+)**i24N4h?fE|-<;=~1=l$CW`~lR;L5D8oBe#MpT-*sQR1FQ(_kFXn>u5dX&JYG9P_X<4=gp85jZa;!79Y5QqtB1*6zzgO=x zEB~}*Z=1@xN?scy)!nImU_GFXo@kL*0Phbv1@`-ayz{`x7Iyr$6S_97l>rUu#p7|2 z@S(nub^HOn5%`PtA|f;$au^IO1X_icm;At}iMpoh;7?}Y-K71VtXBcNz`^MUzVo-_ zb clazz) { - return ExampleBoardFormDto.class.equals(clazz); - } - - @Override - public void validate(Object target, Errors errors) { - ValidationUtils.rejectIfEmptyOrWhitespace(errors, "title", "valid.common.required"); - ValidationUtils.rejectIfEmptyOrWhitespace(errors, "content", "valid.common.required"); - } -} -``` - -`Controller` 메서드에 Validator 가 사용되는데 이때 메서드 인자로 DTO 객체와 BindingResult 객체를 나란히 선언(중요) 해주어야 합니다. (순서가 중요) - -```java -@PostMapping("create") -public String createPost( - // ... - @ModelAttribute("formDto") ExampleBoardFormDto formDto, - BindingResult bindingResult) - throws IOException { - - exampleBoardFormValidator.validate(formDto, bindingResult); - if (bindingResult.hasErrors()) { - return "board/exampleBoardForm"; - } - - // ... -} - -``` - - -이제 `bindingResult` 의 hasError 메서드를 통해 검증에 위배된 항목이 발견되면 메서드 수행을 멈추고 이전 입력폼 화면으로 리턴합니다. -`@ModelAttribute` 를 통해 DTO 객체는 formDto 속성명으로 model 에 담겨 자동 전달됩니다. - -입력폼에서 검증 실패 메세지를 보여줄 때 Thymeleaf 의 `th:object` 와 `th:errors` 를 이용합니다. - -```html -
- -
- 에러 메세지 -
-
-``` - -form 태그에 매핑된 `th:object` 를 통해 form 필드(`th:field`)와 에러 메세지(`th:errors`)를 연결할 수 있습니다. -아래는 검증 실패 메세지가 표현된 화면입니다. - -![캡쳐](./img/validation.png) - - -## step.3 - Ajax 요청일 경우 검증 처리 - -Ajax 비동기 요청의 요청 주체는 Javascript 이기에 validation 실패 메세지 또한 **JSON 응답 형식**으로 전달되야 합니다. - -```java -@PostMapping("save") -@Transactional -public ResponseEntity save(URIFormDto formDto, BindingResult bindingResult) - throws IOException { - ValidationUtils.invokeValidator(uriFormValidator, formDto, bindingResult); - if (bindingResult.hasErrors()) { - return commonUtil.getValidationFailResponseEntity(bindingResult); - } - // ... -``` - -`bindingResult.fieldErrors` 목록을 commonUtil 을 이용해 DTO 로 변환 후 응답객체 본문에 담고, HttpStatus 코드 422 와 함께 내려줍니다. - -* 422 (HttpStatus.UNPROCESSABLE_ENTITY) 는 검증 실패와 관련해 가장 적합한 HTTP 상태코드입니다. - -$.ajax 콜백에서 검증 실패시 처리를 위해 아래와 같이 **httpStatus 콜백을 명시적으로 선언**하는 것을 권장합니다. - -```javascript -$.ajax({ - type: 'POST', - url: '/api/uri/save', - statusCode: { - // validation 실패 시 처리 - 422: function (response) { - const fieldErrors = response.responseJSON; - let form = document.formDto; - $(fieldErrors).each(function (idx, error) { - $(form[error.field]).addClass('is-invalid'); - $('.field-' + error.field).text(error.message); - }); - } - } -}); -``` - -json.fieldErrors 배열 loop 을 돌며, field 와 defaultMessage 를 alert 로 뛰울 수 있고, 위의 예처럼 bootstrap CSS 를 이용해 화면에 render 해주는 방식도 가능합니다. - -$.ajax 의 fail 콜백함수를 사용해도 되지만, -validation 처리 외에 **예외 발생시 시 응답코드 400 를 전달**하는 등 다른 정책들도 있기에 -statusCode 선언을 통한 명시적인 분기처리를 권장합니다.