# 小程序

**Repository Path**: guangshazhiyin/mini-program

## Basic Information

- **Project Name**: 小程序
- **Description**: 微信小程序大赛
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-06
- **Last Updated**: 2026-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 事件中心小程序 · 事件中心 / Event Center Miniapp

> **比赛**：2026 微信小程序开发大赛（腾讯办 · 49 万奖金）
> **截止**：**2026-10-17 23:59** 提报
> **9 月目标**：9 月内完成主链路 demo（25 天成型）

把分散在手机里的**照片 / 聊天截图 / 录音 / 文件 / 文字**统一组织进"事件"，AI 抽出关键事实 + 时间线，**每个 AI 结论都能点击跳回原始记录**。

## 技术栈（原架构）

| 端 | 技术 | 负责人 |
|----|------|------|
| **Core Backend** | Java 21 + Spring Boot 3.5.x + MyBatis + Flyway | **徐** |
| **AI Backend** | Python 3.12 + FastAPI + Pydantic + httpx + OpenCV + Pillow + FFmpeg | **陈** |
| **Database** | PostgreSQL + pgvector（后期）+ Redis | 徐 |
| **Storage** | MinIO（开发）+ 腾讯云 COS（生产） | 徐 |
| **Async** | Redis Streams → RabbitMQ（后期） | 徐 |
| **Infrastructure** | Docker + Compose + Nginx + CI + OTel + Prom + Grafana | 徐 |
| **Client 微信小程序 + H5** | Taro 4.1.11 + React 18 + TS + SCSS（webpack5-runner）+ 自研轻量 store（**已弃用 zustand**，见 `frontend-taro/README.md`）| **邓** |
| **Admin 管理后台** | React + Vite + TS + Antd + TanStack Query | 邓 |
| **AI Provider 抽象层** | OCR / ASR / VLM / LLM / Embedding | 陈 |
| **Report 报告** | HTML/CSS + Headless Chromium → PDF | 陈 |
| **PM + 协调** | 产品决策 / 群沟通 / demo 脚本 / 拍板 | **陈** |

## 目录结构

```
event-center-miniapp/
├── README.md                    ← 本文件
├── .gitignore                   ← 多语言 ignore 规则
├── backend-java/                ← 徐：Spring Boot Core Backend（脚手架待徐初始化）
├── backend-python/              ← 陈：FastAPI AI Backend（★可运行骨架，2026-09-08）
│   ├── app/main.py              FastAPI 入口
│   ├── app/config.py            .env 配置
│   ├── app/api/v1/health.py     健康检查（/api/v1/health）
│   ├── app/providers/           ★ Provider 抽象层（LLM/VLM/OCR/ASR/Embedding）
│   ├── scripts/test_keys.py     4 家 Key 验证（4/4 PASS）
│   └── tests/                   pytest
├── frontend-taro/               ← 邓：Taro Client（脚手架待邓初始化）
├── frontend-admin/              ← 邓：React Admin（脚手架待邓初始化）
├── deploy/                      ← 徐：docker/nginx/ci 占位（W4 填充）
├── assets/
│   ├── README.md                素材约定
│   └── demo-seed/               演示素材（5 类证据占位目录）
└── docs/
    ├── api-contract-v1.yaml     ← 接口契约（Core 12 + AI 6）
    ├── 开发启动计划_v4.md       ← 完整 v4 启动计划（13 节）
    └── 小组群问题清单.md
```

## 快速开始

### 1. Clone

```bash
git clone https://gitee.com/guangshazhiyin/mini-program.git
cd event-center-miniapp
```

### 2. 各成员开发入口

| 你是 | 进入 | 下一步 |
|------|------|------|
| **徐**（Core Backend） | `cd backend-java` | 官方脚手架初始化后 `mvn spring-boot:run` |
| **陈**（AI Backend） | `cd backend-python` | `python -m uvicorn app.main:app --reload`（已可跑） |
| **邓**（Client / Admin） | `cd frontend-taro` 或 `frontend-admin` | 官方脚手架初始化后 `npm run dev` |

> 完整初始化、依赖安装、Docker Compose 启动细节见 `docs/开发启动计划_v4.md`。

## 关键约定

- **commit message**：使用 Conventional Commits（`feat:` / `fix:` / `docs:` / `refactor:`）
- **分支策略**（2026-09-11 定）：
  - `master` = 保护分支，**禁止直推**，所有改动走 PR → **徐或邓审核通过后合并**
  - 各人工作分支：`chen/ai-backend`（陈 + AI 助手）、`feat/*`（邓）、徐按自己习惯命名
  - **AI 助手只往 `chen/ai-backend` 推送**，不碰 master 与其他成员分支
- **PR 流程**：工作分支 → 陈发起 PR → 徐/邓 审核 → 合并 master
- **接口契约**：陈出 v1 OpenAPI/Swagger，徐/邓 按契约 mock
- **沟通**：每日 22:00 群进度（≤5 行）；卡点 ≥4h 升级
- **Provider 抽象**：所有 AI 调用走 Provider 接口，业务代码不动可切换供应商

## 项目状态

- **W1 (9/06-9/12)**：环境就绪 + 接口契约 v1 + AI Key 申请
- **W2 (9/13-9/19)**：核心链路跑通（登录 + CRUD + 时间线）
- **W3 (9/20-9/26)**：AI 抽取全链路（5 类证据 → fact → 时间线）
- **W4 (9/27-9/30)**：9 月底成型收口 + 体验版发布
- **W5 (10/01-10/10)**：CI/CD + Report PDF + 提审
- **W6 (10/11-10/17)**：答辩材料 + 提报

详细见 `docs/开发启动计划_v4.md`。

## 仓库

- 远程：`https://gitee.com/guangshazhiyin/mini-program.git`
- 私有，比赛期间仅团队可见