Leantime/leantime 딥다이브
— "프로젝트 매니저가 아닌 사람들"을 위한 오픈소스 PM 시스템

1프로젝트 한 줄 요약

Leantime은 "아이디어(전략) → 계획 → 실행"의 전 과정을 하나의 웹앱 안에서 다루는 오픈소스 프로젝트 관리 시스템이다. 대부분의 PM 도구가 "이미 정해진 할 일을 칸반에 늘어놓는" 실행 단계에만 집중하는 데 비해, Leantime은 그 앞 단계 — 왜 이 프로젝트를 하는지(목표·전략)부터 붙잡는다. 그래서 Lean Canvas·SWOT·목표(OKR) 같은 전략 수립 도구가 태스크·마일스톤·타임시트 같은 실행 도구와 한 지붕 아래 들어 있다.

가장 큰 차별점은 타깃 사용자다. README 첫 줄이 "for non-project managers(프로젝트 매니저가 아닌 사람들을 위한)" — 즉 PM 전문가가 아니어도, 프리랜서·소규모 팀·스타트업 창업자·비영리 단체가 부담 없이 쓰도록 만들었다. 여기에 "ADHD·난독증·자폐를 염두에 두고 만들었다(Built with ADHD, dyslexia and autism in mind 🧠)"는 뉴로다이버시티(신경다양성) 지향이 더해져, 산만해지기 쉬운 사람도 집중을 유지하도록 UI·동기부여 장치를 설계했다.

2왜 지금 주목받는가

Leantime은 2019년부터 이어온 성숙한 프로젝트지만, 최근 다시 트렌딩에 오른 데는 이유가 있다. 셀프호스팅·데이터 주권에 대한 관심이 커지는 흐름과, AI 에이전트가 앱을 직접 조작하는 MCP(Model Context Protocol) 통합이라는 신규 기능이 겹쳤다. (TrendShift의 굵은 숫자는 별 수가 아니라 사회적 언급 모멘텀이다.) 매력 포인트를 넷으로 정리한다.

주목 포인트 1 — "비-PM"이라는 뾰족한 포지셔닝

PM 도구 시장은 포화 상태지만, 대부분 PM 전문가나 개발팀을 겨냥한다(Jira가 대표). Leantime은 반대로 "프로젝트 관리를 배운 적 없는 사람"을 노린다. README의 표현 그대로 "Trello만큼 단순하지만 Jira만큼 기능이 풍부한(as simple as Trello but as feature-rich as Jira)" 절충점을 표방한다. 이 뾰족함이 프리랜서·1인 창업자·비영리·연구실 같은 틈새에서 강한 지지를 얻는다.

주목 포인트 2 — 전략 수립 도구를 앱 안에 내장

실행(태스크)만 있는 경쟁 도구와 달리, Leantime은 Lean Canvas·Business Model Canvas·SWOT·리스크 분석·목표(Goal/OKR)·아이디어 보드·회고(Retrospective)를 정식 기능으로 넣었다(각각 Canvas·Goalcanvas·Ideas 도메인). "먼저 전략을 세우고, 그 전략에서 목표가 나오고, 목표에서 태스크가 나온다"는 린 스타트업 사고방식을 제품 구조로 구현한 것이 핵심 차별점이다.

주목 포인트 3 — AI 네이티브: 앱 자체가 MCP 서버

가장 최신이자 트렌딩의 직접적 동력. Leantime은 laravel/mcp 위에서 자기 자신을 MCP 서버로 노출해, Claude 같은 AI 에이전트가 태스크 생성·수정, 마일스톤 추가, 목표 관리, 타임시트 기록을 직접 호출할 수 있게 했다(6개 도메인에 걸쳐 55개 AI 툴). 여기에 멀티 LLM 추상화(Prism), AI 에이전트 프레임워크(neuron-ai), 벡터 데이터베이스(Qdrant)까지 얹어 임베딩·시맨틱 검색 기반을 깔았다. "PM 도구에 AI를 붙인" 게 아니라 "AI가 조작하도록 설계된 PM 도구"라는 점이 신선하다.

주목 포인트 4 — 셀프호스팅 + 강력한 기업 인증

