diff --git a/.claude/settings.local.json b/.claude/settings.local.json index a4af320..40aacec 100644 --- a/.claude/settings.local.json +++ b/.claude/settings.local.json @@ -1,7 +1,22 @@ { "permissions": { "allow": [ - "Bash(mkdir:*)" + "Bash(mkdir:*)", + "Bash(grep:*)", + "Bash(rg:*)", + "Bash(npm run dev:*)", + "Bash(pkill:*)", + "Bash(ls:*)", + "Bash(find:*)", + "Bash(npm install:*)", + "Bash(rm:*)", + "Bash(git checkout:*)", + "Bash(npm run type-check:*)", + "Bash(npm run lint)", + "Bash(mv:*)", + "Bash(cp:*)", + "Bash(npm run:*)", + "Bash(git add:*)" ], "deny": [] } diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..9178b17 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,18 @@ +root = true + +[*] +charset = utf-8 +end_of_line = lf +insert_final_newline = true +trim_trailing_whitespace = true + +[*.{js,jsx,ts,tsx,vue}] +indent_style = space +indent_size = 2 + +[*.{json,yml,yaml}] +indent_style = space +indent_size = 2 + +[*.md] +trim_trailing_whitespace = false \ No newline at end of file diff --git a/.env.example b/.env.example index 6cb1eff..c0018c2 100644 --- a/.env.example +++ b/.env.example @@ -6,6 +6,9 @@ APP_DESCRIPTION="RustFS is a distributed file system written in Rust." # Admin API base URL API_BASE_URL=http://localhost:9000/rustfs/admin/v3 +# Console base URL +BASE_URL=/rustfs/console/ + # S3 API base URL S3_ENDPOINT=http://localhost:9000 diff --git a/.prettierignore b/.prettierignore new file mode 100644 index 0000000..7a45c3f --- /dev/null +++ b/.prettierignore @@ -0,0 +1,7 @@ +node_modules +dist +.nuxt +.output +.git +*.log +public \ No newline at end of file diff --git a/.prettierrc b/.prettierrc new file mode 100644 index 0000000..fa9a0b2 --- /dev/null +++ b/.prettierrc @@ -0,0 +1,12 @@ +{ + "semi": false, + "singleQuote": true, + "trailingComma": "es5", + "tabWidth": 2, + "useTabs": false, + "printWidth": 100, + "endOfLine": "lf", + "bracketSpacing": true, + "arrowParens": "avoid", + "vueIndentScriptAndStyle": false +} \ No newline at end of file diff --git a/LICENSE b/LICENSE index 9a3e2b5..941581d 100644 --- a/LICENSE +++ b/LICENSE @@ -1,21 +1,201 @@ -MIT License + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ -Copyright (c) 2024 rustfs + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: + 1. Definitions. -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright 2024 Beijing Henghesha Technology Co., Ltd. + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/README.md b/README.md index 88b33dc..d97d246 100644 --- a/README.md +++ b/README.md @@ -1,75 +1,349 @@ # RustFS Console -Look at the [Nuxt documentation](https://nuxt.com/docs/getting-started/introduction) to learn more. +[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE) +[![TypeScript](https://img.shields.io/badge/TypeScript-5.8+-blue.svg)](https://www.typescriptlang.org/) +[![Vue.js](https://img.shields.io/badge/Vue.js-3.5+-green.svg)](https://vuejs.org/) +[![Nuxt](https://img.shields.io/badge/Nuxt-3.17+-green.svg)](https://nuxt.com/) -## Setup +A modern, responsive web management console for RustFS distributed file system, built with Vue 3, Nuxt 3, and TypeScript. -Make sure to install dependencies: +## ✨ Features + +- 🚀 **Modern Stack**: Built with Vue 3, Nuxt 3, TypeScript, and Tailwind CSS +- 🎨 **Beautiful UI**: Clean and intuitive interface with dark mode support +- 🌍 **Internationalization**: Full i18n support with English and Chinese +- 📱 **Responsive Design**: Mobile-friendly design that works on all devices +- ⚡ **High Performance**: Optimized with caching, lazy loading, and code splitting +- 🔒 **Enterprise Security**: Secure authentication and authorization +- 📊 **Rich Analytics**: Comprehensive monitoring and metrics dashboard +- 🛠 **Developer Experience**: Hot reload, TypeScript, ESLint, and Prettier + +## 🎯 Core Functionalities + +### Storage Management +- **Bucket Operations**: Create, delete, configure buckets +- **Object Management**: Upload, download, delete objects with batch operations +- **File Browser**: Intuitive file explorer with search and filtering +- **Access Control**: Granular permissions and bucket policies + +### User & Access Management +- **User Management**: Create and manage users and groups +- **Access Keys**: Generate and manage API credentials +- **Policies**: Fine-grained access control policies +- **Authentication**: Multiple authentication methods (AccessKey, STS) + +### System Monitoring +- **Performance Metrics**: Real-time system performance monitoring +- **Usage Analytics**: Storage usage and bandwidth statistics +- **Health Monitoring**: System health and status indicators +- **Audit Logs**: Comprehensive audit trail and logging + +### Advanced Features +- **Lifecycle Management**: Automated data lifecycle policies +- **Replication**: Cross-region and site replication +- **Tiering**: Intelligent data tiering and archival +- **Encryption**: Data encryption at rest and in transit +- **Event Notifications**: Real-time event notifications + +## 🛠 Technical Stack + +- **Frontend Framework**: [Vue 3](https://vuejs.org/) with Composition API +- **Meta Framework**: [Nuxt 3](https://nuxt.com/) for SSR/SPA +- **Language**: [TypeScript](https://www.typescriptlang.org/) for type safety +- **Styling**: [Tailwind CSS](https://tailwindcss.com/) + [Naive UI](https://www.naiveui.com/) +- **State Management**: [Pinia](https://pinia.vuejs.org/) for reactive state +- **HTTP Client**: Custom AWS-compatible client with automatic signing +- **Build Tool**: [Vite](https://vitejs.dev/) for fast development and building +- **Package Manager**: npm/pnpm/yarn + +## 🚀 Quick Start + +### Prerequisites + +- Node.js 18+ +- npm/pnpm/yarn package manager +- RustFS backend server running + +### Installation ```bash -# npm +# Clone the repository +git clone https://github.com/your-org/rustfs-console.git +cd rustfs-console + +# Install dependencies npm install - -# pnpm +# or pnpm install - -# yarn +# or yarn install - -# bun -bun install ``` -## Development Server - -Start the development server on `http://localhost:3000`: +### Development ```bash -# npm +# Start development server npm run dev - -# pnpm +# or pnpm dev - -# yarn +# or yarn dev - -# bun -bun run dev ``` -## Production +The development server will start at `http://localhost:3000`. -Build the application for production: +### Environment Configuration + +Create a `.env` file in the root directory: + +```env +# Application Configuration +APP_NAME=RustFS +APP_DESCRIPTION=RustFS Console +BASE_URL=/rustfs/console/ + +# API Configuration +API_BASE_URL=http://localhost:9000/rustfs/admin/v3 +SERVER_HOST=http://localhost:9000 + +# S3 Configuration +S3_REGION=us-east-1 +S3_ENDPOINT=http://localhost:9000 + +# Session Configuration +SESSION_DURATION_SECONDS=43200 +``` + +### Production Build ```bash -# npm +# Build for production npm run build - -# pnpm +# or pnpm build - -# yarn +# or yarn build -# bun -bun run build +# Preview production build locally +npm run preview ``` -Locally preview production build: +## 🔧 Development + +### Project Structure + +``` +├── assets/ # Static assets (images, styles) +├── components/ # Vue components +│ ├── access-keys/ # Access key management +│ ├── buckets/ # Bucket operations +│ ├── object/ # Object management +│ ├── users/ # User management +│ └── ui/ # Reusable UI components +├── composables/ # Vue composables +├── layouts/ # Nuxt layouts +├── middleware/ # Route middleware +├── pages/ # File-based routing +├── plugins/ # Nuxt plugins +├── server/ # Server-side code +├── store/ # Pinia stores +├── types/ # TypeScript definitions +├── utils/ # Utility functions +└── nuxt.config.ts # Nuxt configuration +``` + +### Code Quality + +We maintain high code quality standards with: + +- **TypeScript**: Full type safety and better developer experience +- **ESLint**: Code linting and style enforcement +- **Prettier**: Automatic code formatting +- **Vue TSC**: Vue-specific TypeScript checking ```bash -# npm -npm run preview +# Run type checking +npm run type-check -# pnpm -pnpm preview +# Run linting +npm run lint -# yarn -yarn preview - -# bun -bun run preview +# Fix linting issues +npm run lint:fix ``` -Check out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information. +### Key Architecture Patterns + +- **Composables**: Reusable logic with Vue Composition API +- **Plugin System**: Modular configuration and service injection +- **Error Boundaries**: Comprehensive error handling and user feedback +- **Performance Optimization**: Smart caching, lazy loading, and code splitting +- **Security**: Input validation, XSS protection, and secure authentication + +## 🎨 Customization + +### Theming + +The application supports light and dark themes. Customize themes in: +- `assets/css/tailwind.css` - Tailwind configuration +- `tailwind.config.ts` - Theme colors and design tokens +- `components/theme-switcher.vue` - Theme switching logic + +### Internationalization + +Add new languages by: +1. Creating locale files in `i18n/locales/` +2. Updating `nuxt.config.ts` locales configuration +3. Adding language switcher options + +### Component Library + +Built on Naive UI with custom components in `components/ui/`. Extend the design system by: +- Adding new components to `components/ui/` +- Following established naming conventions +- Including proper TypeScript definitions + +## 🚀 Deployment + +### Docker Deployment + +```dockerfile +FROM node:18-alpine AS builder +WORKDIR /app +COPY package*.json ./ +RUN npm ci +COPY . . +RUN npm run build + +FROM node:18-alpine AS runtime +WORKDIR /app +COPY --from=builder /app/.output ./.output +EXPOSE 3000 +CMD ["node", ".output/server/index.mjs"] +``` + +### Environment Variables + +Production deployment requires these environment variables: + +- `API_BASE_URL`: RustFS backend API endpoint +- `SERVER_HOST`: RustFS server host +- `BASE_URL`: Application base path +- `NODE_ENV`: Set to `production` + +### Build Optimization + +For optimal production builds: +- Enable gzip/brotli compression +- Configure proper caching headers +- Use CDN for static assets +- Monitor bundle size and performance + +## 🤝 Contributing + +We welcome contributions! Please follow our contribution guidelines: + +### Development Workflow + +1. **Fork** the repository +2. **Clone** your fork locally +3. **Create** a feature branch: `git checkout -b feature/amazing-feature` +4. **Install** dependencies: `npm install` +5. **Make** your changes following our coding standards +6. **Test** your changes: `npm run type-check && npm run lint` +7. **Commit** your changes: `git commit -m 'feat: add amazing feature'` +8. **Push** to your branch: `git push origin feature/amazing-feature` +9. **Submit** a Pull Request + +### Coding Standards + +- **TypeScript**: Use TypeScript for all new code +- **Vue 3**: Use Composition API and ` - -
-
- -
-
-
- {{ serverConfig.protocol }}://{{ serverConfig.host }}:{{ serverConfig.port }} - {{ serverConfig.region }} -
- -
-
- - -
- -
- - - {{ t('Server Configuration') }} - - -
- - -
-
- {{ configAlert }} -
- -
-
- - -
{{ urlError }}
-
- -
- - -
-
-
-
-
-
-