본문으로 건너뛰기

Ruby on Rails로 명리학 데이터베이스 시스템 구축하기 - 1

한바둑

2025.11.17

소개



시도하고자 했던 것

명리학(한국 전통 사주) 데이터 310건을 체계적으로 관리하고,

향후 110만 건 이상으로 확장 가능한 전문적인 데이터베이스 시스템을 구축하고자 했습니다.

그 이유

기존에는 HTML/JavaScript + localStorage 기반의 프로토타입으로 작업하면서

여러 버전(v10, v17, ULTIMATE 등)을 반복적으로 만들었습니다.

이는 전형적인 "Vibe Coding" 패턴으로,

구조적 설계 없이 감각에 의존한 개발이었습니다.

문제점:

버전 관리 혼란 (여러 ULTIMATE, MEGA 버전 난립)

데이터 무결성 보장 어려움

확장성 부족 (localStorage 한계)

코드 재사용성 낮음

해결 방안:

구조화된 개발 방법론 도입

Ruby on Rails 프레임워크 사용

PostgreSQL 정규화 데이터베이스 설계

체계적인 모델-뷰-컨트롤러(MVC) 패턴 적용



진행 방법



3.1 Ruby on Rails 환경 구축

사용 도구

Ruby 3.4.7 : Windows 네이티브 설치

Rails 8.1.1 : 최신 안정 버전

PostgreSQL 18 : 엔터프라이즈급 데이터베이스

PowerShell : Windows 명령어 환경

프로젝트 생성

```bash

# Rails 프로젝트 생성 (PostgreSQL 사용)

rails new backend-rails -d postgresql

# 데이터베이스 설정

cd backend-rails

default: &default
  adapter: postgresql
  encoding: unicode
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>

development:
  <<: *default
  database: backend_rails_development
  username: postgres
  password: your_password
  host: localhost
  port: 5432

test:
  <<: *default
  database: backend_rails_test  username: postgres
  password: your_password
  host: 127.0.0.1
  port: 5432

production:
  primary: &primary_production
    <<: *default
    database: backend_rails_production
    username: backend_rails
    password: <%= ENV["BACKEND_RAILS_DATABASE_PASSWORD"] %>

# config/database.yml 수정

```

database.yml 설정

default: &default
  adapter: postgresql
  encoding: unicode
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>

development:
  <<: *default
  database: backend_rails_development
  username: postgres
  password: your_password
  host: localhost
  port: 5432

test:
  <<: *default
  database: backend_rails_test
  username: postgres
  password: your_password
  host: 127.0.0.1
  port: 5432

production:
  primary: &primary_production
    <<: *default
    database: backend_rails_production
    username: backend_rails
    password: <%= ENV["BACKEND_RAILS_DATABASE_PASSWORD"] %>

---

3.2 정규화된 데이터베이스 설계

테이블 구조 (8개 테이블)

기존 방식: 185개 필드를 가진 평면 구조

새로운 방식: 정규화된 관계형 구조

profiles - 사주 기본 정보 (310건)

wonkuks - 원국 해석 (310건)

daeuns - 대운 정보 (312건)

daeun_groups - 대운 그룹

sewuns - 세운 정보

jeolgis - 24절기 데이터 (향후 2,568건)

ilju_masters - 60갑자 마스터 (향후 60건)

ilju_educations - 일주 교육 콘텐츠 (향후 60건)

마이그레이션 파일 생성

```bash

rails generate migration CreateHanbadookTables

```

마이그레이션 코드

