# ana-farmer/esucar architecture

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

- Interactive diagram: https://gitdiagram.com/ana-farmer/esucar
- Repository: https://github.com/ana-farmer/esucar

## Overview

Tutor Virtual ESUCAR is an offline-first Android academic guide for developing and reviewing a research proposal. A user opens the welcome screen, enters the role-based local workspace, follows the titling route into proposal sections, saves drafts and progress, and can submit milestones for teacher review. Other documented capabilities include a searchable FAQ tutor, local library, editable profile, and deadline reminders. The graph distinguishes app navigation, academic content, shared state, and optional device or web integrations. Some screen implementations were not sampled; those links rely on README documentation.

Main entry points: [`app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt`](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt) (App navigation), [`app/src/main/java/cl/duoc/tutorvirtual/viewmodel/TutorViewModel.kt`](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/viewmodel/TutorViewModel.kt) (Shared state and persistence), [`app/src/main/java/cl/duoc/tutorvirtual/ui/screens/RutaScreen.kt`](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/RutaScreen.kt) (Titling route), [`app/src/main/java/cl/duoc/tutorvirtual/MainActivity.kt`](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/MainActivity.kt) (Android activity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry and navigation"]
  node_activity["Android activity<br/>[MainActivity.kt]"]
  node_app["App navigation<br/>[EsucarApp.kt]"]
  node_welcome["Welcome screen<br/>[WelcomeScreen.kt]"]
  node_profiles_ui["Profile switching"]
end

subgraph group_academic["Academic guidance and work"]
  node_route["Titling route<br/>[RutaScreen.kt]"]
  node_guide["Methodology guide<br/>[GuiaRepository.kt]"]
  node_stages["Methodology stages"]
  node_proposal["Proposal and drafts<br/>[AcademicContent.kt]"]
  node_journey["Journey model<br/>[ResearchJourney.kt]"]
  node_tutor["FAQ tutor<br/>[AcademicContent.kt]"]
  node_library["Local library<br/>[EsucarApp.kt]"]
end

subgraph group_state["Profiles and saved state"]
  node_profiles["Demo profiles<br/>[DemoProfiles.kt]"]
  node_viewmodel["Shared state and persistence<br/>[TutorViewModel.kt]"]
  node_datastore[("Local DataStore<br/>[TutorViewModel.kt]")]
end

subgraph group_review["Milestones and review"]
  node_milestones["Milestone status<br/>[AcademicContent.kt]"]
  node_milestone_model["Milestone model<br/>[Hito.kt]"]
  node_review_ui["Teacher review"]
end

subgraph group_integrations["Device and external services"]
  node_reminders["Local reminders<br/>[Reminders.kt]"]
end

node_user(("Student or teacher"))
node_android{{"Android device services"}}
node_apa{{"APA Style website"}}

node_user -->|"opens app"| node_activity
node_activity -->|"launches"| node_app
node_app -->|"shows"| node_welcome
node_app -->|"observes state"| node_viewmodel
node_app -->|"shows route"| node_route
node_app -->|"opens switcher"| node_profiles_ui
node_app -->|"uses guide content"| node_guide
node_route -->|"reads stages"| node_journey
node_route -->|"opens proposal"| node_proposal
node_guide -->|"defines content"| node_stages
node_app -->|"routes proposal work"| node_proposal
node_app -->|"routes FAQ search"| node_tutor
node_app -->|"routes library"| node_library
node_app -->|"routes advances"| node_milestones
node_profiles_ui -->|"changes profile"| node_viewmodel
node_viewmodel -->|"checks permissions"| node_profiles
node_viewmodel -->|"reads and writes"| node_datastore
node_app -->|"saves and submits"| node_viewmodel
node_milestones -->|"creates statuses"| node_milestone_model
node_app -->|"routes teacher reviews"| node_review_ui
node_review_ui -->|"records review"| node_viewmodel
node_app -->|"offers reminders"| node_reminders
node_reminders -->|"schedules alarms"| node_android
node_app -.->|"opens camera and gallery"| node_android
node_library -->|"opens reference link"| node_apa

click node_activity "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/MainActivity.kt"
click node_app "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt"
click node_welcome "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/WelcomeScreen.kt"
click node_profiles_ui "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/DemoProfilesScreen.kt"
click node_route "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/RutaScreen.kt"
click node_guide "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/repository/GuiaRepository.kt"
click node_stages "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/model/EtapaMetodologica.kt"
click node_proposal "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/repository/AcademicContent.kt"
click node_journey "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/model/ResearchJourney.kt"
click node_tutor "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/repository/AcademicContent.kt"
click node_library "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt"
click node_profiles "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/model/DemoProfiles.kt"
click node_viewmodel "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/viewmodel/TutorViewModel.kt"
click node_datastore "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/viewmodel/TutorViewModel.kt"
click node_milestones "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/repository/AcademicContent.kt"
click node_milestone_model "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/model/Hito.kt"
click node_review_ui "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/DemoProfilesScreen.kt"
click node_reminders "https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/Reminders.kt"

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_activity,node_app,node_welcome,node_profiles_ui toneBlue
class node_route,node_guide,node_stages,node_proposal,node_journey,node_tutor,node_library toneAmber
class node_profiles,node_viewmodel,node_datastore toneMint
class node_milestones,node_milestone_model,node_review_ui toneRose
class node_reminders,node_user,node_android,node_apa toneIndigo
```

## Components

### App entry and navigation

- [Android activity](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/MainActivity.kt): `app/src/main/java/cl/duoc/tutorvirtual/MainActivity.kt`
- [App navigation](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt): `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt`
- [Welcome screen](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/WelcomeScreen.kt): `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/WelcomeScreen.kt`
- [Profile switching](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/DemoProfilesScreen.kt): `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/DemoProfilesScreen.kt`

### Academic guidance and work

- [Titling route](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/RutaScreen.kt): `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/RutaScreen.kt`
- [Methodology guide](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/repository/GuiaRepository.kt): `app/src/main/java/cl/duoc/tutorvirtual/data/repository/GuiaRepository.kt`
- [Methodology stages](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/model/EtapaMetodologica.kt): `app/src/main/java/cl/duoc/tutorvirtual/data/model/EtapaMetodologica.kt`
- [Proposal and drafts](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/repository/AcademicContent.kt): `app/src/main/java/cl/duoc/tutorvirtual/data/repository/AcademicContent.kt`
- [Journey model](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/model/ResearchJourney.kt): `app/src/main/java/cl/duoc/tutorvirtual/data/model/ResearchJourney.kt`
- [FAQ tutor](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/repository/AcademicContent.kt): `app/src/main/java/cl/duoc/tutorvirtual/data/repository/AcademicContent.kt`
- [Local library](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt): `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt`

### Profiles and saved state

- [Demo profiles](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/model/DemoProfiles.kt): `app/src/main/java/cl/duoc/tutorvirtual/data/model/DemoProfiles.kt`
- [Shared state and persistence](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/viewmodel/TutorViewModel.kt): `app/src/main/java/cl/duoc/tutorvirtual/viewmodel/TutorViewModel.kt`
- [Local DataStore](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/viewmodel/TutorViewModel.kt): `app/src/main/java/cl/duoc/tutorvirtual/viewmodel/TutorViewModel.kt`

### Milestones and review

- [Milestone status](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/repository/AcademicContent.kt): `app/src/main/java/cl/duoc/tutorvirtual/data/repository/AcademicContent.kt`
- [Milestone model](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/data/model/Hito.kt): `app/src/main/java/cl/duoc/tutorvirtual/data/model/Hito.kt`
- [Teacher review](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/DemoProfilesScreen.kt): `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/DemoProfilesScreen.kt`

### Device and external services

- [Local reminders](https://github.com/ana-farmer/esucar/blob/Hugo/app/src/main/java/cl/duoc/tutorvirtual/ui/screens/Reminders.kt): `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/Reminders.kt`

### Other components

- **Student or teacher**
- **Android device services**
- **APA Style website**

## Connections

- Student or teacher → Android activity: opens app (evidence: `README.md`)
- Android activity → App navigation: launches (evidence: `app/src/main/java/cl/duoc/tutorvirtual/MainActivity.kt`)
- App navigation → Welcome screen: shows (evidence: `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt`)
- App navigation → Shared state and persistence: observes state (evidence: `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt`)
- App navigation → Titling route: shows route (evidence: `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt`)
- App navigation → Profile switching: opens switcher (evidence: `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt`)
- App navigation → Methodology guide: uses guide content (evidence: `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt`)
- Titling route → Journey model: reads stages (evidence: `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/RutaScreen.kt`)
- Titling route → Proposal and drafts: opens proposal (evidence: `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/RutaScreen.kt`)
- Methodology guide → Methodology stages: defines content (evidence: `app/src/main/java/cl/duoc/tutorvirtual/data/repository/GuiaRepository.kt`)
- App navigation → Proposal and drafts: routes proposal work (evidence: `README.md`)
- App navigation → FAQ tutor: routes FAQ search (evidence: `README.md`)
- App navigation → Local library: routes library (evidence: `README.md`)
- App navigation → Milestone status: routes advances (evidence: `README.md`)
- Profile switching → Shared state and persistence: changes profile
- Shared state and persistence → Demo profiles: checks permissions (evidence: `app/src/main/java/cl/duoc/tutorvirtual/viewmodel/TutorViewModel.kt`)
- Shared state and persistence → Local DataStore: reads and writes (evidence: `app/src/main/java/cl/duoc/tutorvirtual/viewmodel/TutorViewModel.kt`)
- App navigation → Shared state and persistence: saves and submits (evidence: `README.md`)
- Milestone status → Milestone model: creates statuses (evidence: `app/src/main/java/cl/duoc/tutorvirtual/data/repository/AcademicContent.kt`)
- App navigation → Teacher review: routes teacher reviews (evidence: `README.md`)
- Teacher review → Shared state and persistence: records review (evidence: `README.md`)
- App navigation → Local reminders: offers reminders (evidence: `README.md`)
- Local reminders → Android device services: schedules alarms (evidence: `README.md`)
- App navigation → Android device services: opens camera and gallery (evidence: `README.md`)
- Local library → APA Style website: opens reference link (evidence: `app/src/main/java/cl/duoc/tutorvirtual/ui/screens/EsucarApp.kt`)
