← Về thư mục
📄 / / root / ceo / projects / tech / OpenMAIC / openmaic_submodule_migration_plan_20260908.md

Kế hoạch chuyển đổi OpenMAIC thành Git Submodule độc lập (Cập nhật: 2026-09-08)

1. Mục tiêu chiến lược

2. Kế hoạch thực thi chi tiết (Implementation Plan)

Giai đoạn 1: Chuẩn bị và Kiểm tra an toàn

  1. Tạo bản sao lưu dự phòng toàn bộ mã nguồn và dữ liệu của OpenMAIC.
  2. Kiểm tra danh mục các tệp cần loại trừ trong .gitignore (node_modules, .next, data).
  3. Xác nhận kết nối đĩa cứng và trạng thái container app-openmaic-1.

Giai đoạn 2: Tách mã nguồn và đẩy lên GitHub Repo riêng

  1. Khởi tạo Git repository độc lập tại thư mục projects/tech/OpenMAIC/app.
  2. Tạo commit đầu tiên chứa toàn bộ mã nguồn ứng dụng OpenMAIC.
  3. Cấu hình remote origin trỏ về https://github.com/nhivo2504/openmaic.git.
  4. Đẩy nhánh main lên GitHub repository openmaic.

Giai đoạn 3: Tích hợp Git Submodule vào Mono-repo ceo-ai-os

  1. Xóa thư mục mã nguồn cũ khỏi Git index của repo chính ceo-ai-os.
  2. Khai báo Git Submodule mới thông qua lệnh git submodule add.
  3. Kiểm tra và cập nhật file .gitmodules tại root dự án ceo-ai-os.
  4. Thực hiện commit xác nhận việc thêm submodule vào ceo-ai-os.

Giai đoạn 4: Kiểm thử và Nghiệm thu hệ thống

  1. Kiểm tra lại việc mount volume Docker cho thư mục dữ liệu /app/data.
  2. Kiểm tra container app-openmaic-1 chạy ổn định sau khi chuyển đổi.
  3. Kiểm tra endpoint HTTPS https://openmaic.161-97-131-21.sslip.io trả về HTTP 200.
  4. Chạy thử nghiệm script git_sync.sh để đảm bảo không bị xung đột tự động.

3. Bảng phân công nhiệm vụ (Task List)