Docker·Helm으로 손쉽게 자체 서버에 올려 데이터를 내부에 두고, LDAP·OIDC·SAML2 + 15종 소셜 로그인·2FA·Sanctum API 토큰까지 지원해 기업 환경 요구를 충족한다. Slack·Mattermost·Discord 알림, S3 파일 저장, CalDAV 캘린더, 20개+ 언어(i18n 48개 파일)도 완비. "무료·오픈소스인데 기업용 기능이 다 있다"는 완성도가 재방문을 부른다.

경쟁 도구와의 비교

3기술 스택 전체 지도

LinkSwift 같은 단일 파일 유틸과 정반대로, Leantime은 백엔드·프런트엔드·인프라가 모두 두꺼운 정통 웹 애플리케이션이다(app/ 아래 PHP 파일만 915개). 스택을 세 계층으로 나눠 본다.

계층 1 — 백엔드 (PHP 8.2 · Laravel 11 기반)

핵심은 Laravel 11 프레임워크를 부분 패키지로 쓰는 게 아니라 통째로 가져와 상속·개조했다는 점이다. illuminate/*를 조각조각 쓰지 않고 laravel/framework 전체를 require한 뒤, app/Core/Application.php가 Illuminate\Foundation\Application을 상속해 폴더 구조를 Leantime 방식으로 재매핑한다.

계층 2 — 프런트엔드 (jQuery 레거시 + HTMX 하이퍼미디어의 이중구조)

프런트엔드는 React·Vue 같은 SPA가 아니다. 서버가 HTML을 그리는 전통 방식을 유지하되, 오래된 jQuery 기반 위에 현대적 HTMX(부분 렌더링)를 얹은 하이브리드다. 빌드는 Laravel Mix(webpack 래퍼)가 담당한다.

계층 3 — 데이터 · 인프라 (MySQL 커스텀 스키마 + Docker/nginx + Helm)

4아키텍처 심화 분석

Leantime의 뼈대는 두 축이다 — ① 상속·개조한 Laravel 커널(app/Core/)과 ② 기능마다 하나씩인 43개 도메인 모듈(app/Domain/). 그 위에 확장성을 책임지는 이벤트/필터 훅 시스템이 관통한다. 하나씩 해부한다.

4-1. 부팅 흐름 — 요청이 들어오면 벌어지는 일

app/Core/Bootloader.php의 싱글턴이 진입점이다. 요청을 잡아 웹이면 HttpKernel, CLI면 ConsoleKernel을 컨테이너에서 꺼내 실행한다. 그 전에 Application이 Laravel의 표준 경로를 Leantime 구조로 갈아끼운다.

// app/Core/Application.php — Laravel Application 을 상속해 경로 재매핑
class Application extends \Illuminate\Foundation\Application {
    // "우리 폴더 구조는 다르며, 부르주아에게 굴복하지 않는다" (실제 주석)
    $this->useAppPath($this->basePath . '/app');
    $this->useLangPath($this->basePath . '/app/Language');
    $this->registerLeantimeAliases();
}

// app/Core/Bootloader.php — 커널 선택 후 실행
Bootloader::getInstance()->boot($app);
$request = IncomingRequest::capture();
$kernel  = $isConsole ? $app[ConsoleKernel::class] : $app[HttpKernel::class];
$kernel->handle($request);   // → leantime.core.* 이벤트 디스패치

DI 컨테이너는 Laravel의 Illuminate 컨테이너를 그대로 쓴다(PHP-DI 아님). 즉 "폴더 배치와 부팅 절차는 개조했지만, 심장(컨테이너·커널·서비스 프로바이더)은 Laravel 그대로"라는 절충이다.

4-2. 도메인 주도 설계(DDD) — 기능 하나 = 폴더 하나

Leantime의 정수는 app/Domain/ 아래 43개의 자기완결 모듈이다. 각 도메인은 컨트롤러·서비스·리포지토리·모델·이벤트·권한·템플릿을 자기 폴더 안에 다 갖는다. 공통 베이스 클래스는 app/Core/Domains/에 있다(BaseService·DomainRepository·DomainModel·DTO). 대표 도메인 Tickets(태스크)의 내부를 보면 구조가 한눈에 들어온다.

서비스는 #[RequiresPermission] 애트리뷰트로 권한을 선언하고, DispatchesEvents 트레이트로 이벤트를 쏘며, 다른 도메인의 서비스·리포지토리를 생성자 주입으로 조합한다. "기능 간 결합을 도메인 경계로 가두는" DDD의 교과서적 적용이다.

4-3. 라우팅 — 규약 기반 + 명시적 라우트의 하이브리드

라우팅도 절충형이다. 대부분의 도메인은 Domain.Controller 이름을 URL로 자동 매핑하는 프론트컨트롤러 규약을 따른다(예: Dashboard는 라우트 파일이 없어도 Controllers/만으로 동작). 반면 단 5개 도메인만 명시적 routes.php를 둔다. 모든 라우트는 CheckPermissions 미들웨어로 감싸져, 앞서 본 #[RequiresPermission] 애트리뷰트가 자동으로 강제된다.

4-4. 확장성의 심장 — WordPress식 이벤트 + 필터 훅

Leantime을 가장 특별하게 만드는 설계. app/Core/Events/EventDispatcher.php(28KB)가 두 종류의 훅을 제공한다 — 이벤트(무언가 일어났음을 알림)와 필터(값을 통과시키며 변형). WordPress의 do_action/apply_filters와 똑 닮았다.

// 이벤트 — "이 일이 일어나면 이 함수를 불러라" (알림형)
add_event_listener('leantime.core.middleware.loadplugins.plugins', function($p){ ... });
dispatch_event('ticket.created', $ticketData);

// 필터 — 값을 가로채 바꿔서 되돌린다 (변형형)
$menu = dispatch_filter('sidebar.menu', $defaultMenu);

// ★ 압권: SQL 문자열조차 필터를 통과한다 → 플러그인이 쿼리를 다시 쓸 수 있다
$sql = dispatch_filter('sql', $sql, ['entity' => 'ticket']);

훅 이름은 leantime.core.middleware.loadplugins...처럼 계층적이고, 와일드카드/정규식 매칭에 컴파일된 패턴 캐시까지 있다. 심지어 리포지토리가 실행하기 직전의 SQL도 필터를 거쳐, 플러그인이 코어를 건드리지 않고 쿼리를 바꿀 수 있다. 이 훅 시스템이 곧 플러그인·마켓플레이스·엔터프라이즈 확장의 토대다.

4-5. 데이터 레이어 — Laravel 위의 원시 PDO

ORM(Eloquent)을 전면에 쓰지 않는 점이 독특하다. app/Core/Db/Db.php는 스스로를 "PDO 연결을 위한 아주 단순한 추상화 계층"이라 부르며, Laravel의 DatabaseManager에서 연결을 얻은 뒤 원시 PDO 객체를 꺼내 직접 prepare/execute한다. 리포지토리 베이스(Repository.php)의 dbcall()이 이 패턴을 감싼다. SQL 인젝션 방지 헬퍼(arrayToPdoBindingString·sanitizeToColumnString)를 직접 구현했고, 앞서 본 dispatch_filter('sql', ...) 훅이 여기에 걸려 있다.

4-6. AI 네이티브 — 앱이 곧 MCP 서버

laravel/mcp 위에서, 6개 도메인의 Tools/ 폴더에 흩어진 55개의 LLM 호출용 "툴"을 노출한다. 각 툴은 Laravel\Mcp\Server\Tool을 상속해 name()·description()·schema()를 정의한다 — AI가 이 스키마를 읽고 함수처럼 호출한다.

// app/Domain/Tickets/Tools/AddTaskTool.php (요지)
class AddTaskTool extends \Laravel\Mcp\Server\Tool {
    public function name()        { return 'addTask'; }
    public function description() { return 'Create a new task/ticket in a project'; }
    public function schema()      { /* 타입 있는 입력 스키마 (제목·프로젝트·담당자…) */ }
}
// 이런 툴이 addTask · addMilestone · findTasks · bulkEditTasks · createSubtasks …로 55개

