Giới thiệu

Khi xây dựng các ứng dụng trong lĩnh vực sức khỏe phụ nữ hoặc femtech, một trong những thách thức đầu tiên là dự đoán chu kỳ. Hầu hết các ứng dụng hiện có đều triển khai logic tính toán ngày rụng trứng, ngày có khả năng thụ thai và chiều dài chu kỳ trung bình theo cách kín.

Tôi muốn tạo ra điều gì đó khác biệt: một thư viện nhẹ, mã nguồn mở dựa trên TypeScript mà các nhà phát triển có thể sử dụng cả ở frontend và backend để triển khai các tính năng dự đoán chu kỳ mà không cần phải phát minh lại bánh xe. Đó là cách Cyclia ra đời.

Tại sao tôi xây dựng Cyclia

Độ minh bạch: Hầu hết các thuật toán dự đoán chu kỳ trong các ứng dụng đều bị ẩn; Cyclia hoàn toàn mã nguồn mở.
Tính linh hoạt: Hoạt động trên cả frontend (React, Vue, v.v.) và backend (Node.js, NestJS).
An toàn kiểu: Viết bằng TypeScript để cải thiện trải nghiệm phát triển (DX).
Tính tái sử dụng: Một thư viện, nhiều trường hợp sử dụng: ứng dụng sức khỏe, dự án nghiên cứu, thí nghiệm cá nhân.

Đây là thư viện mã nguồn mở đầu tiên của tôi, và tôi dự định mở rộng nó trong tương lai. Cyclia hiện tại vẫn rất tối giản — theo thiết kế.

Cyclia có thể làm gì hôm nay

Hiện tại, Cyclia tập trung vào logic cốt lõi để theo dõi chu kỳ:

Dự đoán ngày bắt đầu kỳ tiếp theo
Tính toán khoảng thời gian dễ thụ thai
Ước lượng ngày rụng trứng
Theo dõi chiều dài chu kỳ trung bình

Đây là nền tảng cho bất kỳ ứng dụng theo dõi chu kỳ kinh nguyệt hoặc thai kỳ nào.

Cài đặt

Cyclia được phát hành trên npm và có thể được cài đặt trong vài giây:

bash Copy

npm install cyclia

hoặc với yarn:

bash Copy

yarn add cyclia

Ví dụ sử dụng

Dưới đây là một ví dụ tối thiểu về cách sử dụng Cyclia trong một dự án:

typescript Copy

import { predictCycle } from "cyclia";

const cycleData = {
  lastPeriodDate: new Date("2025-08-15"),
  averageCycleLength: 28,
};

const result = predictCycle(cycleData);

console.log(result);
/*
{
  nextPeriodStart: 2025-09-12,
  fertileWindow: [2025-08-26, 2025-08-31],
  ovulationDay: 2025-08-30
}
*/

Thật đơn giản và sẵn sàng để tích hợp.

Lộ trình phát triển

Cyclia vẫn còn trẻ, nhưng đây là những gì tôi thấy nó sẽ phát triển:

Thêm hỗ trợ cho các chu kỳ không đều
Dự đoán khả năng sinh sản chính xác hơn
Cung cấp thông tin sức khỏe mở rộng
Ví dụ tích hợp cho React và NestJS
Tài liệu tốt hơn và một trang web riêng

Mã nguồn mở & Cộng đồng

Cyclia được cấp phép MIT và mở cho các đóng góp. Tôi rất mong muốn các nhà phát triển thử nghiệm với nó, bất kể là cho các dự án cá nhân hay ứng dụng sản xuất.

GitHub: NextFutureHub/cyclia
npm: cyclia
Trang đích: cycle-landing.vercel.app

Những suy nghĩ cuối cùng

Tôi đã xây dựng Cyclia như một đóng góp mã nguồn mở đầu tiên của mình, và tôi rất hào hứng để phát triển nó hơn nữa. Nếu bạn đang xây dựng một dự án trong lĩnh vực femtech, công nghệ sức khỏe, hoặc chỉ muốn khám phá các thuật toán dự đoán, hãy thử nghiệm với Cyclia.

Nếu bạn thấy Cyclia hữu ích:

⭐️ Đánh giá nó trên GitHub
Thử nghiệm qua npm
Chia sẻ phản hồi hoặc ý tưởng để cải thiện

Hãy cùng nhau làm cho các công cụ femtech mã nguồn mở trở nên dễ tiếp cận hơn.

Cyclia: Thư viện Dự đoán Chu kỳ Đơn giản với TypeScript