Aislo/docs/wiki/index.md

type, last_updated

type	last_updated
index	2026-07-12

Wiki Index

질의 시 항상 이 파일을 먼저 확인한다. 카테고리별로 페이지를 한 줄 요약과 함께 나열한다 (120자 이내).

페이지 — 로그인 후 워크플로우 (B01~B09)

B01_Dashboard/B01_backend

역할별 프로젝트·회사·사용자·가입·자동화 관리와 workflow 배치조회, 시스템 리소스·감사 로그. draft.

B02_ProjRegister/B02_backend

프로젝트 생성 POST /api/b02/project. 트랜잭션: projects INSERT+워크플로우 7단계 시드+감사로그+저장소 초기화. stable.

B03_FileInput/B03_backend

일반·청크 업로드, 메타데이터 분석, WF0/WF1 상태 전이, 이메일 알림과 workflow 조회. draft.

B04_wf1_Surface/B04_backend

지표면 분석 /api/projects 12개 API. LAS→필터4종→모델5종→등고선. three.js 3D 뷰어 구현됨. WF1 stage 전이. stable.

B05_wf2_Route/B05_backend

Dijkstra·ridge-valley 경로 계산, 비용면·skeleton·통계 저장과 route 확정 API. WebCAD 뷰어 미구현. draft.

B06_wf3_ProfileCross/B06_backend

확정 경로 기반 종단·횡단 생성, 표고 sampler·측점 샘플링·결과 확정 API. WebCAD 프로필 뷰어 미구현. draft.

B07_wf4_DesignDetail/B07_frontend

구조물 배치 — 워크플로우 셸만 존재(26줄), 본문 미구현. migration_plan.md에 범위제외 명시(계획적 미착수). stable.

B08_wf5_Quantity/B08_frontend

WF5 workflow 셸만 구현. 수량 계산 본문·Repository·Router/API 미구현. draft.

B09_wf6_Estimation/B09_frontend

견적·문서(Excel/PDF/DXF) 산출 — 워크플로우 셸만 존재(26줄), 본문 미구현. outputs/output_files 테이블 예정. stable.

페이지 — 로그인 전 (A01~A09)

A01_Home/A01_frontend

히어로 + 최신 소식 + 주요 기능 showcase. 정적 페이지. MOCK_NEWS 하드코딩(GET /api/a01/news 미구현). stable.

A02_ProgDetail/A02_frontend

6단계 워크플로우 시각화 + 핵심 기술 소개. Hero + 배지번호 리스트 + 카드그리드. stable.

A03_CompDetail/A03_frontend

회사 미션·핵심가치·연락처. Hero + 본문 + 3개 가치 카드그리드 + 이메일. stable.

A04_NewsHistory/A04_frontend

최신소식 및 개선이력 타임라인. Hero + 태그+제목+날짜 행들. MOCK_HISTORY 데이터, 백엔드 미구현. stable.

A05_EduDetail/A05_frontend

교육 과정 소개 + 문의 CTA. Hero + 3개 과정 카드그리드 + 문의 버튼. stable.

A06_Login/A06_backend

세션쿠키 로그인 + 신규브라우저/주기 OTP 재인증. /api/auth 5개 엔드포인트. backend·frontend 상세. stable.

A07_Register/A07_backend

회원가입 2단계(요청→OTP)+회사검색. 약관 아코디언, NO_COMPANY로 완료. ⚠️UI_Page.ts 구버전 잔재. stable.

A08_Support/A08_backend

기술지원 문의(비로그인 가능). support_requests 저장+관리자 메일. ⚠️DB 컬럼 계획서와 불일치. stable.

A09_Security/A09_backend

백엔드: 마스터/시스템관리자 조직·회원·가입승인·활동로그 API(/api/security). 프론트: 약관 열람만. ⚠️API 클라이언트 미연동. stable.

개념 (Concepts)

a00_app_shell_framework

모든 페이지의 공통 스켈레톤. 헤더(로고/네비/언어·테마/인증), 아울렛, 푸터 + 라우터 + B그룹 스캐폴드.

