跳到主要内容

3R教室使用手册

success

为了更好的使用3R教室,请仔细阅读本手册

🐙群组

如果有技术上的问题请尽量去3r酷论坛发帖,站长和其他管理员以及助教@cloneable会轮值在线.如果是比较简单的问题也可以在会员QQ群讨论解决,请勿在微信会员群讨论

提示

有非技术问题请QQ联系站长@pincman,电脑微信不怎么登录了.另外,站长可能因为生物钟紊乱导致如果无法及时回复请耐心等待,看到会按消息顺序逐条处理的

信息

新进的会员会收到站长给你的账户密码,账户:以你微信或QQ名称命名,密码:12345678.论坛和代码仓库平台统一这一个账户密码,登录两者后请及时修改密码

3R教室有许多讨论工具和群,这里分别说明一下它们的作用和进群方式

🗨️微信群

微信群目前主要会员微信群一和会员微信群二构成

  • 所有会员付费进入3R后,首先站长会拉你进入会员微信群
  • 由于微信会员群群一已满,导致群一群二信息割裂.所以当前我们已放弃微信的具体使用而迁移至QQ群.会员微信群只作为人数统计、活动等通知所用.但请不要退群,后续微信群还是作为没有QQ的会员同学获取通知消息的备用渠道
  • 其他群有海外会员群、大厂会员群、自由职业/创业者会员群,如果匹配,可以让站长@pincman拉进去(后续这些群会改成QQ群,请尽快想办法注册QQ号)

🐧QQ群

会员QQ群(在这里获取)目前已经成为3R教室的主力交流工具,我们正在强制迁移至QQ群,其作用如下

信息

付费购买会员后,请自行申请加入会员群,站长会通过

  • 会员间的日常交流,如发现不良信息艾特社区管理员loki举报
  • 课程更新通知,掘金课直播通知等等
  • 发布3R工作室的一些招聘合作方的岗位信息(坐班/远程都有)
  • 发布3R工作室接到的一些已达成合作的外包项目的组队信息(论坛也会同步一份,但信息会延后,一般用于在组队成功后发布用于大家了解该项目)
  • 会员之间发布岗位信息,外包信息,求职信息等(同时建议在论坛的相应频道发布一份,以免消息被覆盖)
  • 向其他会员(也可以直接艾特pincmancloneable)请教一些简单的课程和技术问题的解答和求助,(复杂以及同质性问题可以去论坛发布或搜索)
  • 分享一些会员自己开发的好的作品或者推广一些会员自己的收费服务(同时建议去论坛发帖同步一份,这样会获得更多的曝光率)
  • 另外,,我们还有个公益的QQ社区交流群,有兴趣也可以加一下,群号:868366691

整体来说,QQ群如同一个轻量级的3R酷论坛,作为一个即时性的教室使用工具(后续我们会开设QQ频道,使该工具为大家提供更多的服务)

🛖论坛

3R酷论坛是与QQ群同等重要的3R教室工具,购买付费会员后,站长pincman会给你添加一个论坛账户,并自动升级为vip用户

✈️其它

  • 电报群:用于一些海外的或者因其他原因无法注册QQ的会员入驻(请尽量使用QQ,电报可能无法得到最及时的消息和资料以及机会),电报链接在这里获取

  • Discord:后续作为一个公益社区存在,我们正在重建中,如果有需要进,请自行访问3R Discord社区服务器(与电报一样需要爬梯,进不去就算了)

🎓课程

2024年课程更新计划表,请查看此贴

👨‍💻路径

危险

我们花了大量的时间在文档上,因为站长认为看文档才是最好的学习方法,这可以拓展思维以及在实践中获取更稳固的经验.而看视频学个基础就要浪费大把时间,看完后可能仍然是一知半解的小白,所以我们视频更新会比较慢,并且作用主要是用于在自媒体平台推广而已!

新课的学习方法比较简单,没有太大的心智负担!查看你要学习的课程的文档,跟着文档一步步走,如果不懂的地方可以在QQ群或者论坛提问就行了,如果需要看详细的学习方法和路线可以看每个课程的概览文档.在学习课程的同时,如果你已经会一部分了,不妨下载来自3R工作的商业项目代码研究(仅客户允许共享的项目).所有新会员默认已开启经客户这些商业项目的下载权限,可进行更改后用于作为你求职或者接单的案例(必须修改后使用),会非常有帮助.@Miwen同学的网站案例就是一个很好的例子!对于技术比较好,时间比较充裕以及有自由职业经验的同学,在我们3R工作室有新项目的情况下也可以参与开发获取报酬并提升技术(人太多,所以这个几率比较低,看缘分的😄)!

