# zzyss-marker/newinno architecture

> Architecture diagram of the GitHub repository zzyss-marker/newinno, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zzyss-marker/newinno
- Repository: https://github.com/zzyss-marker/newinno

## Overview

##### Project Type and Purpose
- This is a full-stack laboratory reservation system consisting of:
- A FastAPI-based RESTful backend (`app/`)
- A Flask-based administrative web app (`admin_system/`)
- A WeChat Mini-Program frontend (`fore/`)
- A SQLite persistence layer

##### File Structure
- Top-level directories:
- `app/` – Main backend (FastAPI)
- `admin_system/` – Admin UI (Flask)
- `fore/` – WeChat mini-program client
- `doc/` – Architecture and command docs
- `test/` – Test scripts (locust load tests, test user creation)
- Key config/build files:
- `requirements.txt` – Python dependencies
- `run.py` – Launcher for FastAPI service
- `admin_system/run.py` – Launcher for Flask admin
- `fore/project.config.json` – Mini-program project config

##### README
- Confirms the above stack and outlines:
- User authentication flows
- Reservation workflows (venues, equipment, 3D printers)
- Admin features (approval, user/device management, data export)
- Tech requirements (Python 3.8+, FastAPI, Flask, SQLite, WeChat dev tools)

##### Main Components
a. WeChat Mini-Program (fore/)
– Pages: login, venue/equipment/3D-printer reservation, approvals, history
– Utilities: API client (`fore/utils/request.js`)
b. API Layer (app/)
– FastAPI entrypoint (`app/main.py`)
– Routers for auth, admin approval, management, reservations
– Business logic & validation (`app/utils/`)
– Data models & schemas (SQLAlchemy models & Pydantic schemas)
c. Admin Web App (admin_system/)
– Flask app (`admin_system/app/routes` & `templates`)
– Static assets & CSS for admin UI
– User/device/reservation management pages
d. Database(s)
– Primary SQLite (`app.db`) used by FastAPI
– Admin SQLite (e.g., `admin.db`) used by Flask app
– Schema creation scripts in `app/db/` and `admin_system/create_admin.py`
e. External Tools
– Uvicorn/ASGI server for FastAPI
– Locust for performance testing (`test/locustfile.py`)
– WeChat Developer Tools for front-end

##### Relationships & Data Flows
- The Mini-Program issues HTTP(S) requests to the FastAPI server (`/api/*` endpoints).
- The FastAPI service uses SQLAlchemy to read/write the primary SQLite database.
- The Flask-based Admin UI runs separately (e.g., on port 5000), reads/writes its own admin database, and may call the same or separate tables for user/device management.
- Both services enforce authentication & authorization (role-based) via tokens or sessions.

##### Architectural Patterns & Principles
- Layered architecture:
- Presentation layer (WeChat UI & Flask admin UI)
- Application/API layer (FastAPI routers, business logic)
- Data access layer (SQLAlchemy models, DB scripts)
- Separation of concerns:
- Frontend vs. backend vs. admin UI
- Validation & security in `utils/` modules
- Microservices-style separation: two independent services (FastAPI + Flask) connected to their respective data stores.

##### Technologies & Frameworks
- FastAPI, Uvicorn, SQLAlchemy, SQLite
- Flask, Jinja2 templates, CSS
- WeChat Mini-Program SDK, JavaScript, WXML/WXSS
- Locust for load testing

##### Essential Elements
- Component labels (e.g., “FastAPI Main”, “SQLAlchemy ORM”, “Venue Router”)
- Annotations for major frameworks and languages
- Callouts for important config files (e.g., `config.py`, `config.js`)

## Diagram (Mermaid)

