# File Storage Hierarchy

## one-account-backend
- bucket: `one-account`

| Type | File Path |
| ---------- | --------- |
| Card Image | `identity-card/{image_id}` |
| Anti-Spoofing Image | `anti-spoofing/{image_id}` |
| Passbook Image | `passbook/{image_id}` |
| Reference Document | `reference-document/{customer_id}/{reference_document_code}` |
| Signed Document | `signed-document/{customer_id}/{general_agreement_code}` |
| Unsigned Document | |

---
==reference_document_code==
- `GENERAL_AGREEMENT_FOR_DERIVATIVES_TRANSACTIONS`
- `AMLRA`
- `FAMILY_PROCEEDING_ANNOUNCEMENT`
- `IDCARD_VERIFYING`
- `TWSE_CREDIT_INVESTIGATION`
- `PERSONAL_DATA_COLLECTION_AGREEMENT`

==general_agreement_code==
- `ONE_ACCOUNT_GENERAL_AGREEMENT_V1`

---
## PGN Trading
- bucket: `pgn-trading`
- object_name: `transaction-document/{transaction_document_code}/{transaction_id}`

| Type | File Path |Description|
|:------------------------------------- |:-------------------------------------------------------------------------- |:-|
| Voluntary Subscription Agreement | `transaction-document/VOLUNTARY_SUBSCRIPTION_AGREEMENT/{transaction_id}` |主動申購說明書|
| Subscription Qualification Evaluation | `transaction-document/SUBSCRIPTION_QUALIFICATION_EVALUATION/{transaction_id}` |交易適當性評估|
|Branch Manager Approval|`transaction-document/BRANCH_MANAGER_APPROVAL/{branch_manager_approval}`|分公司經理簽核|
| Product Manual | `transaction-document/PRODUCT_MANUAL/{transaction_id}` |產品說明書|
| Returning Funds Instruction | `transaction-document/RETURNING_FUNDS_INSTRUCTION/{transaction_id}` |到期款項指示書|
| Risk Disclosure | `transaction-document/RISK_DISCLOSURE/{transaction_id}` |風險宣告|
| ~~(X)KYC~~ | `transaction-document/KYC/{transaction_id}` |(無文件)KYC|
| AML | `transaction-document/AML/{transaction_id}` |AML|
| ~~(X)Deposit~~ | `transaction-document/DEPOSIT/{transaction_id}` |(暫時不考慮)入金|

### TBD
- [x] Should we include file's time info in file name/path? Or just save time info in related database(one-account-backend: `insert_customer_reference_document()`, but we use NoSQL in this proejct)
- there's almost no use case needed to query document by datetime, so we don't include datetime info in file path