Manual paso a paso · Peruvian Oil Company

Caso: Yacimientos y Pozos · Windows Forms con C# · solo entidades

Este manual recrea el parcial Tema A de Peruvian Oil Company y te lleva paso a paso de un proyecto vacio en Visual Studio a la solucion completa con multilistas. Version simple: solo entidades, toda la logica vive en los formularios.

Resumen del caso

Arquitectura del proyecto final

PASO 1 · Crear el proyecto en Visual Studio

1. Abre Visual Studio y elige Create a new project.
2. Busca y selecciona Windows Forms App (.NET Framework) con C#.
3. Nombre del proyecto: PeruvianOilCompany. Framework: .NET Framework 4.7.2.
4. Visual Studio te abre el proyecto con Form1.cs, Program.cs y la carpeta Properties.

PASO 2 · Crear la carpeta entities

En el Solution Explorer, click derecho sobre el proyecto PeruvianOilCompany y elige Add → New Folder:

• entities

PASO 3 · Crear entities/Pozo.cs

using System;

namespace PeruvianOilCompany.entities
{
    public class Pozo
    {
        public string Codigo { get; set; }
        public string NombreTecnico { get; set; }
        public string TipoExtraccion { get; set; }
        public int ProduccionDiaria { get; set; }
    }
}

PASO 4 · Crear entities/Yacimiento.cs

using System;
using System.Collections.Generic;

namespace PeruvianOilCompany.entities
{
    public class Yacimiento
    {
        public string Codigo { get; set; }
        public string Nombre { get; set; }
        public string Region { get; set; }
        public double Reserva { get; set; }
        public List<Pozo> Pozos { get; set; }
    }
}

PASO 5 · Disenar FrmPrincipal y declarar la lista compartida

Arrastra desde el Toolbox y configura:

Distribuye los 3 botones uno debajo del otro, centrados:

Abre el codigo de FrmPrincipal.cs y al inicio de la clase agrega la lista compartida que usaran todos los formularios:

using PeruvianOilCompany.entities;
using System.Collections.Generic;

namespace PeruvianOilCompany
{
    public partial class FrmPrincipal : Form
    {
        // Lista global accesible desde todos los formularios
        public static List<Yacimiento> Yacimientos = new List<Yacimiento>();

        public FrmPrincipal()
        {
            InitializeComponent();
        }
    }
}

PASO 6 · Codigo de los 3 botones del menu

private void btnYacimiento_Click(object sender, EventArgs e)
{
    FrmYacimiento frm = new FrmYacimiento();
    frm.ShowDialog();
}

private void btnPozo_Click(object sender, EventArgs e)
{
    FrmPozo frm = new FrmPozo();
    frm.ShowDialog();
}

private void btnReportes_Click(object sender, EventArgs e)
{
    FrmReportes frm = new FrmReportes();
    frm.ShowDialog();
}

PASO 7 · Configurar Program.cs

Application.Run(new FrmPrincipal());

PASO 8 · Disenar FrmYacimiento

PASO 9 · Cargar combo Region en Form_Load

using PeruvianOilCompany.entities;

private void FrmYacimiento_Load(object sender, EventArgs e)
{
    cboRegion.Items.Add("Costa");
    cboRegion.Items.Add("Sierra");
    cboRegion.Items.Add("Selva");

    MostrarYacimientos();
}

private void MostrarYacimientos()
{
    dgvYacimientos.DataSource = null;
    dgvYacimientos.DataSource = FrmPrincipal.Yacimientos;
}

PASO 10 · btnRegistrar_Click (registrar yacimiento)

