feidZddlmZmZmZmZmZddlmZm Z m Z m Z m Z m Z mZmZmZmZddlmZddlZddlmZddlmZddlmZmZdd lmZmZm Z dd l!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'dd l(m)Z)m*Z*dd l+m,Z,m-Z-m.Z.dd l/m0Z0ddl1m2Z3m4Z5m6Z7m8Z9m:Z;mZ?m@ZAmBZBmCZCmDZEmFZGmHZImJZJddlKmLZLmMZMmNZNmOZOmPZPddlQmRZRmSZSmTZTmUZUmVZVddlWmXZYmZZ[m\Z]m^Z_m`ZaddlbmcZcmdZdmeZeddlfmgZgmhZhddlimjZjmkZkddllmmZmddlnmoZoddlpmqZqddlrmsZsddltmuZueZvejexZyevjde dge ddfd e{d!e fd"Z|evjd#ee{efe jdg$e ed%d&ed'e"d!efd(Z4evjd)ee{efdge ed%d&ed*e%d!efd+ZHevjd#ee{efdge e e efd,e'd-e&d&ed!efd.Z6evjd/ee{efdge efd&ed!efd0Zevjd1ee{efdge ee d2d3d24e dd5d64e dd7d84e d9d:d;ded?ee{d@ee{dAed!ef dBZevjdCee{efdge ee ddDdE4fdFe{d&edGee{d!efdHZ2evjdCee{efdge efdFe{dIe#d&ed!efdJZ:evj dCee{efdge efdFe{d&ed!efdKZ Customer router for handling customer-related API endpoints. )ListOptionalDictUnionAny) APIRouterDepends HTTPExceptionstatusQueryPathBody UploadFileFormFile)SessionN) get_session) APIException)get_current_userget_current_merchant)CustomerSchemaCustomerListSchemaPhoneLookupResponseSchema)CustomerCreateRequestSchemaCustomerUpdateRequestSchemaCustomerActionRequestSchemaCustomerBulkActionRequestSchemaCustomerFilterSchemaCustomerPaginationSchema) AddressSchemaAddressCreateRequestSchema)CustomerContactSchema"CustomerContactCreateRequestSchema"CustomerContactUpdateRequestSchema)User) get_customercreate_customerget_customers_listget_customer_by_emailupdate_customerdelete_customeractivate_customerdeactivate_customercheck_customer_id_existscheck_account_literal_existsget_customer_activitiesget_customer_summarybulk_customer_actionslookup_phone_number)create_customer_addressget_customer_addressesget_customer_addressupdate_customer_addressdelete_customer_address)create_customer_contactget_customer_contactsget_customer_contactupdate_customer_contactdelete_customer_contact)get_customer_notescreate_customer_noteupdate_customer_notedelete_customer_noteget_customer_note)upload_customer_attachmentsdelete_customer_attachmentget_customer_attachments)NoteResponseSchemaNoteListResponseSchema)NoteCreateRequestSchemaNoteUpdateRequestSchema)FileResponseSchema) FileTypes) generate_id)MerchantSchema) UserSchemaz/number-lookup CUSTOMERS)response_modeltags.zPhone number to lookup) descriptionphonereturnc>Kt|}t|dddSw)a4 Lookup phone number information including validation, formatting, and carrier details. Args: phone: Phone number to lookup (can be in various formats) Returns: Phone lookup data including country code, formatted number, location, carrier, and validation status Tz Phone data)data status_codesuccessmessage)r3r)rS phone_datas I/var/www/html/hwPaymentPortal-be-uat/backend/src/apps/customers/router.pyphone_number_lookupr]ps+%U+J $   s)rPrXrQ)dbr_ customer_incKt||d{\}}|ttj|d|t |dr|j dS|dS7Hw)ac Create new customer. The system supports two ways to handle account literals: 1. User-provided: Include 'account_literal' field (15 characters) - system will validate uniqueness 2. Auto-generated: Leave 'account_literal' empty - system will generate a unique account literal Use /customers/account-suggestions to get suggested account literals before creation. Note: All validation (email uniqueness, account literal format, etc.) is handled by Pydantic validators. Note: customer_id is for internal use only, account_literal is the public-facing account number. ) customer_dataNrXdetailT model_dumprYrZrW)create_customer_servicer r HTTP_400_BAD_REQUESThasattrre)r_r`customerrZs r\r'r'sy&6b TTHg33  )0<)H##% OW UsAAA Az/actionsaction_requestcK t||j|jd{}|ddk(}|rd|dd|jd}nd |dd |dd }|||d S7:#t$r&}t |j |j d}~wt$r8}tjd|t tjd d}~wwxYww)a Perform bulk actions on multiple customers. Limit- Maximum 10 customers per request for performance optimization. Available actions: - activate: Enable customers and restore soft-deleted ones - deactivate: Disable active customers - delete: Soft delete customers For single customers, pass one ID in the ids array. Returns detailed success/failure results for each customer. )r_action customer_idsN failed_countrzAll success_countz customers were successfully dzBulk action completed: z succeeded, z failedrfrcz+Unexpected error in bulk customer actions: z:An unexpected error occurred while processing bulk actions) bulk_customer_actions_servicermidsrr rXrZ Exceptionloggingerrorr HTTP_500_INTERNAL_SERVER_ERROR)r_rkresultsoverall_successrZes r\r2r2s&  5!(('++  ".1Q6 W_566STbTiTiSjjklG/0H/IV]^lVmUnnuvG'   (   99     CA3GH==O   sDC%A&A$9A&#C$A&& C/!B C3CCC paginationfiltersc K|jdz |jz}|jdk7r |jnd|_|jdk7r |jnd|_t |||j|dd{}d|d|d|d|d |d|d zdz |d z|d du|d dud |d |d |d |dddS7Kw)z_ Retrieve customers with filtering and pagination using schema-based query parameters. rNT)r_r|limitoffsetpaginaterWtotalpageper_pagenextprevious)rrr total_pageshas_next has_previousfirstlast)rrrr)rYrWmetalinks)rr is_active is_vendorget_customers_list_service)r{r|r_rpagination_results r\r(r(s#oo!Z%8%8 8F.5->->!-C))G-4->->!-C))G9 !! !&)&w/%f-)*5-g69J:9VVYZZ_pq{_||)&1=-j9E  &f-)*5&w/%f-   sA>CC A Cz/account-suggestionscK g}d}d}t|dkrR||krMtd}t||d{s||vr|j||dz }t|dkr||krMt|dkr%tj dt|d|dd d t|d |d d ddddS7#t $r8}tjd|ttjdd}~wwxYww)a0 Generate four unique 15-character account literal suggestions. Returns four automatically generated account literals that are: - Exactly 15 characters long - Follow a consistent pattern - Validated against database for uniqueness - Used as public-facing account numbers rr~rjNzCould only generate z unique suggestions after z attemptsTz Generated z account literal suggestionsz9ACC + 3-char identifier + 6-digit timestamp + 3-char UUIDACCM7X123456ABC)lengthformatexample) suggestions pattern_inforfz&Error generating account suggestions: z&Failed to generate account suggestionsrc) lenrLr/appendloggerwarningrtrvr r rw)r_r max_attemptsattemptsaccount_literalrzs r\get_account_suggestionsr s0'   +"x,'>)*5O6b/JJJ"+5&&7 MH+"x,'> { a  NN1#k2B1CC]^j]kktu v#C $4#55QR* Y0!  K.   =aSAB==;   s?C=3B9B71B9*A B96C=7B99 C:3C55C::C=z/summaryFzFInclude vendor statistics: true=vendor summary, false=customer summary)rRrz5Start date for summary statistics (YYYY-MM-DD format)z 2024-01-01z3End date for summary statistics (YYYY-MM-DD format)z 2024-12-31 r~2z(Number of top/lowest customers to return)gelerRrr date_fromdate_torc6K t||d{}|S7#t$r&}t|j|jd}~wt $rD}t jd|ttjdt|d}~wwxYww)z Get customer summary statistics. Returns summary data including top customers, lowest customers, and most frequent customers. Currently returns static data for demonstration purposes. Nrcz!Error fetching customer summary: Internal server error: ) get_customer_summary_servicerr rXrZrtrrvr rwstr)r_rrrr summary_datarzs r\get_customer_summary_endpointrBs  9"iHH I   99     8<===,SVH5   s<BB B!A B?BBBz/{customer_id}z]Comma-separated list of related fields to include: addresses, contacts, merchant, attachmentszaddresses,contacts customer_idfieldscK t|||d{}ddt|dr|jdS|dS7(#t$r&}t |j |j d}~wwxYww)z Get customer by ID with optional related fields. By default, no related fields are loaded for better performance. Use the 'fields' parameter to specify which relationships to include. rrNTzCustomer foundrerfrc)get_customer_servicerirerr rXrZ)rr_rrjapi_excs r\r&r&`s  -bkRXYY'-4X|-LH'')  S[  Z  ++??   ?A2A>#AA2AA2A A/ !A**A//A2customer_updatecK t|||d{}ddt|dr|jdS|dS7(#t$r&}t |j |j d}~wwxYww)z Update customer by ID. )rrbNTzCustomer updated successfullyrerfrc)update_customer_servicerirerr rXrZ)rrr_updated_customerrs r\r*r*|s  !8ds!tt65<=M|5\$//1  cs  u  ++??   rcfK t||dd{}t||d{}|sttjddd d S7;#t$rP}|jdk(rttj dt|j|j d}~wwxYw7w) z. Delete (soft delete) customer by ID. NrCustomer not foundrc)rzFailed to delete customerTzCustomer deleted successfullyrYrZ) rrrXr r HTTP_404_NOT_FOUNDrZdelete_customer_servicerh)rr_existing_customerrzrYs r\r+r+s  "6r{[_"``,BKHHG 33.  2 +a   ==C "55+  99   IsBB1AAAB1B/&B1A B,A B''B,,B1z/{customer_id}/addresseszCUSTOMER ADDRESSES address_datacK t|||d{}ddt|dr|jdS|dS7(#t$r&}t |j |j d}~wt$rG}tjd|d|t tjd t|d}~wwxYww) z>Create a new address for a customer with use_as_default=False.NTzAddress created successfullyrerfrcz$Error creating address for customer : r) r4rirerr rXrZrtrrvr rwr)rrr_addressrzs r\ create_customer_address_endpointr /KNN5,3G\,JG&&(  QX  O   99     ;K=1#NO==,SVH5   GB??=#?B??B?? B<!A)) B<5AB77B<<B?zPage number for pagination)rrRrdz"Number of items per page (max 100)zFilter by address typebilling)rshippinglegalmailing)rRrenumz>Filter by active status: true=active only, false=inactive onlyTz Filter by default address statusz0Search in address lines, city, state, or countryzNew Yorkrr address_typeruse_as_defaultsearchc K |}|dz |z} t|||| ||||d{} dd| dd| d| d| d | d | d | d | d | dddS72#t$r&} t| j| jd} ~ wt $rG} t jd|d| ttjdt| d} ~ wwxYww)zAGet paginated list of customer addresses with optional filtering.r~)r_rrrrrrrNTFound rz addressesrWrrrrrrrrrrrrrrYrZrWrrcz%Error listing addresses for customer rr) r5rr rXrZrtrrvr rwr) rr_rrrrrrrrresultrzs r\list_customer_addressesrs' (h&-#%)   w0 ;6Nv":.v":.v    0   99     <[MA3OP==,SVH5   EC AA1ACA C"!B CACCCz%/{customer_id}/addresses/{address_id} address_idc K t|||d{}ddt|dr|jdS|dS7(#t$r&}t |j |j d}~wt$rJ}tjd|d|d |t tjd t|d}~wwxYww) z,Get a specific address by ID for a customer.NTz Address foundrerfrczError getting address  for customer rr) r6rirerr rXrZrtrrvr rwr)rrr_rrzs r\get_customer_address_endpointr  ,RjII&,3G\,JG&&(  QX  J   99     -j\ }TVWXVYZ[==,SVH5   GC?=#?C?C? B?!A)) B?5AB::B??Cc K t||||d{}ddt|dr|jdS|dS7(#t$r&}t |j |j d}~wt$rJ}tjd|d|d |t tjd t|d}~wwxYww) z4Update a customer address with partial or full data.NTzAddress updated successfullyrerfrczError updating address rrr) r7rirerr rXrZrtrrvr rwr)rrrr_rrzs r\ update_customer_address_endpointr% /K\ZZ5,3G\,JG&&(  QX  [   99     .zl. UWXYWZ[\==,SVH5   LCA>#ACACA C !A** C6AB;;CCc JK t|||d{dddS7 #t$r&}t|j|jd}~wt $rJ}t jd|d|d|ttjd t|d}~wwxYww) z/Soft delete a customer address with validation.NTzAddress deleted successfullyrrczError deleting address rrr) r8rr rXrZrtrrvr rwr)rrr_rzs r\ delete_customer_address_endpointrA %b+zBBB5   C   99     .zl. UWXYWZ[\==,SVH5   =B#  B# B !A  B ABB  B#z/{customer_id}/contactszCUSTOMER CONTACTS contact_datacK t|||d{}ddt|dr|jdS|dS7(#t$r&}t |j |j d}~wt$rG}tjd|d|t tjd t|d}~wwxYww) z$Create a new contact for a customer.NTzContact created successfullyrerfrcz$Error creating contact for customer rr) r9rirerr rXrZrtrrvr rwr)rrr_contactrzs r\ create_customer_contact_endpointr\rrz9Search across contact name, email, title, or phone numberjohnz+Filter by contact job title (partial match)ManagerzFilter by contact relation typeprimarytitlerelationc K |}|dz |z} t|||| ||||d{} dd| dd| d| d| d | d | d | d | d | dddS72#t$r&} t| j| jd} ~ wt $rG} t jd|d| ttjdt| d} ~ wwxYww)z@Get paginated list of customer contacts with optional filtering.r~)r_rrrrrrrNTrrz contactsrWrrrrrrrrrcz$Error listing contacts for customer rr) r:rr rXrZrtrrvr rwr) rr_rrrrrrrrrrzs r\list_customer_contactsrws' (h&,#   w0 :6Nv":.v":.v    0   99     ;K=1#NO==,SVH5   rz$/{customer_id}/contacts/{contact_id} contact_idc K t|||d{}ddt|dr|jdS|dS7(#t$r&}t |j |j d}~wt$rJ}tjd|d|d |t tjd t|d}~wwxYww) z4Get a specific contact by contact_id for a customer.NTz Contact foundrerfrczError getting contact rrr) r;rirerr rXrZrtrrvr rwr)rrr_rrzs r\get_customer_contact_endpointrrrc K t||||d{}ddt|dr|jdS|dS7(#t$r&}t |j |j d}~wt$rJ}tjd|d|d |t tjd t|d}~wwxYww) z4Update a customer contact with partial or full data.NTzContact updated successfullyrerfrczError updating contact rrr) r<rirerr rXrZrtrrvr rwr)rrrr_rrzs r\ update_customer_contact_endpointrrrc JK t|||d{dddS7 #t$r&}t|j|jd}~wt $rJ}t jd|d|d|ttjd t|d}~wwxYww) z/Soft delete a customer contact with validation.NTzContact deleted successfullyrrczError deleting contact rrr) r=rr rXrZrtrrvr rwr)rrr_rzs r\ delete_customer_contact_endpointrrrz/{customer_id}/activitieszCUSTOMER ACTIVITIESc<K t||d{}|S7#t$r&}t|j|jd}~wt $rG}t jd|d|ttjdt|d}~wwxYww)z Get customer activities. Returns a list of activities for the specified customer. Currently returns static data for demonstration purposes. Nrcz'Error fetching activities for customer rr) get_customer_activities_servicerr rXrZrtrrvr rwr)r_ractivities_datarzs r\r0r0s  ?K PPQ   99     >{m2aSQR==,SVH5   s=BB B!A BABBBz/{customer_id}/attachmentszCUSTOMER ATTACHMENTSzUpload Customer AttachmentszyUpload multiple attachment files for a customer. Files are stored in uploads/data_files/merchant_id/accounts/customer_id/zList of uploaded files)rPrQsummaryrRresponse_descriptionzThe unique ID of the customerzFiles to uploadzType of files being uploaded)defaultrRfiles file_typecKtjdd}tjdd}t||t |drt |j n t ||||d{}|dd S7 w) z'Upload attachment files for a customer. merchant_001r~ merchant_ididuser_idrvalue)r_rr current_usermerchantrNz&Attachment files uploaded successfullyrWrZ)rMmodel_constructrNrCrirr)rrrr_r rresponses r\ upload_customer_attachment_filesr sx&--.QOH--aA>L0 *1)W*E#ioo&3y>! H)Q RRsA-A;/A90 A;zGet Customer Attachmentsz,Retrieve all attachment files for a customerzList of customer attachmentscBKt||d{}|ddS7 w)z(Get all attachment files for a customer.)r_rNz+Customer attachments retrieved successfullyr )rE)rr_r s r\get_customer_attachment_filesr<s0. H)V WW s  z$/{customer_id}/attachments/{file_id}zDelete Customer Attachmentz0Delete a specific attachment file for a customerzDeletion confirmationzThe unique ID of the filefile_idcKtjdd}tjdd}t|||||d{}|ddS7 w) z)Delete an attachment file for a customer.rr~rr)r_rr rrNz$Attachment file deleted successfullyr )rMr rNrD)rrr_r rr s r\delete_customer_attachment_filerPs]$--.QOH--aA>L/ ! H)O PPsAAA Az/{customer_id}/noteszCUSTOMER NOTESzGet Customer Notesz8Retrieve paginated list of notes for a specific customerz2Paginated list of customer notes with user detailsNotes retrieved successfullyzapplication/jsonrz)Customer called regarding payment inquiryz2025-12-02T15:30:00.000ZAdminr%zadmin@example.com)r first_name last_nameemail)rrR created_at updated_at deleted_at created_by_id created_by)rrrrr)rYrZrWr{)rRcontentrRrInternal server error)rVr)rPrQrrRr responseszCustomer ID (customer_id field)ACCKDU1537895E7z&Number of items to skip for paginationz2Search term to filter notes by description contentpaymentrc rK t|||||d{}dd|d|d|d|d|d |d |d |d d ddS7,#t$r&}t|j|jd}~wt $r8}t jd|ttjdd}~wwxYww)a Get paginated list of notes for a specific customer. Returns paginated notes associated with the customer, ordered by creation date (most recent first). Each note includes full details of the user who created it. **Features:** - Pagination support with configurable page size - Search functionality in note descriptions - Full user details for note creators - Ordered by creation date (newest first) **Parameters:** - **customer_id**: The customer's unique identifier - **limit**: Number of notes per page (1-100, default: 10) - **offset**: Number of notes to skip (default: 0) - **search**: Optional search term to filter notes )rrrNTrrWrrrrrrrrrV)rYrZrWr{rXrcz(Unexpected error in get_customer_notes: r) get_customer_notes_servicerr rXrZrtrrvr rw)rrrrr_rrrzs r\r>r>psN 1  5  56Nv":.v":.v   $  ++??     ?sCD==*   sDB7AA+AB7A B4!A00 B4<3B//B44B7zCreate Customer Notez)Create a new note for a specific customerz+Note created successfully with full detailsNote created successfullyrfz&Invalid input data or validation error)rr)rPrXrQrrRrr z7Note creation data with description (1-2000 characters) note_datachK tddddd}t||||d{}dd |jd d S7#t$r&}t |j |j d}~wt$r8}tjd |t tjd d}~wwxYww)a Create a new note for a customer. Creates a new note associated with the specified customer. The note will be attributed to the currently authenticated user. **Features:** - Automatic user attribution to authenticated user - Description validation (1-2000 characters) - Customer existence validation - Returns full note details with user information **Request Body Example:** ```json { "description": "Customer called regarding payment inquiry and requested status update" } ``` **Authorization Required:** Valid JWT token (currently uses placeholder user ID) r~temp@example.com temp_userTempr%rrusernamerrNTr%r&rYrZrWrXrcz*Unexpected error in create_customer_note: r) r%create_customer_note_servicererr rXrZrtrrvr rw)rr(r_created_by_usernoterrzs r\r?r?sF $   2  Y  2OO%      ++??     A!EF==*   sAB2!A?AB2A B/ !A++ B/73B**B//B2z/{customer_id}/notes/{note_id}zGet Customer Notez(Get a specific note by ID for a customerz"Note details with user informationzNote found successfully Note foundzCustomer or note not foundzNote ID to retrievenote_idcFK t|||d{}dd|jddS7#t$r&}t|j|j d}~wt $r8}tjd|ttjdd}~wwxYww) a Get a specific note by ID for a customer. Returns full details of the specified note, including the user who created it. **Features:** - Full note details with user information - Customer and note existence validation - Soft-delete awareness (won't return deleted notes) **Parameters:** - **customer_id**: The customer's unique identifier - **note_id**: The note's unique ID to retrieve NTr3rVr/rcz'Unexpected error in get_customer_note: r) get_customer_note_servicererr rXrZrtrrvr rw)rr4r_r2rrzs r\rBrB<sp .r;HH#OO%   I  ++??     >qcBC==*   s<B!0.0B!0 B!A B&3BBB!zUpdate Customer Notez&Update an existing note for a customerz+Note updated successfully with full detailsNote updated successfullyzWUpdated note: Customer called regarding payment inquiry and provided additional detailsz2025-12-02T16:15:00.000Z)rVr'rrzNote ID to updatez5Note update data with description (1-2000 characters)cjK tddddd}t|||||d{}dd |jd d S7#t$r&}t |j |j d}~wt$r8}tjd |t tjd d}~wwxYww)a Update an existing note for a customer. Updates the specified note with new data. Only the user who created the note or admin users should be able to update it. **Features:** - Description validation (1-2000 characters) - Customer and note existence validation - Automatic timestamp update - Full note details in response **Request Body Example:** ```json { "description": "Updated note: Customer called regarding payment inquiry and provided additional details" } ``` **Authorization Required:** Valid JWT token (currently uses placeholder user ID) **Permissions:** Note creator or admin users r~r*r+r,r%r-NTr7rVr/rcz*Unexpected error in update_customer_note: r) r%update_customer_note_servicererr rXrZrtrrvr rw)rr4r(r_updated_by_userr2rrzs r\r@r@sH $   2  Wi  2OO%      ++??     A!EF==*   sCB3"AAAB3A B0 !A,, B083B++B00B3zDelete Customer Notez!Soft delete a note for a customerzNote deleted successfullyzNote ID to deletecBK tddddd}t||||d{}|S7#t$r&}t|j|j d}~wt $r8}tjd |ttjd d}~wwxYww) a Delete a note for a customer. Soft deletes the specified note (sets deleted_at timestamp). Only the user who created the note or admin users should be able to delete it. **Features:** - Soft delete (preserves data with deleted_at timestamp) - Customer and note existence validation - Returns success confirmation **Parameters:** - **customer_id**: The customer's unique identifier - **note_id**: The note's unique ID to delete **Authorization Required:** Valid JWT token (currently uses placeholder user ID) **Permissions:** Note creator or admin users **Note:** This is a soft delete operation - the note will be marked as deleted but data is preserved in the database. r~r*r+r,r%r-Nrcz*Unexpected error in delete_customer_note: r) r%delete_customer_note_servicerr rXrZrtrrvr rw)rr4r_deleted_by_userrrrzs r\rArAsf $   4  Wo      ++??     A!EF==*   s<B!.,.B. B!A B$3BBB)__doc__typingrrrrrfastapirr r r r r rrrr FastAPIFilesqlalchemy.ormrrusrc.core.databasersrc.core.exceptionsrsrc.apps.auth.utils.authrr*src.apps.customers.schemas.customer_commonrrr,src.apps.customers.schemas.customer_requestsrrrrrrsrc.apps.base.schemas.commonr r!+src.apps.customers.schemas.customer_contactr"r#r$src.apps.users.models.userr%src.apps.customers.servicesr&rr'rgr(rr)get_customer_by_email_servicer*rr+rr,activate_customer_servicer-deactivate_customer_servicer.r/r0rr1rr2rrr3,src.apps.customers.services.address_servicesr4r5r6r7r8,src.apps.customers.services.contact_servicesr9r:r;r<r=3src.apps.customers.services.customer_notes_servicesr>r$r?r0r@r9rAr<rBr69src.apps.customers.services.customer_attachments_servicesrCrDrE"src.apps.notes.schemas.note_commonrFrG$src.apps.notes.schemas.note_requestsrHrI"src.apps.files.schemas.file_commonrJsrc.core.utils.enumsrKsrc.core.functionsrL*src.apps.merchants.schemas.merchant_commonrM"src.apps.users.schemas.user_commonrNrouter getLogger__name__rgetrr]postHTTP_201_CREATEDrboolintrputdeleterrrdictrrrrrrrGALLERYr rrr\rhsP43www"),K S ,$ B**E9    8 $ -Fk][s(@A \,RS#XF V+&3 3 3 W3 lJtCH~[MJ+&E/wBGH$T7nyE F"45juABraB4^hjk    } c]      K : T#s(^;-P+&!$5T^rs    SM   Q 6 T#s(^;-P+&  0     Q ,S#Xk]S+&!!! !T!J 'S#XTZTkTktHsIJ+&  ,    #s(^  J 4 &tCH~MaLbc+&aA+GQRS"s8\fhi"':R\emX#Y %d8xCG!H%*4=_im%n!$4fpz{2 2 2  2  2 3- 2 ~ 2 TN2  SM2  #s(^2 d2 j 3DcNZnYop+&      #s(^  q 4 3DcNZnYop +&         #s(^  q 66tCQTH~]q\rs+&      #s(^  t 4 &tCH~SYSjSjsFrGH+&  4    #s(^  H 4 %d38nL_K`a+&aA+GQRS"s8\fhi %d8xCG!H!$4oyA 3`jst#D6Wajk2 2 2  2  2 ~ 2 SM 2  C=2 sm2  #s(^2 b2 j 24S>YlXmn+&      #s(^  o 4 24S>YlXmn +&    5     #s(^  o 65d3PS8n\o[pq+&      #s(^  r 2 'S#XNcMde+&     f 8 S> ! )L1  C-LM)#;LM (9(9Gef+& SS  SS  S #s(^SS2 S> ! &>7  C-LM+& X X X #s(^ X X*S> ! (B0 C-LM)DE+&QQ Q Q #s(^QQ0S>   JM:"#'#A'(/Z.H.H.212*+2917-@ /" !"&'$%(*$((, '' %! D1 24 5I% -^C-NXijraC5Ycefa-U_`a!$4hr{|+& 6 6 6  6  SM 6  6  #s(^ 6 ]-\6 rS>''   ";F7"#'#>"#+V*D*D*.-.&'.5-3)< + ! % 2E F1 24 59 &PC-NXij)-c?x)y+&; ; &;  ;  #s(^ ; O&N; |$S>   :=5"#'#/"#+V*D*D*.-.&'.5-3)< + ! % 29 :4 57 $LC-NXij)>J+&% % %  %  #s(^ % K$J% P$S>   "8F7"#'#>"#,E*D*D*.-.&'.5-3)< + ! % 2E F9 :4 59 %NC-NXij)   "347"#'#> $ %  9 :4 52C-NXij)