How mc-team-two/altspace works
Project type and purpose
• This is a full-stack web application for a space-rental platform (“Alt Space”) with two Gradle modules:
• admin – the host/administrator portal
• client – the guest/public portal
• Both modules use Spring Boot (MVC + MyBatis), JSP/HTML/CSS/JS for views, MySQL for persistence, and integrate with external services (AI, email, OAuth2, WebSocket).
File structure
• Top-level modules:
• admin/ – host portal (DTO, repository, service, controller, config, util, static assets, JSP views)
• client/ – guest portal (similar layered structure, plus RESTful controllers, AI/Chatbot integration)
• Shared patterns:
• Layered MVC: controllers → services → repositories (MyBatis mappers) → MySQL
• Configuration packages for security, mail, WebSocket, locale, file upload
• Static resources under src/main/resources/static and JSP views under src/main/webapp/views
• Build & deploy: Gradle wrapper, application-*.yml, Naver Cloud Platform
README
• Confirms tech stack: Java, Spring Boot, MyBatis, JSP, Bootstrap, MySQL, Gemini AI, NCP
• Shows high-level UI flow, service flow, and ERD
• External integrations: OAuth2 (Google/Kakao/Naver), Papago, Gemini AI
a. Main components
• Frontends:
– Client UI (JSP/HTML/JS/CSS) served by ClientApplication
– Admin UI (static assets + JSP) served by AdminApplication
• Backend services (two Spring Boot applications)
• Database: MySQL (single or separate schemas for admin/client)
• External services:
– OAuth2 providers (Google, Kakao, Naver)
– Email SMTP service
– Gemini AI API
– Papago translation API
• WebSocket broker for real-time messaging (StompWebSocketConfig)
b. Relationships and interactions
1. User → UI (browser)
2. UI → Spring Boot controller (MVC or REST API)
3. Controller → Service layer → Repository (MyBatis mapper) → MySQL
4. Service layer may call external APIs (AI, translation, email, OAuth2)
5. For notifications/chat, WebSocket channel broadcasts via Spring’s message broker
c. Architectural patterns & principles
• Layered architecture (presentation, business, data)
• Separation of concerns: two distinct modules for host vs guest
• MyBatis for data mapping, DTOs to isolate domain objects
• Config-driven security (OAuth2, JWT if any), internationalization, file upload
• Externalization of environment: application-dev/server.yml
d. Key technologies/frameworks
• Spring Boot (MVC, Security, WebSocket)
• MyBatis (mapper XML under resources/mapper)
• JSP + Bootstrap + custom JS/CSS
• MySQL on NCP
• Gemini AI, Papago
• OAuth2 (Google/Kakao/Naver)