본 프로젝트는 카카오임팩트 테크포임팩트 프로그램을 통해 개발되었습니다.

전동보장구(전동휠체어, 전동스쿠터 등)의 수리는
① 종이문서, 구두 전달 위주로 이루어지고 있고
② 수리 이력이 기관, 사용자, 수리기사 간에 공유되지 않으며
③ 수리 내역이 축적되지 않아 반복적인 고장이 발생하고 있음.

결과적으로 이동권 침해, 복지예산 비효율, 책임소재 불분명 등의 문제가 발생하고 있음.

수리수리 마수리는 다음과 같은 해결책을 제공합니다:

• QR 코드를 통해 장비 고유 식별 및 수리 이력 조회
• 사용자 / 수리기사 / 기관 관리자 각각의 관점에서 설계된 화면
• 수리 항목 체크 → 수리일자 자동기록 → 복지관 통계 연동
• 수리비 예산 산정 및 보증 여부 확인 가능

수리기사의 사용 편의성을 높이기 위해 기록 부담 최소화,
사용자에게는 직관적인 이력 확인 UI 제공

• 사용자: 내 장비의 QR코드를 스캔해 수리이력 조회
• 수리기사: QR을 스캔하여 수리 항목 체크 → 자동 저장
• 복지관: 전체 통계 조회 및 Excel 다운로드 기능 제공 예정
• 장비별 이력은 MongoDB에 저장되며, 각 역할별 권한에 따라 접근이 제한됨

• Frontend: Flutter Web + Firebase Hosting
• Backend: Next.js App Router + MongoDB
• Authentication: Firebase 전화번호 기반 SMS 인증
• Device Recognition: uuidv4 기반 QR 코드 생성
• Deploy: 자체 서버 (AWS 이전 계획)

• ✅ 수리 내역 입력 및 저장 기능 구현
• ✅ QR 스캔 및 장비별 이력 확인 기능
• ✅ 인증 및 권한 분리 구현
• ✅ 복지관과 연계하여 전동보장구 테스트 사용자 확보, QR 이미지 생성 및 스티거 제작
• 🔄 복지관 실사용 테스트 및 피드백 반영 중
• 🔄 별따러가자 프로젝트와 연계 예정 (사고 감지 → 수리 연동)

• 성동장애인종합복지관
• 별따러가자

(주)별따러가자는 AIoT 기반 모빌리티 안전 솔루션 기업으로,
운전 습관 분석, 사고 탐지 및 검증 모델, 사회적 비용 절감을 위한 기술을 개발 중입니다.

전동보장구, 이륜차, 농기계 등 다양한 이동수단에 부착 가능한 모션 센서를 통해
운전자의 안전 점수 제공, 사고 경중 판단, 도난 알림 등의 기능을 제공합니다.

2023~2024년 충남 예산군 시범사업에서 실사고 6건 전부 탐지,
사고 재확인 모델의 100% 정확도를 입증했습니다.

현재 수리이력 관리 시스템과 사고 탐지 시스템 간 연계를 위한 사전 인프라 통합 중이며,
장비 고장 ↔ 사고 이력 간 상관관계 분석까지 발전시킬 계획입니다.

• 수리 빈도 기반 부품 수명 예측 기능 개발
• 사용자 대시보드 시각화
• 복지 예산 자동 집계 기능 추가
• 공개 API 제공 및 타 기관 확산 검토

모든 API는 Firebase 로그인 이후에만 사용할 수 있습니다. 각 요청은 "사용자가 누굴까?"를 확인하기 위해 로그인 정보가 필요합니다.

• 주소: /auth/role
• 방식: GET
• 설명: 로그인한 사용자의 역할(role)을 알려줍니다.
• 성공 예시:

{ "role": "user" }

• 실패 상황: 로그인 정보가 잘못되었거나, 사용자가 존재하지 않음

• 주소: /users/{vehicleId}
• 방식: POST
• 설명: 사용자를 새로 등록하고, vehicleId에 해당되는 차량과 연결합니다.
• 필수 정보 (Body 안에 포함):
  • 이름(name)
  • 차량 모델명(model)
  • 구매일자(purchasedAt) → 예: "2024-01-10T00:00:00.000Z"
  • 등록일자(registeredAt)
  • 수신자 유형(recipientType) → 예: "user"
• 성공 예시:

{ "userId": "...", "name": "홍길동", "phoneNumber": "01012345678", "role": "user", "recipientType": "user", "vehicleId": "abcd-1234" }