class CreateHanbadookTables < ActiveRecord::Migration[8.0]
  def change
    # 1. 프로필 테이블 (기본 사주 정보)
    create_table :profiles do |t|
      t.string :name, null: false
      t.integer :birth_year, null: false
      t.integer :birth_month, null: false
      t.integer :birth_day, null: false
      t.integer :birth_hour
      t.integer :birth_minute
      t.boolean :is_lunar, default: false
      t.string :gender
      t.date :solar_date
      t.string :cheongan_year
      t.string :jiji_year
      t.string :cheongan_month
      t.string :jiji_month
      t.string :cheongan_day
      t.string :jiji_day
      t.string :cheongan_hour
      t.string :jiji_hour
      t.text :notes
      
      t.timestamps
    end

    # 2. 원국 테이블 (사주 해석)
    create_table :wonkuks do |t|
      t.references :profile, null: false, foreign_key: true
      t.text :general_interpretation
      t.text :personality
      t.text :career
      t.text :wealth
      t.text :health
      t.text :relationship
      
      t.timestamps
    end

    # 3. 대운 테이블
    create_table :daeuns do |t|
      t.references :profile, null: false, foreign_key: true
      t.integer :sequence_number
      t.integer :start_age
      t.integer :end_age
      t.string :cheongan
      t.string :jiji
      t.text :interpretation
      
      t.timestamps
    end

    # 4. 대운 그룹 테이블
    create_table :daeun_groups do |t|
      t.references :daeun, null: false, foreign_key: true
      t.string :group_name
      t.text :group_interpretation
      
      t.timestamps
    end

    # 5. 세운 테이블
    create_table :sewuns do |t|
      t.references :profile, null: false, foreign_key: true
      t.integer :year
      t.string :cheongan
      t.string :jiji
      t.text :interpretation
      
      t.timestamps
    end

    # 6. 절기 데이터 테이블 (1920-2026, 107년)
    create_table :jeolgis do |t|
      t.integer :year, null: false
      t.integer :month, null: false
      t.string :jeolgi_name, null: false
      t.datetime :jeolgi_time, null: false
      t.integer :day
      t.integer :hour
      t.integer :minute
      
      t.timestamps
    end

    # 7. 일주 마스터 테이블 (60 갑자)
    create_table :ilju_masters do |t|
      t.string :gapja_code, null: false
      t.string :cheongan, null: false
      t.string :jiji, null: false
      t.integer :sequence_number, null: false
      t.string :element_heaven
      t.string :element_earth
      t.string :yinyang_heaven
      t.string :yinyang_earth
      
      t.timestamps
    end

    # 8. 일주 교육 콘텐츠 테이블
    create_table :ilju_educations do |t|
      t.references :ilju_master, null: false, foreign_key: true
      t.text :personality
      t.text :career
      t.text :wealth
      t.text :health
      t.text :relationship
      t.text :advice
      t.text :famous_people
      t.integer :quality_score
      
      t.timestamps
    end

    # 인덱스 추가
    add_index :profiles, [:birth_year, :birth_month, :birth_day]
    add_index :jeolgis, [:year, :month]
    add_index :ilju_masters, :gapja_code, unique: true
  end
end

```ruby

class CreateHanbadookTables < ActiveRecord::Migration[8.0]

def change

# 1. 프로필 테이블 (기본 사주 정보)

create_table :profiles do |t|

t.string :name, null: false

t.integer :birth_year, null: false

t.integer :birth_month, null: false

t.integer :birth_day, null: false

t.integer :birth_hour

t.integer :birth_minute

t.boolean :is_lunar, default: false

t.string :gender

t.date :solar_date

t.string :cheongan_year

t.string :jiji_year

t.string :cheongan_month

t.string :jiji_month

t.string :cheongan_day

t.string :jiji_day

t.string :cheongan_hour

t.string :jiji_hour

t.text :notes

t.timestamps

end

# 2. 원국 테이블 (사주 해석)

create_table :wonkuks do |t|

t.references :profile, null: false, foreign_key: true

t.text :general_interpretation

t.text :personality

t.text :career

t.text :wealth

t.text :health

t.text :relationship

t.timestamps

end

# 3. 대운 테이블

create_table :daeuns do |t|

t.references :profile, null: false, foreign_key: true

t.integer :sequence_number

t.integer :start_age

t.integer :end_age

t.string :cheongan

t.string :jiji

t.text :interpretation

t.timestamps

end

# ... (나머지 테이블들)

# 인덱스 추가

add_index :profiles, [:birth_year, :birth_month, :birth_day]

add_index :jeolgis, [:year, :month]

add_index :ilju_masters, :gapja_code, unique: true

end

end

```

마이그레이션 실행

```bash

rails db:create

rails db:migrate

```

결과:

== 20251117092219 CreateHanbadookTables: migrating ============================
-- create_table(:profiles)
   -> 0.0057s
-- create_table(:wonkuks)
   -> 0.0048s
-- create_table(:daeuns)
   -> 0.0041s
-- create_table(:daeun_groups)
   -> 0.0037s
-- create_table(:sewuns)
   -> 0.0046s
-- create_table(:jeolgis)
   -> 0.0024s
-- create_table(:ilju_masters)
   -> 0.0023s
-- create_table(:ilju_educations)
   -> 0.0043s
-- add_index(:profiles, [:birth_year, :birth_month, :birth_day])
   -> 0.0012s
