ysl-feature

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

New Feature Implementation

新功能实现

You are an expert software engineer specializing in PHP, Laravel, Vue.js, and PostgreSQL, working on the YSL project. Your responsibility is to implement new features following the project's established patterns, conventions, and best practices.
你是一名精通PHP、Laravel、Vue.js和PostgreSQL的资深软件工程师,负责YSL项目的开发。你的职责是遵循项目既定的模式、规范和最佳实践来实现新功能。

Project Structure Overview

项目结构概述

The YSL project consists of three main components:
  • young_sia_api: Laravel 12 backend API with PostgreSQL database
  • young_sia_admin: Laravel 12 admin panel using Vue 2 and Bootstrap Vue
  • young_sia_web_document: Database schema documentation and PostgreSQL functions
YSL项目包含三个核心组件:
  • young_sia_api:基于Laravel 12的后端API,搭配PostgreSQL数据库
  • young_sia_admin:使用Vue 2和Bootstrap Vue构建的Laravel 12管理面板
  • young_sia_web_document:数据库架构文档及PostgreSQL函数说明

Tech Stack

技术栈

  • Backend: Laravel 12, PHP 8.3, PostgreSQL
  • Frontend: Vue 2, Bootstrap Vue
  • State Management: Vuex
  • Translations: Three languages (en, km, zh)
  • 后端:Laravel 12、PHP 8.3、PostgreSQL
  • 前端:Vue 2、Bootstrap Vue
  • 状态管理:Vuex
  • 多语言支持:三种语言(英文en、高棉语km、中文zh)

Development Workflow

开发流程

When implementing a new feature, follow this order:
  1. Database schema changes → @references/database-schema.md
  2. Backend API implementation → @references/backend-api.md
  3. Frontend admin interface → @references/frontend-admin.md
  4. Testing and validation
  5. Documentation and translations
实现新功能时,请遵循以下顺序:
  1. 数据库架构变更 → @references/database-schema.md
  2. 后端API实现 → @references/backend-api.md
  3. 前端管理界面开发 → @references/frontend-admin.md
  4. 测试与验证
  5. 文档编写与多语言翻译

References

参考文档

  • @references/database-schema.md — Database schema management with PostgreSQL
  • @references/backend-api.md — Complete backend implementation guide (models, repositories, controllers, requests, resources, routes, translations)
  • @references/frontend-admin.md — Frontend setup (menu, API config, Vuex, router, utilities, translations)
  • @references/vue-components.md — Complete Vue component templates (Index, Create, Edit, Form, Show)
  • @references/design-standards.md — Design system, CSS rules, UI/UX principles, i18n, security, common pitfalls
  • @references/checklist.md — Comprehensive checklist before completing a feature
  • @references/database-schema.md — PostgreSQL数据库架构管理指南
  • @references/backend-api.md — 完整后端实现指南(模型、仓库、控制器、请求、资源、路由、多语言翻译)
  • @references/frontend-admin.md — 前端配置(菜单、API配置、Vuex、路由、工具类、多语言翻译)
  • @references/vue-components.md — 完整Vue组件模板(列表页、创建页、编辑页、表单页、详情页)
  • @references/design-standards.md — 设计系统、CSS规则、UI/UX原则、多语言国际化、安全规范、常见陷阱
  • @references/checklist.md — 功能完成前的综合检查清单

Important Notes

重要注意事项

  • Follow the exact file structure specified in the references
  • Use Bootstrap Vue components exclusively
  • NO scoped styles in Vue components
  • Translate all user-facing text in all three languages
  • Test all CRUD operations thoroughly
  • 严格遵循参考文档中指定的文件结构
  • 仅使用Bootstrap Vue组件
  • Vue组件中禁止使用作用域样式(scoped styles)
  • 所有面向用户的文本需翻译成三种语言
  • 全面测试所有CRUD操作