# aigeek-learn-w1

**Repository Path**: YYaa18/aigeek-learn-w1

## Basic Information

- **Project Name**: aigeek-learn-w1
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-06
- **Last Updated**: 2025-12-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Project Alpha 项目文档总览

本文档目录按开发阶段组织，包含所有项目的设计、开发和实施文档。 这是一个vibe coding练习项目，没有写一行代码

## 📁 目录结构

### 📦 项目初始化阶段
包含项目启动和基础配置相关的文档：

- **项目说明.md** - 项目概述、技术栈、架构设计和快速开始指南

### 📦 数据库设计阶段
包含数据库设计、种子数据和初始化相关的文档：

- **种子数据详细说明.md** - 详细的种子数据说明文档（包含 50+ tickets 和标签系统）
- **种子数据快速指南.md** - 快速上手指南（3 步完成数据加载）

### 📦 第二阶段开发
包含后端核心功能开发和实施的文档：

- **阶段完成报告.md** - Phase 2 详细完成报告（包含所有后端功能实现）

### 📦 需求和设计阶段
位于 `specs/` 目录下，包含项目的原始需求和设计文档：

- **需求说明.md** - 原始需求文档
- **项目需求和设计文档.md** - 详细的需求和设计文档 (0001-spec.md)
- **实施计划.md** - 详细的实施计划 (0002-implementation-plan.md)

## 📖 文档使用指南

### 新手入门
1. 首先阅读：`项目初始化/项目说明.md`
2. 然后查看：`数据库设计/种子数据快速指南.md`

### 开发参考
- 后端开发：参考 `第二阶段开发/阶段完成报告.md`
- 数据库设计：参考 `数据库设计/种子数据详细说明.md`
- 需求分析：参考 `specs/` 目录下的文档

### 文档更新规则
- **根目录** 下的 .md 文件不会直接编辑
- 所有新文档按阶段分类存放
- 使用 **中文文件名** 便于阅读
- 保持文档与代码同步更新

## 🔗 相关链接

- 后端源码：[backend/](../backend/)
- 前端源码：[frontend/](../frontend/)
- 数据库脚本：[backend/src/main/resources/db/](../backend/src/main/resources/db/)

## 📝 贡献指南

编辑文档时：
1. 确认文档归属哪个阶段
2. 使用中文命名文件
3. 在文档开头添加更新日期
4. 保持文档结构清晰

---

**最后更新**: 2025-12-06