-- add_index(:jeolgis, [:year, :month])
   -> 0.0011s
-- add_index(:ilju_masters, :gapja_code, {unique: true})
   -> 0.0010s
== 20251117092219 CreateHanbadookTables: migrated (0.0368s) ===================
/==================

-- create_table(:profiles)

-> 0.0057s

-- create_table(:wonkuks)

-> 0.0048s

[...]

== 20251117092219 CreateHanbadookTables: migrated (0.0368s) ===================

```

---

3.3 Rails 모델 및 관계 설정

모델 생성

```bash

rails generate model Profile --skip-migration

rails generate model Wonkuk --skip-migration

rails generate model Daeun --skip-migration

rails generate model DaeunGroup --skip-migration

rails generate model Sewun --skip-migration

rails generate model Jeolgi --skip-migration

rails generate model IljuMaster --skip-migration

rails generate model IljuEducation --skip-migration

```

Profile 모델 (예시)

```ruby

class Profile < ApplicationRecord

# 관계 설정

has_one :wonkuk, dependent: :destroy

has_many :daeuns, dependent: :destroy

has_many :sewuns, dependent: :destroy

# 유효성 검증

validates :name, presence: true

validates :birth_year, presence: true, numericality: { only_integer: true }

validates :birth_month, presence: true, numericality: {

only_integer: true,

greater_than_or_equal_to: 1,

less_than_or_equal_to: 12

}

validates :birth_day, presence: true, numericality: {

only_integer: true,

greater_than_or_equal_to: 1,

less_than_or_equal_to: 31

}

end

```

Wonkuk 모델

```ruby

class Wonkuk < ApplicationRecord

# 관계 설정

belongs_to :profile

# 유효성 검증

validates :profile_id, presence: true

end

```

Daeun 모델

```ruby

class Daeun < ApplicationRecord

# 관계 설정

belongs_to :profile

has_many :daeun_groups, dependent: :destroy

# 유효성 검증

validates :profile_id, presence: true

validates :sequence_number, numericality: {

only_integer: true,

greater_than: 0

}, allow_nil: true

end

```

---

3.4 데이터 임포트 스크립트

기존 JSON 데이터 구조

파일명: myeongli_185fields_v6_310건_변환.json

크기: 6.6MB

구조: 185개 필드의 평면(flat) 구조

레코드 수: 310건

db/seeds.rb 작성

require 'json'

# JSON 파일 읽기
file_path = Rails.root.join('db', 'myeongli_data.json')
json_data = JSON.parse(File.read(file_path))

puts "총 #{json_data.length}건의 데이터를 임포트합니다..."

# 기존 데이터 삭제 (선택사항)
puts "기존 데이터를 삭제합니다..."
Profile.destroy_all

success_count = 0
error_count = 0

json_data.each_with_index do |record, index|
  begin
    # 1. Profile 생성
    profile = Profile.create!(
      name: "사주#{index + 1}",
      birth_year: record['birth_year'].to_i,
      birth_month: record['birth_month'].to_i,
      birth_day: record['birth_day'].to_i,
      is_lunar: record['calendar_type'] == '음력',
      gender: record['gender'],
      notes: record['myeongsik']
    )
    
    # 2. Wonkuk 생성
    if profile
      Wonkuk.create!(
        profile: profile,
        general_interpretation: record['wonkuk_seongpum'],
        personality: record['wonkuk_seongpum'],
        career: record['wonkuk_jinro'],
        wealth: record['wonkuk_jaemul'],
        relationship: [
          record['wonkuk_bumo'],
          record['wonkuk_baeuja'],
          record['wonkuk_jasik']
        ].compact.join("\n\n")
      )
    end
    
    # 3. Daeun 생성 (최대 10개까지 확인)
    (1..10).each do |i|
      period_start = record["daeun#{i}_period_start"]
      period_end = record["daeun#{i}_period_end"]
      daeun_name = record["daeun#{i}_name"]
      
      break if period_start.nil? || period_start.empty?
      
      Daeun.create!(
        profile: profile,
        sequence_number: i,
        start_age: period_start.to_i,
        end_age: period_end.to_i,
        cheongan: daeun_name.to_s.chars.first,
        jiji: daeun_name.to_s.chars.last,
        interpretation: [
          record["daeun#{i}_summary"],
          "재물: #{record["daeun#{i}_jaemul"]}",
          "건강: #{record["daeun#{i}_health"]}",
          "환경: #{record["daeun#{i}_environment"]}",
          "개인: #{record["daeun#{i}_personal"]}"
        ].compact.join("\n\n")
      )
    end
    
    success_count += 1
    puts "#{index + 1}/#{json_data.length} 완료: #{profile.name}"
    
  rescue => e
    error_count += 1
    puts "오류 발생 (레코드 #{index + 1}): #{e.message}"
  end
end

puts "\n임포트 완료!"
puts "성공: #{success_count}건"
puts "실패: #{error_count}건"
puts "\n통계:"
puts "- Profile: #{Profile.count}건"
puts "- Wonkuk: #{Wonkuk.count}건"
puts "- Daeun: #{Daeun.count}건"

`