• 실패 상황:
  • 해당 차량이 존재하지 않음
  • 이미 해당 차량은 누군가가 등록함
  • 이미 사용자로 등록된 전화번호임
  • 로그인 정보가 유효하지 않음

• 주소: /vehicles/{vehicleId}
• 방식: GET
• 설명: 차량에 연결된 사용자 정보와 기본 차량 정보를 확인합니다. vehicleId를 제외한 항목들이 비어있다면 주인없는 vehicle
• 성공 예시:

{ "userId": "사용자 ID", "vehicleId": "abcd-1234", "model": "휠체어 3000", "purchasedAt": "2024-01-10T00:00:00.000Z", "registeredAt": "2024-02-10T00:00:00.000Z" }

• 실패 상황:
  • 차량 ID가 잘못됨
  • 로그인한 사람이 해당 차량의 주인이 아님

• 주소: /repairs/{vehicleId}
• 방식: GET
• 설명: 차량의 모든 수리 내역을 가져옵니다. 가장 최근 수리가 먼저 나옵니다.
• 성공 예시:

[ { "repairer": "홍수리기사", "repairStationCode": "ST01", "repairStationLabel": "강남수리센터", "repairedAt": "2024-12-12T00:00:00.000Z", "billingPrice": 15000, "isAccident": false, "repairCategories": ["타이어", "기타"], "batteryVoltage": 36.5, "etcRepairParts": "배터리 교체", "memo": "비상 수리" } ]

• 실패 상황:
  • 차량 ID가 잘못됨
  • 로그인한 사람이 해당 차량의 주인이 아님
  • 로그인 정보가 유효하지 않음

• 주소: /repairs/{vehicleId}
• 방식: POST
• 설명: 차량의 새로운 수리 정보를 등록합니다.
• 필수 정보:
  • 수리자 이름 (repairer)
  • 수리일자 (repairedAt)
  • 수리비 (billingPrice)
  • 사고 여부 (isAccident: true/false)
  • 수리 항목 목록 (repairCategories: 예: ["타이어", "기타"])
  • 배터리 전압 (batteryVoltage) -- "배터리" 가 수리 항목 목록에서 선택되었을 경우
  • 기타 수리내역 -- "기타" 가 수리 항목 목록에서 선택되었을 경우
  • 메모 (memo, 선택)
• 성공 예시:

{ "_id": "자동생성된수리ID", ... }

• 실패 상황:
  • 필수 항목이 빠졌거나 형식이 틀림
  • 수리자가 아님
  • 서버 오류

• 주소: /repair-stations
• 방식: GET
• 설명: 전국 수리센터의 목록을 가져옵니다. 위치 좌표도 포함되어 있어 지도에 표시할 수 있습니다. (state: 도, city: 시, region: 구)
• 성공 예시:

{ "stations": [ { "code": "ST01", "state": "서울", "city": "서울", "region": "강남구", "address": "서울시 강남구 테헤란로 123", "label": "강남보장구수리센터", "telephone": "02-1234-5678", "coordinate": [127.12345, 37.12345] } ] }

• 실패 상황:
  • 서버 오류

• 모든 API 요청은 로그인 후 발급된 토큰을 사용해야 합니다.
• 예시:

Authorization: Bearer <로그인한 사용자 토큰>

• 브라우저에서는 자동 처리되며, 외부에서 테스트할 경우 위의 형식을 헤더에 추가합니다.

MongoDB (Mongoose) 기반 데이터 모델 설명. 각 모델은 /lib/db/models/ 디렉토리에 정의되어 있음.

• timestamps: true createdAt, updatedAt 관리를 위함
• versionKey: false mongoose의 버전. package.json에서 확인 가능하므로 불필요한 field

Collection: users
File: Users.js

Collection: vehicles
File: Vehicles.js

Collection: repairs
File: Repairs.js

Collection: repairstations
File: RepairStations.js

• { coordinate: '2dsphere' } for geo queries

Collection: guardians
File: Guardians.js

Users ---< Vehicles
Users ---< Guardians
Vehicles ---< Repairs
Repairs >--- RepairStations (code/label only, not ObjectId)

• One User can own multiple Vehicles
• One Vehicle can have multiple Repairs
• One User can have multiple Guardians
• Repairs reference RepairStation via repairStationCode/label (not strict ObjectId)

lib/
└── db/
    ├── connect.js
    ├── models/
    │   ├── Users.js
    │   ├── Vehicles.js
    │   ├── Repairs.js
    │   ├── RepairStations.js
    │   ├── Guardians.js
    │   └── index.js