Summary

datawhalechina/wow-fullstack provides a runnable full-stack development tutorial coupled with a functional time management and learning system. Aimed at developers, it offers copy-pasteable code and a structured learning path, integrating theoretical concepts with a practical Vue 3/FastAPI application.

How It Works

This project merges educational content with a live application. The frontend uses TypeScript, Vue 3, and Vite; the backend employs FastAPI. Its core design emphasizes synergy between tutorial examples and the application's codebase, enabling hands-on learning and direct concept application within a functional system.

Quick Start & Requirements

• Clone: git clone https://github.com/datawhalechina/wow-fullstack.git
• Prerequisites: Python 3.10, Node.js v18.18.0, npm 10.2.5.
• Backend Setup: cd tm-backend, copy .env.example to .env, pip install -r requirement.txt, alembic upgrade head, python seed.py.
• Frontend Setup: cd tm-frontend, copy .env.example to .env (set VITE_API_URL), npm install.
• Running: Backend: python main.py (in tm-backend). Frontend: npm run dev (in tm-frontend).
• Docs: Tutorials in tutorial/ (Markdown). Dev docs available.
• Demo: Backend: http://127.0.0.1:8008 / /docs. Frontend: 192.168.x.x link. Login: 15812345678 / zishu.

Highlighted Details

• Curriculum: 13 tutorial modules cover frontend (Vue 3, TS, ElementUI-Plus), backend (FastAPI), automation (Excel, PDF, PPT, Word, Compression), and basics (CSS, IP).
• Integrated App: Features time management, course learning, "塾值" (points) system, AI chatbot (Coze AI), and user learning statistics.
• Admin Panel: User/permission management, system config, statistics analysis.
• Code Synergy: Tutorial examples derive from project code; project code references tutorials, creating a tight learning loop.

Maintenance & Community

Maintained by the "自塾" team with Datawhale. Contributions are welcomed via GitHub Issues and Discussions. The primary maintainer is Kailigithub. Follow Datawhale's official account via QR code.

Licensing & Compatibility

Licensed under MIT. A note mentions default CC 4.0 use, requiring clarification for specific commercial integration.

Limitations & Caveats

The project is in "Beta public testing" (Beta公测版) with ongoing detail optimization. Requires specific Python (3.10) and Node.js (v18.18.0) versions. The dual licensing mention (MIT/CC 4.0) may require further investigation for strict commercial use.