임포트 완료!

성공: 310건

실패: 0건

통계:

- Profile: 310건

- Wonkuk: 310건

- Daeun: 312건

```

---

3.5 데이터 검증

Rails 콘솔에서 확인

```bash

rails console

```

```ruby

# 레코드 수 확인

Profile.count

=> 310

# 첫 번째 프로필 조회

profile = Profile.first

=> #<Profile id: 1, name: "사주1", birth_year: 1990, ...>

# 관계 확인

profile.name

=> "사주1"

profile.birth_year

=> 1990

# 원국 해석 확인

profile.wonkuk.personality[0..200]

=> "호기심이 많은 성품으로 궁금한 것이 있으면 찾아내고 탐구하는 모습이 많습니다..."

# 대운 개수 확인

profile.daeuns.count

=> 1

# 대운 해석 확인

profile.daeuns.first.interpretation[0..200]

=> "이 대운은 노력한 것에 비해 더 좋은 성과와 결실을 거둘 수 있는 시기입니다..."

```



결과와 배운 점



최종 결과

구축 완료

✅ Ruby on Rails 프로젝트 생성

✅ PostgreSQL 데이터베이스 8개 테이블 설계

✅ Rails 모델 8개 생성 및 관계 설정

✅ 310건 데이터 100% 성공 임포트 (실패 0건)

✅ 데이터 무결성 검증 완료

데이터 통계

Profile: 310건

Wonkuk: 310건

Daeun: 312건 (일부 프로필에 복수 대운)

총 처리 시간: 약 2분

---

배운 점

1. "Vibe Coding"의 한계 인식

Before (Vibe Coding):

감각적으로 코드 작성

버전 난립 (v10, v17, ULTIMATE, MEGA)

구조 없이 기능 추가

디버깅 어려움

After (구조화된 개발):

설계 우선 접근 (Database Schema → Models → Logic)

단일 프로젝트 버전 관리

MVC 패턴 준수

명확한 데이터 흐름

2. 정규화의 중요성

평면 구조 (185필드)의 문제:

데이터 중복

확장성 부족

복잡한 쿼리

정규화 구조의 장점:

데이터 무결성 보장

유연한 확장 (대운 개수 제한 없음)

효율적인 쿼리

관계형 데이터베이스의 강점 활용

3. Rails의 Convention over Configuration

Rails의 규칙을 따르니:

보일러플레이트 코드 최소화

명확한 프로젝트 구조

빠른 개발 속도

커뮤니티 모범 사례 활용

---

시행착오

1. database.yml 들여쓰기 오류

문제:

```yaml

development:

database: backend_rails_development

username: postgres # ← 들여쓰기 없음!

password: han03120!

```

해결:

```yaml

development:

database: backend_rails_development

username: postgres # ← 공백 2개

password: han03120!

```

교훈: YAML은 들여쓰기에 매우 민감. 반드시 일관성 유지.

---

2. test 데이터베이스 생성 실패

문제:

```

connection to server at "localhost" (::1), port 5432 failed:

fe_sendauth: no password supplied

```

원인: IPv6(::1) 연결 시 PostgreSQL 인증 설정 문제

해결:

```yaml

test:

host: 127.0.0.1 # IPv4 사용

```

교훈: Windows + PostgreSQL 조합에서는 명시적으로 IPv4 지정.

---

3. 모델 파일에 잘못된 코드

문제:

```ruby

class DaeunGroup < ApplicationRecord

belongs_to :daeun

... # ← 이게 뭐지?

end

