คู่มือการเปลี่ยนชื่อโปรเจกต์ gohig

คู่มือนี้มีวัตถุประสงค์เพื่ออธิบายเหตุผลและวิธีการเปลี่ยนชื่อโปรเจกต์จากชื่อเดิม (apps/gohig) ไปเป็นชื่อใหม่ (apps/hrmock) เพื่อป้องกันความสับสนและแยกให้ชัดเจนจากระบบที่ตั้งใจพัฒนาขึ้นจริงในอนาคต

เหตุผลที่ต้องเปลี่ยนชื่อ

ในเบื้องต้น โปรเจกต์ gohig ถูกวางแผนให้เป็นระบบที่ผู้ใช้งานแต่ละคนสามารถเป็นสมาชิกในหลาย workspace ได้ โดยแต่ละ workspace มีเจ้าของที่สามารถกำหนดบทบาท (roles) ได้เอง รวมทั้งสามารถกำหนดสิทธิ์การเข้าถึงของแต่ละบทบาทได้ละเอียดในแต่ละส่วนของระบบ เช่น /blog, /admin, /report เป็นต้น

อย่างไรก็ตาม ในการพัฒนาจริงที่ผ่านมา โปรเจกต์นี้ได้ออกมาเป็นระบบจัดการเวลาทำงานทั่วไป ซึ่งมีเพียงผู้ดูแลระบบ (admin) และพนักงานทั่วไปเท่านั้น ยังไม่มีการรองรับหลาย workspace ระบบกำหนดสิทธิ์ต่างๆ ยังไม่ได้ถูกพัฒนาอย่างละเอียด ระบบ signin ยังเป็นระบบที่เรียบง่ายโดยใช้ localStorage ในการเก็บข้อมูลผู้ใช้ รวมถึงฐานข้อมูลยังคงอยู่ในสถานะ mockup

สรุปได้ว่า โปรเจกต์ที่พัฒนาขึ้นมาในขณะนี้ยังไม่ตรงกับแนวคิดและข้อกำหนดดั้งเดิมของระบบ gohig แต่ถึงแม้ว่าจะยังไม่ใช่ระบบที่ตั้งใจไว้แต่แรก โปรเจกต์นี้ยังคงมีประโยชน์ในการเก็บไว้เป็นต้นแบบหรือระบบทดลองสำหรับการต่อยอดในอนาคต

ดังนั้น เพื่อป้องกันความเข้าใจผิดและความสับสนในอนาคต จึงมีความจำเป็นที่จะต้องเปลี่ยนชื่อโปรเจกต์ให้สอดคล้องกับลักษณะและวัตถุประสงค์ที่แท้จริงของระบบที่มีอยู่ในขณะนี้

ขั้นตอนการเปลี่ยนชื่อโปรเจกต์

1. เปลี่ยนชื่อโฟลเดอร์

เปลี่ยนจาก:

apps/gohig

เปลี่ยนเป็น:

apps/hrmock

2. เปลี่ยนชื่อในไฟล์ package.json

เปิดไฟล์ package.json ภายในโฟลเดอร์ที่เปลี่ยนชื่อไปข้างต้น และแก้ไข

"name": "gohig"

ให้เป็น

"name": "hrmock"

3. แก้ไขไฟล์ .cz-config.cjs

แก้ไข scope ภายในไฟล์นี้จาก

scopes: [
  { name: 'apps/gohig' },
  { name: 'apps/nfdocs' },
  { name: 'apps/nokfa' },
  { name: 'apps/nfbuild' },
  { name: 'packages/ui' },
  { name: 'packages/config' },
  { name: 'packages/lib-posts' },
  { name: 'scripts' },
  { name: 'root' }
],

เป็น

scopes: [
  { name: 'apps/hrmock' },
  { name: 'apps/nfdocs' },
  { name: 'apps/nokfa' },
  { name: 'apps/nfbuild' },
  { name: 'packages/ui' },
  { name: 'packages/config' },
  { name: 'packages/lib-posts' },
  { name: 'scripts' },
  { name: 'root' }
],

4. แก้ไขไฟล์ commitlint.config.cjs

เปลี่ยน scope ภายในไฟล์นี้จาก

'scope-enum': [
  2,
  'always',
  [
    'apps/gohig',
    'apps/nfdocs',
    'apps/nokfa',
    'apps/nfbuild',
    'packages/ui',
    'packages/config',
    'packages/lib-posts',
    'scripts',
    'root'
  ],
],

เป็น

'scope-enum': [
  2,
  'always',
  [
    'apps/hrmock',
    'apps/nfdocs',
    'apps/nokfa',
    'apps/nfbuild',
    'packages/ui',
    'packages/config',
    'packages/lib-posts',
    'scripts',
    'root'
  ],
],

5. Commit และ Push การเปลี่ยนแปลง

รันคำสั่งต่อไปนี้

git add .
git commit -m "rename gohig to hrmock"
git push origin dev

เมื่อดำเนินการครบทุกขั้นตอนตามคู่มือนี้แล้ว โปรเจกต์จะถูกเปลี่ยนชื่อเรียบร้อย เพื่อให้เกิดความชัดเจนในการพัฒนาระบบต่อไป