{"id":21093835,"url":"https://github.com/s35241607/lan-side-project","last_synced_at":"2025-06-16T05:37:27.933Z","repository":{"id":262633909,"uuid":"887271191","full_name":"s35241607/lan-side-project","owner":"s35241607","description":"這是一個採用 前後端分離架構 的開源專案，致力於解決 [問題描述]，提供高效、現代化的解決方案。","archived":false,"fork":false,"pushed_at":"2025-04-08T13:44:28.000Z","size":11929,"stargazers_count":4,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-13T01:30:02.439Z","etag":null,"topics":["api","docker","dotnet-core","postgresql","side-project","vite","vue3"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/s35241607.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-12T13:10:55.000Z","updated_at":"2025-04-08T13:44:31.000Z","dependencies_parsed_at":"2024-12-17T14:30:18.161Z","dependency_job_id":"36a9ec78-8998-4421-a935-ae147e024dfe","html_url":"https://github.com/s35241607/lan-side-project","commit_stats":null,"previous_names":["s35241607/lan-side-project"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s35241607%2Flan-side-project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s35241607%2Flan-side-project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s35241607%2Flan-side-project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/s35241607%2Flan-side-project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/s35241607","download_url":"https://codeload.github.com/s35241607/lan-side-project/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248654045,"owners_count":21140236,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","docker","dotnet-core","postgresql","side-project","vite","vue3"],"created_at":"2024-11-19T22:12:59.954Z","updated_at":"2025-04-13T01:30:50.580Z","avatar_url":"https://github.com/s35241607.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **Lan side project**\n\n![license](https://img.shields.io/github/license/s35241607/lan-side-project.svg)\n![issues](https://img.shields.io/github/issues/s35241607/lan-side-project.svg)\n![issues-pr](https://img.shields.io/github/issues-pr/s35241607/lan-side-project.svg)\n\n這是一個採用 **前後端分離架構** 的開源專案，致力於解決 [問題描述]，提供高效、現代化的解決方案。\n\n-   前端使用 [Vite](https://vitejs.dev/) 與 [Vue 3](https://vuejs.org/)，實現快速且高效的單頁應用。\n-   後端基於 [C# .NET 8](https://learn.microsoft.com/en-us/dotnet/) 開發，提供穩定且安全的 API。\n-   資料庫使用 [PostgreSQL](https://www.postgresql.org/)，保證資料一致性與高性能。\n\n---\n\n## **目錄**\n\n-   [功能](#功能)\n-   [技術架構](#技術架構)\n-   [安裝與使用](#安裝與使用)\n-   [貢獻指南](#貢獻指南)\n-   [專案結構](#專案結構)\n-   [未來規劃](#未來規劃)\n-   [授權](#授權)\n\n---\n\n## **功能**\n\n-   🖥️ **前端功能**：\n    -   用戶註冊、登入與驗證。\n    -   互動式的 UI，提供動態內容更新。\n    -   即時通知與狀態更新。\n-   ⚙️ **後端功能**：\n    -   完整的 RESTful API。\n    -   使用 JWT 實現安全的身份驗證。\n    -   提供多角色權限管理（RBAC）。\n-   📊 **資料庫功能**：\n    -   高效的資料查詢與關聯。\n    -   完整的數據遷移與版本控制。\n    -   支持大數據處理與擴展。\n\n---\n\n## **技術架構**\n\n### 前端\n\n-   **框架**：Vue 3\n-   **工具**：Vite、Pinia（狀態管理）、Axios（HTTP 請求）\n-   **樣式**：TailwindCSS\n\n### 後端\n\n-   **語言與框架**：C# .NET 8\n-   **認證與授權**：JWT\n-   **架構模式**：Clean Architecture（分層結構）\n-   **日誌與監控**：Serilog\n\n### 資料庫\n\n-   **類型**：PostgreSQL\n-   **ORM**：Entity Framework Core\n-   **資料遷移**：EF Core Migration\n\n---\n\n## **安裝與使用**\n\n### 1. **環境需求**\n\n-   **Node.js**: 版本 \u003e= 18\n-   **.NET SDK**: 版本 \u003e= 8.0\n-   **PostgreSQL**: 版本 \u003e= 15\n\n### 2. **後端部署**\n\n1. Clone 儲存庫並進入目錄：\n\n    ```bash\n    git clone https://github.com/s35241607/lan-side-project.git\n    cd lan-side-project/backend\n\n    ```\n\n2. 安裝依賴並啟動伺服器：\n\n    ```bash\n    dotnet restore\n    dotnet run\n\n    ```\n\n3. 確認後端 API 運行在 `http://localhost:8080`。\n\n### 3. **前端部署**\n\n1. 進入前端目錄：\n\n    ```bash\n    cd ../frontend\n\n    ```\n\n2. 安裝依賴並啟動開發伺服器：\n\n    ```bash\n    npm install\n    npm run dev\n\n    ```\n\n3. 前端應用會運行在 `http://localhost:5173`。\n\n---\n\n## **專案結構**\n\n```\nlan-side-project/\n├── backend/               # 後端程式碼\n│   ├── Controllers/       # API 控制器\n│   ├── Models/            # 資料模型\n│   ├── Services/          # 業務邏輯\n│   └── appsettings.json   # 配置文件\n├── frontend/              # 前端程式碼\n│   ├── src/\n│   │   ├── components/    # Vue 組件\n│   │   ├── store/         # 狀態管理\n│   │   ├── views/         # 頁面視圖\n│   └── vite.config.js     # Vite 配置\n├── README.md              # 專案說明\n└── LICENSE                # 授權文件\n\n```\n\n---\n\n## **貢獻指南**\n\n我們非常歡迎任何形式的貢獻！請參考以下流程：\n\n1. Fork 此專案到你的帳號。\n2. 建立分支並進行修改：\n\n    ```bash\n    git checkout -b feature/你的功能名稱\n\n    ```\n\n3. 提交 PR，並描述你做了什麼變更。\n\n提交 Issue 前，請確保：\n\n-   檢查是否有相關 Issue 已存在。\n-   提供清楚的描述與重現步驟。\n\n---\n\n## **未來規劃**\n\n-   添加 GraphQL 支持。\n-   引入 WebSocket 進行即時更新。\n-   支持多語系功能。\n-   提供 Docker Compose 支持，一鍵啟動環境。\n\n---\n\n## **授權**\n\n此專案採用 [MIT License](https://github.com/s35241607/lan-side-project/blob/main/LICENSE) 授權，歡迎自由使用、修改與分發。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs35241607%2Flan-side-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fs35241607%2Flan-side-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fs35241607%2Flan-side-project/lists"}