Day 6 Summary Codex AI Architect Technical Design

Day 6. Technical design (data normalization) training summary

Convert meeting minutes written in natural language into data structures (Mermaid ERD), build a standard project terminology dictionary, and master key information for the entire collaborative design pipeline preserving decision-making and impact analysis of design changes.

Part 1. Introduction background
Part 2. Practice objectives
Part 3. Follow along
Part 4. How it works
Part 5. Training Guide
Part 6. Final Task

Bottleneck in technical design

Errors in understanding between planning, design, and development at the project site directly lead to database omission and loss of consistency. Find out why ensuring consistency at the design stage is important.

understanding error

When looking at the same service screen plan, the data model and relationship settings that planners, designers, and developers associate with each other are misaligned, ultimately leading to omissions or data inconsistencies (runtime errors).

vocabulary error

When naming variables using different names for the same entity, such as 'Member, Customer, User, Member', unnecessary translation and communication rework costs are greatly incurred.

shared error

By modifying the DB schema and not updating the API or screen plan in line with the rapidly increasing service policy, system inconsistencies snowball and cause system paralysis.

ChatGPT vs Codex Client (Workspace-based)

Unlike ChatGPT, which is limited to a single conversation context, we compare the characteristics of Codex Client, which recognizes the entire folder structure and dependency relationships between multiple files.

Compare items ChatGPT (General Conversational AI) Codex Client (Workspace-based AI)
Context awareness Only locally understand the contents of a single file/text pasted by the user Intelligently recognizes multiple dependencies of DDL schema, plan, and API specifications within a folder at the same time
Terminology standardization Remaining at the level of a one-off English work, it is impossible to maintain consistency in variable names throughout the entire project. Self-recommendation of consistent standard naming and DB column names based on project standard terminology dictionary
Scope of Impact Analysis Level of suggestions for fragmentary schema errors or hypothetical table modifications Reverse inference on list of API specifications and screen modification areas according to subtle changes in schema (e.g. column addition)

Summary of final results to be created today

A list of the final products the learner produces during the Day 6 session and the purpose of those products.

Task 01. Data structuring

Entities and relationships are extracted and rendered from the natural language plan. Mermaid ERD scripts and statements (Output: erd-schema.md)

Task 02. Terminology standardization

Fragmented Korean/English planning terms defined in standard English column format Project Standards Glossary (Output: project-glossary.md)

Task 03. Share the impact of change

API and screen modification list according to addition of reservation approval system (WAIT_APPROVE) Change impact analysis report (Output: change-impact-report.md)

Mission 01. Design record

Archives the reasons for normalization and data design decisions and rejected alternatives. Design Decision Log (DDL) (Output: design-decision-log.md)

Mission 02. Discover exception scenarios

Contains DB improvement measures for concurrent payment errors, referential integrity loss of withdrawal, and transaction rollback. Edge Case Analysis Report (Output: edge-case-analysis.md)

Input / Output data pipeline

This is a mapping between the input values used in the practice stage and the results generated through Codex Workspace inference.

01
data structure
02
Terminology standardization
03
Impact of change
M1
decision making
M2
Exception scenario
Task 01. Resolving gaps in understanding data structure
πŸ“₯ Input (planning meeting minutes)
β€’ day6_meeting_notes.md (meeting minutes) - User flow scenario and reservation process content in the form of irregular lines
Codex Workspace βž”
πŸ’Ύ Output (ERD specification)
erd-schema.md with Mermaid ERD code - Visualization of Primary Key/Foreign Key relationships of User, Expert, Reservation, and Payment entities

STEP 1. Task 01 - Resolving gaps in understanding data structure

Enter meeting scenario lines to derive precise normalization relationships (1:N, 1:1) and Mermaid codes.

πŸ” Codex request prompt (data structuring)

Please analyze the provided meeting minutes from a data structure perspective to derive key entities and relationships, and write a data structure definition and Mermaid ERD code.
  • Check whether the PK and FK settings of the four major entities, User, Expert, Reservation, and Payment, do not conflict with the scenario logic.
  • When rendering a Mermaid diagram (`erDiagram`), check that the cardinality notation is correct.

STEP 2. Task 02 - Terminology standardization

We build a master dictionary of domain terms by comparing and analyzing the gap between Figma planning terms and DB development specifications.

πŸ” Codex request prompt (generating a glossary of terms)

