Skip to content
@projectcleanroom

깔끔한방

토이프로젝트로 시작합니다

깔끔한방

90

‘깔끔한 방’ 서비스 소개

  • '깔끔한 방' 은 사용자 친화적인 청소 중개 플랫폼입니다.
  • 이 플랫폼은 소비자가 청소 의뢰를 비대면으로 신청할 수 있습니다.
  • 청소업체는 소비자가 보낸 의뢰를 확인하고 견적을 작성, 발송해 줄 수 있습니다.
  • 소비자는 작성된 견적목록을 보고 비교분석 하여 원하는 청소업체를 선택할 수 있습니다.

프로젝트 기획 배경

기획배경

  • 청소 서비스 수요 증가

    • 저장 강박, 1인 가구 증가, 빈번한 이사와 같은 사회적 트렌드로 인해 청소 서비스에 대한 수요가 폭발적으로 증가하고 있습니다.
    • 특히 대학생들이나 자취생들이 방학마다 새로운 공간으로 이사할 때, 청소 서비스에 대한 필요성이 크게 대두되고 있습니다.
  • 사용자 불편 해결

    • 현재 시장에는 다양한 청소 서비스가 존재하지만, 업체를 쉽게 비교하고 선택할 수 있는 사용자 친화적 플랫폼이 부족합니다.
    • 이는 소비자들이 청소 서비스를 선택하는 데 많은 시간과 노력을 소비하게 만들며, 서비스 품질에 대한 신뢰성 문제도 있습니다.

사용자 문제 해결

  • 청소 중계 서비스 플랫폼의 부재

    • 현재까지 사용자들이 여러 청소 업체를 비교하고 선택하는 과정을 단순화한 어플리케이션이나 플랫폼은 부족한 상태입니다.
    • 따라서 청소 업체를 한곳에서 모아보고, 간편하게 예약하고 관리할 수 있는 솔루션이 필요합니다.
  • 신뢰성 및 품질 보장

    • 소비자들이 안심하고 청소 서비스를 이용할 수 있도록, 플랫폼에서 제공되는 서비스의 품질을 보장하고, 업체를 비교 분석하며 선택할 수 있는 기능을 제공해야 합니다.

Team Motivation

  • 개발자는 단순한 코더가 아닌 엔지니어입니다.
  • 엔지니어는 철저한 설계도를 작성하고, 그 설계도를 바탕으로 체계적인 엔지니어링을 실행합니다.
  • 우리는 테스트를 통해 품질을 보증하며, 그 결과로 만들어진 산출물은 단순한 결과물이 아니라
    지속적으로 발전시켜 나가야 할 자산입니다.
  • 우리는 설계를 더욱 정교하게 하고, 기술적 의사결정을 신중히 내리는 과정을 통해 고도화된 산출물을 만들어가겠습니다.
  • 설계를 잘하면, 더 나은 결과와 성공적인 프로젝트를 이끌 수 있습니다.

팀원 소개

Front-End

이대성 김성우
FE 팀장 FE 팀원
Github 링크 Github 링크

Back-End & DevOps

정시온 현정재 권하진 최윤지 천장희
BE 팀장 BE 팀원 BE 팀원 BE 팀원 DevOps 팀원
Github 링크 Github 링크 Github 링크 Github 링크 Github 링크

기술 스택

Frontend

Vite TypeScript React VSCode HTML5 CSS3 TailwindCSS Axios TanStack Query React Router

Backend

Spring Boot Java JMeter Lombok IntelliJ IDEA Gradle Spring Data JPA BCrypt Logback JUnit

DevOps & Database

Apache Tomcat MySQL AWS Prometheus Vercel Grafana Docker GitHub Actions Ubuntu Nginx

Collaboration & Tools

Swagger Canva ERD Gather Slack MobaXterm GitHub Notion Postman draw.io HeidiSQL

서비스 아키텍처

image (3) (1)

ERD

image (3) (2)

POC

프로젝트 설치 및 실행 가이드

이 가이드는 프로젝트의 백엔드와 프론트엔드 설치 및 실행 방법을 안내합니다.

사전 요구사항

  • Java: Zulu 17
  • Spring boot 3.3.2
  • Node.js: 22.9.0
  • MySQL

백엔드 설치 및 실행 (clean_back)