즉 Claude 같은 에이전트가 "이 프로젝트에 마일스톤 3개 만들고 태스크를 분배해줘"라고 지시받으면, Leantime의 MCP 툴을 직접 호출해 실행한다. 뒤에서 Prism(멀티 LLM)·neuron-ai(에이전트)·Qdrant(벡터 검색)가 받친다.

5디렉토리 · 파일 구조 해부

루트는 Laravel 앱과 비슷하지만, app/ 내부가 완전히 다르다. 프레임워크 개조 부분(Core)과 기능 부분(Domain)이 명확히 갈린다.

6학습 포인트

Leantime은 "PM 도구"라는 겉모습을 넘어, 실전 규모의 PHP/Laravel 애플리케이션을 어떻게 설계·조직·확장하는가에 대한 살아있는 교재다. 기술별로 배울 거리를 정리한다.

배울 것 1 — Laravel 프레임워크를 상속·개조하는 법

대부분의 튜토리얼은 Laravel의 기본 구조를 "그대로 따르라"고 가르친다. Leantime은 반대로 Illuminate\Foundation\Application을 상속해 경로·부팅을 재정의한다. 프레임워크를 사용자가 아니라 개조자의 눈으로 보게 해준다 — 서비스 컨테이너·커널·서비스 프로바이더가 실제로 어떻게 맞물리는지 배우는 최고의 실물.