private void btnRegistrar_Click(object sender, EventArgs e)
{
    // 1. Validar campos no vacios
    if (txtCodigo.Text == "" || txtNombre.Text == "" ||
        cboRegion.SelectedIndex == -1 || txtReserva.Text == "")
    {
        MessageBox.Show("Debe completar todos los campos.");
        return;
    }

    string codigo = txtCodigo.Text;

    // 2. Validar codigo unico (en yacimientos y en pozos)
    foreach (Yacimiento ya in FrmPrincipal.Yacimientos)
    {
        if (ya.Codigo == codigo)
        {
            MessageBox.Show("El codigo ya existe.");
            return;
        }
        foreach (Pozo p in ya.Pozos)
        {
            if (p.Codigo == codigo)
            {
                MessageBox.Show("El codigo ya existe (esta usado por un pozo).");
                return;
            }
        }
    }

    // 3. Crear el yacimiento e inicializar la lista de pozos
    Yacimiento y = new Yacimiento();
    y.Codigo = codigo;
    y.Nombre = txtNombre.Text;
    y.Region = cboRegion.Text;
    y.Reserva = double.Parse(txtReserva.Text);
    y.Pozos = new List<Pozo>();

    FrmPrincipal.Yacimientos.Add(y);

    MostrarYacimientos();
    txtCodigo.Clear();
    txtNombre.Clear();
    txtReserva.Clear();
    cboRegion.SelectedIndex = -1;

    MessageBox.Show("Yacimiento registrado.");
}

PASO 11 · Disenar FrmPozo

PASO 12 · Cargar combos Yacimiento y Extraccion en Form_Load

using PeruvianOilCompany.entities;

private void FrmPozo_Load(object sender, EventArgs e)
{
    // Combo de yacimientos: muestra Nombre, identifica por Codigo
    cboYacimiento.DataSource = null;
    cboYacimiento.DataSource = FrmPrincipal.Yacimientos;
    cboYacimiento.DisplayMember = "Nombre";

    // Combo de tipo de extraccion
    cboExtraccion.Items.Add("Convencional");
    cboExtraccion.Items.Add("No Convencional");
}

private void cboYacimiento_SelectedIndexChanged(object sender, EventArgs e)
{
    if (cboYacimiento.SelectedItem == null) return;
    Yacimiento y = (Yacimiento)cboYacimiento.SelectedItem;
    dgvPozos.DataSource = null;
    dgvPozos.DataSource = y.Pozos;
}

PASO 13 · btnRegistrar_Click (registrar pozo en yacimiento)

private void btnRegistrar_Click(object sender, EventArgs e)
{
    // 1. Validar yacimiento seleccionado
    if (cboYacimiento.SelectedItem == null)
    {
        MessageBox.Show("Seleccione un yacimiento.");
        return;
    }

    // 2. Validar campos no vacios
    if (txtCodigo.Text == "" || txtNombre.Text == "" ||
        cboExtraccion.SelectedIndex == -1 || txtBarriles.Text == "")
    {
        MessageBox.Show("Debe completar todos los campos.");
        return;
    }

    string codigo = txtCodigo.Text;

    // 3. Validar codigo unico global (yacimientos y pozos)
    foreach (Yacimiento ya in FrmPrincipal.Yacimientos)
    {
        if (ya.Codigo == codigo)
        {
            MessageBox.Show("El codigo ya existe.");
            return;
        }
        foreach (Pozo pp in ya.Pozos)
        {
            if (pp.Codigo == codigo)
            {
                MessageBox.Show("El codigo ya existe.");
                return;
            }
        }
    }

    // 4. Validar produccion no negativa
    int barriles = int.Parse(txtBarriles.Text);
    if (barriles < 0)
    {
        MessageBox.Show("La produccion no puede ser negativa.");
        return;
    }

    // 5. Crear el pozo y agregarlo al yacimiento seleccionado
    Yacimiento y = (Yacimiento)cboYacimiento.SelectedItem;

    Pozo p = new Pozo();
    p.Codigo = codigo;
    p.NombreTecnico = txtNombre.Text;
    p.TipoExtraccion = cboExtraccion.Text;
    p.ProduccionDiaria = barriles;

    y.Pozos.Add(p);

    dgvPozos.DataSource = null;
    dgvPozos.DataSource = y.Pozos;

    txtCodigo.Clear();
    txtNombre.Clear();
    txtBarriles.Clear();
    cboExtraccion.SelectedIndex = -1;

    MessageBox.Show("Pozo registrado.");
}

PASO 14 · Disenar FrmReportes y cargar combo de reportes

using PeruvianOilCompany.entities;
using System.Collections.Generic;

