这是亚马逊 Q 开发者“Quack The Code”挑战赛的参赛作品：探索各种可能性
作为一名热衷于用实用软件解决现实世界问题的人，我提交此文档的目标是探索各种可能性，并展示AWS Q Developer如何增强日常应用程序的开发体验——特别是使用 PHP、MySQL 和现代前端技术构建的个人财务管理 (PFM)应用程序。
个人理财常常因为预算工具的复杂性或缺乏个性化而被忽视。我想要创造一款不仅实用而且易于使用的工具——一个轻量级、用户专属的系统，让用户能够轻松追踪收入和支出、生成报表并管理财务数据。
在探索 AWS Q Developer 的功能时，我意识到它可以显著减少以下工作量：
本文旨在展示AWS Q Developer不仅是经验丰富的开发人员的强大助手，而且还是一个富有创造力的伙伴，可以提高生产力、鼓励探索，并最终缩短从想法到解决方案的路径。
通过这个循序渐进的演示，我希望鼓励开发者——尤其是独立开发者或学生——尝试构建有用的工具，同时利用AWS Q Developer 的AI 辅助开发功能。
通过这项探索，我开发了一款简洁直观的个人财务管理 (PFM) Web 应用程序，使用户能够每日追踪收入和支出，按类别整理财务数据，并轻松生成富有洞察力的报告。这款功能齐全的工具旨在展示AWS Q Developer如何简化和加速构建以用户为中心的实际应用程序的过程。
PFM应用程序包含用户注册、自定义收入和支出类别、密码重置、货币偏好设置和CSV导出等功能。每位用户的数据都经过安全隔离和个性化设置，确保用户获得私密且量身定制的财务跟踪体验。
虽然底层技术栈包括PHP、MySQL、HTML/CSS、JavaScript和用于响应式设计的Bootstrap，但真正的增强功能来自AWS Q Developer，它被用于……
该项目表明，借助AWS Q Developer，即使是像财务跟踪器这样传统的复杂应用程序，也可以更快、更简洁、更智能地构建，而不会影响可用性或性能。
Username: newuser
E-Mail: nizzad@example.com
Password: 2025DEVChallenge
# You can register an account as well.
mohamednizzad /个人理财经理个人财务管理工具 (PFM) 是一款功能强大的 Web 应用程序，使用户能够高效地跟踪、管理和分析个人收入和支出。该应用程序采用 PHP 和 MySQL 构建，提供了一个安全且用户专属的环境，用户可以在其中维护详细的财务交易记录并生成全面的报告。
该应用程序拥有直观的仪表盘，提供实时财务洞察、可自定义的收入和支出类别以及详细的报表功能。用户可以以自己偏好的货币追踪交易，通过可视化图表分析支出模式，并导出财务数据以进行进一步分析。PFM 同时支持浅色和深色模式，提供现代化的响应式界面，可根据用户偏好进行调整。
├── config/ # Configuration files for在深入探讨我是如何使用Amazon Q Developer之前，它是一款专为软件开发而设计的 AI 助手。它通过自然语言交互帮助开发人员编写、理解和改进代码。与通用 AI 助手不同，Amazon Q Developer 经过编程最佳实践、AWS 服务和软件开发模式的训练，使其成为各个技能水平开发人员的得力助手。
因此，我尽可能多地参考了官方文件。
通过参考这些资料，我了解到最好的方法是先拟定一个草稿，并解释我想要实现的目标。
假设这样一种情况：一位非技术客户向业务分析师解释他的需求。
因此，我提出了以下个人财务管理理念。
Application Name:-
Personal Finance Manager (PFM)
Purpose:-
The purpose of this application is to provide users the ability to manage personal income and expenses on daily basis where the user will sign up an account and the account will be created. The entire application should be user specific. Meaning, any information created by one user is exclusively available to him using any application primary key to track individual user.
Features:-
- User Sign Up
-- User Profile
-- User should be able to reset password
-- User should set the currency
- Income Manager
-- Add Income with details such as Amount, Description, Category, Date
-- User should be able to Create, Read, Update and Delete (CRUD) Income
-- If Income Category is not there, user should be able to create new category applicable to him
- Expense Manager
-- Add Expense with details such as Amount, Description, Category, Date
-- User should be able to Create, Read, Update and Delete (CRUD) Expense
-- If Expense Category is not there, user should be able to create new category applicable to him
- Report Management
-- The user should be able to query his income and expense using particular day, category, between two dates and any other combination
-- Download the income and expense as CSV File
- Database
-- Create MySQL Database for the purpose of PFM Application
- Tech Stack
-- Use PHP as Backend
-- Use HTML, CSS and JS as front end
-- Use Bootstrap Framework for Responsive Design
- General
-- The user interface should have both light and dark mode with sleek responsive design.
-- Anything not specified, use judgement based on common practice in financial domain.
根据 Amazon Q Developer文档，Amazon Q Developer 支持您的工作地点和工作方式。
1️⃣ VS Code IDE [免费]： 如果您尚未安装 Visual Studio Code，请下载并安装它。
现在，让我们访问Visual Studio Marketplace 上的Amazon Q页面，安装适用于 VS Code 的 Amazon Q Developer。
🎥 视频演示：如何在 VS Code 中安装 Amazon Q
注意：如果您要使用 Amazon Q Developer 免费套餐，请创建一个免费的AWS Builder ID，您需要使用该ID 在 VS Code 上验证您的 Amazon Q Developer 帐户。
我完全使用Amazon Q Developer构建了个人财务管理 (PFM)应用程序，目标是零手动代码，以实现功能齐全的生产级应用程序。
使用/dev [提示]来指示 Amazon Q 在您的整个项目中生成新代码并实现功能。
# I used the below prompt to do the Magic
I have created user_requirements.txt file which basically explains the required features for the Personal Finance Manager Application.
I want you to follow the instruction and create the application at the best interest of greater user experience and functionality of the application.
🎥 Amazon Q Developer 中使用/dev命令的视频演示
简直太神奇了！快去GitHub或应用演示上看看个人财务管理工具的最终成果吧！
.
├── config/ # Configuration files for database and application settings
├── controllers/ # Application logic and request handling
│ ├── AuthController.php # Handles user authentication and authorization
│ ├── DashboardController.php # Manages dashboard view and data
│ ├── ExpenseController.php # Handles expense-related operations
│ ├── IncomeController.php # Manages income-related operations
│ └── ReportController.php # Generates financial reports and exports
├── models/ # Data models and database interactions
│ ├── Expense.php # Expense data operations
│ ├── Income.php # Income data operations
│ └── User.php # User management operations
└── views/ # User interface templates
├── auth/ # Authentication-related views
├── dashboard/ # Dashboard interface
├── expense/ # Expense management views
├── income/ # Income management views
└── report/ # Report generation interface
2️⃣ XAMPP 软件包 [免费]： 如果您想在本地运行该应用程序，请根据您的操作系统 (OS)下载并安装相应的软件包。
XAMPP 是一个完全免费、易于安装的 Apache 发行版，其中包含 MariaDB、PHP 和 Perl。XAMPP 开源软件包的设计宗旨是让安装和使用都极其简单。
下面，我将向您展示如何借助 XAMPP 包在 Windows 上配置个人财务管理应用程序。
🎥 如何在 Windows 上运行个人财务管理软件的视频演示
我仅做了少量调整，完全使用Amazon Q Developer为个人财务管理 (PFM)应用程序创建了文档，目标是零手动编辑，从而创建一个精心制作的专业 README.md 文件。
请点击此处查看自述文件
使用/doc [提示]指示 Amazon Q 生成项目相关文档。
# I used the below prompt to do the Magic
Based on what you have created for the Personal Finance Manager, I want you to create a step-by-step beginner friendly github readme file.
🎥 视频演示：如何在 Amazon Q Developer 中使用/doc命令生成完美文档
使用 Amazon Q Developer，唯一的缺点就是我们想象力的限制。
我再次尝试使用Amazon Q Developer为个人财务管理 (PFM)应用程序创建Dev.to 文章，目的是尽量减少手动编辑，从而创建一个精心制作的、适合初学者的分步教程，介绍我是如何利用这个强大工具的潜力的。
使用/doc [提示]命令指示 Amazon Q 为 PFM 应用程序生成 Dev.to 文章
# I used the below prompt to do the Magic
Please write me a complete article to publish in dev.to as a step-by-step tutorial to use Amazon Q Developer using this Personal Finance Manager Application as the project and tutorial to follow.
I want you the article to include the following in the tutorial
- Utilization of Amazon Q Developer
- best practices shared
- lessons learned
- impact and Etc
🎥 视频演示：如何在 Amazon Q Developer 中使用/doc命令为该 PFM 应用程序生成 Dev.to 文章。
我对最终成果感到非常惊讶。请查看文章的原始版本。
让我们探讨一下Amazon Q Developer如何在整个开发生命周期中提供帮助。
在本文的最后一部分，我想讨论如何利用Amazon Q Developer来引导整个开发生命周期，从构思到文档编写，从编码到调试，并以个人财务管理应用程序为例进行说明。
让我们逐一探究……
参与新项目最具挑战性的方面之一是理解现有的代码库。让我们看看 Amazon Q Developer 如何提供帮助。
假设你刚刚加入个人财务管理应用程序的开发团队。你需要快速了解该应用程序的结构。
使用 Amazon Q Developer：
@workspace在 Amazon Q 聊天面板中输入内容，即可包含相关的工作区文件。Amazon Q 将分析代码库，并提供应用程序架构的全面概述，包括：
最佳实践：在处理大型代码库时，可以使用此功能@folder将 Amazon Q 的关注点限定在特定目录。例如，@folder controllers这将有助于 Amazon Q 只关注控制器逻辑。
假设你需要了解应用程序中的仪表盘是如何工作的。
使用 Amazon Q Developer：
@file以将当前文件包含在上下文中Amazon Q 将提供详细的解释：
现在我们已经了解了代码库，让我们使用 Amazon Q Developer 来帮助我们为个人财务管理器添加新功能。
我们的用户要求增加一项新功能，允许他们为不同的支出类别设置每月预算。让我们借助 Amazon Q 来实现这个功能。
使用 Amazon Q Developer：
发起新的对话并输入：“我想在个人财务管理应用程序中添加预算管理功能。用户应该能够为每个支出类别设置月度预算，并跟踪他们的支出与这些预算的对比情况。”
Amazon Q 将提供一种实施方案：
To implement a budget management feature, we'll need to:
1. Create a new Budget model to store budget data
2. Add a BudgetController to handle budget operations
3. Create views for setting and viewing budgets
4. Update the dashboard to show budget progress
Let's start with the database structure and model.
Amazon Q 将生成一个完整的模型文件，其中包含用于 CRUD 操作、验证以及与其他模型建立关系的适当方法。
最佳实践：在使用 Amazon Q 时，将复杂的功能请求分解成更小、更易于管理的任务。这有助于 AI 提供更有针对性和更准确的帮助。
现在，让我们改进仪表盘，使其显示每个类别的预算进度。
使用 Amazon Q Developer：
@file以将当前文件包含在上下文中Amazon Q 将生成必要的 HTML、CSS 和 JavaScript 代码来创建预算进度部分，包括以可视化方式表示预算支出情况的进度条。
经验教训：当要求 Amazon Q 修改现有文件时，务必提供有关当前文件结构和功能的上下文信息。这有助于 AI 生成更准确、更兼容的代码。
即使是最优秀的开发者也会遇到 bug。让我们看看 Amazon Q Developer 如何帮助我们排查个人财务管理应用程序中的问题。
假设用户反映仪表盘上的月度余额计算有误。
使用 Amazon Q Developer：
@file以将当前文件包含在上下文中Amazon Q 将分析代码，并可能识别出以下问题：
I notice a potential issue in the balance calculation. The code is calculating the balance as:
$balance = $totalIncome - $totalExpense;
However, there's no validation to ensure that $totalIncome and $totalExpense are numeric values. If either method returns null or a non-numeric value, this could cause incorrect calculations.
Let's add proper validation:
// Get total income for current month
$totalIncome = $this->incomeModel->getTotalIncomeByDateRange($userId, $startDate, $endDate);
$totalIncome = is_numeric($totalIncome) ? $totalIncome : 0;
// Get total expense for current month
$totalExpense = $this->expenseModel->getTotalExpenseByDateRange($userId, $startDate, $endDate);
$totalExpense = is_numeric($totalExpense) ? $totalExpense : 0;
// Get balance
$balance = $totalIncome - $totalExpense;
最佳实践：在使用 Amazon Q 进行调试时，请尽可能提供有关问题的上下文信息，包括您观察到的任何错误消息或意外行为。
Amazon Q Developer 可以通过提供优化建议和最佳实践来帮助我们提高代码质量。
让我们优化收入模型中的数据库查询，以提高性能。
使用 Amazon Q Developer：
@file以将当前文件包含在上下文中Amazon Q 可能会提出以下改进建议：
Here are some optimizations for the database queries in the Income model:
1. Add indexing to frequently queried columns:
- income_date
- user_id
- category_id
2. Use prepared statements consistently for all queries to improve security and performance
3. Implement query caching for frequently accessed data like monthly totals
4. Batch related queries where possible instead of making multiple database calls
5. Consider pagination for large result sets to reduce memory usage and improve response time
经验教训： Amazon Q 可以提供一些关于性能优化的宝贵见解，这些见解可能并不显而易见，尤其对于数据库优化经验不足的开发人员而言更是如此。
良好的文档对于任何项目都至关重要。让我们看看 Amazon Q Developer 如何帮助我们编写个人财务管理应用程序的文档。
我们需要记录 API 端点，以便将来与移动应用程序集成。
使用 Amazon Q Developer：
@folder controllers以包含所有控制器文件Amazon Q 将分析控制器并生成全面的 API 文档，其中包括：
最佳实践：使用 Amazon Q 来维护代码演进过程中的文档。当您对 API 进行更改时，请让 Amazon Q 相应地更新文档。
测试是开发过程中不可或缺的一部分。让我们看看 Amazon Q Developer 如何帮助我们为个人财务管理应用程序编写测试。
我们需要为费用模型创建单元测试，以确保其方法能够正确运行。
使用 Amazon Q Developer：
@file models/Expense.php要包含费用模型的输入Amazon Q 将为 Expense 模型生成全面的单元测试，包括以下方面的测试：
经验教训： Amazon Q 可以根据现有代码生成测试用例，从而显著加快测试过程，确保更好的代码覆盖率和可靠性。
对于金融应用而言，安全性至关重要。让我们使用 Amazon Q Developer 来增强个人财务管理工具的安全性。
我们需要为表单实施 CSRF（跨站请求伪造）保护。
使用 Amazon Q Developer：
Amazon Q 将提供详细的实施计划，其中包括：
Here's how to implement CSRF protection in your PHP application:
1. Create a CSRF token generation function in a security utility class
2. Add token generation to session initialization
3. Create a function to validate tokens
4. Update all forms to include the CSRF token
5. Modify form processing code to validate tokens before processing
Let me show you the implementation for each step...
最佳实践：在实现处理敏感数据或用户输入的功能时，务必向 Amazon Q 咨询安全最佳实践。
在将 Amazon Q Developer 集成到我的个人财务管理应用程序开发工作流程中后，我观察到了一些显著的影响：
在我的 Amazon Q Developer 学习过程中，我学到了许多宝贵的经验：
Amazon Q 的回答质量与您提供的上下文信息的清晰度和完整性直接相关。请策略性地使用 `<command>` @file、@folder`<command>` 和@workspace`<command>` 命令，以便为 Amazon Q 提供其所需的信息。
不要指望第一次就能找到完美的解决方案。使用 Amazon Q 时要迭代进行，不断改进你的问题和生成的代码，直到达到预期结果。
在实施 Amazon Q 生成的代码之前，务必先查看并理解这些代码。这不仅能确保代码质量，还能帮助您从 AI 的建议中学习。
Amazon Q 的最佳用途是作为协作伙伴，而不是取代人类专家。将您的领域知识与 Amazon Q 的建议相结合，才能获得最佳效果。
Amazon Q 可以成为一个绝佳的学习工具。你可以向它询问你不理解的概念、模式或代码片段，从而加速你的学习。
根据我的经验，以下是一些有效使用 Amazon Q Developer 的最佳实践：
在向亚马逊Q寻求帮助之前，请先明确定义您想要达成的目标。模糊的问题只会得到模糊的答案。
对于复杂的功能或问题，将其分解成更小、更易于管理的任务，Amazon Q 可以逐一提供帮助。
使用上下文命令（@file，，@folder）@workspace确保 Amazon Q 可以访问相关代码和信息。
如果亚马逊 Q 的初步回复未能完全满足您的需求，请提出后续问题以完善和改进解决方案。
在提交人工审核之前，请先让 Amazon Q 审核您的代码，以发现潜在问题、优化空间或安全漏洞。
对于经常执行的任务，创建保存的提示，@prompt以便快速访问常用工作流程。
Amazon Q 作为综合开发工具包的一部分才能发挥最佳效果。将其与其他工具和实践相结合，可最大限度地提高效率。
Amazon Q Developer 正在改变我们进行软件开发的方式，使其更快、更高效、更易于使用。通过将 Amazon Q 集成到我的个人财务管理应用程序开发工作流程中，我发现生产力、代码质量和开发人员体验都得到了显著提升。
随着人工智能驱动的开发工具不断发展，采用 Amazon Q Developer 等工具对于保持竞争力并高效交付高质量软件将变得越来越重要。无论您是经验丰富的开发人员还是刚刚踏上开发之路的新手，Amazon Q Developer 都能成为您开发工具包中的得力助手。
请查看专门的 YouTube 播放列表，其中涵盖了该项目的所有关键方面。
我鼓励您尝试使用 Amazon Q Developer 开发自己的项目，亲身体验其优势。
未来的发展模式是协作式的，人类和人工智能将携手合作，以前所未有的速度创造出更好的软件。
你试过 Amazon Q Developer 或其他类似的 AI 开发工具吗？你的使用体验如何？欢迎在下方评论区分享你的想法和疑问！
文章来源：https://dev.to/mohamednizzad/a-definite-guide-to-develop-product-grade-applications-with-aws-q-developer-in-2025-video-3690