Please analyze terms such as 'Member/User/Customer/Member' and 'Counselor/Expert/Teacher/Counselor' that are used interchangeably throughout the project and create a dictionary of standard project terms in the form of a Markdown table.
  • Check whether the English standard naming and column type information that matches the business domain are presented correctly.

STEP 3. Task 03 - Share the impact of change

Understand the scope of API and table impact when a release plan change adds an 'Approval' step to the scheduling process.

πŸ” Codex request prompt (understand scope of influence)

Please fill out the API specifications, DB schema, screens, and change sharing reports that are affected as the reservation confirmation process has been changed to 'Awaiting Approval' status and 'Payment after expert approval'.
  • Check whether status changes in the Reservations table, new API specifications, and button state transition chain effects on the planning screen have been detected.

STEP 4. Mission 01 - Design Decision Log

Log rejection reasons and agreements regarding normalization decisions, physical separation decisions for reservation history, etc.

πŸ” Codex request prompt (decision record)

Please extract normalization and database structure design decisions from the meeting and create a Design Decision Log that includes decision items, background reasons, alternatives reviewed, approvers, and possible future changes.
  • Check whether the background of the decision to separate history tables (DEC-003) and the alternatives (performance degradation when unifying tables) are clearly logged.

STEP 5. Mission 02 - Discover exception scenarios (Edge Case)

We audit system vulnerabilities to prevent referential integrity violations (withdrawals) and transaction collapses.

πŸ” Codex request prompt (Edge case derivation)

Please derive edge case exception scenarios for data consistency violations that may occur in the currently defined User, Expert, Reservation, and Payment table structures and suggest improvement measures.
  • Check the plan to maintain reference consistency and distributed transaction rollback response by introducing soft delete (logical deletion).

How it works and its core mechanisms

Schema context-aware reasoning

Beyond simple text matching, it identifies the referential integrity (FK) relationships and transaction life cycle of entities and automatically deduces natural language proposals into Data Definition Language (DDL) queries and state machine rules.

Meta term clustering

We derive a master dictionary of enterprise terms by semantically clustering differently written terms (customer name vs. nickname), and synchronize the consistency of the data dictionary based on this.

Technical design synergy of five Tasks/Missions

We check how the data and analysis information derived from each step goes through the technical design loop to maximize quality.

[Data Modeling Agreement] (Task 01. Structuring)
β–Ό
[Unification of domain terms] (Task 02. Standard dictionary)
β–Ό
[Design change impact tracking] (Task 03. Change control)
β–Ό
[Architecture Decision Logging] (Mission 01. Why Preservation)
β–Ό
[Consistency and edge case exception prevention] (Mission 02. Safety design)

This five-step collaboration loop blocks exceptions from the planning and design stage, providing an absolute advantage in gaining productivity and eliminating human errors for developers who begin actual coding work.

πŸ’‘ Educational design specifications

  • Difficulty level: β˜…β˜…β˜…β˜…β˜† (Advanced - includes database design normalization and distributed transaction concepts)
  • Estimated lab time: 1 hour 30 minutes ~ 2 hours (comprehensive design practice)
  • Practical usability: β˜…β˜…β˜…β˜…β˜…

Learner questions/discussion topics

This is a list of topics that are great for discussion during training or to use as interview questions.

Q1. Membership Withdrawal Strategy

β€œWhat are the performance shortcomings of selecting Soft Delete (logical deletion) instead of Hard Delete when processing membership withdrawal, and what is the index/DB partitioning strategy that can compensate for this?”

Q2. Terminology Debt

β€œWhen a project progresses to the halfway point without creating a terminology standardization dictionary, how does the β€˜terminology debt’ cost incurred within the development team affect the actual schedule?”

Planning and design stage final training task

This is a diagram of the overall practice tasks and missions covered on Day 6.

Task topic How to use AI
Task 01 Addressing gaps in understanding data structures Convert meeting content into data structures and organize entities and relationships
Task 02 Terminology standardization Create a standard terminology dictionary by analyzing terms throughout the project
Task 03 Share the impact of change Analyze the impact of design changes and track related documents and functions
Mission 01 Design decision history Create a decision log to manage design basis and change history
Mission 02 Excavating Exception Scenarios Analyze missing edge cases and derive risk factors and improvement plans
← Day 6 Classroom entrance View full roadmap