# mvi-app

**Repository Path**: startingsystem/mvi-app

## Basic Information

- **Project Name**: mvi-app
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-03
- **Last Updated**: 2026-03-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Craftime Android 应用

Craftime 是一个面向 DIY 创作者社区的 Android 多模块应用。

## 当前技术栈
- Kotlin `2.0.21`
- AGP `8.5.2`
- Gradle Wrapper `8.7`
- compileSdk `35`、targetSdk `35`、minSdk `26`
- Jetpack Compose + Material 3
- MVI + Clean Architecture
- Hilt、Coroutines/Flow、Room、DataStore、Retrofit/OkHttp、Timber

## 当前模块结构
```text
:app
:core:common
:core:ui
:core:theme
:core:network
:core:database
:core:analytics
:core:auth
:data:model
:data:network
:data:repository
:feature:auth
:feature:home
:feature:profile
:feature:settings
```

## 包名与应用 ID
- 包名前缀：`com.craftime.*`
- 应用 ID：`com.craftime.app`
- Debug 应用 ID：`com.craftime.app.debug`

## 构建与运行
```bash
./gradlew clean build
./gradlew installDebug
```

ADB 启动（debug）：
```bash
adb shell am start -n com.craftime.app.debug/com.craftime.app.MainActivity
```

## 统一配置管理
版本统一在 `gradle/libs.versions.toml` 管理：
- SDK 版本（`compileSdk`/`targetSdk`/`minSdk`）
- AGP / Kotlin
- 依赖与插件版本

各活跃模块统一从版本目录读取 SDK：
```kotlin
compileSdk = libs.versions.compileSdk.get().toInt()
minSdk = libs.versions.minSdk.get().toInt()
targetSdk = libs.versions.targetSdk.get().toInt()
```

## API 地址配置
请在以下文件修改后端地址：
- `app/src/main/java/com/craftime/app/di/AppModule.kt`

```kotlin
@Provides
@BaseUrl
fun provideBaseUrl(): String = "https://api.craftime.app/v1/"
```

## Phase 1 已落地能力
- `feature:auth`：登录/注册骨架
- `feature:home`：主页 Feed 骨架
- `feature:profile`：个人主页骨架
- `feature:settings`：主题/语言切换（en / zh-CN）

## 测试
```bash
./gradlew testDebug
./gradlew connectedAndroidTest
```

## 说明
- 当前实施状态以 `CRAFTIME_ARCHITECTURE_PLAN.md` 的“已落地”部分为准。