AX 스타터 킷

업무 프로세스의 병목을 찾아 빠르게 해결합니다.Low cost, Maximum efficiency로 AX 문화를 확산합니다.

시작하기기술 스택 보기
Low Cost
최소 비용
Max Speed
최대 효율
Full Stack
통합 개발

AX 팀 미션

IT-현업 접점에서 시작해 전사로 AX 문화 확산

병목 해결

수작업/비효율 업무의 병목을 빠르게 파악하고 해결합니다. IT-현업 접점에서 시작해 전사적 문제를 발굴합니다.

Low Cost, Max Efficiency

최소 비용으로 최대 효율을 달성하는 MVP 솔루션을 설계하고 구현합니다.

속도가 경쟁력

빠른 프로토타이핑과 배포로 비즈니스 가치를 신속하게 창출합니다.

기술 스택

AX 팀이 사용하는 핵심 기술과 도구

Next.js (App Router)

React 기반 풀스택 프레임워크. App Router, Server Components, API Routes를 활용한 프론트엔드 개발.

FastAPI (Python)

고성능 Python 백엔드 프레임워크. 타입 안전한 API 개발, 자동 문서 생성, 비동기 처리 지원.

Palantir Ontology

데이터 모델링 및 통합 방법론. 비즈니스 객체와 관계를 체계적으로 정의하고 활용.

AWS EC2 + Coolify

셀프호스팅 PaaS 인프라. AWS EC2 위에 Coolify를 운영하여 배포 자동화 및 서비스 관리.

Docker Compose

컨테이너 기반 배포 환경. 프론트엔드, 백엔드, DB를 하나의 구성 파일로 통합 관리.

Monorepo

프론트엔드와 백엔드를 하나의 저장소에서 통합 관리. 코드 공유와 일관된 개발 경험 제공.

시스템 아키텍처

프론트엔드부터 배포까지 AX 팀의 기술 아키텍처

Step 1

Frontend

Next.js App Router

Step 2

Backend

FastAPI Python

Step 3

Data

Palantir Ontology

Step 4

Infra

Coolify on AWS EC2

Step 5

Deploy

Docker Compose

로컬 개발에서 프로덕션까지 Git Push 한 번으로 자동 배포

프로젝트 구조

Monorepo 기반의 프론트엔드/백엔드 통합 프로젝트

project-structure
ax-project/
├── backend/
│   ├── app/
│   │   ├── main.py              # FastAPI 앱 진입점
│   │   ├── config.py            # 환경변수 설정
│   │   ├── database.py          # DB 엔진/세션
│   │   ├── models/              # SQLAlchemy 모델
│   │   ├── schemas/             # Pydantic 스키마
│   │   ├── routers/             # API 라우터
│   │   ├── services/            # 비즈니스 로직
│   │   └── middleware/          # 미들웨어
│   ├── alembic/                 # DB 마이그레이션
│   ├── Dockerfile
│   └── requirements.txt
├── frontend/
│   ├── src/
│   │   ├── app/                 # Next.js 페이지
│   │   ├── components/          # React 컴포넌트
│   │   └── lib/                 # API 클라이언트, 유틸
│   ├── Dockerfile
│   └── package.json
├── docker-compose.yml
└── README.md

Monorepo 장점

코드 공유, 일관된 린트/포맷 설정, 단일 PR로 프론트/백엔드 동시 변경 가능.

도구 선정 중

Turborepo, Nx 등 빌드 도구는 추후 확정 예정입니다.

개발 환경 설정

크로스 플랫폼 로컬 개발 환경 구축 가이드

1
Step 1 of 5

레포지토리 클론

모노레포 저장소를 로컬에 클론합니다.

  • Git 설치 확인 (git --version)
  • git clone <repository-url>
  • cd ax-project
2
Step 2 of 5

Node.js 환경 설정

프론트엔드 개발을 위한 Node.js 환경을 구성합니다.

  • Node.js 20+ 설치 (node --version)
  • cd apps/web && npm install
  • npm run dev (localhost:3000 확인)
3
Step 3 of 5

Python 환경 설정

백엔드 개발을 위한 Python 가상환경을 구성합니다.

  • Python 3.11+ 설치 (python --version)
  • cd apps/api && python -m venv venv && pip install -r requirements.txt
  • uvicorn main:app --reload (localhost:8000 확인)
4
Step 4 of 5

환경변수 설정

프로젝트에 필요한 환경변수를 설정합니다.

  • .env.example 파일을 .env.local로 복사
  • 필요한 API 키 및 DB 연결 정보 입력
  • 프론트/백엔드 각각의 .env 파일 확인
5
Step 5 of 5

개발 도구 설정

팀 표준 개발 도구와 확장 프로그램을 설치합니다.

  • VS Code 확장: ESLint, Prettier, Tailwind CSS IntelliSense, Python
  • ESLint/Prettier 설정 확인 (.eslintrc, .prettierrc)
  • Git hooks 설정 (pre-commit, commit-msg)
프론트엔드 localhost:3000, 백엔드 localhost:8000에서 확인하세요

코딩 컨벤션 & 워크플로우

AX 팀의 코딩 규칙과 개발 프로세스

commit-convention.md
# Git 커밋 컨벤션

## 커밋 메시지 포맷
<타입>: <제목>

<본문>

Related to: #Issue ID

## 타입 종류
- feat: 기능 추가
- fix: 버그 수정
- docs: 문서 수정
- refactor: 코드 리팩터링
- test: 테스트 추가/수정
- chore: 기타 변경
- build: 빌드/종속성 변경

## 브랜치 명명
- feature/<기능명>
- fix/<버그명>
- hotfix/<긴급수정>

## 예시
feat: 사용자 인증 API 추가

- JWT 기반 인증 미들웨어 구현
- 로그인/로그아웃 엔드포인트 생성

Related to: #42

PR 필수

모든 코드 변경은 Pull Request를 통해 리뷰 후 머지합니다.

자동 배포

main 브랜치 머지 시 Coolify가 자동으로 프로덕션 배포합니다.

배포 파이프라인

Git Push부터 프로덕션까지 완전 자동화된 배포 흐름

Step 1

Git Push

main 브랜치에 코드 머지

Step 2

Coolify Webhook

변경 감지 및 빌드 트리거

Step 3

Docker Build

컨테이너 이미지 빌드

Step 4

Production Deploy

프로덕션 배포 완료

배포 환경

  • AWS EC2 인스턴스
  • Coolify 셀프호스팅 PaaS
  • Let's Encrypt SSL 자동 발급

배포 설정

  • Docker Compose 멀티 서비스
  • 환경변수 UI 관리 (Coolify)
  • 자동 롤백 지원

온보딩 체크리스트

AX 팀 합류 후 확인해야 할 항목들을 체크하세요

진행률0 / 20 완료

개발 환경

레포지토리

팀 프로세스

접근 권한

문서 확인