关于具体的学习和实践路径,站长的建议如下(技术课和掘金课可以同时学习不冲突)

🤺技术课

课程学习
  • 零基础或非前端开发者:TS基础 -> nestjs -> 运维/CICD -> react -> nextjs
  • 前端开发者:nestjs -> 运维/CICD

在学习时对着文档写一遍代码并尝试理解(无法理解可以看我们后续补上的视频).如果代码有问题再对比从代码仓库中拉下来的课程代码纠错.最后,如果还有问题可以QQ群或论坛问答

对于代码的使用,我们遵循两个原则

一、每个课程对应一个代码仓库

比如《nestjs最佳实践》对应classroom/nestjs仓库,查看对应课程对应的仓库请访问课程文档主页的该课程目录部分,如图

二、需要查看当前课程的代码,请切换到对应分支

如《Nestjs最佳实践》课程学习到核心框架模块,则使用以下命令切换到framework分支

git checkout framework

在该课程的代码仓库从查看分支列表,如图

商业项目
  1. 学习3R工作室开发的部分开发权限的商业外包项目源码,并吃透其中一两个案例的代码(建议goflash/kuromi+xiaowen)
  2. 尝试修改并扩展为自己的案例
  3. 买个服务器部署你的案例
  4. 商业项目有问题可以在论坛求助版块或者QQ群求助该项目的开发者(开发者志愿回答,没有必回的义务)

第三步:个人网站

如果前端比较强则最好自己写个个人网站部署,否则可以选择

信息

使用typecho/wordpress搭建网站只需要看一下《TS全栈开发课》的"服务器运维部署"这一节课即可,而其他方式还需要学习"Gitea+Drone构建CICD"这节课

  • 使用typecho+handsome主题(收费)搭建一个网站(适合完全不会技术的同学)
  • 使用wordpress并网上找个好点的收费主题搭建一个网站(需要会一定的PHP)
  • 使用3rcd的官网源码 - rowfishclassroom仓库中)并在此基础上进行修改(需要对react玩得比较好)部署到你自己的服务器上
  • 使用@愧怍(纯静态React)或者@Miwen(Nextjs+Nestjs)或者@小何(Nextjs+Nestjs+React+Vite)几位会员的官网源码修改并搭建自己的网站

💰掘金课

如果自己有明确的目标,则按自己的需求去学习掘金课的方法并尝试

  • 远程工作求职
  • 海外高价外包接单
  • 被动收入实现
  • 提升被动收入收益

等等

如果没有明确的目标和规划或实践无效,可以发帖预约站长"一对一"服务规划一下 从2024年开始,站长建议把你的实践效果分享到论坛(为了避免竞争可以不用写出你的方法),如果符合要求站长会在节日寄送一些我们3R教室的订制礼物给你!

📚流程图

具体学习与协作方案可参考下图

📒文档

信息

在windows下必须安装wsl2,下面所有linux操作包含Debian系的Linux发行版(Redhat或者Arch系的大同小异)和windows下的wsl2 linux子系统

📌准备工作

注意

在windows下所有执行的命令,都是打开windows terminal 进入 wsl子系统后执行的.非要在windows宿主机中打开git bash或者powershell去执行命令遇到的一切问题不做解答,请自行负责!

MacOS系统

  1. 下载安装iterm2(一个比苹果自带的terminal更好用的命令行工具)
  2. iterm2执行/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"命令安装brew(一个包管理工具) 3.(可选步骤)可以自行按需配置iterm2使他变得更好看,怎么配置请自行谷歌搜索,不配置也不影响使用
  3. 执行brew install git以安装git
  4. 下载并安装docker桌面版,请尽量在(设置 -> General)里设置开机启动,以免开机后手动启动

