# egglet

**Repository Path**: royhatsune/egglet

## Basic Information

- **Project Name**: egglet
- **Description**: Egglet（易格）, 基于 Egg.js + Vue 3 的轻量级全栈 JavaScript 后台管理系统开发模板，开箱即用。
—— 这不是大神项目，是为像我这样的人准备的。
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-27
- **Last Updated**: 2025-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🥚 Egglet（易格）  
> **基于 Egg.js + Vue 的后台管理系统开发模板**  

[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
[![Docs](https://img.shields.io/badge/docs-online-brightgreen)](http://120.79.30.228)
[![Status](https://img.shields.io/badge/status-experimental-orange)](https://github.com/royhatsune/egglet)

## 📚 教程
查看完整文档：👉 [在线文档](http://120.79.30.228/)
---

## 🌟 前言：托起那些被技术浪潮冲散的人

在这个人人都在谈论 Next.js、Nest、TypeScript、微服务和 Serverless 的时代，  
有一群开发者却常常感到“格格不入”：

- 你可能不是科班出身，但因业务需要，开始自己动手搭建系统；
- 你需要短时间内交付一个带权限、用户、表单和报表的后台；
- 你试过低代码，但卡在“不能交付源码、无法深度定制”；
- 你搜过开源项目，却发现不是“只有登录页”，就是满屏 TS、Java、K8s，文档像天书；
- 你想用 AI 辅助编程，却因项目结构混乱，生成的代码根本跑不起来。

你开始怀疑：“是不是我能力不够？”

**不，不是你不行——是这个世界太着急了。**

急着追新，急着卷深度，却忘了：  
很多人只是想安静地、体面地，交付一个**能用、能改、能交接**的系统。

**Egglet（易格）**，就是为这样一群人而生：

- 会写 JavaScript，能改前端逻辑，但不一定是“全栈专家”——甚至可能刚入门；
- 需要快速交付一个可运行、可维护、可交付的企业后台；
- 希望用更少、更轻的技术栈快速上手，而不是被复杂的配置、艰深的类型系统或层出不穷的新框架挡在门外；
- 渴望拥有真正的源码控制权和灵活定制能力，而不是困在“黑盒”工具里；
- 正在学习全栈开发，希望从一个**结构清晰、注释完整、贴近真实场景**的项目中边做边学。

> 始终相信：**懂业务 + 愿意学 = 能做成事**。

> **我们不是在追赶技术浪潮，而是在托起那些被浪潮冲散的人。**

---

## 🎯 为什么是 Egglet？

### ✅ 交付导向，而非技术炫技

Egglet 的设计哲学很简单：  
**不追新，不炫技，只求稳、可用、能交付。**

在这个热衷于“最新框架”“最潮架构”的时代，Egglet 选择回归本质：

- 采用轻量、统一的全栈 JavaScript 技术栈，无需切换语言或生态；
- 使用经典的单体架构，一套代码覆盖前后端，开发、调试、部署更简单；
- 通过清晰的目录结构、JSDoc 注释和规范配置，让代码可读、可改、可维护。

Egglet 的每一个设计决策，都围绕一个目标：  
**让你在有限时间、有限资源下，交付一个客户认可、自己能维护、团队能接手的系统。**

因为我们相信：  
> **真正的好系统，不在于用了多少新技术，而在于能不能稳稳地上线、长久地运行。**

### ✅ 全栈 JavaScript，开箱即用
- 前端：Vue 3 + JavaScript（ES6+） + Ant Design Vue（antdv）  
- 后端：Egg.js 3+ + JavaScript + JSDoc（结构清晰，AI 友好）  
- 数据库：MongoDB（灵活 Schema） + Redis（缓存/会话）

> **我们选择 JavaScript，是为了让你更轻松地迈出第一步。**  
> 不是否定 TypeScript，而是希望降低门槛，  
> 让你**愿意学、敢修改、改得动**——  
> 因为只有真正动手，才能真正学会。

### ✅ 专为 AI 编程时代设计
- 清晰的目录结构、统一命名、完整 JSDoc；
- 让 Copilot、通义灵码等 AI 工具能准确理解上下文，生成可用代码；
- 配套 VS Code 推荐配置 + AI 插件指南。

### ✅ 保姆级中文文档
- 不只是“怎么用”，更是“为什么这样设计”；
- 不只是“能跑起来”，还会讲清楚核心模块的**设计思路与实现原理**；
- 包含常见问题排查、调试技巧、学习路径推荐；
- 从“改一行代码”到“独立交付项目”，陪你一步步成长。

---

## 🧑‍💻 谁适合用 Egglet？

- 🏭 传统行业 IT（实验室、检测机构、小工厂）需要自研管理系统；
- 💼 自由职业者接私活，客户要“能部署、能维护、有源码”；
- 📊 产品经理 / 业务分析师想自己搭原型或 MVP；
- 🧩 低代码用户遇到瓶颈，渴望转向“轻代码 + 高控制”；
- 🌱 编程初学者，希望从真实项目中学习工程化思维。

---

## 🚧 项目状态

> **当前处于初期开发阶段。**

- 开发节奏较慢（作者在职，业余维护）；
- 代码仍在打磨，但设计理念清晰；
- **非常欢迎你一起参与！**

你可以：
- 提出需求或痛点 💬  
- 贡献文档或示例 📝  
- 提交 PR 修复问题 🛠️  
- 分享使用体验 🌈  

**这不是一个人的项目，而是一群务实开发者的共同尝试。**

---

## 📦 技术栈一览

| 层级       | 技术选型                     | 说明 |
|------------|------------------------------|------|
| 前端       | Vue 3 + JavaScript (ES6+)    | 轻量易学，无需类型系统负担 |
| UI 框架    | Ant Design Vue (antdv)       | 企业级 UI，开箱即用 |
| 后端       | Egg.js 3+ + JavaScript       | 国内友好，文档完善 |
| 类型提示   | JSDoc                        | AI 友好，无需编译 |
| 数据库     | MongoDB                      | 灵活 Schema，适合快速迭代 |
| 缓存/会话  | Redis                        | 提升性能，支持分布式 |
| 配置       | dotenv                       | 环境变量统一管理 |
| 部署       | Docker + Shell 脚本          | 一键部署到云服务器 |

---

## 🤝 一起参与吧！

如果你也相信：  
> “**代码不是天才的专利，而是解决问题的工具。**”

那就来加入 Egglet 社区吧！

- Star 本项目 ⭐  
- 提 Issue 讨论想法 💡  
- Fork 并提交你的改进 🍴  
- 在 Gitee / GitHub 分享你的使用故事 📢  

---

## 💌 最后的话

做这个项目，不是因为我有多厉害，  
而是因为我经历过“想做点东西，却被技术门槛卡住”的时刻。

Egglet 不追求炫技，只求实用；  
不标榜先进，只求可用；  
不服务极客，只陪伴普通人。

**你不需要完美，你只需要开始。**

—— 一个正在学习和实践中的开发者  
2025 年 10 月