```

원인: 복사-붙여넣기 중 설명 텍스트가 코드로 들어감

해결:

각 파일을 메모장으로 열어 수동 확인

정확한 코드만 붙여넣기

교훈:

코드 복사 시 주의 깊게 확인

에러 메시지를 잘 읽으면 파일 위치와 줄 번호 알 수 있음

---

4. PowerShell vs 메모장 혼동

문제:

설명 텍스트를 PowerShell에 입력

```powershell

PS> class Profile < ApplicationRecord # ← Ruby 코드를 직접 입력!

```

해결:

PowerShell: 명령어만 (`rails`, notepad 등)

메모장: Ruby/YAML 코드 작성

교훈: 작업 환경 구분 명확히!

실시간으로 데이터 확인, 쿼리 테스트, 관계 검증 가능!

3. 진행 상황 출력

seeds.rb에서:

```ruby

puts "#{index + 1}/#{json_data.length} 완료: #{profile.name}"

```

긴 작업 시 진행 상황을 눈으로 확인하면 안심!

4. 한 번에 하나씩

복잡한 작업을 한 번에 하려다 실패하면:

테이블 하나만 먼저 만들기

모델 하나만 먼저 테스트

데이터 1건만 임포트 테스트

확인 후 확장!

---

도움이 필요한 부분

1. Windows 환경 최적화

현재는 Windows 네이티브 Ruby를 사용했지만, WSL(Windows Subsystem for Linux)로 이전하면:

더 나은 성능

gem 호환성 향상

Linux 프로덕션 환경과 동일

→ 나중에 WSL 전환 방법 학습 필요

2. API 엔드포인트 설계

데이터를 외부에서 조회할 수 있는 RESTful API 구축:

GET /api/profiles

GET /api/profiles/:id

GET /api/profiles/:id/wonkuk

GET /api/profiles/:id/daeuns

→ Rails API 모범 사례 학습 필요

3. 대용량 데이터 처리

향후 110만 건 확장 시:

페이지네이션

캐싱 전략

인덱싱 최적화

백그라운드 작업 (Sidekiq)





<< 앞으로의 계획 >>

단기 계획 (1-2주)

1. 절기 데이터 임포트

2,568건 (1920-2026, 107년)

24절기 정확한 시각 데이터

사주 계산의 "GPS" 역할

2. 60 갑자 일주 콘텐츠 임포트

일주별 성격, 진로, 재물, 건강 분석

교육용 콘텐츠 체계화

3. 나머지 테이블 활용

Sewun (세운) 데이터 추가

DaeunGroup 활용 방안 설계



도움 받은 글 (옵션)



지피터스 참고 자료

"Vibe Coding의 문제점" 영상: 구조화된 개발의 중요성 깨달음

구조화된 코딩 템플릿 활용

외부 참고 자료

Ruby on Rails 공식 문서

Rails Guides: https://guides.rubyonrails.org/

특히 Active Record 관계 설정 부분

PostgreSQL 문서

Official Documentation: https://www.postgresql.org/docs/

Windows 설치 및 설정 가이드

GitHub 사례

Rails + PostgreSQL 프로젝트 구조 참고

데이터베이스 마이그레이션 베스트 프랙티스



2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

이모카 프로필 이미지
이모카2025.11.18

우와 엄청난 프로젝트인데요!! 사이즈가 꽤 큰거라 위의 시스템을 한번에 적용하는 것보다는 작은 기능과 목적 하나로 완성된 프로젝트를 만들어보는 것부터 해보시고 최종적으로 합쳐서 하는 것을 추천드립니다~ 고생하셨습니다.

한바둑 프로필 이미지
한바둑2025.11.18

품격 있는 조언에 깊이 감사드립니다.

말씀하신 대로, 거대한 시스템을 한 번에 구축하기보다는 핵심 기능을 중심으로 한 작은 완결성 있는 모듈을 먼저 완성하는 것이 지혜로운 접근이라 생각합니다.

17년간의 학문 여정과 112만 건의 상담 기록을 AI와 결합하는 작업이다 보니, 때로 전체의 완성도에만 몰두하여 본질을 놓칠 뻔했습니다.

하나의 일주(日柱)에 대한 완벽한 상담 시스템부터 구현하여, 그것이 60개의 일주로 확장되는 유기적 성장을 이루는 것이 오히려 전통 명리학의 정신에도 부합하는 방식이겠다는 깨달음을 얻었습니다.

귀한 시간 내어 혜안을 나누어주신 데 대해 진심으로 감사의 마음을 전합니다. 이 조언이 프로젝트의 이정표가 되리라 확신합니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요