**bizneshelper.ru** — dự án web trong lĩnh vực tư vấn kinh doanh và chuyên môn quản trị.

## Mục đích dự án

Trang web giới thiệu các lĩnh vực hỗ trợ chuyên nghiệp cho doanh nghiệp, đăng tải các tài liệu chuyên gia và đóng vai trò là điểm truy cập công khai để làm quen với các phương pháp, năng lực và kinh nghiệm của đội ngũ.

## Chủ đề

Phần công khai của dự án trình bày các tài liệu liên quan đến:

* tư vấn chiến lược và quản trị;
* phát triển doanh số và marketing;
* quản lý sản xuất và quản ốc khủng hoảng (chống khủng hoảng);
* quy trình kinh doanh và thay đổi tổ chức;
* nhân sự, pháp lý, kinh tế đối ngoại và các lĩnh vực ứng dụng khác;
* các case study thực tế và bài viết chuyên gia.

## Đối tượng

Dự án hướng đến chủ sở hữu, nhà quản lý và chuyên gia của các công ty đang hoạt động, những người cần chuyên môn bên ngoài trong các vấn đề quản lý, phát triển và nâng cao hiệu quả kinh doanh.

## Vai trò của trang web

Trang web đồng thời thực hiện một số chức năng:

* giới thiệu năng lực và lĩnh vực hoạt động;
* tạo dựng niềm tin thông qua các tài liệu công khai và kinh nghiệm;
* tích lũy nội dung chuyên gia;
* giúp khách truy cập hiểu rõ các nhiệm vụ nào có thể yêu cầu trợ giúp tư vấn;
* làm cơ sở cho sự phát triển tiếp theo của sự hiện diện kỹ thuật số của dự án.

## Nguyên tắc vận hành dự án

Chỉ thông tin công khai mới được ghi nhận trong thẻ dự án và các thực thể công khai liên quan. Các thỏa thuận nội bộ, chỉ số tài chính, quyền truy cập, dữ liệu cá nhân, thông tin khách hàng và thông tin nhạy cảm khác không được công bố.

## Các thực thể liên quan

* Khái niệm hiện đại hóa kỹ thuật: [bizneshelper.ru — hiện đại hóa và di chuyển sang haih-cms](/concepts/bizneshelper-ru-modernizatsiya-i-migratsiya-na-haih-cms).
* Công việc hiện tại được thực hiện thông qua các nhiệm vụ của dự án; các sáng kiến kỹ thuật riêng lẻ không quyết định nội dung của chính dự án.

bizneshelper.ru — trang web về tư vấn kinh doanh, quản trị và phát triển tổ chức.

bizneshelper.ru

# Mục tiêu

Có được bản đồ chính xác của trang web hiện tại để quá trình chuyển đổi sang haih-cms dựa trên cấu trúc thực tế thay vì các giả định.

## Cần làm gì

- Duyệt qua các phần công khai chính và các loại trang.
- Ghi lại cấu trúc điều hướng, độ lồng nhau của các phần và các mẫu lặp lại.
- Xác định các loại nội dung: dịch vụ, bài viết, tin tức, nghiên cứu tình huống, nhân viên, trang dịch vụ và các thực thể công khai khác.
- Ghi lại các biểu mẫu, điểm đầu vào, kịch bản người dùng, tích hợp công khai và hành vi của các trang chính.
- Thu thập riêng danh sách các URL công khai, phương tiện truyền thông và tài nguyên liên quan cần được tính đến trong quá trình di dời.
- Đánh dấu rõ ràng các phần lỗi thời hoặc trùng lặp, nhưng không xóa chúng khỏi kế hoạch nếu không có quyết định riêng.

## Kết quả

Bản đồ công khai của trang web hiện có và danh sách các thực thể, tuyến đường và kịch bản đủ để thiết kế việc triển khai mới.

## Tiêu chí hoàn thành

- Các phần công khai chính và loại trang đã được liệt kê.
- Rõ ràng những thực thể và trường nào cần được di dời.
- Các biểu mẫu, phương tiện truyền thông, điều hướng và kịch bản người dùng chính đã được ghi lại.
- Có cơ sở cho các nhiệm vụ tiếp theo về mô hình dữ liệu, tuyến đường, chuyển hướng và kiểm thử.

## Hạn chế

Không công bố quyền truy cập nội bộ, tham số máy chủ, dữ liệu tích hợp riêng tư và thông tin nhạy cảm về mặt thương mại.

Thực hiện kiểm kê công khai toàn diện trang web Ruby hiện tại làm điểm khởi đầu cho việc di dời.

