How eryajf/xirang-ui works
Project type and purpose
• This repository is the frontend for the XiRang full-stack application. The backend lives in a separate Go/Gin+Gorm project; this is a Vue.js SPA (single-page application) that consumes those REST APIs, implements pages (login, dashboard, user/role management, etc.), and ships in a Docker container behind an HTTP server.
File structure
• Top-level config and build scripts:
• Dockerfile, default.conf (nginx-style config)
• babel.config.js, postcss.config.js, vue.config.js, build/* (custom Webpack/Vue CLI build)
• .env.* files for dev/staging/prod
• Public assets and HTML template: public/index.html
• Source code (src/):
• App.vue, main.js, router/, store/ (Vue Router + Vuex modules), permission.js (route guards)
• api/ directory: HTTP client wrappers and modules per domain (dashboards, system, example)
• components/, layout/, views/: component-based MVVM structure
• utils/, directive/, filters/: cross-cutting utilities, custom directives, and filters
• Tests: unit tests for components and utils under tests/unit/
README for additional insights
• The overall XiRang system is a simple web framework built with Gin (HTTP server) + Gorm (ORM) and MySQL.
• The frontend (this repo) is intended to be cloned alongside the backend and run via yarn dev on port 8090, forwarding API calls to the Go server.