devcamp7-leap

Leap (Learning Pathways) is a peer-to-peer Udemy inspired learning application built on Holochain.

This particular version of leap is built for the community-ran Holochain DevCamp 7.

See Homework for guidelines related to DevCamp homework assignments.

Development

IDE / editor

There are multiple parts in this repository where the code is located:

dna/course/zomes/courses/code contains Rust backend code
dna/course/test contains backend integration tests

You can either open these directories manually or you can use leap.code-workspace file to open the Microsoft Visual Studio Code workspace that would:

automatically open directories with zome code and integration tests;
prompt you to install the recommended extensions if they're not already present;
configure code formatting on each save for Rust files.

To open the workspace file, you can use two ways:

open Microsoft Visual Studio Code separately and then go to File > Open Workspace and select the leap.code-workspace file in the root of this repo. This would run Visual Studio outside of Holochain shell and it will be loading system level Rust tools
start Holochain shell in the root of this repository and inside it run code .. This will run Visual Studio inside the Holochain shell and it will be loading Rust tools provided by it.

working with rust-analyzer VSC extension

This is applicable for users of Microsoft Visual Studio Code. There's a great extenstion rust-analyzer that simplifies working with code in many different ways. However, there's a catch when using it for a Holochain app: it won't work at first until you build a Rust project directly for each zome:

open the project using the workspace file
open a VSC terminal in the code/ directory (Terminal > New Terminal)
start a Holochain shell there
do cargo build

You only need to do it once for a project given that you won't be deleting the build files.

Building

All code building needs to be done in a Holochain shell which you can start by running:

nix-shell https://holochain.love

If you don't have it installed, please refer to the official doc.

Package the entire DNA

This will build Rust project for every zome in DNA (we have just one) and then package it all into a Holochain format.

go to dna/course
run hc package

Build Rust project for a zome

This will just build a Rust project using Rust toolchain.

go to a zome directory dna/course/zomes/courses/code
run cargo build

User stories

A user should be able to view 3 tabs: enrolled courses, my courses and all courses
In enrolled courses, a user should be able to see all the courses in which the user is enrolled
In my courses, a user should be able to see all the courses in which the user is the teacher, with a "Create course" button and a "Delete course" button, and an Edit button inlined
In all courses, a user should be able to see all courses with an "Enrol" button if the user is not its teacher
The teacher for a course should be able to create/edit/delete a section in the course from each course view inside "My courses" tab
The teacher for a course should be able to create/edit/delete contents for each section from the section's view inside "My courses" tab
The teacher for a course should be able to see all the students for that course

Joshfairhead/devcamp7-leap