private void FrmReportes_Load(object sender, EventArgs e)
{
    cboReportes.Items.Add("1. Yacimientos ordenados por reserva (asc)");
    cboReportes.Items.Add("2. Yacimiento(s) con menor numero de pozos");
    cboReportes.Items.Add("3. Selva con al menos un pozo No Convencional");
    cboReportes.Items.Add("4. Sin pozos con produccion mayor a 500");
}

private void btnEjecutar_Click(object sender, EventArgs e)
{
    switch (cboReportes.SelectedIndex)
    {
        case 0: Reporte1(); break;
        case 1: Reporte2(); break;
        case 2: Reporte3(); break;
        case 3: Reporte4(); break;
        default: MessageBox.Show("Seleccione un reporte."); break;
    }
}

PASO 15 · Reporte 1 · ordenar yacimientos por reserva

private void Reporte1()
{
    List<Yacimiento> ordenados = new List<Yacimiento>();

    // Copiar la lista para no modificar la original
    foreach (Yacimiento y in FrmPrincipal.Yacimientos)
    {
        ordenados.Add(y);
    }

    // Bubble sort ascendente por Reserva
    for (int i = 0; i < ordenados.Count - 1; i++)
    {
        for (int j = 0; j < ordenados.Count - 1 - i; j++)
        {
            if (ordenados[j].Reserva > ordenados[j + 1].Reserva)
            {
                Yacimiento tmp = ordenados[j];
                ordenados[j] = ordenados[j + 1];
                ordenados[j + 1] = tmp;
            }
        }
    }

    dgvReportes.DataSource = null;
    dgvReportes.DataSource = ordenados;
}

PASO 16 · Reporte 2 · yacimiento(s) con menor numero de pozos

private void Reporte2()
{
    List<Yacimiento> lista = FrmPrincipal.Yacimientos;
    if (lista.Count == 0) return;

    // 1) Buscar el menor numero de pozos
    int menor = lista[0].Pozos.Count;
    foreach (Yacimiento y in lista)
    {
        if (y.Pozos.Count < menor) menor = y.Pozos.Count;
    }

    // 2) Filtrar los que tienen ese minimo (puede haber empates)
    List<Yacimiento> resultado = new List<Yacimiento>();
    foreach (Yacimiento y in lista)
    {
        if (y.Pozos.Count == menor) resultado.Add(y);
    }

    dgvReportes.DataSource = null;
    dgvReportes.DataSource = resultado;
}

PASO 17 · Reporte 3 · Selva con al menos un pozo No Convencional

private void Reporte3()
{
    List<Yacimiento> resultado = new List<Yacimiento>();

    foreach (Yacimiento y in FrmPrincipal.Yacimientos)
    {
        if (y.Region != "Selva") continue;

        bool tieneNoConvencional = false;
        foreach (Pozo p in y.Pozos)
        {
            if (p.TipoExtraccion == "No Convencional")
            {
                tieneNoConvencional = true;
                break;
            }
        }

        if (tieneNoConvencional) resultado.Add(y);
    }

    dgvReportes.DataSource = null;
    dgvReportes.DataSource = resultado;
}

PASO 18 · Reporte 4 · sin pozos con produccion mayor a 500 barriles

private void Reporte4()
{
    List<Yacimiento> resultado = new List<Yacimiento>();

    foreach (Yacimiento y in FrmPrincipal.Yacimientos)
    {
        bool tieneAlguno = false;
        foreach (Pozo p in y.Pozos)
        {
            if (p.ProduccionDiaria > 500)
            {
                tieneAlguno = true;
                break;
            }
        }

        if (!tieneAlguno) resultado.Add(y);
    }

    dgvReportes.DataSource = null;
    dgvReportes.DataSource = resultado;
}

PASO 19 · Probar el programa completo

Presiona F5 y prueba con estos datos para verificar los 4 reportes:

Resultados esperados:

• Reporte 1: Talara (50), Aguaytia (85), Lobitos (120.5), Camisea (200)
• Reporte 2: Talara (0 pozos)
• Reporte 3: Aguaytia, Camisea (Selva con al menos un No Convencional)
• Reporte 4: Aguaytia (max 320), Talara (sin pozos), Lobitos (max 600 → queda fuera). Camisea queda fuera porque tiene un pozo de 800. Resultado real: Aguaytia y Talara.

PASO 20 · Errores comunes y como evitarlos