# 项目基本信息
project:
  name: uniapp-vue3-cloud
  description: 基于 uni-app + Vue3 + 云函数的跨平台应用
  platforms:
    - 微信小程序
    - Web端
    - H5
    - App

# 技术栈规范
tech_stack:
  frontend:
    framework: 
      - Vue3
      - uni-app
    state_management: Pinia
    style:
      - SCSS
      - uview-plus
    language: TypeScript
  backend:
    - uni-app云函数
  package_manager: pnpm

# 目录结构规范
directory_structure:
  src:
    api: API接口定义
    components: 公共组件
    composables: 组合式函数
    pages: 页面文件
    static: 静态资源
    store: Pinia状态管理
    styles: 全局样式
    types: TypeScript类型定义
    utils: 工具函数
  cloudfunctions:
    common: 公共模块
    business: 业务模块

# 开发规范
development_rules:
  # 命名规范
  naming:
    folders: kebab-case
    components: PascalCase
    variables: camelCase
    constants: UPPER_SNAKE_CASE
    files:
      components: PascalCase
      pages: kebab-case
      api: camelCase

  # 代码规范
  code_style:
    typescript: true
    vue:
      script_setup: required
      composition_api: required
    component_order:
      - name
      - components
      - props
      - emits
      - setup
    
  # Git提交规范
  git_commit:
    format: <type>(<scope>): <subject>
    types:
      - feat: 新功能
      - fix: 修复
      - docs: 文档
      - style: 格式
      - refactor: 重构
      - test: 测试
      - chore: 构建

  # 云函数规范
  cloud_functions:
    - 模块化开发
    - 统一错误处理
    - 使用TypeScript
    - RESTful API设计

# 环境要求
environment:
  node: ">=16"
  pnpm: ">=7"
  editor: VSCode
  extensions:
    - Vue Language Features
    - TypeScript Vue Plugin
    - ESLint
    - Prettier

# 开发工具配置
editor_config:
  tab_size: 2
  end_of_line: lf
  charset: utf-8
  trim_trailing_whitespace: true
  insert_final_newline: true

# 代码质量规范
code_quality:
  eslint: required
  prettier: required
  typescript: strict
  unit_test: recommended

# 性能规范
performance:
  image_size: "<=200KB"
  initial_loading_time: "<=3s"
  component_reuse: required
  lazy_loading: recommended

# 安全规范
security:
  api:
    authentication: required
    data_encryption: required
  sensitive_data:
    encryption: required
    secure_storage: required

# 发布规范
deployment:
  environments:
    - development
    - staging
    - production
  version_control:
    branch_naming: feature/fix/hotfix-description
    tag_format: v1.0.0