# peidon/aubot architecture

> Architecture diagram of the GitHub repository peidon/aubot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/peidon/aubot
- Repository: https://github.com/peidon/aubot

## Overview

Aubot is a Django backend for a browser-extension assistant: it accepts field labels and profile data, helps match fields to titles, and stores/retrieves profile, education, and work-history records. The main evidenced server workflow routes requests to views; title-link requests are delegated to the matching service and its NLP routines, while profile requests read or update Django models. The README describes extension-based autofill and local-device data, but the extension itself is not in this tree. The excerpts do not establish how the extension calls these endpoints or where user data is ultimately hosted.

Main entry points: [`bot/views.py`](https://github.com/peidon/aubot/blob/master/bot/views.py) (Request handlers), [`bot/urls.py`](https://github.com/peidon/aubot/blob/master/bot/urls.py) (API routes), [`bot/service.py`](https://github.com/peidon/aubot/blob/master/bot/service.py) (Title linking), [`bot/ml/text_processor.py`](https://github.com/peidon/aubot/blob/master/bot/ml/text_processor.py) (Text processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP interface"]
  node_routes["API routes<br/>[urls.py]"]
  node_views["Request handlers<br/>[views.py]"]
end

subgraph group_matching["Field matching"]
  node_service["Title linking<br/>[service.py]"]
  node_nlp["Text processing<br/>[text_processor.py]"]
  node_tailor["Title generation<br/>[tailor.py]"]
end

subgraph group_profiles["Profile records"]
  node_records[("Profile records<br/>[models.py]")]
end

node_extension(("Browser extension"))
node_gemini{{"Google Gemini"}}

node_extension -.->|"uses API"| node_routes
node_routes -->|"routes requests"| node_views
node_views -->|"requests links"| node_service
node_service -->|"selects and matches"| node_nlp
node_nlp -->|"generates titles"| node_tailor
node_tailor -->|"requests generation"| node_gemini
node_views -->|"reads and updates"| node_records

click node_routes "https://github.com/peidon/aubot/blob/master/bot/urls.py"
click node_views "https://github.com/peidon/aubot/blob/master/bot/views.py"
click node_service "https://github.com/peidon/aubot/blob/master/bot/service.py"
click node_nlp "https://github.com/peidon/aubot/blob/master/bot/ml/text_processor.py"
click node_tailor "https://github.com/peidon/aubot/blob/master/bot/agent/tailor.py"
click node_records "https://github.com/peidon/aubot/blob/master/bot/models.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_routes,node_views,node_extension toneBlue
class node_service,node_nlp,node_tailor toneAmber
class node_records toneMint
class node_gemini toneIndigo
```

## Components

### HTTP interface

- [API routes](https://github.com/peidon/aubot/blob/master/bot/urls.py): `bot/urls.py`
- [Request handlers](https://github.com/peidon/aubot/blob/master/bot/views.py): `bot/views.py`

### Field matching

- [Title linking](https://github.com/peidon/aubot/blob/master/bot/service.py): `bot/service.py`
- [Text processing](https://github.com/peidon/aubot/blob/master/bot/ml/text_processor.py): `bot/ml/text_processor.py`
- [Title generation](https://github.com/peidon/aubot/blob/master/bot/agent/tailor.py): `bot/agent/tailor.py`

### Profile records

- [Profile records](https://github.com/peidon/aubot/blob/master/bot/models.py): `bot/models.py`

### Other components

- **Browser extension**
- **Google Gemini**

## Connections

- Browser extension → API routes: uses API
- API routes → Request handlers: routes requests (evidence: `bot/urls.py`)
- Request handlers → Title linking: requests links (evidence: `bot/views.py`)
- Title linking → Text processing: selects and matches (evidence: `bot/service.py`)
- Text processing → Title generation: generates titles (evidence: `bot/ml/text_processor.py`)
- Title generation → Google Gemini: requests generation (evidence: `bot/agent/tailor.py`)
- Request handlers → Profile records: reads and updates (evidence: `bot/views.py`)