배울 것 2 — 도메인 주도 설계(DDD)로 대형 앱 나누기

기능이 수십 개인 앱을 "컨트롤러 폴더, 모델 폴더"처럼 기술별로 쌓으면 금세 무너진다. Leantime의 "기능 = 폴더" 도메인 구조는 코드가 커져도 길을 잃지 않는 조직법을 보여준다. 베이스 클래스(BaseService·DomainRepository)로 공통을 뽑고, 도메인 간엔 생성자 주입으로만 소통하는 경계 설계를 관찰하라.

배울 것 3 — WordPress식 이벤트/필터 훅 아키텍처

플러그인이 코어를 수정하지 않고 동작을 바꾸게 하는 훅(hook) 시스템은 확장 가능한 소프트웨어의 핵심 패턴이다. Leantime의 dispatch_event/dispatch_filter(특히 SQL조차 필터로 가로채는 대담함)는 "값을 통과시키며 변형하는 필터"와 "알림형 이벤트"의 차이를 코드로 익히게 해준다. WordPress·Drupal의 훅 철학을 Laravel 위에 구현한 사례.

배울 것 4 — HTMX 하이퍼미디어 UI (SPA 없이 인터랙티브)

React/Vue 없이도 현대적인 UX를 만드는 HTMX의 실전 예다. 백엔드의 Hxcontrollers/가 조각 HTML을 반환하고 브라우저가 그 부분만 교체한다. "무거운 프런트 빌드 없이 서버 렌더로 인터랙션을 주는" 요즘 대안 접근법을, 레거시 jQuery와 공존시키는 현실적 마이그레이션과 함께 볼 수 있다.

배울 것 5 — 앱을 AI에 여는 법 (MCP 서버 구현)

지금 가장 뜨거운 주제. 기존 앱에 MCP 서버를 붙여 AI 에이전트가 기능을 호출하게 하는 실제 구현을 통째로 볼 수 있다. Tool을 상속해 name/description/schema를 정의하는 패턴, 그리고 그 뒤를 받치는 멀티 LLM 추상화(Prism)·벡터 DB(Qdrant) 배선까지 — "AI 네이티브 앱"의 실전 청사진.

배울 것 6 — ORM 없이 원시 PDO로 안전하게 DB 다루기

Eloquent 같은 ORM에 의존하지 않고 원시 PDO + 직접 만든 인젝션 방지 헬퍼로 데이터를 다루는 접근. ORM이 감춰버린 "prepared statement·바인딩·SQL 새니타이즈"의 원리를 눈으로 확인하게 해준다. 성능·제어를 위해 ORM을 걷어낸 트레이드오프의 사례.

7시스템 · 설치 요구사항

단일 파일 유틸과 달리 Leantime은 서버·PHP·DB가 갖춰진 환경이 필요하다. 다만 Docker 이미지가 잘 정리돼 있어, 명령 몇 줄이면 뜬다.

설치 흐름 (세 갈래)

8직접 해볼 수 있는 실습 과제

9관련 기술 심화 학습 로드맵

10핵심 키워드 사전

11참고 링크