init

Author: hamtolchu

.editorconfig

@@ -0,0 +1,6 @@
+root = true
+
+[*]
+charset = utf-8
+indent_size = 2
+indent_style = space

.gitignore

@@ -0,0 +1 @@
+node_modules

.idea/.gitignore

@@ -0,0 +1 @@
+14.16.1

.idea/modules.xml

@@ -0,0 +1,37 @@
+
+# 배경
+Scheme 과 데이터가 N : N 관계에 있을때,
+이를 검증하는 2가지 방법에 대한 예시 프로그램을 만들어봅니다.
+
+# 환경 구성
+```
+# node 14.16.1
+nvm use
+
+npm ci
+
+# Schema 파일을 특정할 수 있는 검증 방법
+npm run single
+
+# Schema 파일을 특정할 수 없는 검증 방법
+npm run bulk
+```
+
+# 정리
+- bulk : 모든 Schema 들을 병합하여 특정 data.json 이 valid 한지 여부만 판단할 수 있습니다.
+  - 장점
+    - 개별적으로 비교하지 않아도 되어 처리 시간이 단축될 수 있다.
+    - 매핑 파일이 필요하지 않다.
+  - 단점: 개별 Schema 들이 복잡하게 구성되어있다면 `mergeSchemes` 함수가 훨씬 복잡하게 구현되어야 한다.
+  
+- single: 특정 data.json 을 기준으로 일치하는 Schema 를 찾습니다.
+  - 장점: 매핑 파일이 필요하지 않다.
+  - 단점: 일치하지 않는 Schema 도 모두 validate 함수 호출
+
+---
+
+Data, Schema 모두에 ID 를 넣게 되었을때
+- 장점: data.json 만 보고 이 데이터가 어떤 Schema 를 따라야 하는지 알 수 있다.
+- 단점: data.json 의 id 와 schema.json 의 $id 를 기준으로 할것인지 아니면 다른 기준으로 할 것인지... 모호하다.
+
+

.idea/schema-sample.iml

@@ -0,0 +1,81 @@
+import { resolve } from 'path'
+import { readdir } from 'fs/promises'
+import Ajv from 'ajv'
+import addFormats from 'ajv-formats'
+import { pipe, each } from '@fxts/core'
+import type { JSONSchema7 } from 'json-schema'
+
+type KurlySchema = JSONSchema7 &
+  Required<Pick<JSONSchema7, "$id" | "oneOf" | "definitions">>;
+
+async function mergeSchemes(): Promise<KurlySchema> {
+  const mergedSchema: KurlySchema = {
+    $id: 'kurly',
+    $schema: "http://json-schema.org/draft-07/schema#",
+    definitions: {},
+    oneOf: []
+  }
+  const schemaDir = resolve(__dirname, './schema')
+  const schemaFileNames = await readdir(schemaDir)
+  pipe(
+    schemaFileNames,
+    each(fileName => {
+      const schema = require(`${schemaDir}/${fileName}`)
+      const schemaId = schema.$id
+      mergedSchema.definitions = {
+        ...mergedSchema.definitions,
+        ...schema.definitions,
+        [schemaId]: schema,
+      }
+      mergedSchema.oneOf.push({ $ref: `#/definitions/${schemaId}` })
+    })
+  )
+  return mergedSchema
+}
+
+async function run() {
+  const ajv = new Ajv({ strict: true })
+  addFormats(ajv)
+
+  /*
+    NOTE: 이 함수가 중요하옵니다.
+    schema Dir 의 모든 schema 들 하나로 합칩니다.
+   */
+  const mergedSchema = await mergeSchemes();
+
+  const validate = ajv.compile(mergedSchema)
+
+  // NOTE: 아래는 예시 폴더 안의 파일들을 검사합니다.
+  const exampleDir = resolve(__dirname, './examples')
+  const exampleFileNames = await readdir(exampleDir)
+
+  pipe(
+    exampleFileNames,
+    each(fileName => {
+      const isValid = validate(require(`${exampleDir}/${fileName}`))
+      console.group()
+      console.log(`${fileName} : is ${isValid ? 'Valid' : 'In-Valid'}`)
+      /* NOTE: Detail Logging
+      if (!isValid && validate.errors) {
+        pipe(
+          validate.errors,
+          each(error => {
+            const { message } = error
+            console.warn(`${fileName} : ${message}`)
+          })
+        )
+      }
+      */
+      console.groupEnd()
+    })
+  )
+}
+
+run()
+
+/*
+  NOTE:
+    잘 되는 것 처럼 보입니다만 하나의 문제가 있습니다.
+    validate 함수는 boolean 만 return 하기 때문에 검증된 파일이 어떤 Schema 인지 모릅니다.
+    (single 파일에서 처럼 개별벅으로 검사하지 않는 이상 가져올 수 있는 방법이 없는것 같아용ㅠ)
+ */

.idea/vcs.xml

@@ -0,0 +1,45 @@
+{
+  "regionCode": [
+    "A",
+    "R",
+    "C",
+    "X",
+    "F",
+    "M",
+    "I",
+    "Y",
+    "H",
+    "D",
+    "B",
+    "S",
+    "T",
+    "G",
+    "Z",
+    "W"
+  ],
+  "ALL": {
+    "startDate": "2022-09-09T23:00:00+09:00",
+    "endDate": "2022-09-10T22:59:59+09:00",
+    "description": "오늘 주문하고 <span class='emph'>월요일(9/12) 아침</span> 샛별배송 받으세요."
+  },
+  "AA": {
+    "startDate": "2022-09-09T23:00:00+09:00",
+    "endDate": "2022-09-10T22:59:59+09:00",
+    "description": "오늘 주문하고 <span class='emph'>월요일(9/12) 아침</span> 샛별배송 받으세요."
+  },
+  "AB": {
+    "startDate": "2022-09-09T23:00:00+09:00",
+    "endDate": "2022-09-10T19:59:59+09:00",
+    "description": "오늘 주문하고 <span class='emph'>월요일(9/12) 아침</span> 샛별배송 받으세요."
+  },
+  "BS": {
+    "startDate": "2022-09-09T23:00:00+09:00",
+    "endDate": "2022-09-10T17:59:59+09:00",
+    "description": "오늘 주문하고 <span class='emph'>월요일(9/12) 아침</span> 샛별배송 받으세요."
+  },
+  "UL": {
+    "startDate": "2022-09-09T23:00:00+09:00",
+    "endDate": "2022-09-10T17:59:59+09:00",
+    "description": "오늘 주문하고 <span class='emph'>월요일(9/12) 아침</span> 샛별배송 받으세요."
+  }
+}

.nvmrc

@@ -0,0 +1,5 @@
+{
+  "id": "other",
+  "foo": "foo",
+  "bar": "bar"
+}

README.md

@@ -0,0 +1,4 @@
+{
+  "foo": "no-foo",
+  "bar": "no-bar"
+}

bulk.ts

@@ -0,0 +1,4 @@
+{
+  "foo": "foo",
+  "bar": "bar"
+}