a00_app_shell_framework_scaffold

App Shell Framework의 세부 스캐폴드, CSS 인젝션 구조, 외부 라이브러리 및 사용처 매핑.

ui_templates

다국어 관리(i18n [한국어, 영어]), 공통 컴포넌트(버튼/카드/태그/워크플로우셸), theme.css 변수.

DB 스키마

• db_schema/overview — 34개 테이블 확정; workflow 상태 및 system_admin_logs 용도 분석 완료.
• db_schema/users_auth — users/companies/sessions/email_otps/trusted_devices/join_requests/user_consents
• db_schema/logs_monitoring — login_logs/activity_logs/audit_logs/system_audit_logs/system_admin_logs/system_resources/support_requests/change_logs
• db_schema/projects — projects/project_versions/project_automations
• db_schema/files_surface — upload_sessions/upload_chunks/input_files/processed_point_cloud/surface_models/terrain_layers
• db_schema/route_profile — routes/route_points/route_statistics/longitudinal_sections/cross_sections
• db_schema/structure_output — structures/quantity_items/outputs/output_files
• db_schema/unconfirmed/README — 미확정/미연동 테이블 격리 및 임시 분석 보관소

auth_rbac

세션쿠키 인증, OTP, 3역할 RBAC 접근표, 권한헬퍼 5종, 사용자 상태 생명주기.

storage_paths

B03~B09 워크플로우 기반 storage/ 경로 패턴, DB 경로컬럼 매핑, 경로 생성 책임 분리 원칙.

common_util

common_util_* 11개 파일 목록과 역할 (auth/storage/email/resource_monitor/workflow_state 등).

API 공통 (여러 페이지가 공유하는 엔드포인트)

• api_common — 공통 오류포맷, workflow-state API(✅구현·실사용 확인)

의존성 (여러 페이지가 공유하는 외부 라이브러리)

• dependencies — Trimesh/Whitebox/Geopandas/Shapely/Rasterio/Laspy/aiomysql 사용처 매핑

공통 스키마 (Pydantic 요청/응답 모델)

• schema_common — 공통 에러 포맷 {"status":"error","message":...}. 페이지 간 공유 모델은 미발견.

Workflow 상태 관리

• workflow_state — B01~B06 연동 확인, project_workflow_stages SSOT·stale 전파. B04 폴백은 레거시 안전장치.

⚠️ 미해결 항목

• raw/guidelines/design.md는 "Wiza"(보라색 SaaS 프로덕트) 스타일 가이드로 Aislo와 무관해 보여 ingest하지 않음 — 잘못 들어온 파일인지 확인 필요
• B04_wf1_Surface_Router.py:412-427 — projects.status 문자열 비교(416 WF1_COMPLETE, 420 WF1_ANALYZING)는 구형 잔재가 아니라 project_workflow_stages 부재 시 레거시 폴백(백필 안전장치). SSOT 안정화 후 제거 가능 → B04_wf1_Surface/B04_backend
• B04_wf1_Surface_Router.py:76 update_project_status() — 정의만, 호출처 없음(죽은 코드) → 정리 권장
• B07~B09는 실 코드 상 아직 미착수 또는 셸만 존재 (B02는 backend 확인·반영 완료, B04도 이번에 5분할 상세화 완료)

A그룹 인제스트 이슈

• 세션·OTP 정책 불일치, support_requests 컬럼 불일치, A07/A09 구버전 코드가 발견됨. 상세는 각 페이지와 auth_rbac 참조.
• support_requests 컬럼 불일치: db_schema/logs_monitoring 계획서(user_id/title/priority/status) vs 실 코드(A08_Support/A08_backend INSERT: company_id/company_name/user_name/user_email/user_phone/subject/message). → 실 DB 대조 필요
• 미사용/구버전 코드 2건: A07_Register_UI_Page.ts(구버전 잔재, 라우터는 UI_Auth_Page 사용), A09_Security_Api_Fetch.ts(마스터/관리자 8함수 정의만, 미연동) — 정리 권장