feat: add new files for project structure and configuration #697
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
feat(structure): reorganize project structure and enhance documentation
📝 Description | 描述
English: This PR introduces a major project structure reorganization, separating backend and frontend code into dedicated directories, updating configuration files, and adding comprehensive documentation. The changes improve project maintainability, organization, and developer experience.
中文: 本次PR引入了重大的项目结构重组,将后端和前端代码分离到专用目录,更新配置文件,并添加了全面的文档。这些变更提高了项目的可维护性、组织性和开发体验。
🎯 Type of Change | 变更类型
🔗 Related Issues | 相关 Issue
📋 Changes Made | 具体变更
English:
Project Structure Reorganization:
backend/directory with proper internal package structureweb/tofrontend/directoryconfigs/directoryscripts/directorydocker/directoryDocumentation:
STRUCTURE.mddetailing the new project structure and Docker configurationPR_DESCRIPTION.mdandPR_READY_TO_COPY.mdfor PR managementConfiguration Updates:
start.shto create database in the correct directory (configs/)Code Organization:
backend/internal/with proper package structureFile Cleanup:
.dockerignore,.prettierignore,.prettierrc.jsonfrom old frontend location.husky/pre-commithook from old location中文:
项目结构重组:
backend/目录,采用规范的内部包结构web/移至frontend/目录configs/目录scripts/目录docker/目录文档:
STRUCTURE.md,详细说明新的项目结构和Docker配置PR_DESCRIPTION.md和PR_READY_TO_COPY.md用于PR管理配置更新:
start.sh以在正确的目录(configs/)中创建数据库代码组织:
backend/internal/下,具有规范的包结构文件清理:
.dockerignore、.prettierignore、.prettierrc.json.husky/pre-commit钩子📊 Statistics | 统计信息
🧪 Testing | 测试
Test Environment | 测试环境
Manual Testing | 手动测试
Testing Steps | 测试步骤:
./start.shto verify database creation inconfigs/directorycd backend && go build ./cmd/servercd frontend && npm install && npm run buildcd docker && docker compose up🔄 Migration Guide | 迁移指南
For Developers | 开发者迁移指南:
Update Import Paths | 更新导入路径:
import "nofx/api"import "nofx/backend/internal/api"Update Script References | 更新脚本引用:
scripts/directoryUpdate Configuration Paths | 更新配置路径:
configs/directoryconfig.jsonreferences if neededDocker Setup | Docker 设置:
docker/directorycd docker && docker compose upto start services✅ Checklist | 检查清单
Code Quality | 代码质量
Documentation | 文档
Build & Configuration | 构建和配置
Git
devbranch | 已 rebase 到最新dev分支📚 Additional Notes | 补充说明
English:
This is a significant structural refactoring that improves project organization and maintainability. The separation of backend and frontend into dedicated directories makes the codebase more scalable and easier to navigate. All functionality remains the same, only the organization has changed.
Key Benefits:
Breaking Changes:
中文:
这是一次重大的结构重构,提高了项目的组织性和可维护性。将后端和前端分离到专用目录使代码库更具可扩展性且更易于导航。所有功能保持不变,只是组织结构发生了变化。
主要优势:
破坏性变更:
By submitting this PR, I confirm | 提交此 PR,我确认:
🌟 Thank you for your contribution! | 感谢你的贡献!