# freecode.academy

**Trang web:** https://freecode.academy

## Nó là gì

Freecode Academy định vị mình là một **AI R&D Lab + private execution network**, chứ không phải là một chợ freelancer cổ điển. Ý tưởng cốt lõi không chỉ là kết nối khách hàng và nhà thầu, mà là tham gia vào toàn bộ vòng đời: làm rõ vấn đề, thành lập nhóm phù hợp, tổ chức thực hiện cộng tác và duy trì trách nhiệm cho đến khi bàn giao kết quả thực tế.

Mạng lưới đã tồn tại từ năm 2012 và được tái định hình cho kỷ nguyên AI vào năm 2026. Trang web công bố có **hơn 4.000 thành viên** và **hơn 100 studio và nhóm**.

## Nguyên tắc cốt lõi

* **Curated / invite-only:** quyền truy cập bị giới hạn nhằm đảm bảo tỷ lệ tín hiệu trên nhiễu cao và tạo dựng niềm tin giữa các thành viên.
* **AI-native:** AI được sử dụng không chỉ như một công cụ sản xuất mà còn là lớp điều hướng và kết nối con người, dự án và đề xuất.
* **Shared responsibility:** nền tảng không kết thúc sự tham gia sau khi giới thiệu các bên, mà tuyên bố trách nhiệm chung đối với kết quả.
* **Real collaboration:** chú trọng vào các nhóm cộng tác và dự án thực tế thay vì các đơn hàng việc vặt ngẫu nhiên, đơn lẻ.
* **Research → execution:** nghiên cứu và thử nghiệm công khai phải chuyển hóa thành các nguyên mẫu, sản phẩm và hệ thống hoạt động.

## Vòng đời làm việc chính

1. **Define the problem** — biến một ý tưởng mơ hồ thành phạm vi rõ ràng.
2. **Assemble the team** — lựa chọn các chuyên gia và nhóm trong mạng lưới đã được xác minh.
3. **Execute together** — làm việc trong một nhóm được điều phối với các mục tiêu chung và sự minh bạch.
4. **Deliver results** — đưa công việc đến kết quả cụ thể.

## Các thực thể chính của nền tảng

* **Members** — thành viên của mạng lưới; việc xem công khai được mở, liên hệ trực tiếp bị giới hạn ở các thành viên được mời.
* **Teams** — các studio và nhóm làm việc có thể tích lũy hồ sơ năng lực và cùng nhau đảm nhận các dự án phức tạp hơn.
* **Offers** — định dạng đề xuất linh hoạt: dịch vụ, hợp tác, nghiên cứu, tuyển dụng và các sáng kiến khác.
* **Projects** — các dự án có cơ hội tìm kiếm đối tác, đầu tư và hỗ trợ.
* **Tasks** — các nhiệm vụ cụ thể bị giới hạn trong các dự án; công việc hoàn thành có thể trở thành nhật ký công việc/nghiên cứu tình huống công khai.
* **Topics / Ấn phẩm** — lớp nghiên cứu và công cộng của nền tảng.

## Dành cho ai

### Khách hàng

Dành cho các công ty và nhà sáng lập không chỉ cần tìm nhà thầu, mà còn cần gỡ rối sự hỗn loạn của AI, xác định giải pháp đúng đắn và thành lập một đội ngũ đáng tin cậy để triển khai.

### Chuyên gia

Dành cho các chuyên gia cần các dự án thực tế, đội ngũ vững mạnh, uy tín và quyền tiếp cận luồng giao dịch khép kín.

### Studio và Trưởng nhóm

Dành cho các nhóm muốn kết hợp năng lực, mở rộng quy mô cho các nhiệm vụ lớn hơn và hợp tác với các studio khác.

## Bối cảnh lịch sử

freecode.academy vẫn giữ lại lớp giáo dục ban đầu: các phần học về HTML/CSS/JavaScript/React, thuật toán, cấu trúc dữ liệu và các dự án thực tế. Trong các phiên bản trước của dự án, sự chú ý lớn đã được dành cho việc dạy phát triển web thông qua các nhiệm vụ công khai thực tế và quy trình làm việc pull request. Định vị hiện tại rộng hơn đáng kể: mạng lưới chuyên nghiệp khép kín và cơ sở hạ tầng thực thi dự án mang tính AI-native.

## Tại sao dự án này quan trọng

freecode.academy kết hợp một số lĩnh vực thường tồn tại riêng biệt: cộng đồng chuyên nghiệp, R&D, quản lý dự án, kết nối đội ngũ, uy tín và kết nối có sự hỗ trợ của AI. Giả thuyết sản phẩm chính là **chất lượng mạng lưới và trách nhiệm đối với kết quả quan trọng hơn quy mô mở của một thị trường**.

