MSW-REPO
社会工作硕士项目库
一个全面的、个性化的研究生中心，用于管理课程作业、作业、研究、网络应用程序和自动化工作流程。此存储库与 Notion作为主要的编程前端，存储文件、文档、笔记、论文、文章和家庭作业，同时利用现代开发工具，包括pnpm工作区、带Turbopack的Next.js和MCP服务器集成。
🎯 概念整合
Notion是主要的编程前端 通过 MCP官方理念 （基于OAuth），通过Cursor IDE连接。
- 积分方法：官方概念托管MCP（OAuth）
- 状态: ✅ 已连接并验证
- 工作区：MOODMNKY有限责任公司→ MSW H.Q.团队空间
- 整合：学者MNKY
- 数据库：MSW-REPO学术档案(
2becd2a6-5422-816e-93b6-e3db7b4af11b)
主要方法：使用游标与Notion MCP进行所有Notion操作。看 MCP设置官方概念 了解详情。
替代方法：通过脚本直接调用API（请参阅 概念集成指南)可用于自动化，但Notion MCP是主要接口。
📁 存储库结构
MSW-REPO/
├── courses/ # Course-specific content
│ └── SOCW-6510/ # Example course structure
│ ├── assignments/ # Course assignments
│ ├── papers/ # Research papers
│ ├── articles/ # Academic articles
│ ├── notes/ # Class notes and materials
│ ├── research/ # Research materials
│ ├── projects/ # Course projects
│ └── documents/ # Other documents
├── storage/ # Centralized file storage
│ ├── documents/ # General documents
│ ├── papers/ # Research papers
│ └── articles/ # Academic articles
├── apps/ # Web applications (Next.js apps)
├── tools/ # Shared utilities and scripts
│ └── notion-integration/ # Notion API integration tools
├── workflows/ # n8n workflow definitions (JSON)
│ └── notion-sync/ # Notion synchronization workflows
├── docs/ # Documentation
├── .cursor/ # Cursor IDE configuration
│ └── mcp.json # MCP server configurations
├── .notion-config.json # Notion database configuration
├── package.json # Root package.json (shared dependencies)
├── pnpm-workspace.yaml # pnpm workspace configuration
└── .gitignore # Git ignore patterns🚀 入门指南
先决条件
- Node.js 18+
- pnpm（通过安装
npm install -g pnpm) - Git
- 游标IDE（用于MCP服务器集成）
- 具有SCHOLAR MNKY集成访问权限的Notion帐户
初始设置
- 克隆仓库 （GitHub设置后）：
git clone
cd MSW-REPO- 安装依赖项:
pnpm install- 配置概念集成:
- 主要的，重要的：官方Notion MCP是通过Cursor（基于OAuth）配置的 - 替代：提供直接API脚本（请参阅 tools/notion-integration/) - 数据库已配置（请参阅 .notion-config.json) - 整合：学者MNKY→ MSW H.Q.团队空间
- 验证设置:
cd tools/notion-integration
pnpm run verify🛠️ 发展
创建新的课程工作区
- 创建课程目录：
mkdir -p courses/SOCW-XXXX- 创建子目录：
cd courses/SOCW-XXXX
mkdir assignments notes research projects papers articles documents- 同步到通知：
cd ../../tools/notion-integration
pnpm run sync SOCW-XXXX创建新的Web应用程序
- 在apps目录中创建Next.js应用程序：
cd apps
npx create-next-app@latest my-app --typescript --tailwind --app- Next.js 14中默认启用Turbopack+
- 运行开发服务器：
pnpm --filter my-app dev将文件同步到Notion
将存储库文件同步到Notion数据库：
cd tools/notion-integration
pnpm run sync [course-code]或同步所有课程：
pnpm run sync📦 依赖管理
共享依赖关系
共享开发依赖关系在根级别进行管理 package.json这些措施包括：
- TypeScript
- 埃斯林特
- 更漂亮
- 其他共享工具
应用程序依赖关系
每个应用程序 apps/ 在其 package.json.
🎯 概念集成（主要前端）
Notion是主要的编程前端 用于管理所有学术内容。存储库存储文件，而Notion提供组织、元数据和工作流管理的接口。
主要特点
- 双向同步：保持Notion数据库和存储库文件同步
- 自动化组织：根据Notion数据库条目自动组织的文件
- 元数据管理：将文件属性与Notion数据库字段链接
- 工作流程自动化：n8n工作流实现无缝集成
快速开始
- 数据库已创建：MSW-REPO学术档案数据库已建立
- 同步文件：运行
cd tools/notion-integration && pnpm run sync - 管理理念：使用Notion作为主要界面
有关详细的设置和使用方法，请参阅：
🔧 MCP服务器集成
此存储库配置为与Cursor IDE的MCP（模型上下文协议）服务器配合使用，以提高生产率：
- MCP概念 ⭐ 主要的：官方Notion托管MCP（OAuth）-所有Notion操作的主要接口
- 通过Notion应用程序通过OAuth连接 - 使用光标聊天与Notion工作区交互 - 看 MCP设置官方概念
- GitHub MCP：版本控制操作
- 研究MCP：Tavily，勇敢地寻找研究
- 文件系统MCP：文件操作
- 其他MCP：如中所配置
.cursor/mcp.json
📝 最佳实践
版本控制
- 使用以下描述性提交消息 约定式提交
- 为主要工作创建特征分支
- 保持
main分支稳定且可部署
文件组织
- 使用清晰、描述性的文件名
- 遵循一致的命名约定（日期为YYYY-MM-DD）
- 按课程组织→ 任务/项目→ files
- 将文件同步到Notion以进行元数据管理
文档
- 添加新课程或主要功能时更新README
- 文档工作流自动化
docs/workflows/ - 在各自的课程目录中保存课程特定的笔记
- 使用Notion进行详细的注释和标注
🔐 安全
- 切勿提交敏感信息（API密钥、密码）
- 使用环境变量进行配置(
.env被忽视） - 审查
.gitignore确保敏感文件被排除在外 - 保持安全补丁的依赖关系更新
- 通知API密钥安全存储在
.env文件
📚 资源
文档
- 概念整合——主要方法 ⭐ 主要的 -MCP（OAuth）官方概念
- 集成状态 -当前集成状态和验证
- MCP设置官方概念 -完整的设置指南
- 概念MCP快速入门 -快速参考指南
- 概念集成指南 -API直接集成（替代方法）
- 集成信息 -SCHOLAR MNKY集成详情
- 数据库设置完成 -数据库配置
- 存储库结构 -详细的结构文档
- 安装指南 -初始设置说明
外部资源
📄 许可证
\[在此处添加您的许可证\]
👤 作者
\[你的名字\]
______________________________________________________________________
备注：此存储库结构旨在随着您的学术旅程而发展。根据需要添加课程、项目和工具，同时维护组织结构。Notion是您通过官方Notion MCP（OAuth）集成管理所有学术内容的主要界面。