## Что это

Freecode Academy позиционируется как **AI R\&D Lab + private execution network**, а не как классический фриланс-маркетплейс. Основная идея — не просто сводить заказчиков и исполнителей, а участвовать в полном цикле: уточнить проблему, собрать подходящую команду, организовать совместное исполнение и сохранить ответственность до фактической поставки результата.

Сеть существует с 2012 года и в 2026 году была переосмыслена под AI-era. На сайте заявлены **4,000+ участников** и **100+ студий и команд**.

## Ключевые принципы

* **Curated / invite-only:** ограниченный доступ ради высокого signal-to-noise и доверия между участниками.
* **AI-native:** AI используется не только как инструмент производства, но и как слой навигации и подбора людей, проектов и предложений.
* **Shared responsibility:** площадка не заканчивает участие после знакомства сторон, а декларирует общую ответственность за результат.
* **Real collaboration:** упор на совместные команды и реальные проекты вместо случайных разовых gig-заказов.
* **Research → execution:** публичные исследования и эксперименты должны переходить в прототипы, продукты и работающие системы.

## Основной рабочий цикл

1. **Define the problem** — превратить размытую идею в понятный scope.
2. **Assemble the team** — подобрать специалистов и команды внутри проверенной сети.
3. **Execute together** — работать в координированной команде с общими целями и прозрачностью.
4. **Deliver results** — довести работу до конкретного результата.

## Основные сущности платформы

* **Members** — участники сети; публичный просмотр открыт, прямой контакт ограничен приглашённым участникам.
* **Teams** — студии и рабочие команды, которые могут накапливать портфолио и совместно брать более сложные проекты.
* **Offers** — свободный формат предложения: услуга, сотрудничество, исследование, найм и другие инициативы.
* **Projects** — проекты с возможностью искать партнёров, инвестиции и помощь.
* **Tasks** — конкретные ограниченные задачи внутри проектов; завершённая работа может становиться публичным worklog/case study.
* **Topics / публикации** — исследовательский и общественный слой платформы.

## Для кого

### Клиенты

Для компаний и основателей, которым нужно не просто найти исполнителя, а разобраться в AI-хаосе, определить правильное решение и собрать надёжную команду под реализацию.

### Специалисты

Для профессионалов, которым нужны реальные проекты, сильные команды, репутация и доступ к закрытому deal flow.

### Студии и тимлиды

Для команд, которые хотят объединять компетенции, масштабироваться на более крупные задачи и сотрудничать с другими студиями.

## Исторический контекст

На freecode.academy сохранился более ранний образовательный слой: учебные разделы по HTML/CSS/JavaScript/React, алгоритмам, структурам данных и практическим проектам. В прошлых версиях проекта большое внимание уделялось обучению веб-разработке через реальные публичные задачи и pull request workflow. Текущее позиционирование значительно шире: закрытая профессиональная сеть и AI-native инфраструктура исполнения проектов.

## Почему проект важен

freecode.academy сочетает несколько направлений, которые обычно существуют раздельно: профессиональное сообщество, R\&D, управление проектами, подбор команд, репутацию и AI-assisted matching. Главная продуктовая гипотеза — **качество сети и ответственность за результат важнее открытого масштаба маркетплейса**.

## Источники исследования

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

Freecode Academy — частная AI-native execution network: площадка объединяет клиентов, независимых специалистов и студии, помогает формализовать задачи, собирать команды и доводить проекты до результата с общей ответственностью.

freecode.academy

# Отформатировать контент

Сейчас многие страницы сайта оформлены некачественно — это результат неудачного обновления сайта.

Нужно пройти по проблемным страницам и привести контент к аккуратному, единообразному виду.

## Что сделать

- выявить страницы с нарушенным или неаккуратным форматированием;
- исправить структуру заголовков, списков, абзацев и других блоков;
- убрать визуальные артефакты и следы некорректной миграции/обновления;
- привести оформление к единому стилю по сайту;
- проверить итоговое отображение страниц после правок.

## Результат

Контент на страницах должен выглядеть аккуратно, последовательно и без явных следов некачественного обновления сайта.

Исправить плохое оформление страниц после некачественного обновления сайта.

Отформатировать контент

Надо накатить свежую версию хейх-агента.

Обновить сайт

# Проблема

На `freecode.academy` некоторые URL с percent-encoded спецсимволами могут отдавать 404, хотя соответствующая страница, вероятно, существует.

Пример:

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

Гипотеза: на одном из этапов роутинга, поиска записи по slug или сопоставления URL отсутствует/некорректно выполняется URL decoding (`decodeURIComponent` или эквивалент), из-за чего slug сравнивается в encoded-виде с сохраненным decoded-значением либо наоборот.

## Что проверить

1. Проследить полный путь URL от HTTP request до поиска сущности по slug:
   - framework/router;
   - route params;
   - server/API handler;
   - запрос в БД;
   - генерация canonical URL/ссылок.
2. Проверить, на каком этапе `%22` и другие percent-encoded символы декодируются автоматически, а где требуется явный decode.
3. Не допустить двойного декодирования (`decodeURIComponent` поверх уже decoded param), особенно для `%`, `%25`, `%2F` и других чувствительных последовательностей.
4. Сверить формат slug в БД: хранится ли он decoded, encoded или нормализованный.
5. Проверить генератор ссылок: URL должен кодироваться ровно один раз (`encodeURIComponent`/URL API там, где это необходимо).
6. Отдельно проверить символы:
   - кавычки `"` / `%22`;
   - запятые;
   - пробелы / `%20`;
   - кириллицу;
   - `%`;
   - `?`, `#`, `/` внутри потенциального slug.
7. Проверить старые уже опубликованные URL и обратную совместимость. Если существуют разные исторические варианты одного slug — при необходимости добавить redirect/canonical normalization вместо 404.

## Конкретный кейс

Для URL:

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

нужно выяснить:

- существует ли запись с логически соответствующим slug;
- какое значение route param получает приложение фактически;
- какое значение используется в запросе к БД;
- исправляется ли 404 после корректной нормализации/decode.

## Критерии приемки

- [ ] Найдена точная причина 404 для приведенного URL.
- [ ] URL со спецсимволами корректно открывают существующие страницы.
- [ ] Нет двойного decode и связанных с ним ошибок/исключений.
- [ ] Генерация ссылок и чтение route params используют согласованный формат slug.
- [ ] Некорректные URL по-прежнему возвращают корректный 404, а не приводят к ошибке приложения.
- [ ] Добавлены тесты минимум на `%22`, кириллицу и `%25`/двойное кодирование.
- [ ] Проверена обратная совместимость существующих ссылок; при необходимости добавлен redirect на canonical URL.

Проверить 404 на URL со спецсимволами и корректность decode/slug routing.

Задачи

Перепроверить обработку URL и декодирование спецсимволов

Обновить сайт

Отформатировать контент