# shadowings-zy/trainticketssystem architecture

> Architecture diagram of the GitHub repository shadowings-zy/trainticketssystem, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shadowings-zy/trainticketssystem
- Repository: https://github.com/shadowings-zy/trainticketssystem

## Overview

##### Project type and purpose
- This is a full-stack web application (a train-ticket reservation system) developed as a database course project.
- Front-end: React single-page application (SPA) that provides user, train, and order management views.
- Back-end: Java + SpringMVC hosted on Tomcat, exposing JSON REST endpoints (/register, /login, /lockSeat, etc.).
- Database: MySQL stores users, trains, seats, orders.

##### File structure
- Top level:
- train-tickets-front-end (React app with src/, public/, build/)
- train-tickets-back-end (Eclipse web project with src/, WebContent/, build/, ImportedClasses/)
- Front-end: standard React directory structure—components, pages, router, tools.
- Back-end: SpringMVC pattern—src/controller (controllers), src/model (DAOs + JDBC templates + domain objects), src/tools (helper classes), Beans.xml for Spring config. WebContent/ holds JSP, static assets, WEB-INF/lib (Spring & JDBC driver jars), web.xml.
- DB scripts: “火车票售票系统重点sql.txt” outlines key schema & queries.

##### README for additional insights
- Tech stack: Java, JSP, CSS, JavaScript, SpringMVC, React, MySQL, Tomcat 8.
- Interaction: JSON over HTTP.
- Deployment: build React → WebContent/, package back-end as WAR → Tomcat, endpoints accessed at /TrainTickets/xxx.

##### Elements
- Blue for front-end (React SPA)
- Green for back-end (SpringMVC layers)
- Orange for database (MySQL)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client (Browser)" 
        direction TB
        Client["Browser / React SPA"]:::frontend
        subgraph "React SPA" 
            direction TB
            Router["Router (React Router)"]:::frontend
            subgraph "Pages" 
                direction TB
                Login["Login View"]:::frontend
                Register["Register View"]:::frontend
                TrainPage["Train Management"]:::frontend
                OrderPage["Order Management"]:::frontend
                UserPage["User Management"]:::frontend
            end
            Components["Shared UI Components"]:::frontend
            Tools["HTTP & Utility Tools"]:::frontend
        end
    end

    %% Server Layer
    subgraph "Web Server (Tomcat 8)" 
        direction TB
        Static["Static Assets (React Build)"]:::backend
        subgraph "SpringMVC Application" 
            direction TB
            subgraph "Controllers" 
                direction TB
                UC["UserController"]:::backend
                TC["TrainController"]:::backend
                OC["OrderController"]:::backend
            end
            subgraph "DAO Layer (JdbcTemplate)" 
                direction TB
                UserDAO["UserDAO"]:::backend
                UserJDBC["UserJDBCTemplate"]:::backend
                TrainDAO["TrainDAO"]:::backend
                TrainJDBC["TrainJDBCTemplate"]:::backend
                OrderDAO["OrderDAO"]:::backend
                OrderJDBC["OrderJDBCTemplate"]:::backend
            end
            subgraph "Domain Models" 
                direction TB
                UserModel["User.java"]:::backend
                TrainModel["Train.java"]:::backend
                OrderModel["Order.java"]:::backend
            end
            Beans["Beans.xml"]:::backend
            WebXML["web.xml"]:::backend
        end
    end

    %% Database Layer
    MySQL["MySQL Database"]:::db
    SQL["DB Schema & Queries"]:::db

    %% Connections
    Client -->|"Loads SPA"| Static
    Client -->|"HTTP/JSON Requests"| UC
    UC -->|"calls DAO"| UserDAO
    UC -->|"calls DAO"| TrainDAO
    UC -->|"calls DAO"| OrderDAO
    UserDAO -->|"SQL Queries"| MySQL
    TrainDAO -->|"SQL Queries"| MySQL
    OrderDAO -->|"SQL Queries"| MySQL

    %% Click Events
    click Client "https://github.com/shadowings-zy/trainticketssystem/tree/master/train-tickets-front-end/src"
    click Router "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-front-end/src/router/Router.js"
    click Login "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-front-end/src/pages/login-register-page/Login.js"
    click Register "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-front-end/src/pages/login-register-page/Register.js"
    click TrainPage "https://github.com/shadowings-zy/trainticketssystem/tree/master/train-tickets-front-end/src/pages/train-page"
    click OrderPage "https://github.com/shadowings-zy/trainticketssystem/tree/master/train-tickets-front-end/src/pages/order-page"
    click UserPage "https://github.com/shadowings-zy/trainticketssystem/tree/master/train-tickets-front-end/src/pages/user-page"
    click Components "https://github.com/shadowings-zy/trainticketssystem/tree/master/train-tickets-front-end/src/components"
    click Tools "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-front-end/src/tools/Tools.js"
    click UC "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/controller/UserController.java"
    click TC "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/controller/TrainController.java"
    click OC "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/controller/OrderController.java"
    click UserDAO "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/model/user/UserDAO.java"
    click UserJDBC "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/model/user/UserJDBCTemplate.java"
    click TrainDAO "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/model/train/TrainDAO.java"
    click TrainJDBC "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/model/train/TrainJDBCTemplate.java"
    click OrderDAO "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/model/order/OrderDAO.java"
    click OrderJDBC "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/model/order/OrderJDBCTemplate.java"
    click UserModel "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/model/user/User.java"
    click TrainModel "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/model/train/Train.java"
    click OrderModel "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/model/order/Order.java"
    click Beans "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/src/Beans.xml"
    click WebXML "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/WebContent/WEB-INF/web.xml"
    click Static "https://github.com/shadowings-zy/trainticketssystem/tree/master/train-tickets-back-end/WebContent/static"
    click SQL "https://github.com/shadowings-zy/trainticketssystem/blob/master/train-tickets-back-end/火车票售票系统重点sql.txt"

    %% Styles
    classDef frontend fill:#bbdefb,stroke:#1e88e5,color:#0d47a1
    classDef backend fill:#c8e6c9,stroke:#43a047,color:#1b5e20
    classDef db fill:#ffe0b2,stroke:#fb8c00,color:#e65100
```
