아이디어 실행 기록 시스템

1. 프로젝트 개요

• 무엇을 하는가
  Spark Lab은 아이디어를 초기 구상부터 실행 단계, 최종 결과까지 추적하는 Laravel 기반 애플리케이션으로, 개인 작업 관리와 공개 탐색 기능을 동시에 제공한다.

• 해결하는 문제
  단순 메모 도구와 무거운 백로그 관리 도구 사이의 간극을 메우며, 하나의 단위에 맥락, 단계, 참고자료, 태그, 결과를 통합하여 관리할 수 있도록 한다..

• 대상 사용자
  제품, 디자인, 리서치, 운영, 엔지니어링 등 탐색적이거나 협업 기반 작업을 수행하는 팀

2. 핵심 아키텍처

• 구조
  Laravel MVC 기반의 모듈형 모놀리식 구조, 서버 렌더링 중심

• 주요 구성 요소

  • 라우팅: routes/web.php
  • 컨트롤러: app/Http/Controllers
  • 모델: app/Models
  • 뷰: resources/views
  • 데이터베이스: database/migrations, database/seeders

• 요청 흐름

  1. public/index.php로 요청 진입
  2. bootstrap/app.php에서 부트스트랩
  3. web.php 라우팅 처리
  4. FormRequest로 입력 검증
  5. 컨트롤러에서 Eloquent 모델 조작
  6. Blade 뷰 또는 리다이렉트 반환
  7. 인증은 서명 URL + 세션 기반 처리

3. 기술 스택

• 백엔드

  • PHP 8.3
  • Laravel 13

• 프론트엔드

  • Blade 템플릿
  • Tailwind CSS v4
  • Alpine.js
  • Axios
  • Vite

• 데이터베이스

  • 해당: MariaDB
  • 선택: SQLite / MySQL / PostgreSQL / SQL Server

• 인프라 기본 설정

  • DB 기반 세션, 캐시, 큐

• 외부 서비스

  • 이메일 (가입 및 비밀번호 재설정)
  • 별도 외부 서비스 연동 없음

4. 주요 기능

• Spark 생명주기 관리
  제목, 요약, 상세 내용, 결과, 공개 여부, 완료 시점, 조회수 관리

• 순차적 실행 단계 관리
  단계가 순서 기반으로 추가 및 정렬됨

• 단계별 북마크 기능
  각 단계에 URL 및 메모 형태의 참고자료 저장 가능

• 태그 시스템
  소문자 정규화 및 중복 제거 후 관리

• 공개 / 비공개 구조

  • /sparks → 개인 작업 영역
  • /explore/sparks → 공개 탐색 영역

• 인증 방식
  서명된 URL 기반 회원가입 및 비밀번호 재설정

• 관련 Spark 추천
  태그 기반 연관 항목 추천

• SEO 대응
  메타데이터를 Blade partial로 구성

5. 코드 구조

• 디렉토리 구성

  • app — 컨트롤러, 모델, 요청, 메일
  • bootstrap — 애플리케이션 초기화
  • config — 설정
  • database — 스키마 및 시드 데이터
  • resources — 뷰, CSS, JS
  • routes — 라우팅 정의
  • tests — 테스트 코드
  • public — 웹 진입점

• 엔트리 포인트

  • 웹: public/index.php
  • CLI: artisan
  • 라우팅: routes/web.php

6. 설계 결정

• 적용 패턴

  • Laravel MVC 구조
  • FormRequest 기반 검증 레이어
  • Eloquent 중심 도메인 모델링
  • 최소 JS 기반 서버 렌더링 UI

• 트레이드오프

  • 컨트롤러 중심 로직 (단순하지만 확장성 제한)
  • 세션 기반 인증 (API 재사용성 낮음)
  • DB 기반 인프라 (초기 구축은 쉽지만 확장성 제한)
  • 서명 URL 인증 (Laravel 기본 방식과 차이 존재)

7. 강점

• 명확하고 일관된 도메인 구조
  Spark → Steps → Bookmarks

• 핵심 흐름을 커버하는 테스트 구성

  • 인증
  • CRUD
  • 공개/비공개 처리
  • SEO

• 공개/비공개 로직이 명확하게 분리됨

• 실제 사용 시나리오 기반 시드 데이터 제공

8. 차별점

• 핵심 단위가 "작업"이 아닌
  실행 흐름을 포함한 아이디어

• 단계 단위 지식 축적 구조

  • 일반 백로그보다 구조적

• 서명 URL 기반 인증 흐름

  • Laravel 기본 방식과 다른 접근

• 공개/비공개를 하나의 모델로 처리

  • 별도 퍼블리싱 구조 없음

9. 한 줄 요약

아이디어를 실행 단계와 맥락까지 포함한 구조화된 기록으로 전환하고, 이를 탐색 가능하게 만드는 Laravel 13 기반 모놀리식 애플리케이션