Windows系统

  1. 打开App商店的Windows Terminal,点击"install"按钮安装Windows Terminal
  2. 打开Windows Terminal,点击标签栏的向下箭头按钮选择"Windows Powershell"
  3. 输入wsl --install以安装wsl2
  4. 关闭windows terminal并重新打开,点击标签栏的向下箭头按钮选择"ubuntu"子系统(即进入wsl)
  5. 在wsl子系统中先执行sudo apt-get update && sudo apt-get upgrade -y升级包,然后执行sudo apt-get install -y git 命令以升级系统包和安装git
  6. (可选步骤)可以把wsl作为windows terminal默认打开的窗口以及做一些其它的美化,请自行谷歌搜索"windows terminal配置"等
  7. 下载安装docker桌面版,并整合wsl(点击顶部的设置图标 -> Resources -> WSL integration),请尽量在(设置 -> General)里设置开机启动,以免开机后手动启动

Linux系统

你都这么屌了,我就不多说了(建议manjaro系统) 先安装docker,桌面发行版安装docker desktop,远程服务器安装docker EC 然后安装git

sudo apt-get update && sudo apt-get upgrade -y
sudo apt-get install -y git
# redhat系,fadora/centos等
# sudo yum update && sudo yum upgrade -y
# sudo yum install -y git

# arch系,manjaro/arch等
# sudo pacman -Syy
# sudo pacman -S yay
# yay Syu
# yay -S git

💻克隆仓库

提示

新手请注意:这里的~符号是默认指向用户目录

一、生成ssh key 打开命令窗口,执行以下命令,不停按回车生成,不要输入密码什么的

ssh-keygen -t rsa -C "随意填一个邮箱地址"

二、添加密钥 打开刚才生成的密钥,位置在~/.ssh/id_rsa.pub 可以通过cat命令来输出内容,并复制

cat ~/.ssh/id_rsa.pub

然后使用站长给你提供的账户及密码登录我们自建的git代码托管平台,点这个链接,点"增加密钥",把刚才复制的key内容添加进去(名称随意填写或默认即可)并添加

三、克隆文档 打开命令窗口,使用以下命令克隆文档

git clone git@git.3rcd.com:classroom/courses.git

在克隆或拉取更新代码时如果遇到以下问题 请使用命令code ~/.ssh/known_hosts(~为当前用户目录)打开known_hosts,并删除其中那些带有git.3rcd.com的行 后续请关注QQ群以及3R酷论坛的教室 -> 通知频道,如果课程有更新消息,请通过以下命令更新

cd ~/courses && git pull origin main

☕启动文档

打开命令行窗口,定位到文档目录,并用以下命令启动

cd ~/courses
docker compose up -d

然后用浏览器打开localhost:3333就能看到文档了

📽️视频

目前课程网盘主要存放旧版Nestjs课以及 《掘金课》 的直播及录制视频,新版《TS全栈课》采用全文档方式学习

提示

为了方便零基础的同学快速入门,2024年2月开始,我们将陆续增加新版《TS全栈课》的视频,请自行通过网盘获取,但强烈不建议作为技术课主要学习途径!

所有视频均在百度网盘下载,百度网盘链接请点击这里获取

📃问答

在学习课程的时候(掘金课除外),遇到问题,请到3R酷的教室-问答版块发帖提问

  1. 如果问题需要加紧处理,则在帖子中@cloneable助教,对于帖子的问题,我们一般会在24小时内进行答复
  2. 简单问题可以在QQ群求助其他会员也可以直接@cloneable或者@pincman
  3. 课程代码或文档BUG在BUG子版块提交
  4. 非课程问题求助和一些交流探讨可以在求助/探讨版块版块进行

🐸技术课问答(BUG报告除外)

注意

严禁一切微信开私聊问答,微信私聊问答一律不解答,请各位R友使用QQ或者小灰机!

