# multica-study

**Repository Path**: rowger_217/multica-study

## Basic Information

- **Project Name**: multica-study
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-13
- **Last Updated**: 2026-05-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Multica Study TodoList

Multica Study TodoList 是一个前后端分离的 TodoList 学习项目，适合用于练习 Vue 3、TypeScript、Go 与 SQLite 的基础工程化能力。

## 技术栈

| 模块 | 技术 |
| --- | --- |
| Web | Vite、Vue 3、TypeScript |
| Server | Go、SQLite |

## 文档导航

- [前端架构规划](./WEB_ARCHITECTURE.md)：说明页面、组件、状态管理、API 分层与测试建议。
- [后端架构规划](./SERVER_ARCHITECTURE.md)：说明服务分层、数据模型、接口设计、配置与测试建议。
- [API 接口文档](./API_DOCUMENTATION.md)：说明统一响应、错误码、请求参数和 Todo 接口约定。

## 项目目标

项目的 MVP 目标是完成一套可联调、可持久化的 TodoList：

1. 用户可以查看 Todo 列表。
2. 用户可以新增、编辑、删除 Todo。
3. 用户可以切换 Todo 完成状态。
4. 用户可以按状态筛选 Todo。
5. 服务端负责数据持久化与基础校验。

## 推荐目录结构

```text
.
├── web/                 # Vue + Vite 前端
│   ├── src/
│   ├── public/
│   ├── package.json
│   └── vite.config.ts
├── server/              # Go + SQLite 后端
│   ├── cmd/
│   ├── internal/
│   ├── migrations/
│   ├── go.mod
│   └── config/
├── README.md
├── WEB_ARCHITECTURE.md
└── SERVER_ARCHITECTURE.md
```

## 推荐开发顺序

### 第一阶段：后端最小可用能力

- 初始化 Go 服务与基础路由。
- 建立 SQLite 数据库与 `todos` 表。
- 提供 Todo 的增删改查接口。
- 补齐 service、repository、handler 的基础测试。

### 第二阶段：前端最小可用页面

- 初始化 Vue 3 + TypeScript 工程。
- 完成 Todo 列表页与基础组件拆分。
- 接入后端接口。
- 完成新增、编辑、删除、筛选与完成状态切换交互。

### 第三阶段：体验完善

- 增加加载态、空态、错误态。
- 增加表单校验与提交中状态。
- 优化列表交互与样式。
- 补齐联调说明、启动说明与部署说明。

## 接口边界约定

- 前端只通过 HTTP API 与后端交互，不直接访问数据库。
- 后端统一返回 JSON，便于前端进行一致的成功与错误处理。
- 时间字段统一使用 ISO 8601 字符串。
- 删除操作默认使用物理删除；如后续需要审计，再引入软删除。

## 核心数据模型

```ts
interface TodoItem {
  id: number
  title: string
  completed: boolean
  createdAt: string
  updatedAt: string
}
```

## 当前文档范围

当前仓库主要提供项目总览与前后端架构规划，可作为后续编码、任务拆分和联调的基线。正式实现时应以小步迭代为主，新功能配套测试。