1. 저장소 클론 (clean_back: 고객 서버, clean_adm_back: 청소업체 서버)

git clone https://github.com/projectcleanroom/clean_back
cd clean_back
git clone https://github.com/projectcleanroom/clean_adm_back
cd clean_adm_back

2. 프로젝트 빌드

  • IDE: 프로젝트를 열고 빌드 옵션을 실행합니다.
  • 커맨드 라인을 사용하는 경우 아래의 명령어를 실행합니다.
./gradlew build

3. 애플리케이션 실행

  • IDE: 'Run' 버튼을 클릭하여 애플리케이션을 실행합니다.
  • 커맨드 라인을 사용하는 경우 아래의 명령어를 실행합니다.
./gradlew bootRun

프론트엔드 설치 및 실행 (clean_front)

1. 저장소 클론

git clone https://github.com/projectcleanroom/clean_front
cd clean_front

2. 의존성 설치

yarn install

3. 개발 서버 실행

yarn dev

환경설정

백엔드: application.properties 또는 application.yml 파일에서 데이터베이스 연결 정보를 설정합니다.
프론트엔드: .env 파일을 생성하고 필요한 환경 변수를 설정합니다.

API 키 및 비밀 정보

API 키와 같은 민감한 정보는 GitHub Secrets에 저장되어 있습니다.
로컬 개발 환경에서는 이 정보를 별도의 파일(예: .env)에 저장하고 .gitignore에 추가하여 관리하세요.

개발 팀원들과 안전하게 공유하려면
1.암호화된 채널(예: 암호화된 메신저, 보안 파일 공유 서비스)을 사용하세요.
2.각 개발자가 자신의 로컬 환경에 직접 설정하도록 안내하세요.

주의사항

  • 데이터베이스 스키마 및 초기 데이터 설정이 필요할 수 있습니다.
  • 백엔드와 프론트엔드의 개발 서버 주소가 일치하는지 확인하세요.

문제가 발생하거나 추가 도움이 필요한 경우 프로젝트 관리자에게 문의하세요.

License

MIT 라이센스

저작권 (c) 2024 Cleanroom

이 소프트웨어와 관련된 문서 파일(이하 "소프트웨어")의 사본을 취득하는 모든 사람에게,
소프트웨어를 제한 없이 사용할 수 있는 권한을 무료로 부여합니다.
여기에는 소프트웨어를 사용하는 권한, 복사, 수정, 병합, 게시, 배포, 서브라이센스,
그리고 소프트웨어의 사본을 판매하는 권한이 포함되며,
소프트웨어가 제공된 사람에게 이러한 권한을 허용하는 것도 포함됩니다.

다음 조건을 충족해야 합니다:

위의 저작권 표시와 이 허가 문구는 소프트웨어의 모든 복사본 또는 주요 부분에 포함되어야 합니다.
해당 소프트웨어는 "있는 그대로" 제공되며, 명시적이거나 묵시적인 어떠한 종류의 보증도 포함되지 않습니다.
여기에는 상업성, 특정 목적에 대한 적합성 및 비침해성에 대한 묵시적인 보증이 포함되지만 이에 국한되지 않습니다.
어떠한 경우에도 저작권자 또는 권리자는 소프트웨어나 이 소프트웨어의 사용 또는 기타 거래와 관련하여 발생하는
청구, 손해 또는 기타 책임에 대해 책임을 지지 않습니다.
이는 계약, 불법행위 또는 기타 행위로 인한 것일 수 있습니다.

바로가기 링크

Popular repositories Loading

  1. clean_front clean_front Public

    TypeScript 2

  2. clean_back clean_back Public

    Java

  3. clean_adm_back clean_adm_back Public

    Java

  4. .github .github Public

Repositories

Showing 4 of 4 repositories
  • clean_back Public
    projectcleanroom/clean_back’s past year of commit activity
    Java 0 0 11 0 Updated Dec 4, 2024
  • .github Public
    projectcleanroom/.github’s past year of commit activity
    0 0 0 0 Updated Dec 4, 2024
  • clean_front Public
    projectcleanroom/clean_front’s past year of commit activity
    TypeScript 0 2 4 0 Updated Sep 22, 2024
  • projectcleanroom/clean_adm_back’s past year of commit activity
    Java 0 0 3 0 Updated Sep 19, 2024

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…