How dbtkdfhr/hwalro works
HWALRO supports pre-opening safety review of pop-up, exhibition, and event spaces. The main workflow registers a review, creates a drawing and layout, configures and runs an evacuation simulation, then analyzes results; users can compare layouts and create a report from simulation results. Separate work areas manage risks, safety checklists, and regulations. The README documents product stages and service responsibilities; sampled source confirms selected authentication, simulation, safety-check, and regulation behavior, but does not expose every route or service-to-service connection.
Main entry points: App.tsx Web application · SimulationService.java Simulation service · SimulationResultPage.tsx Result analysis · LayoutPage.tsx Drawings and layouts
Components 22
User application
- Web application
apps/frontend/src/App.tsx - Review dashboard
apps/frontend/src/features/home/hooks/useHomeDashboard.ts
Identity and access
- Sign-in and access
apps/frontend/src/features/auth/context/AuthContext.tsx - Authentication service
apps/auth-service/src/main/java/com/hwalro/auth/auth/AuthService.java - User and roles
apps/auth-service/src/main/java/com/hwalro/auth/domain/User.java
Review and simulation
- Drawings and layouts
apps/frontend/src/features/layout/pages/LayoutPage.tsx - Simulation setup
apps/frontend/src/features/simulations/pages/SimulationSetupPage.tsx - Simulation service
apps/simulation-service/src/main/java/com/hwalro/simulation/simulation/service/SimulationService.java - Drawing service
apps/simulation-service/src/main/java/com/hwalro/simulation/drawing/service/DrawingService.java - Evacuation engine
apps/simulation-service/src/main/java/com/hwalro/simulation/simulation/engine/SimulationEngineRunner.java - Result analysis
apps/frontend/src/features/simulationResult/pages/SimulationResultPage.tsx - Layout search
apps/simulation-service/src/main/java/com/hwalro/simulation/search/service/LayoutSearchQueryService.java - Improvement proposals
apps/simulation-service/src/main/java/com/hwalro/simulation/improvement/service/ImprovementProposalQueryService.java - Evacuation preview
apps/simulation-service/src/main/java/com/hwalro/simulation/zone/service/EvacuationPreviewService.java
Safety operations
- Risk management
apps/regulation-service/src/main/java/com/hwalro/regulation/risk/service/RiskService.java - Safety checklists
apps/regulation-service/src/main/java/com/hwalro/regulation/safetycheck/service/SafetyCheckService.java
Laws and reporting
- Regulation browser
apps/frontend/src/pages/RegulationsPage.tsx - Regulation lookup
apps/regulation-service/src/main/java/com/hwalro/regulation/law/service/RegulationService.java - External law API
apps/regulation-service/src/main/java/com/hwalro/regulation/law/api/LawApiClient.java - Reports and AI drafts
apps/regulation-service/src/main/java/com/hwalro/regulation/report/service/ReportService.java - AI draft generator
apps/regulation-service/src/main/java/com/hwalro/regulation/report/ai/OpenAiReportDraftGenerator.java
Other components
- Operator
Connections 21
- Operator → Web application: uses
README.md - Web application → Sign-in and access: signs in
README.md - Sign-in and access → Authentication service: authenticates
README.md - Authentication service → User and roles: loads user
apps/auth-service/src/main/java/com/hwalro/auth/auth/AuthService.java - Web application → Review dashboard: opens review
README.md - Review dashboard → Drawings and layouts: registers layout
README.md - Drawings and layouts → Simulation setup: sets conditions
README.md - Simulation setup → Simulation service: runs simulation
README.md - Simulation service → Drawing service: uses drawings
- Simulation service → Evacuation engine: executes model
apps/simulation-service/src/main/java/com/hwalro/simulation/simulation/service/SimulationService.java - Simulation service → Result analysis: provides results
README.md - Result analysis → Layout search: compares layouts
README.md - Result analysis → Improvement proposals: reviews proposals
- Drawings and layouts → Evacuation preview: previews routes
- Web application → Risk management: manages risks
README.md - Web application → Safety checklists: records checks
README.md - Web application → Regulation browser: browses laws
README.md - Regulation browser → Regulation lookup: searches laws
README.md - Regulation lookup → External law API: fetches law data
apps/regulation-service/src/main/java/com/hwalro/regulation/law/service/RegulationService.java - Result analysis → Reports and AI drafts: starts report
README.md - Reports and AI drafts → AI draft generator: generates draft