```mermaid
graph TB

    %% WeChat Mini-Program Frontend
    subgraph "WeChat Mini-Program" 
        direction TB
        WM[("Mini-Program Client")]:::frontend
        Pages[("Pages (login, venue, device, printer, approval, records, admin, my)")]:::frontend
        RequestUtil[("API Client Utility")]:::frontend
    end

    %% FastAPI Backend
    subgraph "FastAPI Backend (app/)"
        direction TB
        Main[("FastAPI Entrypoint\napp/main.py")]:::backend
        DatabaseCfg[("DB Config & Init\napp/database.py\napp/db/init_db.py\napp/db/admin_system_db.py")]:::backend
        Routers[("Routers")]:::backend
        AuthRouter[("Auth Router\napp/routers/auth.py")]:::backend
        AdminRouter[("Admin Approval Router\napp/routers/admin.py")]:::backend
        MgmtRouter[("Management Router\napp/routers/management.py")]:::backend
        ResRouter[("Reservations Router\napp/routers/reservations.py")]:::backend
        Models[("Data Models\napp/models/models.py\napp/models/admin_system_models.py")]:::backend
        Schemas[("Pydantic Schemas\napp/schemas/schemas.py")]:::backend
        Utils[("Utilities\napp/utils/auth.py\napp/utils/validation.py\napp/utils/security.py\napp/utils/excel.py")]:::backend
    end

    %% Flask Admin UI
    subgraph "Flask Admin UI (admin_system/)"
        direction TB
        AdminRun[("Launcher\nadmin_system/run.py")]:::admin
        AdminCfg[("App Factory & Config\nadmin_system/app/__init__.py\nadmin_system/app/config.py")]:::admin
        AdminModels[("Models\nadmin_system/app/models.py")]:::admin
        Routes[("Routes")]:::admin
        AllRoutes[("Combined Routes\nadmin_system/app/routes.py")]:::admin
        SubAdminRoute[("Admin Blueprint\nadmin_system/app/routes/admin.py")]:::admin
        SubAuthRoute[("Auth Blueprint\nadmin_system/app/routes/auth.py")]:::admin
        Templates[("Templates\nadmin_system/app/templates/")]:::admin
        StaticCSS[("Static Assets\nadmin_system/app/static/style.css")]:::admin
        CreateAdmin[("Admin DB Script\nadmin_system/create_admin.py")]:::admin
    end

    %% Databases
    subgraph "SQLite Databases"
        direction TB
        AppDB[("Primary SQLite DB\napp.db")]:::db
        AdminDB[("Admin SQLite DB\nadmin.db")]:::db
    end

    %% External Tools
    subgraph "External Tools"
        direction TB
        Uvicorn[("Uvicorn/ASGI Server")]:::external
        Locust[("Locust Load Tests\ntest/locustfile.py")]:::external
        TestUser[("Test Scripts\ntest/create_approval_admin.py")]:::external
        WeChatTools[("WeChat Dev Tools")]:::external
    end

    %% Connections
    WM -->|HTTPS /api/*| Main
    Pages -->|uses| RequestUtil
    RequestUtil -->|calls| Main

    Main -->|initializes| DatabaseCfg
    Main -->|includes| Routers
    Routers --> AuthRouter
    Routers --> AdminRouter
    Routers --> MgmtRouter
    Routers --> ResRouter

    AuthRouter -->|uses| Utils
    AdminRouter -->|uses| Utils
    MgmtRouter -->|reads/writes| Models
    ResRouter -->|reads/writes| Models

    Models --> Schemas
    Main -->|serves via| Uvicorn

    DatabaseCfg -->|SQL| AppDB

    AdminRun -->|starts| AdminCfg
    AdminCfg --> AllRoutes
    AllRoutes --> SubAdminRoute
    AllRoutes --> SubAuthRoute
    SubAdminRoute --> AdminModels
    SubAuthRoute --> AdminModels
    AdminModels -->|SQL| AdminDB
    Templates -->|render| AllRoutes
    StaticCSS -->|styling| Templates

    AdminDB -.->|optional data sync| AppDB

    Locust -->|load tests| Main
    TestUser -->|setup| AppDB
    WeChatTools -->|build| WM

    %% Click Events
    click WM "https://github.com/zzyss-marker/newinno/tree/main/fore/"
    click Pages "https://github.com/zzyss-marker/newinno/tree/main/fore/pages/"
    click RequestUtil "https://github.com/zzyss-marker/newinno/blob/main/fore/utils/request.js"

    click Main "https://github.com/zzyss-marker/newinno/blob/main/app/main.py"
    click DatabaseCfg "https://github.com/zzyss-marker/newinno/blob/main/app/database.py"
    click DatabaseCfg "https://github.com/zzyss-marker/newinno/blob/main/app/db/init_db.py"
    click DatabaseCfg "https://github.com/zzyss-marker/newinno/blob/main/app/db/admin_system_db.py"
    click AuthRouter "https://github.com/zzyss-marker/newinno/blob/main/app/routers/auth.py"
    click AdminRouter "https://github.com/zzyss-marker/newinno/blob/main/app/routers/admin.py"
    click MgmtRouter "https://github.com/zzyss-marker/newinno/blob/main/app/routers/management.py"
    click ResRouter "https://github.com/zzyss-marker/newinno/blob/main/app/routers/reservations.py"
    click Models "https://github.com/zzyss-marker/newinno/blob/main/app/models/models.py"
    click Models "https://github.com/zzyss-marker/newinno/blob/main/app/models/admin_system_models.py"
    click Schemas "https://github.com/zzyss-marker/newinno/blob/main/app/schemas/schemas.py"
    click Utils "https://github.com/zzyss-marker/newinno/blob/main/app/utils/auth.py"
    click Utils "https://github.com/zzyss-marker/newinno/blob/main/app/utils/validation.py"
    click Utils "https://github.com/zzyss-marker/newinno/blob/main/app/utils/security.py"
    click Utils "https://github.com/zzyss-marker/newinno/blob/main/app/utils/excel.py"

    click AdminRun "https://github.com/zzyss-marker/newinno/blob/main/admin_system/run.py"
    click AdminCfg "https://github.com/zzyss-marker/newinno/blob/main/admin_system/app/__init__.py"
    click AdminCfg "https://github.com/zzyss-marker/newinno/blob/main/admin_system/app/config.py"
    click AdminModels "https://github.com/zzyss-marker/newinno/blob/main/admin_system/app/models.py"
    click AllRoutes "https://github.com/zzyss-marker/newinno/blob/main/admin_system/app/routes.py"
    click SubAdminRoute "https://github.com/zzyss-marker/newinno/blob/main/admin_system/app/routes/admin.py"
    click SubAuthRoute "https://github.com/zzyss-marker/newinno/blob/main/admin_system/app/routes/auth.py"
    click Templates "https://github.com/zzyss-marker/newinno/tree/main/admin_system/app/templates/"
    click StaticCSS "https://github.com/zzyss-marker/newinno/blob/main/admin_system/app/static/style.css"
    click CreateAdmin "https://github.com/zzyss-marker/newinno/blob/main/admin_system/create_admin.py"

    click Locust "https://github.com/zzyss-marker/newinno/blob/main/test/locustfile.py"
    click TestUser "https://github.com/zzyss-marker/newinno/blob/main/test/create_approval_admin.py"

    %% Styles
    classDef frontend fill:#c8e6c9,stroke:#2e7d32,color:#2e7d32;
    classDef backend fill:#bbdefb,stroke:#1565c0,color:#1565c0;
    classDef admin fill:#e1bee7,stroke:#6a1b9a,color:#6a1b9a;
    classDef db fill:#ffe0b2,stroke:#e65100,color:#e65100;
    classDef external fill:#eeeeee,stroke:#424242,color:#424242;
```