Kiểm kê trang web Ruby hiện tại

# Mục tiêu

Có được bản sao cục bộ hoạt động của trang web Ruby ban đầu để bạn có thể nghiên cứu an toàn việc triển khai hiện tại, so sánh hành vi trước và sau khi di chuyển, và phát triển việc chuyển đổi sang haih-cms mà không phụ thuộc vào môi trường production.

## Việc cần làm

- Lấy mã nguồn của dự án Ruby cũ từ một nguồn làm việc khả dụng.
- Xác định phiên bản Ruby, Bundler và các phụ thuộc chính của dự án đang được sử dụng.
- Cài đặt các phụ thuộc cục bộ cần thiết và đảm bảo lệnh cài đặt bundle thành công.
- Xác định các yêu cầu về cơ sở dữ liệu, lưu trữ tệp và các dịch vụ cục bộ khác.
- Chuẩn bị cấu hình ứng dụng cục bộ mà không chuyển các bí mật production vào các tệp mở hoặc thẻ công việc.
- Nếu cần thiết, chuẩn bị tập dữ liệu cục bộ an toàn hoặc cách khác để tái tạo các kịch bản công khai chính của trang web.
- Chạy ứng dụng cục bộ và xác minh việc tải trang chủ, các phần chính, trang thông thường và các kịch bản công khai chính.
- Ghi lại các đặc điểm khởi động, sự không tương thích của các phụ thuộc cũ và các rào cản kỹ thuật có thể ảnh hưởng đến quá trình di chuyển.
- Chuẩn bị hướng dẫn khởi động cục bộ ngắn gọn, có thể tái tạo để làm việc tiếp với dự án.

## Kết quả

Trang web Ruby ban đầu chạy cục bộ trong một môi trường có thể tái tạo và có thể được sử dụng làm chuẩn trong quá trình di chuyển sang haih-cms.

## Tiêu chí hoàn thành

- Dự án cài đặt và khởi động thành công cục bộ.
- Đã xác định phiên bản Ruby và các phụ thuộc chính.
- Các trang công khai chính mở được bình thường.
- Đã biết các dịch vụ và phụ thuộc cục bộ cần thiết.
- Có hướng dẫn rõ ràng để chạy lại.
- Tất cả các hạn chế kỹ thuật phát hiện được có khả năng ảnh hưởng đến việc di chuyển đã được ghi lại.

## Hạn chế

Không được xuất bản mật khẩu, mã thông báo, khóa, cấu hình production, bản kết xuất cơ sở dữ liệu riêng tư, dữ liệu cá nhân hoặc thông tin nhạy cảm khác. Nếu cần dữ liệu này để khởi động cục bộ, các giá trị cụ thể phải được thảo luận và truyền tải độc lập bên ngoài thẻ công việc công khai.

Thiết lập bản sao cục bộ có thể tái tạo của dự án Ruby hiện tại để phân tích, di chuyển và kiểm tra hành vi của trang web cũ.

Triển khai cục bộ trang web Ruby ban đầu

# Bối cảnh

Core của `react-markdown` và `@mdxeditor/editor` biên dịch các phần của Markdown khác nhau, đặc biệt là khoảng trắng/thụt lề (whitespace/indentation). Do đó, nội dung kèm HTML hợp lệ sau khi qua MDXEditor có thể bị biến thành code block trong quá trình đọc SSR.

## Cần làm gì

- Tạm thời thêm một component Markdown nội bộ / tầng chuẩn hóa (normalization layer) cho BiznesHelper theo giải pháp đã áp dụng trên VietnamGuru.
- Khắc phục các trường hợp sử dụng bốn dấu cách và tab mà không làm hỏng các code block thực sự.
- Không chuyển giải pháp này vào core cho đến khi hoàn thành nhiệm vụ R&D riêng của haih-agent.
- Thay thế component nội bộ bằng component chung sau khi có giải pháp cấp nền tảng (platform solution).

## Kết quả

Markdown được nhập và cập nhật bởi AI sẽ hiển thị chính xác trên BiznesHelper thông qua SSR mà không bị chuyển đổi nhầm HTML/nội dung thành đoạn mã nguồn (code listing).

Trước khi tái cấu trúc Markdown trong core haih-agent, hãy thêm vào BiznesHelper một renderer nội bộ tương thích với định dạng Markdown thực tế được lưu bởi MDXEditor.

Nhiệm vụ

Thêm component tương thích Markdown nội bộ

Triển khai cục bộ trang web Ruby ban đầu

Kiểm kê trang web Ruby hiện tại