## Nguồn nghiên cứu

* https://freecode.academy/
* https://freecode.academy/about
* https://freecode.academy/projects
* https://freecode.academy/start/developers

Freecode Academy là một mạng lưới thực thi AI-native riêng tư: nền tảng kết nối khách hàng, chuyên gia độc lập và các studio, giúp chuẩn hóa nhiệm vụ, thành lập nhóm và đưa các dự án đến kết quả với trách nhiệm chung.

freecode.academy

Cần cập nhật phiên bản mới của heych agent.

Cập nhật trang web

# Vấn đề

Trên `freecode.academy`, một số URL có chứa ký tự đặc biệt dạng percent-encoded có thể trả về lỗi 404, mặc dù trang tương ứng có khả năng vẫn tồn tại.

Ví dụ:

```text
/comments/topics/dzheneriki-typescript/nu-vot-ts-tebe-govorit-%22ty-zanimaeshsya-figney%22,-i
```

Giả thuyết: tại một trong các bước định tuyến (routing), tìm kiếm bản ghi theo slug hoặc khớp URL, việc giải mã URL (`decodeURIComponent` hoặc tương đương) đang bị thiếu hoặc thực hiện không chính xác, khiến slug ở dạng đã mã hóa bị đem ra so sánh với giá trị đã giải mã được lưu trữ hoặc ngược lại.

## Những điểm cần kiểm tra

1. Theo dõi toàn bộ đường đi của URL từ HTTP request đến quá trình tìm kiếm thực thể theo slug:
   - framework/router;
   - route params;
   - server/API handler;
   - truy vấn cơ sở dữ liệu (DB);
   - tạo canonical URL/đường dẫn liên kết.
2. Kiểm tra xem ở giai đoạn nào `%22` và các ký tự percent-encoded khác được giải mã tự động, và ở đâu cần gọi giải mã tường minh (explicit decode).
3. Tránh việc giải mã hai lần (`decodeURIComponent` đè lên tham số đã được giải mã), đặc biệt đối với `%`, `%25`, `%2F` và các chuỗi nhạy cảm khác.
4. Đối chiếu định dạng slug trong DB: xem nó được lưu dưới dạng đã giải mã, đã mã hóa hay đã chuẩn hóa.
5. Kiểm tra bộ tạo liên kết (link generator): URL phải được mã hóa đúng một lần (`encodeURIComponent`/URL API ở những nơi cần thiết).
6. Kiểm tra riêng biệt các ký tự:
   - dấu ngoặc kép `"` / `%22`;
   - dấu phẩy;
   - khoảng trắng / `%20`;
   - tiếng Nga (Cyrillic);
   - `%`;
   - `?`, `#`, `/` nằm bên trong slug tiềm năng.
7. Kiểm tra các URL cũ đã được xuất bản và tính tương thích ngược. Nếu tồn tại các biến thể lịch sử khác nhau của cùng một slug — thêm chuyển hướng (redirect)/chuẩn hóa canonical thay vì trả về 404 nếu cần.

## Trường hợp cụ thể

Đối với URL:

```text
/comments/topics/dzheneriki-typescript/nu-vot-ts-tebe-govorit-%22ty-zanimaeshsya-figney%22,-i
```

cần tìm hiểu:

- bản ghi có slug tương ứng về mặt logic có tồn tại hay không;
- giá trị route param thực tế mà ứng dụng nhận được là gì;
- giá trị nào được sử dụng trong truy vấn DB;
- lỗi 404 có được khắc phục sau khi chuẩn hóa/giải mã đúng cách hay không.

## Tiêu chí nghiệm thu

- [ ] Đã tìm ra nguyên nhân chính xác gây ra lỗi 404 cho URL được cung cấp.
- [ ] Các URL có ký tự đặc biệt mở đúng các trang đang tồn tại.
- [ ] Không có hiện tượng giải mã kép và các lỗi/ngoại lệ liên quan.
- [ ] Việc tạo liên kết và đọc route params sử dụng định dạng slug đồng nhất.
- [ ] Các URL không hợp lệ vẫn trả về mã 404 chính xác thay vì gây ra lỗi ứng dụng.
- [ ] Đã thêm các bài kiểm thử (test) ít nhất cho `%22`, tiếng Nga và `%25`/mã hóa kép.
- [ ] Đã kiểm tra tính tương thích ngược của các liên kết hiện có; thêm chuyển hướng đến canonical URL nếu cần thiết.

Kiểm tra lỗi 404 trên các URL chứa ký tự đặc biệt và tính chính xác của decode/slug routing.

Nhiệm vụ

Kiểm tra lại việc xử lý URL và giải mã ký tự đặc biệt

Cập nhật trang web