---
# System prepended metadata

title: File Storage Hierarchy

---

# 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