按问题优先等级进行提问

  1. 最高级别为课程文档问题:如果下载文档后按本文方式无法跑起来这时候可以直接QQ联系站长pincman
  2. 简单课程代码问题:对课程代码不理解的地方,建议QQ群@pincman@cloneable解答
  3. 复杂课程代码问题:对课程代码不理解的地方,建议论坛的"教室-问答"版块@cloneable解答
  4. 站长开发的作品(比如rowfish,极客星空,toome等)代码问题:在QQ群或者论坛的"教室-问答"求助站长@pincman
  5. 3R工作室商业外包项目部署或代码问题:可以艾特该项目的主力开发(如果是单人开发直接艾特开发者即可(凭开发者志愿是否愿意解答)
  6. 如果是非3R课程或工作室相关代码请自行群里求助,站长或助教无义务解答,但是群友们都很牛掰!

🐻淘金课问答

直接去"教室-一对一预约"版块发帖预约时间,然后QQ联系站长确认时间即可(建议时间到的时候提前10分钟再次通知站长)

🥝仓库

课程文档和代码统一放在classroom组织中,课程文档集合中于courses仓库.而每个课的代码仓库其示意如下图

红箭头中是在学习完课程后一些3R工作室承接的一些客户允许共享的商业项目代码(老会员如果没有的话可联系@cloneable或者@loki开通访问权限

这些项目对应的需求文档和设计在论坛的招聘/外包->工作室版块中,自己打开对应的帖子就能看到

💰掘金课

《远程掘金课》有直播会议和一对一指导两种模式

会议模式

关注群消息,每一期掘金课直播时在QQ群艾特所有人,然后录制会放到百度网盘里。主要时站长和其他通过远程技术变现成功的同学(嘉宾位)分享一些自己的经验和心得,以及一些非常实用的渠道和方法

主要集中于以下内容

  • 海外(或国内)高价外包项目接单的渠道和与客户洽谈的技巧
  • 被动收入与睡后收入的成功方案(比如售卖自己的作品,做平台通过会员制或广告费盈利,做知识付费等)
  • 远程工作的求职技巧和方法
  • 创业快速融资的一些办法和资源的对接
  • ...

一对一模式[新]

提示

预约请避免当天有其他同学预约,每天最多一次一对一.如果站长当天没时间,会在回复里写明,如果站长没有回复请在时间到之前半小时QQ群联系站长再次确认时间以免站长遗忘

一对一服务是教室新推出的一项服务,对于有技术变现,职业规划等需求会员同学,站长@pincman会提供一些自己力所能及的经验和方案 需要该服务请去11预约版块按照模板发帖,预约不是一次性的,可以根据结果反馈不断地跟进调整

🗽英语教室

由于讲师@慧敏同学时间不够用,英语教室项目暂时停摆中

🪄 资源

💼招聘外包

信息

如果你有外包需要我们工作室承包开发/如果有招聘人员需求可以联系站长pincman
会员的外包站长收取差价比较低,但会得到质量和效率上的保障.会员需要招聘人员是免招聘中介费的,站长会在会员中快速给你找到合适匹配的人才

需要招聘开发者或者其他工作人员(可远程/坐班),请到招聘/外包版块发帖

  • 工作室子版块为3R工作室自行发布的外包项目组队和招聘合作方的招聘信息,也就是外部客户或会员联系我们官方发布的机会信息
  • 如果你需要自行发布,请先QQ联系站长,通过允许后才可以发布
  • 组队中的项目是正在找人的外包项目、已交付的项目是3R工作室只负责编写代码而由客户自行维护的项目、维护中的项目委托给3R工作室维护的项目

请注意以下事项:

自2024年起

  • 工作室有新项目需要会员群中同学组队开发或者有招聘信息不会在微信群发了,而是在QQ群和论坛的招聘/外包版块中发,看到后如果有兴趣请回帖或联系站长QQ
  • 如果你是招聘者,必须先把JD给站长看一下,允许后可去论坛发贴找人.但不得留下微信号,而是写明请会员QQ群联系 @cloneable@pincman不得直接在群里私加招聘或求职,多次被举报会取消会员资格,同时举报者有大额红包可领
  • 如果你是有项目外包,可以首先考虑"3R工作室",如果不需要3R工作室开发也可以自行去论坛发帖找人.但不得留下微信号,而是写明请会员QQ群联系 @cloneable@pincman不得直接在群里私加做单或接单,多次被举报会取消会员资格,同时举报者有大额红包可领)

💡资源互通

分享/推广版块你可以

  • 分享一些你自己的作品或者发现的或开源的或收费的好东西
  • 推广你自己的收费产品或服务(可以是任何虚拟或实物产品及服务,如云主机,移民咨询服务、课程、软件等也可以是其他的电器,电脑,键盘甚至水果等)

创意/展示版块的作用是

  • 可以展示自己,以获取3R工作室向招聘合作方的推荐机会和开发工作室外包项目的机会,亦或是让更多需要人才的会员看到你
  • 如果你是创业者,可以在此发布寻找合作伙伴或融资需求(推广产品请去分享/推广版块)