생각이 태어난 장소를 기억하고,
그 생각으로 다시 돌아갈 수 있도록 돕는 공간 기반 기록 서비스

📍 What is Locus?

Locus는 생각을 텍스트나 데이터로만 저장하지 않습니다.
우리는 중요한 생각이 언제나 특정한 시간과 장소에서 발생한다는 전제에서 출발합니다.

Locus는 사용자가 어디에서 무엇을 생각했고,
그 생각이 어떤 맥락 속에서 태어났는지를
지도 위의 장소로 기억할 수 있도록 돕는 서비스입니다.

기록은 저장을 위한 것이 아니라,
다시 돌아가기 위한 단서가 됩니다.

---

✦ Locus가 만드는 경험

• 생각은 장소와 함께 남는다
  텍스트·사진·태그는 위치와 하나의 단위로 기록됩니다.

• 지도는 이동 경로가 아니라 사유의 지도다
  기록은 점으로 남고,
  사용자는 그 점들 사이의 흐름과 패턴을 다시 걷습니다.

• 기록은 흐름을 방해하지 않는다
  Locus는 빠른 캡처 도구가 아니라,
  생각이 지속될 수 있는 상태를 지향합니다.

• 장소에서 다시 마주치는 회상 경험
  과거 기록이 있는 장소에 다시 섰을 때,
  생각은 텍스트가 아니라 맥락으로 돌아옵니다.

---

🚀 프로젝트 상태

현재 단계

• 초기 개발 단계
  프로젝트 기반 구조를 구축하고, MVP 핵심 기능 개발을 진행 중입니다.

완료된 작업

• 프로젝트 기획 및 설계
  • 서비스 목표, 문제 정의, 주요 기능 및 실행 계획 정리
• 공통 개발 환경 구축
  • Monorepo 기반 프로젝트 구조
  • 프론트엔드 / 백엔드 개발 환경 설정
• 프론트엔드 기반 구현
  • 공통 UI 컴포넌트 및 디자인 시스템 일부 구현
  • PWA 기본 설정 및 사용자 경험 개선 요소 적용
• 백엔드 기반 구조 구성
  • 서버 아키텍처 및 데이터베이스 기본 구조 설계
  • 사용자 인증을 위한 데이터 모델 정의
• 개발 도구 및 품질 관리
  • 코드 스타일 및 품질 관리 환경 구성
  • 협업을 위한 개발 워크플로우 정리

진행 중

• MVP 핵심 기능 구현
• 사용자 인증 및 로그인 기능
• 서비스 배포 환경 구성

---

🛠️ 기술 스택

Frontend

Backend

Database

Infrastructure

Tools

---

🧭 Quick Start | 문서 바로가기

Locus를 이해하는 가장 빠른 방법입니다.

• 👉 서비스 개요
  → Locus가 어떤 문제를 풀고자 하는지

• 👉 문제 · 유저 · 가치
  → 왜 이 서비스가 필요한지, 누구를 위한 것인지

• 👉 판단 기준 / 설계 원칙
  → 모든 UX·기능·기술 선택의 기준이 되는 전제

• 👉 기능 설계
  → 주요 기능과 경험 흐름, P0/P1/P2 구조

• 👉 실행 계획
  → 일정, 마일스톤, 그리고 검증 전략

---

🚀 시작하기

사전 요구사항

• Node.js 22.x (.nvmrc 파일 참조)
• pnpm 9.x
• PostgreSQL (백엔드 개발 시)

설치 및 실행

1. Node.js 버전 설정 (nvm 사용 시)

   nvm use

   .nvmrc 파일에 명시된 Node.js 버전(22.20.0)을 자동으로 사용합니다.

2. 의존성 설치

   pnpm install

3. Playwright 브라우저 설치 (필수)

   pnpm exec playwright install

   [!WARNING] 스토리북 테스트 실행을 위해 필수입니다.

4. 개발 서버 실행

   # 전체 앱 동시 실행
   pnpm dev
   
   # 프론트엔드만 실행
   pnpm dev:web
   # 또는
   cd apps/web && pnpm dev
   
   # 백엔드만 실행
   pnpm dev:api
   # 또는
   cd apps/api && pnpm dev

5. 스토리북 실행

   cd apps/web
   pnpm storybook

테스트 실행

# 전체 테스트
pnpm test

# 프론트엔드 테스트 (Vitest + Storybook)
pnpm test:web

# 백엔드 테스트 (Jest)
pnpm test:api

빌드

# 전체 빌드
pnpm build

# 프론트엔드 빌드
pnpm build:web

# 백엔드 빌드
pnpm build:api

데이터베이스 설정 (백엔드)

cd apps/api

# Prisma 클라이언트 생성
pnpm db:generate

# 마이그레이션 실행
pnpm db:migrate

# Prisma Studio 실행 (DB GUI)
pnpm db:studio

---

🖥️ 팀

팀원 소개

그루	휴고	피넛	아리	민다
Tech Lead 검색 시스템 엔지니어링	공간 시스템 엔지니어링	관계 모델링 엔지니어링	Search Lead 인프라	Frontend Lead

Made with 🐥 by Team Haping

by you, for memory, thought, and spatial understanding.