refactor: 문서 사람처럼 작성하기
This commit is contained in:
+3
-3
@@ -22,7 +22,7 @@ source:
|
||||
|
||||
주제 안의 축은 세 테이블로 표현된다. 주제가 축의 이름을 스스로 정하고, 축의 값들이 따로 있고, 어느 기록이 어느 축에 걸리는지를 종류와 아이디의 쌍으로 적는다. 기록이 종류마다 다른 테이블에 살기 때문에 그 쌍에 외래키를 걸지 못한다.
|
||||
|
||||
## 관계
|
||||
## Topic Variant와 Record Variant는 서로 다른 분류 축이다
|
||||
|
||||
- **주제를 넷으로 쪼개지 않고 주제 안에 축을 하나 뒀다**
|
||||
이 구조를 만든 결정이다.
|
||||
@@ -31,7 +31,7 @@ source:
|
||||
- **홈의 비교 구역이 세 번 바뀌었다**
|
||||
이 구조가 화면에서 어떻게 쓰이는지가 그 기록에 있다.
|
||||
|
||||
## 본문
|
||||
## 주제가 축 이름을 정하고 기록은 kind와 id로 연결된다
|
||||
|
||||
<!-- body:start -->
|
||||
|
||||
@@ -73,7 +73,7 @@ topic (주제)
|
||||
|
||||
주제를 지울 때와 반대다. 주제는 그것을 쓰는 기록이 있으면 아예 거절한다.
|
||||
|
||||
> 주제를 지웠다는 이유로 그 주제를 쓰던 문서의 분류가 조용히 사라지면 안 되기 때문이다 — 지우려면 먼저 그 문서들을 옮기라는 뜻이다.
|
||||
> 주제를 지웠다는 이유로 그 주제를 쓰던 문서의 분류가 자동으로 사라지면 안 되기 때문이다 — 지우려면 먼저 그 문서들을 옮기라는 뜻이다.
|
||||
|
||||
주제는 그 기록이 무엇에 관한 것인지를 말하는 분류이고, 축은 같은 주제 안에서 무엇과 견주는지를 말하는 비교 축이다. 분류가 사라지면 기록의 뜻이 바뀌고, 비교 축이 사라지면 비교만 없어진다.
|
||||
|
||||
|
||||
+4
-4
@@ -21,7 +21,7 @@ source:
|
||||
|
||||
「브라우저와 서버 사이 credential 책임을 어디에 둘 것인가」 하나의 질문에 네 구조를 만들어 봤는데, 기록에 붙는 축이 주제와 프로젝트뿐이라 그 넷을 담을 데가 없었다. 주제를 넷으로 쪼개는 대신 주제 안에 축을 하나 뒀다.
|
||||
|
||||
## 근거
|
||||
## 네 패턴은 하나의 인증 주제를 비교하는 축이다
|
||||
|
||||
- **축은 주제가 이름을 정하고, 기록은 종류와 아이디의 쌍으로 축에 걸린다**
|
||||
이 결정을 담은 스키마다.
|
||||
@@ -30,13 +30,13 @@ source:
|
||||
- **축의 결론 문장과 기록 수는 기록을 붙여도 따라오지 않는다**
|
||||
이 결정으로 감수한 비용이 그 질문에 있다.
|
||||
|
||||
## 결정문
|
||||
## 패턴마다 주제를 만들지 않고 한 주제 안에 축을 둔다
|
||||
|
||||
한 질문에 여러 구조를 만들어 비교하는 경우, 주제를 그 수만큼 쪼개지 않고 주제 안에 축을 하나 둔다.
|
||||
|
||||
축의 이름은 주제가 정하고, 기록은 여러 축에 걸릴 수 있으며, 아무 축에도 걸리지 않은 기록은 그 주제의 공통 기록으로 읽는다.
|
||||
|
||||
## 판단 이유
|
||||
## 비교 대상과 프로젝트 맥락을 같은 화면에서 유지한다
|
||||
|
||||
주제를 넷으로 쪼개면 네 구조가 함께 쓰는 기록을 어디에 둘지 애매해진다. PKCE(Proof Key for Code Exchange)와 CSRF(Cross-Site Request Forgery) 방어, Authorization Code 흐름이 그런 기록이다. 어느 한 주제에 넣으면 나머지 셋에서 그 기록에 닿을 수 없고, 넷에 복사하면 같은 글이 넷이 된다.
|
||||
|
||||
@@ -46,7 +46,7 @@ source:
|
||||
|
||||
축 이름을 주제가 정하게 한 것은 주제마다 비교하는 것이 다르기 때문이다. 인증 경계 주제는 credential 을 어디에 두느냐로 갈리고 조회 성능 주제는 같은 데이터를 어떻게 읽느냐로 갈린다.
|
||||
|
||||
## 영향
|
||||
## 축 링크와 기록 연결 규칙을 별도로 관리해야 한다
|
||||
|
||||
축의 이름·요약·결론이 기록에서 자동으로 나오지 않는다. 주제의 논지와 축의 요약·결론은 사람이 쓰는 칸이고, 기록을 스무 개 붙여도 그 문장은 누가 고치기 전까지 그대로다.
|
||||
|
||||
|
||||
+7
-7
@@ -19,7 +19,7 @@ source:
|
||||
|
||||
홈의 비교 구역에서 줄은 문서가 아니라 축이다. 기록을 스무 개 붙여도 줄 수는 늘지 않고, 줄에 보이는 결론 문장은 축에 손으로 쓴 글이라 누가 고치기 전까지 바뀌지 않는다. 주제 화면에는 축마다 기록 수가 붙는데 홈에는 없다.
|
||||
|
||||
## 관계
|
||||
## 축의 결론 문장과 기록 수는 서로 다른 값으로 저장된다
|
||||
|
||||
- **주제를 넷으로 쪼개지 않고 주제 안에 축을 하나 뒀다**
|
||||
이 결정으로 감수한 비용이 이 질문이다.
|
||||
@@ -28,7 +28,7 @@ source:
|
||||
- **프록시 지표가 아니라 보이는 것을 측정한다**
|
||||
화면에서 무엇이 달라지는지 확인하는 방법이 그 기준에 있다.
|
||||
|
||||
## 사실
|
||||
## 기록을 추가해도 결론 문장과 개수는 자동으로 갱신되지 않는다
|
||||
|
||||
홈의 비교 구역에서 한 줄은 축 하나다. 기록을 스무 개 붙여도 줄 수는 그대로다.
|
||||
|
||||
@@ -42,13 +42,13 @@ source:
|
||||
|
||||
주제의 논지와 축의 결론은 2026-09-01 에 AI 가 써서 DB 에 직접 넣은 초안이다. 사용자 검토 대상이고 아직 검토되지 않았다.
|
||||
|
||||
## 가정
|
||||
## 일부 값은 실제 기록에서 파생할 수 있다
|
||||
|
||||
결론을 사람이 쓰게 한 것이 의도라고 보고 있다. 요약은 「무엇인가」이고 결론은 「무엇을 알게 됐나」라서 기록의 요약 첫 줄을 잘라 쓰면 안 된다고 판단했는데, 그 판단이 지금도 맞는지 다시 보지 않았다.
|
||||
|
||||
기록 수는 유도할 수 있다고 보고 있다. 주제 화면이 이미 그 수를 그리므로 같은 값을 홈에 붙이면 된다고 짐작하지만, 홈의 목록 호출이 그 수를 싣는지 확인하지 않았다.
|
||||
|
||||
## 미지수
|
||||
## 작성자 문장과 파생 값의 경계를 어디에 둘 것인가
|
||||
|
||||
홈에 기록 수를 붙이면 축에 기록을 더했을 때 화면이 달라지는가. 달라진다면 결론 문장이 낡았다는 것도 같은 화면에서 드러나는가.
|
||||
|
||||
@@ -56,13 +56,13 @@ source:
|
||||
|
||||
DB 에 직접 넣은 초안을 누가 언제 검토하는가. 검토 전까지 그 문장을 공개 화면에 그대로 둘지.
|
||||
|
||||
## 제약
|
||||
## 수동 입력과 자동 집계를 함께 두면 불일치가 생긴다
|
||||
|
||||
축의 요약과 결론은 기록을 합쳐 자동으로 만들지 않는다. 결론은 비교표가 읽는 칸이라 기록의 요약 첫 줄을 잘라 쓰면 안 된다.
|
||||
|
||||
홈이 처음 보내는 요청은 목록 하나와 주제 하나로 고정한다. 기록 수를 붙이려고 주제마다 상세를 미리 받지 않는다.
|
||||
|
||||
## 선택지
|
||||
## 결론을 직접 쓰게 둘지 일부를 파생할지
|
||||
|
||||
**홈 비교표에 기록 수를 붙인다**
|
||||
목록 호출이 이미 그 수를 실을 수 있으면 요청이 늘지 않는다. 결론 문장은 그대로 사람이 쓴다. 기록이 늘면 수가 바뀌므로 결론만 낡은 상태가 화면에 드러난다.
|
||||
@@ -73,7 +73,7 @@ DB 에 직접 넣은 초안을 누가 언제 검토하는가. 검토 전까지
|
||||
**결론을 쓰지 않은 축은 결론 줄을 비운다**
|
||||
쓰지 않은 것과 낡은 것을 구분한다. 지금은 초안이 들어 있어 둘이 같아 보인다.
|
||||
|
||||
## 다음 검증
|
||||
## 기록 추가와 삭제 뒤 축 화면을 다시 확인한다
|
||||
|
||||
1. 홈의 목록 호출 응답에 축별 기록 수가 실려 있는지 확인하고, 없으면 싣는 비용을 잰다
|
||||
2. 축 하나에 기록을 더하고 홈에서 무엇이 달라지고 무엇이 그대로인지 화면으로 가른다
|
||||
|
||||
Reference in New Issue
Block a user