--- type: index last_updated: 2026-07-12 --- # Wiki Index > 질의 시 항상 이 파일을 먼저 확인한다. 카테고리별로 페이지를 한 줄 요약과 함께 나열한다 (120자 이내). ## 페이지 — 로그인 후 워크플로우 (B01~B09) ### [[B01_Dashboard/B01_backend|B01_Dashboard]] 역할별 프로젝트·회사·사용자·가입·자동화 관리와 workflow 배치조회, 시스템 리소스·감사 로그. draft. ### [[B02_ProjRegister/B02_backend|B02_ProjRegister]] 프로젝트 생성 `POST /api/b02/project`. 트랜잭션: projects INSERT+워크플로우 7단계 시드+감사로그+저장소 초기화. stable. ### [[B03_FileInput/B03_backend|B03_FileInput]] 일반·청크 업로드, 메타데이터 분석, WF0/WF1 상태 전이, 이메일 알림과 workflow 조회. draft. ### [[B04_wf1_Surface/B04_backend|B04_wf1_Surface]] 지표면 분석 `/api/projects` 12개 API. LAS→필터4종→모델5종→등고선. three.js 3D 뷰어 구현됨. WF1 stage 전이. stable. ### [[B05_wf2_Route/B05_backend|B05_wf2_Route]] Dijkstra·ridge-valley 경로 계산, 비용면·skeleton·통계 저장과 route 확정 API. WebCAD 뷰어 미구현. draft. ### [[B06_wf3_ProfileCross/B06_backend|B06_wf3_ProfileCross]] 확정 경로 기반 종단·횡단 생성, 표고 sampler·측점 샘플링·결과 확정 API. WebCAD 프로필 뷰어 미구현. draft. ### [[B07_wf4_DesignDetail/B07_frontend|B07_wf4_DesignDetail]] 구조물 배치 — 워크플로우 셸만 존재(26줄), 본문 미구현. migration_plan.md에 범위제외 명시(계획적 미착수). stable. ### [[B08_wf5_Quantity/B08_frontend|B08_wf5_Quantity]] WF5 workflow 셸만 구현. 수량 계산 본문·Repository·Router/API 미구현. draft. ### [[B09_wf6_Estimation/B09_frontend|B09_wf6_Estimation]] 견적·문서(Excel/PDF/DXF) 산출 — 워크플로우 셸만 존재(26줄), 본문 미구현. outputs/output_files 테이블 예정. stable. ## 페이지 — 로그인 전 (A01~A09) ### [[A01_Home/A01_frontend|A01_Home]] 히어로 + 최신 소식 + 주요 기능 showcase. 정적 페이지. MOCK_NEWS 하드코딩(GET /api/a01/news 미구현). stable. ### [[A02_ProgDetail/A02_frontend|A02_ProgDetail]] 6단계 워크플로우 시각화 + 핵심 기술 소개. Hero + 배지번호 리스트 + 카드그리드. stable. ### [[A03_CompDetail/A03_frontend|A03_CompDetail]] 회사 미션·핵심가치·연락처. Hero + 본문 + 3개 가치 카드그리드 + 이메일. stable. ### [[A04_NewsHistory/A04_frontend|A04_NewsHistory]] 최신소식 및 개선이력 타임라인. Hero + 태그+제목+날짜 행들. MOCK_HISTORY 데이터, 백엔드 미구현. stable. ### [[A05_EduDetail/A05_frontend|A05_EduDetail]] 교육 과정 소개 + 문의 CTA. Hero + 3개 과정 카드그리드 + 문의 버튼. stable. ### [[A06_Login/A06_backend|A06_Login]] 세션쿠키 로그인 + 신규브라우저/주기 OTP 재인증. `/api/auth` 5개 엔드포인트. backend·frontend 상세. stable. ### [[A07_Register/A07_backend|A07_Register]] 회원가입 2단계(요청→OTP)+회사검색. 약관 아코디언, NO_COMPANY로 완료. ⚠️UI_Page.ts 구버전 잔재. stable. ### [[A08_Support/A08_backend|A08_Support]] 기술지원 문의(비로그인 가능). `support_requests` 저장+관리자 메일. ⚠️DB 컬럼 계획서와 불일치. stable. ### [[A09_Security/A09_backend|A09_Security]] 백엔드: 마스터/시스템관리자 조직·회원·가입승인·활동로그 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함수 정의만, 미연동) — 정리 권장