Subjects and Teacher Assignments (Materias) Mi Cole

Subjects (Subject / materias) are the academic disciplines offered by a school—such as Mathematics, Language Arts, or Natural Sciences. They live at the tenant level and are independent of any particular academic period or course. Once created, subjects can be assigned to teachers so that each teacher is linked to the disciplines they will instruct, enabling grade books, schedules, and class dashboards to be scoped correctly.

Subject Model

class Subject {
  final int?    id;
  final String? name;
  final int?    tenantId;

  Subject({this.id, this.name, this.tenantId});

  factory Subject.fromJson(Map<String, dynamic> json) {
    return Subject(
      id:       json['id'],
      name:     json['name'],
      tenantId: json['tenant_id'],
    );
  }
}

int

required

Unique identifier for the subject.

name

String

required

Display name of the subject, e.g. "Matemáticas" or "Lengua y Literatura".

tenantId

int

Tenant-scoping identifier. Populated server-side; subjects are isolated per school.

SubjectRepository

All four CRUD operations plus a single-record fetch are available in SubjectRepository.

class SubjectRepository {
  final Dio _dio;
  SubjectRepository(this._dio);
}

List Subjects
Get by ID
Create Subject
Update Subject
Delete Subject

Returns all subjects belonging to the current tenant.

Future<List<Subject>> getSubjects() async {
  final response = await _dio.get('/subjects');
  return (response.data as List)
      .map((e) => Subject.fromJson(e))
      .toList();
}

Endpoint: GET /api/subjects

[
  { "id": 1, "name": "Matemáticas",        "tenant_id": 3 },
  { "id": 2, "name": "Lengua y Literatura", "tenant_id": 3 },
  { "id": 3, "name": "Ciencias Naturales",  "tenant_id": 3 }
]

Fetches a single subject record by its ID. Used internally by SubjectEditScreen to pre-populate the edit form.

Future<Subject> getSubjectById(int id) async {
  final response = await _dio.get('/subjects/$id');
  return Subject.fromJson(response.data);
}

Endpoint: GET /api/subjects/:id

Creates a new subject scoped to the authenticated tenant.

Future<Subject> createSubject(String name) async {
  final response = await _dio.post(
    '/subjects',
    data: {'name': name},
  );
  return Subject.fromJson(response.data);
}

Endpoint: POST /api/subjects

// Request body
{ "name": "Historia" }

// Response
{ "id": 4, "name": "Historia", "tenant_id": 3 }

Updates the name of an existing subject.

Future<Subject> updateSubject({
  required int    id,
  required String name,
}) async {
  final response = await _dio.put(
    '/subjects/$id',
    data: {'name': name},
  );
  return Subject.fromJson(response.data);
}

Endpoint: PUT /api/subjects/:id

Permanently removes a subject.

Future<void> deleteSubject(int id) async {
  await _dio.delete('/subjects/$id');
}

Endpoint: DELETE /api/subjects/:id

Deleting a subject that is currently assigned to one or more teachers or linked to grade book entries may cause data integrity errors. Remove all teacher assignments before deleting.

Assigning Subjects to Teachers

Subjects become actionable when they are assigned to a teacher. This links a Profesor to a Subject and optionally to a specific Paralelo, forming the basis for class dashboards, grade books, and schedule entries. Endpoint: POST /api/profesores/asignar-materia Directors navigate to /profesores/:id/materia to open AsignarMateriaScreen, where they select a subject and (optionally) a section to complete the assignment. After assignment, the teacher’s assigned subjects are visible at /profesores/:id/materias-asignadas.

Open the teacher profile

Navigate to /profesores and select the teacher you want to assign a subject to.

Go to subject assignment

Tap Asignar materia to navigate to /profesores/:id/materia, which opens AsignarMateriaScreen.

Choose the subject

The screen lists all subjects returned by GET /api/subjects. Select the desired subject from the dropdown or list.

Save the assignment

Confirm to call POST /api/profesores/asignar-materia. The assignment is now visible under the teacher’s assigned-subjects view and enables grade book and schedule features.

App Routes

/materias

List all subjects for the school (SubjectListScreen).

/materias/create

Create a new subject (SubjectScreen).

/materias/:id/edit

Edit an existing subject’s name (SubjectEditScreen).

/profesores/:id/materia

Assign a subject to a specific teacher (AsignarMateriaScreen).

/profesores/:id/materias-asignadas

View all subjects assigned to a teacher (MateriasAsignadasScreen).

School Administration

People Management

Classroom Tools

Student & Parent Portal

Subjects and Teacher Assignments (Materias) Mi Cole

Subject Model

SubjectRepository

Assigning Subjects to Teachers

App Routes

/materias

/materias/create

/materias/:id/edit

/profesores/:id/materia

/profesores/:id/materias-asignadas

Build docs developers (and LLMs) love

School Administration

People Management

Classroom Tools

Student & Parent Portal

Documentation Index

​Subject Model

​SubjectRepository

​Assigning Subjects to Teachers

​App Routes

/materias

/materias/create

/materias/:id/edit

/profesores/:id/materia

/profesores/:id/materias-asignadas

Build docs developers (and LLMs) love

Subject Model

SubjectRepository

Assigning Subjects to Teachers

App Routes