blank/docs/architecture/index.md

shadcn全栈管理后台启动模板 Fullstack Architecture Document

Table of Contents

• shadcn全栈管理后台启动模板 Fullstack Architecture Document
  • 1. Introduction
  • 2. High Level Architecture
  • 2.1 Technical Summary
  • 2.2 Platform and Infrastructure Choice
  • 2.3 Repository Structure
  • 2.4 High Level Architecture Diagram
  • 2.5 Architectural Patterns
  • 3. Tech Stack
  • Technology Stack Table
  • 4. Data Models
  • 4.1 User（用户模型）
  • 4.2 Role（角色模型）
  • 会话管理策略
  • 5. API Specification
  • OpenAPI 3.0规范（修订）
  • 基于hono/client的RPC方式
  • Zod Schema独立配置
  • 6. Components
  • 6.1 认证服务 (AuthService)
  • 6.2 用户服务 (UserService)
  • 6.3 通用CRUD服务 (GenericCRUDService)
  • 6.4 通用CRUD路由 (GenericCRUDRouter)
  • 6.5 组件关系图
  • 7. Core Workflows
  • 7.1 用户登录工作流
  • 7.2 用户注册工作流
  • 8. Database Schema
  • 8.1 MySQL数据库Schema
  • 8.2 TypeORM实体定义
  • 9. Frontend Architecture
  • 9.1 组件架构
    • 组件组织
    • 组件模板
  • 9.2 状态管理架构
    • 状态结构
  • 9.3 路由架构
    • 路由组织
    • 保护路由模式
  • 9.4 前端服务层
    • API客户端设置
  • 10. Backend Architecture
  • 10.1 服务架构
    • 控制器/路由组织
    • 控制器模板
  • 10.2 数据库架构
    • Schema设计
    • 数据访问层
  • 10.3 认证架构
    • 认证流程
    • 中间件/守卫
  • 11. Unified Project Structure
  • 项目目录结构
  • Monorepo配置 (turbo.json)
  • 根package.json脚本
  • 12. Development Workflow
  • 12.1 Local Development Setup
    • Prerequisites
    • Initial Setup
    • Development Commands
  • 12.2 Environment Configuration
    • Required Environment Variables
    • 开发环境快速启动脚本
  • 13. Deployment Architecture
  • 13.1 部署策略
  • 13.2 CI/CD流水线
  • 13.3 环境配置
  • 14. Security and Performance
  • 14.1 安全要求
  • 14.2 性能优化
  • 15. Testing Strategy
  • 15.1 测试金字塔
  • 15.2 测试组织
  • 16. Coding Standards
  • 16.1 关键全栈规则
  • 16.2 命名约定
  • 17. Error Handling Strategy
  • 17.1 错误流程
  • 17.2 错误响应格式
  • 18. Monitoring and Observability
  • 18.1 监控栈
  • 18.2 关键指标